novolis-apps repository and HandcraftedMarkdown editor

name: novolis-apps repo overview: "Create a new novolis-apps repository that hosts production Avalonia/desktop applications built exclusively from NuGet packages (no in-repo shared libraries). First app: a generic folder-based markdown editor in src/HandcraftedMarkdown, validated against your Calypso novel tree as the primary dogfood target." todos:

• id: scaffold-repo

content: Create novolis-apps repo scaffold (LICENSE, docs, Directory.Build.props, nuget.config, global.json, Novolis.Apps.slnx) status: completed

• id: ci-workflows

content: Add pull-request.yml and merge.yml (GPR auth + dotnet build) status: completed

• id: handcrafted-markdown-app

content: "Implement src/HandcraftedMarkdown: studio shell, folder tree, editor, Markdig preview, save/open" status: completed

• id: verify-and-dogfood

content: Run verify-nuget-only.ps1, build from GPR-only restore, smoke-test against the-calypso-cycle path status: completed

• id: governance-docs

content: Document dogfooding vs novolis-apps split and studio migration path in docs/design.md + governance note status: completed isProject: false

Context

Ecosystem gaps relevant to this app (exploration summary):

• Strong Avalonia studio chrome in Novolis.Avalonia.Studio (StudioWorkspace)
• Novolis.Markup.Markdown is generation + basic parse, not a full GFM renderer — no markdown editor UI exists
• Your novel files use rich GFM (alerts, HTML comments) — v1 stays generic; Calypso-specific toggles (hide NOTES, booktools-chapter sort) are a follow-up

Repository scaffold

Create novolis-apps from novolis-template-dotnet conventions, adapted for an apps-only repo (like dogfooding, not a package repo).

novolis-apps/
  LICENSE                    # MIT, Copyright (c) 2026 Novolis-Platform
  README.md
  docs/design.md             # nuget-only, no shared/, migration path from dogfooding
  docs/getting-started.md
  docs/release.md
  Directory.Build.props      # net10.0, IsPackable=false, TreatWarningsAsErrors
  Directory.Packages.props   # central versions; Novolis.* at 2026.1.*
  global.json                # SDK 10.0.100+
  nuget.config               # nuget.org + GitHub Packages only (no novolis-local)
  Novolis.Apps.slnx
  .github/workflows/
    pull-request.yml         # restore + build solution
    merge.yml                # same on main
  src/
    HandcraftedMarkdown/     # first app — fully self-contained

Hard rules (stricter than dogfooding):

• Every .csproj under src/ is a complete app (OutputType=WinExe, IsPackable=false)
• No src/shared/, no cross-app ProjectReference
• Cross-repo deps: PackageReference to Novolis.* at 2026.1.* only (nuget-only-policy)
• Run pwsh -File novolis-governance/scripts/verify-nuget-only.ps1 before claiming done

Not in platform slnx — same treatment as novolis-dogfooding (consumer repo, not a library producer).

First app: `HandcraftedMarkdown`

Purpose: Open a folder on disk, browse .md files in a tree, edit raw markdown, preview rendered GFM in a split view. Optimized for prose manuscripts (your Calypso tree at D:\repos\books\content\series\the-calypso-cycle has ~376 markdown files across books/ and references/).

UI layout (reuse Novolis studio patterns)

flowchart LR
  subgraph shell [Novolis.Avalonia.Studio]
    leftRail[FileTree]
    center[Editor + Toolbar]
    rightRail[GFM Preview]
  end
  leftRail --> center
  center --> rightRail

• Chrome: StudioChrome.Create() + StudioWorkspace(leftRail, center, rightRail) — same pattern as NovolisVoiceStudio / MeshBench
• Left rail: TreeView built from System.IO walk (filter *.md; skip common junk like .git)
• Center: toolbar (Open Folder, Save, dirty indicator) + monospace editor
• Right rail: scrollable preview panel
• Hosting: Microsoft.Extensions.Hosting + DI for IFileSystem (MeshBench Program.cs pattern)

Dependencies (v1)

Deferred v1: Novolis.Markup.Markdown (limited parser; preview uses Markdig), Novolis.Workspaces.* (MeshBench-grade persistence — overkill for plain file edit), AvaloniaEdit (nice editor UX — can add in v1.1 if TextBox feels too bare).

Core behaviors (v1 MVP)

1. Open folder — OpenFolderPicker or CLI arg HandcraftedMarkdown.exe "D:\repos\books\content\series\the-calypso-cycle"
2. File tree — recursive .md listing; select file loads content
3. Editor — TextBox (AcceptsReturn, monospace) tracks dirty state; Ctrl+S saves
4. Preview — debounced Markdig pipeline (UseAdvancedExtensions() + GFM) → HTML displayed in preview panel
5. Persistence — remember last opened root in %LocalAppData%/Novolis/HandcraftedMarkdown/settings.json (app-local JSON, not a shared library)
6. Status line — path, word count, save state via StudioFeedback

Preview rendering approach

Markdig produces HTML strings. For v1, use a lightweight Avalonia HTML display option:

• Preferred: Avalonia.HtmlRenderer (MIT) if it restores cleanly on Avalonia 12
• Fallback: WebView control (platform-dependent) or read-only ScrollViewer with basic TextBlock strips (last resort)

Validate preview choice during implementation against Avalonia 12 compatibility; document the chosen renderer in src/HandcraftedMarkdown/README.md.

Calypso validation (manual, not v1 features)

After build, smoke-test against your novel root:

• Open the-calypso-cycle, navigate books/calypso/chapters/047-marsh-black.md
• Confirm editor shows raw content (including <!-- NOTES blocks)
• Confirm preview renders # headers and > [!date] alert blocks reasonably
• Save round-trip does not corrupt encoding (UTF-8)

Calypso-specific features (v2, not v1):

• Toggle hide HTML comments in editor/preview
• Chapter sort by <!-- booktools-chapter: N -->
• Separate roots for books/ vs references/

CI and governance

• Add pull-request.yml + merge.yml: dotnet restore + dotnet build Novolis.Apps.slnx with GITHUB_TOKEN for GPR
• Dogfooding currently has no CI — novolis-apps should have CI because it targets shipped apps
• Update novolis-governance/docs (short addition to repository-policy or a new apps-repos.md): clarify dogfooding vs apps split and migration intent
• Optional: register repo in workspace checkout at d:\novolis\novolis-apps (clone from GitHub after creation)

Studio migration path (document, not execute in v1)

When migrating apps from dogfooding:

Blocker to resolve during migration: NovolisVoiceStudio.csproj references ..\..\shared\Novolis.Dogfooding.Voice — that helper logic must become a published Novolis.* package or live inside the app project before migration.

Sequence: (1) ship novolis-apps + HandcraftedMarkdown, (2) migrate one studio app as proof, (3) deprecate moved apps in dogfooding README.

Implementation order

1. Create GitHub repo Novolis-Platform/novolis-apps (from template or manual scaffold)
2. Wire repo metadata: MIT LICENSE, docs trio, nuget.config, Directory.Build.props, Directory.Packages.props
3. Add Novolis.Apps.slnx with src/HandcraftedMarkdown
4. Implement HandcraftedMarkdown (Program → MainWindow → session service → tree/editor/preview)
5. Add CI workflows
6. verify-nuget-only.ps1, dotnet restore, dotnet build
7. Manual dogfood against Calypso path; document in docs/getting-started.md

Key files to mirror