Add main/supporting characters, character arcs and open questions

Three things the outline could not express before:

Main vs supporting. A new CharacterImportance sits alongside CharacterRole
rather than inside it — role is the part a character plays (protagonist,
mentor, foil), importance is how much of the book they carry, and a mentor can
be either. Characters start Supporting and get promoted. Listings put main
characters first.

Character arcs. A main character's arc is a flat ordered list of stages, the
same shape as a chapter's beats and for the same reason: an arc is a sequence
of changes, not a tree. A stage can be pinned to the chapter where it lands.
Nothing refuses an arc on a supporting character — demoting someone should not
delete their work.

Open questions. What the writer has not decided yet, hanging off a chapter
outline, a character, both, or neither. They can be resolved, reopened or
deleted, and resolving can append the decision to the notes of whatever the
question was attached to, so it lands where the writer will re-read it.
Resolved questions drop off the list unless asked for.

Also adds GET /api/characters/{id}/beats — every beat a character appears in,
in manuscript order, carrying each beat's chapter so the character page can
link straight into that chapter's outline.

Deletes are deliberately asymmetric: deleting a chapter unpins arc stages and
detaches questions rather than taking them, because a plan outlives a decision
about where the chapter break falls. Deleting a character or project does take
their arcs and questions.

All three capabilities are surfaced in the REST API, the agent toolset and the
MCP server, per the one-source-of-truth rule.

Two things worth flagging in the migration: EF's generated default for the new
Importance column was an empty string, which does not parse back to a
CharacterImportance and would have faulted every read of an existing dossier —
it now defaults to Supporting, verified by migrating a database seeded on the
old schema and reading the row back through the API. And the earlier migrations
were renamed to the namespace EF derives from the output folder, so future
`migrations add` runs stop drifting.

72 tests pass (28 new). The endpoints were also exercised over curl end to end:
arc stages resolving their chapter, a character's beats across chapters, and a
question attached to both a chapter and a character resolving into both sets of
notes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S56bfZMGe1hnhpWP4CjjNw

src/Novelly.Api/Characters/CharacterArcService.cs

@@ -0,0 +1,143 @@
+using Microsoft.EntityFrameworkCore;
+using Novelly.Api.Common;
+using Novelly.Api.Data;
+
+namespace Novelly.Api.Characters;
+
+/// <summary>
+/// A character's arc: a flat, ordered list of the changes they go through. Same shape as
+/// a chapter's beats, and for the same reason — an arc is a sequence, not a tree.
+/// </summary>
+/// <remarks>
+/// Arcs are only really worth keeping for main characters, but nothing here refuses one
+/// on a supporting character. Demoting someone should not delete work, and a character
+/// who turns out to matter gets promoted after the arc is already sketched.
+/// </remarks>
+public class CharacterArcService(INovelDbContext db)
+{
+    public async Task<IReadOnlyList<ArcStageDto>> ListAsync(Guid characterId, CancellationToken ct = default)
+    {
+        var stages = await Query()
+            .Where(s => s.CharacterId == characterId)
+            .OrderBy(s => s.SortOrder)
+            .ToListAsync(ct);
+
+        return [.. stages.Select(s => s.ToDto())];
+    }
+
+    public async Task<ArcStageDto> GetAsync(Guid id, CancellationToken ct = default) =>
+        (await FindAsync(id, ct)).ToDto();
+
+    public async Task<ArcStageDto> CreateAsync(
+        Guid characterId, CreateArcStageRequest request, CancellationToken ct = default)
+    {
+        var character = await db.Characters.FirstOrDefaultAsync(c => c.Id == characterId, ct)
+            ?? throw new NotFoundException(nameof(Character), characterId);
+
+        await EnsureChapterIsInSameProjectAsync(character, request.ChapterId, ct);
+
+        var stage = new CharacterArcStage
+        {
+            CharacterId = characterId,
+            Title = request.Title,
+            SortOrder = request.SortOrder ?? await NextSortOrderAsync(characterId, ct),
+            Description = request.Description,
+            ChapterId = request.ChapterId
+        };
+
+        db.CharacterArcStages.Add(stage);
+        await db.SaveChangesAsync(ct);
+        return (await FindAsync(stage.Id, ct)).ToDto();
+    }
+
+    public async Task<ArcStageDto> UpdateAsync(
+        Guid id, UpdateArcStageRequest request, CancellationToken ct = default)
+    {
+        var stage = await FindAsync(id, ct);
+
+        var character = await db.Characters.FirstOrDefaultAsync(c => c.Id == stage.CharacterId, ct)
+            ?? throw new NotFoundException(nameof(Character), stage.CharacterId);
+
+        await EnsureChapterIsInSameProjectAsync(character, request.ChapterId, ct);
+
+        stage.Title = Patch.Apply(stage.Title, request.Title) ?? stage.Title;
+        stage.SortOrder = request.SortOrder ?? stage.SortOrder;
+        stage.Description = Patch.Apply(stage.Description, request.Description);
+        stage.ChapterId = request.ChapterId ?? stage.ChapterId;
+        stage.UpdatedAt = DateTimeOffset.UtcNow;
+
+        await db.SaveChangesAsync(ct);
+        return (await FindAsync(id, ct)).ToDto();
+    }
+
+    public async Task DeleteAsync(Guid id, CancellationToken ct = default)
+    {
+        var stage = await FindAsync(id, ct);
+        db.CharacterArcStages.Remove(stage);
+        await db.SaveChangesAsync(ct);
+    }
+
+    /// <summary>
+    /// Renumbers a character's arc to match the order given. Stages left out keep their
+    /// relative position after the ones listed, exactly as beat reordering works.
+    /// </summary>
+    public async Task<IReadOnlyList<ArcStageDto>> ReorderAsync(
+        Guid characterId, ReorderArcStagesRequest request, CancellationToken ct = default)
+    {
+        var stages = await db.CharacterArcStages
+            .Where(s => s.CharacterId == characterId)
+            .ToListAsync(ct);
+
+        var missing = request.StageIds.Where(id => stages.All(s => s.Id != id)).ToList();
+        if (missing.Count > 0)
+        {
+            throw new NotFoundException(nameof(CharacterArcStage), missing[0]);
+        }
+
+        var order = 1;
+        foreach (var id in request.StageIds)
+        {
+            stages.Single(s => s.Id == id).SortOrder = order++;
+        }
+
+        foreach (var stage in stages.Where(s => !request.StageIds.Contains(s.Id)).OrderBy(s => s.SortOrder))
+        {
+            stage.SortOrder = order++;
+        }
+
+        await db.SaveChangesAsync(ct);
+        return await ListAsync(characterId, ct);
+    }
+
+    private async Task EnsureChapterIsInSameProjectAsync(
+        Character character, Guid? chapterId, CancellationToken ct)
+    {
+        if (chapterId is not { } id)
+        {
+            return;
+        }
+
+        var belongs = await db.Chapters.AnyAsync(c => c.Id == id && c.ProjectId == character.ProjectId, ct);
+
+        if (!belongs)
+        {
+            throw new InvalidOperationException(
+                "An arc stage can only point at a chapter in the same project as its character.");
+        }
+    }
+
+    private async Task<int> NextSortOrderAsync(Guid characterId, CancellationToken ct)
+    {
+        var max = await db.CharacterArcStages
+            .Where(s => s.CharacterId == characterId)
+            .MaxAsync(s => (int?)s.SortOrder, ct);
+
+        return (max ?? 0) + 1;
+    }
+
+    private IQueryable<CharacterArcStage> Query() => db.CharacterArcStages.Include(s => s.Chapter);
+
+    private async Task<CharacterArcStage> FindAsync(Guid id, CancellationToken ct) =>
+        await Query().FirstOrDefaultAsync(s => s.Id == id, ct)
+        ?? throw new NotFoundException(nameof(CharacterArcStage), id);
+}