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:
James Wampler
co-authored by
Claude Opus 5
Claude Opus 5
parent
30e0c6926e
commit
725758ccd9
@@ -0,0 +1,124 @@
|
||||
using System.ComponentModel;
|
||||
using ModelContextProtocol.Protocol;
|
||||
using ModelContextProtocol.Server;
|
||||
|
||||
namespace Novelly.Mcp.Tools;
|
||||
|
||||
[McpServerToolType]
|
||||
public static class CharacterTools
|
||||
{
|
||||
[McpServerTool(Name = "list_characters")]
|
||||
[Description("List a project's character dossiers in full, including their relationships.")]
|
||||
public static Task<CallToolResult> ListCharacters(
|
||||
NovelApiClient api,
|
||||
[Description("The project's id.")] Guid projectId,
|
||||
CancellationToken ct) =>
|
||||
api.GetAsync($"/api/projects/{projectId}/characters", ct);
|
||||
|
||||
[McpServerTool(Name = "get_character")]
|
||||
[Description("Read one character's dossier.")]
|
||||
public static Task<CallToolResult> GetCharacter(
|
||||
NovelApiClient api,
|
||||
[Description("The character's id.")] Guid characterId,
|
||||
CancellationToken ct) =>
|
||||
api.GetAsync($"/api/characters/{characterId}", ct);
|
||||
|
||||
[McpServerTool(Name = "create_character")]
|
||||
[Description("Add a character dossier to a project. Name is the only requirement — leave a field "
|
||||
+ "blank when the writer has not decided it yet rather than inventing detail.")]
|
||||
public static Task<CallToolResult> CreateCharacter(
|
||||
NovelApiClient api,
|
||||
[Description("The project's id.")] Guid projectId,
|
||||
[Description("The character's name.")] string name,
|
||||
CancellationToken ct,
|
||||
[Description("Protagonist, Antagonist, Deuteragonist, Supporting, Minor, Mentor, LoveInterest or Foil.")]
|
||||
string? role = null,
|
||||
[Description("Age, exact or approximate.")] string? age = null,
|
||||
[Description("The pronouns this character uses.")] string? pronouns = null,
|
||||
[Description("What they do.")] string? occupation = null,
|
||||
[Description("How they look.")] string? appearance = null,
|
||||
[Description("Temperament, habits, how they treat people.")] string? personality = null,
|
||||
[Description("History that shapes who they are now.")] string? backstory = null,
|
||||
[Description("What they consciously pursue.")] string? want = null,
|
||||
[Description("What they actually need, usually at odds with what they want.")] string? need = null,
|
||||
[Description("The war inside them.")] string? internalConflict = null,
|
||||
[Description("What in the world opposes them.")] string? externalConflict = null,
|
||||
[Description("How they change over the course of the book.")] string? arcSummary = null,
|
||||
[Description("Speech patterns and register that make their dialogue theirs.")] string? voice = null,
|
||||
[Description("Anything else worth recording.")] string? notes = null,
|
||||
[Description("Tags for cross-referencing. Unknown tags are created.")] string[]? tags = null) =>
|
||||
api.PostAsync($"/api/projects/{projectId}/characters", new
|
||||
{
|
||||
name,
|
||||
role = role ?? "Supporting",
|
||||
age,
|
||||
pronouns,
|
||||
occupation,
|
||||
appearance,
|
||||
personality,
|
||||
backstory,
|
||||
want,
|
||||
need,
|
||||
internalConflict,
|
||||
externalConflict,
|
||||
arcSummary,
|
||||
voice,
|
||||
notes,
|
||||
tags
|
||||
}, ct);
|
||||
|
||||
[McpServerTool(Name = "update_character")]
|
||||
[Description("Revise an existing character dossier. Only the fields you supply change.")]
|
||||
public static Task<CallToolResult> UpdateCharacter(
|
||||
NovelApiClient api,
|
||||
[Description("The character's id.")] Guid characterId,
|
||||
CancellationToken ct,
|
||||
[Description("New name.")] string? name = null,
|
||||
[Description("Protagonist, Antagonist, Deuteragonist, Supporting, Minor, Mentor, LoveInterest or Foil.")]
|
||||
string? role = null,
|
||||
[Description("Age, exact or approximate.")] string? age = null,
|
||||
[Description("The pronouns this character uses.")] string? pronouns = null,
|
||||
[Description("What they do.")] string? occupation = null,
|
||||
[Description("How they look.")] string? appearance = null,
|
||||
[Description("Temperament, habits, how they treat people.")] string? personality = null,
|
||||
[Description("History that shapes who they are now.")] string? backstory = null,
|
||||
[Description("What they consciously pursue.")] string? want = null,
|
||||
[Description("What they actually need.")] string? need = null,
|
||||
[Description("The war inside them.")] string? internalConflict = null,
|
||||
[Description("What in the world opposes them.")] string? externalConflict = null,
|
||||
[Description("How they change over the course of the book.")] string? arcSummary = null,
|
||||
[Description("Speech patterns and register.")] string? voice = null,
|
||||
[Description("Anything else worth recording.")] string? notes = null,
|
||||
[Description("Tags for cross-referencing. Replaces the existing tags.")] string[]? tags = null) =>
|
||||
api.PatchAsync($"/api/characters/{characterId}", new
|
||||
{
|
||||
name,
|
||||
role,
|
||||
age,
|
||||
pronouns,
|
||||
occupation,
|
||||
appearance,
|
||||
personality,
|
||||
backstory,
|
||||
want,
|
||||
need,
|
||||
internalConflict,
|
||||
externalConflict,
|
||||
arcSummary,
|
||||
voice,
|
||||
notes,
|
||||
tags
|
||||
}, ct);
|
||||
|
||||
[McpServerTool(Name = "relate_characters")]
|
||||
[Description("Record a relationship from one character to another in the same project.")]
|
||||
public static Task<CallToolResult> RelateCharacters(
|
||||
NovelApiClient api,
|
||||
[Description("Id of the character the relationship belongs to.")] Guid characterId,
|
||||
[Description("Id of the character they are related to.")] Guid relatedCharacterId,
|
||||
[Description("How they are related, e.g. 'sister', 'rival', 'former mentor'.")] string relationshipType,
|
||||
CancellationToken ct,
|
||||
[Description("What the relationship is like, and where it is headed.")] string? description = null) =>
|
||||
api.PostAsync($"/api/characters/{characterId}/relationships",
|
||||
new { relatedCharacterId, relationshipType, description }, ct);
|
||||
}
|
||||
Reference in New Issue
Block a user