Metadata views + `novolis-apps` on `main`

name: Metadata views and git main overview: Replace Book Authoring metadata toolbar buttons with exportable Timeline, Relationships, and Map views (Mermaid source + file export in v1), and publish novolis-apps to GitHub with default branch main — never master. todos:

• id: git-main-remote

content: Clean git state, rename master→main, create Novolis-Platform/novolis-apps with default branch main, push origin/main status: completed

• id: metadata-index-builders

content: Add BookMetadataIndex + Timeline/Relationships/Map Mermaid builders using Novolis.Markup.Mermaid status: completed

• id: right-rail-views-ui

content: Extend IManuscriptExtension + MainWindow right-rail view switcher; replace toolbar with Insert menu + exports status: completed

• id: mermaid-export

content: Implement MermaidViewExporter (.mmd + manifest) under dataRoot/exports status: completed

• id: docs-verify-smoke

content: Update docs, build, verify-nuget-only, Calypso smoke test for views + export status: completed isProject: false

Part A — Git remote and branch policy

Current state: Local repo at novolis-apps is on branch `master` with no `origin` remote. Novolis-Platform/novolis-apps does not exist on GitHub yet. Uncommitted work includes full ManuscriptStudio tree; index still shows stale HandcraftedMarkdown paths.

Target state:

Steps (execution order):

1. Stage all current files (ManuscriptStudio, docs, slnx); remove deleted HandcraftedMarkdown from index.
2. Commit if needed so main has a clean snapshot.
3. git branch -m master main (rename local branch; do not push master).
4. gh repo create Novolis-Platform/novolis-apps --public --source=. --remote=origin --push with explicit default branch main:

   gh repo create Novolis-Platform/novolis-apps --public --source=. --remote=origin
   git push -u origin main

If the org requires template scaffolding first, create empty repo with --default-branch main then push.

1. Verify: gh repo view Novolis-Platform/novolis-apps --json defaultBranchRef → main; git branch -a shows only main on remote.
2. Optional: add HEAD symlink protection / branch rules in GitHub UI (org policy) so master cannot be created.

No changes to novolis-governance required unless you want apps-repos.md to link the live repo URL after creation.

Part B — Replace toolbar buttons with metadata views (v1: export-only)

User choice: Live Mermaid rendering deferred — source panel + export in v1.

UX change

Replace the crowded toolbar in BookAuthoringExtension.cs (lines 59–74) with:

Center column stays the chapter editor. Right rail switches content by view (not RenderPreviewHtml only).

flowchart LR
  subgraph left [Left rail]
    SeriesBookChapter
  end
  subgraph center [Center]
    Editor
  end
  subgraph right [Right rail view]
    Preview[Preview HTML]
    Timeline[Mermaid timeline source]
    Relations[Mermaid flowchart source]
    Map[Mermaid places graph source]
  end
  left --> center
  center --> right

Data pipeline (in-app, no books repo dependency)

New folder: src/ManuscriptStudio/Extensions/BookAuthoring/Views/

Reference alignment (design only): Mirror patterns in D:\repos\books\...\references\about\relationships-timelines-and-maps.md — do not read that file at runtime in v1; generated charts come from live chapter metadata scan.

Optional v1.1: Load curated history/timeline.md table as overlay section in timeline builder (parse markdown table dates).

Mermaid generation package

Add to Directory.Packages.props:

<PackageVersion Include="Novolis.Markup.Mermaid" Version="2026.1.*" />

Use Novolis.Markup.Mermaid (Timeline, Flowchart, Node, Link) from GPR — programmatic builders, not string hacks.

MainWindow / extension contract

Extend IManuscriptExtension.cs:

Control CreateRightRail(ManuscriptHostContext host);  // preview OR diagram source
void OnRightRailViewChanged(string viewId);
IReadOnlyList<BookViewDescriptor> GetRightRailViews(); // Book Authoring only; Generic returns Preview only

Update MainWindow.cs:

• Replace fixed _preview HtmlPanel with _rightRailHost Grid.
• Book Authoring: right-rail combo drives CreateRightRail / refresh; Timeline/Relationships/Map show read-only monospace TextBox + Copy / Save .mmd buttons in rail header.
• Preview view keeps HtmlPanel + existing debounced refresh.

Persist last right-rail view in ManuscriptSettings.cs:

"bookAuthoring": { "rightRailView": "timeline", ... }

Export behavior (v1)

No SVG/PNG in v1 (requires mermaid-cli or WebView — follow-up).

Calypso smoke test

After build, Book Authoring → D:\repos\books → Calypso Cycle → calypso:

• Timeline view shows Mermaid with chapter dates from metadata-rich chapters (e.g. 047-marsh-black.md).
• Relationships shows character nodes from [!characters] / [!pov].
• Map shows system/location nodes.
• Export writes .mmd under app data exports/.

Part C — Docs and verify

• Update docs/getting-started.md and src/ManuscriptStudio/README.md — views, export paths, no live diagram preview in v1.
• dotnet build Novolis.Apps.slnx -c Release
• verify-nuget-only.ps1 (PackageReference only; new Novolis.Markup.Mermaid)

Implementation order

1. Git: Clean commit → master → main → create GitHub repo → git push -u origin main → verify default branch.
2. Views data layer: BookMetadataIndex + three Mermaid builders + exporter.
3. UI: Extend extension contract; right-rail view switcher; slim toolbar (Insert menu + exports).
4. Docs + build + Calypso smoke.

Deferred (not in this plan)

• Live Mermaid render (WebView + mermaid.js)
• SVG/PNG export via @mermaid-js/mermaid-cli
• Merging curated reference markdown (relationships-timelines-and-maps.md) into generated charts