Reorganise by feature, rename to Novelly, add Aspire and a pre-push hook
The layered split into Domain/Application/Infrastructure/Api was forcing organisation by layer: adding one capability meant touching four projects and four folders that each held a slice of it. Those four projects are now one feature-organised Novelly.Api, where each folder — Projects, Characters, Chapters, Beats, Scenes, Tags, Agent — holds its entity, DTOs, service and endpoints together. Common/ holds what genuinely crosses features (the patch semantics, the two exception types, DraftStatus) and Data/ holds the DbContext and migrations. Six .NET projects become five: the three layer projects are gone, and Novelly.AppHost and Novelly.ServiceDefaults are new. - Namespaces move from NovelSoftware.* to Novelly.*, including the entity type names recorded in the EF model snapshots. The migration ids are untouched, so an existing novel.db still migrates cleanly — verified against a fresh file. - Aspire orchestration mirrors the mic-check setup: the AppHost starts the API on :5080 and the Vite dev server on :5173, and the API picks up OpenTelemetry, health checks and service discovery from ServiceDefaults. /health and /alive now answer in development. - A Husky pre-push hook runs scripts/ci/prepush.sh: build, test, then a web build. The scripts are plain bash so CI can run the same steps. - The MCP server's env var is now NOVELLY_API_URL. Verified beyond the build: 44 tests pass, the web client builds, the API was exercised over curl (project/chapter/beat/tag round trip, tag cross-reference, 503 on the agent without a key while conversation listing still returns 200), the MCP server was driven over stdio JSON-RPC (26 tools, errors still surface the API's own message rather than being flattened), and the AppHost was run to confirm both resources come up and Vite proxies /api through to the API. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S56bfZMGe1hnhpWP4CjjNw
This commit is contained in:
co-authored by
Claude Opus 5
parent
30e0c6926e
commit
725758ccd9
@@ -0,0 +1,71 @@
|
||||
using System.ComponentModel;
|
||||
using ModelContextProtocol.Protocol;
|
||||
using ModelContextProtocol.Server;
|
||||
|
||||
namespace Novelly.Mcp.Tools;
|
||||
|
||||
[McpServerToolType]
|
||||
public static class BeatTools
|
||||
{
|
||||
[McpServerTool(Name = "get_chapter_outline")]
|
||||
[Description("Read a chapter's outline: its beats in order. Each beat is one row — a short "
|
||||
+ "title, whose beat it is, what happened, and what it sets up. The chapter's "
|
||||
+ "summary paragraph sits on the chapter itself, via get_chapter.")]
|
||||
public static Task<CallToolResult> GetChapterOutline(
|
||||
NovelApiClient api,
|
||||
[Description("The chapter's id.")] Guid chapterId,
|
||||
CancellationToken ct) =>
|
||||
api.GetAsync($"/api/chapters/{chapterId}/beats", ct);
|
||||
|
||||
[McpServerTool(Name = "create_beat")]
|
||||
[Description("Add a beat to a chapter's outline. Keep the title to three to five words — it "
|
||||
+ "is a handle, not a sentence; detail belongs in whatHappened and whatsNext.")]
|
||||
public static Task<CallToolResult> CreateBeat(
|
||||
NovelApiClient api,
|
||||
[Description("The chapter's id.")] Guid chapterId,
|
||||
[Description("Three to five words naming the beat.")] string title,
|
||||
CancellationToken ct,
|
||||
[Description("Position in the chapter. Appended to the end when omitted.")] int? sortOrder = null,
|
||||
[Description("Id of the character whose beat this is.")] Guid? characterId = null,
|
||||
[Description("The event itself.")] string? whatHappened = null,
|
||||
[Description("What it sets in motion — the hook into the next beat.")] string? whatsNext = null,
|
||||
[Description("Id of the scene this beat will be written into, if decided.")] Guid? sceneId = null,
|
||||
[Description("Tags for cross-referencing. Unknown tags are created.")] string[]? tags = null) =>
|
||||
api.PostAsync($"/api/chapters/{chapterId}/beats",
|
||||
new { title, sortOrder, characterId, whatHappened, whatsNext, sceneId, tags }, ct);
|
||||
|
||||
[McpServerTool(Name = "update_beat")]
|
||||
[Description("Revise a beat. Only the fields you supply change. Supplying a tag list replaces "
|
||||
+ "the beat's tags outright, so include the ones you want to keep.")]
|
||||
public static Task<CallToolResult> UpdateBeat(
|
||||
NovelApiClient api,
|
||||
[Description("The beat's id.")] Guid beatId,
|
||||
CancellationToken ct,
|
||||
[Description("Three to five words naming the beat.")] string? title = null,
|
||||
[Description("Position in the chapter.")] int? sortOrder = null,
|
||||
[Description("Id of the character whose beat this is.")] Guid? characterId = null,
|
||||
[Description("The event itself.")] string? whatHappened = null,
|
||||
[Description("What it sets in motion.")] string? whatsNext = null,
|
||||
[Description("Id of the scene this beat will be written into.")] Guid? sceneId = null,
|
||||
[Description("Tags for cross-referencing. Replaces the existing tags.")] string[]? tags = null) =>
|
||||
api.PatchAsync($"/api/beats/{beatId}",
|
||||
new { title, sortOrder, characterId, whatHappened, whatsNext, sceneId, tags }, ct);
|
||||
|
||||
[McpServerTool(Name = "delete_beat")]
|
||||
[Description("Remove a beat from a chapter's outline. Confirm with the writer first.")]
|
||||
public static Task<CallToolResult> DeleteBeat(
|
||||
NovelApiClient api,
|
||||
[Description("The beat's id.")] Guid beatId,
|
||||
CancellationToken ct) =>
|
||||
api.DeleteAsync($"/api/beats/{beatId}", ct);
|
||||
|
||||
[McpServerTool(Name = "reorder_beats")]
|
||||
[Description("Renumber a chapter's beats to match the order given. List every beat id in the "
|
||||
+ "order wanted; any left out keep their relative position at the end.")]
|
||||
public static Task<CallToolResult> ReorderBeats(
|
||||
NovelApiClient api,
|
||||
[Description("The chapter's id.")] Guid chapterId,
|
||||
[Description("Beat ids in their new order.")] Guid[] beatIds,
|
||||
CancellationToken ct) =>
|
||||
api.PostAsync($"/api/chapters/{chapterId}/beats/reorder", new { beatIds }, ct);
|
||||
}
|
||||
Reference in New Issue
Block a user