narrarium-astro-reader 0.1.20 → 0.1.22

package/README.md

@@ -43,6 +43,7 @@ In public mode:
 - secrets stay hidden from the public atlas and nav
 - direct canon pages fall back to teaser or locked views when `known_from` or `reveal_in` say a dossier is not safe yet
 - search, canon popups, and backlinks follow the same thresholds
+- chapter and scene prose should keep canon names as plain text; the reader upgrades visible mentions into canon popups and also rewrites legacy internal canon links at runtime
 
 If you want an author-only or spoiler-friendly deployment, enable full canon mode:
 

package/cli-dist/lib/book.d.ts

@@ -26,6 +26,7 @@ export declare function loadHomePageData(): Promise<{
         path: string;
         metadata: import("narrarium").ChapterFrontmatter;
     }[];
+    draftChapterCount: number;
     characters: {
         slug: string;
         path: string;

package/cli-dist/lib/book.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../../src/lib/book.ts"],"names":[],"mappings":"AAaA,KAAK,gBAAgB,GACjB,WAAW,GACX,UAAU,GACV,SAAS,GACT,MAAM,GACN,QAAQ,GACR,gBAAgB,CAAC;AAErB,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,wBAAsB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CrC;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM;;;;;;;;GAG5D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;GAa/D;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;;;;;GAG5E;AAED,wBAAsB,oBAAoB;;;;;;;;;;;;;GAoBzC"}
+{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../../src/lib/book.ts"],"names":[],"mappings":"AAcA,KAAK,gBAAgB,GACjB,WAAW,GACX,UAAU,GACV,SAAS,GACT,MAAM,GACN,QAAQ,GACR,gBAAgB,CAAC;AAErB,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,wBAAsB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CrC;AAQD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM;;;;;;;;GAG5D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB;;;;;;;;;GAa/D;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;;;;;GAG5E;AAED,wBAAsB,oBAAoB;;;;;;;;;;;;;GAoBzC"}

package/cli-dist/lib/book.js

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { readdir } from "node:fs/promises";
 import { listChapters, listEntities, pathExists, readBook, readChapter, readEntity, readTimelineMain, } from "narrarium";
 import { defaultBookRoot } from "./book-config.js";
 import { readReaderBookRootEnv, resolveReaderBookRootCandidate } from "./env.js";
@@ -18,6 +19,7 @@ export async function loadHomePageData() {
             root,
             book: null,
             chapters: [],
+            draftChapterCount: 0,
             characters: [],
             locations: [],
             factions: [],
@@ -26,9 +28,10 @@ export async function loadHomePageData() {
             timelineEvents: [],
         };
     }
-    const [book, chapters, characters, locations, factions, items, secrets, timelineEvents] = await Promise.all([
+    const [book, chapters, draftChapterCount, characters, locations, factions, items, secrets, timelineEvents] = await Promise.all([
         readBook(root),
         listChapters(root),
+        countDraftChapters(root),
         listEntities(root, "character"),
         listEntities(root, "location"),
         listEntities(root, "faction"),
@@ -41,6 +44,7 @@ export async function loadHomePageData() {
         root,
         book,
         chapters,
+        draftChapterCount,
         characters,
         locations,
         factions,
@@ -49,6 +53,11 @@ export async function loadHomePageData() {
         timelineEvents,
     };
 }
+async function countDraftChapters(root) {
+    const draftsRoot = path.join(root, "drafts");
+    const entries = await readdir(draftsRoot, { withFileTypes: true }).catch(() => []);
+    return entries.filter((entry) => entry.isDirectory()).length;
+}
 export async function loadChapterPageData(chapterSlug) {
     const root = getBookRoot();
     return readChapter(root, chapterSlug);

package/cli-dist/lib/book.js.map

@@ -1 +1 @@
-{"version":3,"file":"book.js","sourceRoot":"","sources":["../../src/lib/book.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"book.js","sourceRoot":"","sources":["../../src/lib/book.ts"],"names":[],"mappings":"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"}

package/cli-dist/lib/canon-mentions.d.ts

@@ -0,0 +1,8 @@
+export type CanonMentionEntry = {
+    id: string;
+    href: string;
+};
+export declare function buildCanonHrefIndex(entries: CanonMentionEntry[]): Map<string, string>;
+export declare function resolveCanonEntryIdFromHref(href: string, entries: CanonMentionEntry[]): string | null;
+export declare function normalizeCanonEntityHref(href: string): string | null;
+//# sourceMappingURL=canon-mentions.d.ts.map

package/cli-dist/lib/canon-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-mentions.d.ts","sourceRoot":"","sources":["../../src/lib/canon-mentions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAarF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAOrG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyCpE"}

package/cli-dist/lib/canon-mentions.js

@@ -0,0 +1,86 @@
+export function buildCanonHrefIndex(entries) {
+    const index = new Map();
+    for (const entry of entries) {
+        const normalizedHref = normalizeCanonEntityHref(entry.href);
+        if (!normalizedHref) {
+            continue;
+        }
+        index.set(normalizedHref, entry.id);
+    }
+    return index;
+}
+export function resolveCanonEntryIdFromHref(href, entries) {
+    const normalizedHref = normalizeCanonEntityHref(href);
+    if (!normalizedHref) {
+        return null;
+    }
+    return buildCanonHrefIndex(entries).get(normalizedHref) ?? null;
+}
+export function normalizeCanonEntityHref(href) {
+    const strippedOrigin = href
+        .trim()
+        .replace(/^[a-z]+:\/\/[^/]+/i, "")
+        .split(/[?#]/, 1)[0]
+        .replace(/\\/g, "/");
+    if (!strippedOrigin) {
+        return null;
+    }
+    const segments = strippedOrigin
+        .split("/")
+        .filter(Boolean)
+        .filter((segment) => segment !== "." && segment !== "..");
+    for (let index = 0; index < segments.length; index += 1) {
+        const current = segments[index]?.toLowerCase();
+        if (!current) {
+            continue;
+        }
+        if (current === "timelines" && segments[index + 1]?.toLowerCase() === "events") {
+            const slug = normalizeSlugSegment(segments[index + 2]);
+            if (slug) {
+                return `timeline/${slug}/`;
+            }
+            continue;
+        }
+        const section = normalizeCanonSection(current);
+        if (!section) {
+            continue;
+        }
+        const slug = normalizeSlugSegment(segments[index + 1]);
+        if (slug) {
+            return `${section}/${slug}/`;
+        }
+    }
+    return null;
+}
+function normalizeCanonSection(segment) {
+    switch (segment.toLowerCase()) {
+        case "character":
+        case "characters":
+            return "characters";
+        case "location":
+        case "locations":
+            return "locations";
+        case "faction":
+        case "factions":
+            return "factions";
+        case "item":
+        case "items":
+            return "items";
+        case "secret":
+        case "secrets":
+            return "secrets";
+        case "timeline":
+        case "timeline-event":
+            return "timeline";
+        default:
+            return null;
+    }
+}
+function normalizeSlugSegment(segment) {
+    if (!segment) {
+        return null;
+    }
+    const normalized = segment.replace(/\.md$/i, "").trim().toLowerCase();
+    return /^[a-z0-9-]+$/.test(normalized) ? normalized : null;
+}
+//# sourceMappingURL=canon-mentions.js.map

package/cli-dist/lib/canon-mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-mentions.js","sourceRoot":"","sources":["../../src/lib/canon-mentions.ts"],"names":[],"mappings":"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"}

package/cli-dist/lib/workshop.d.ts

@@ -0,0 +1,49 @@
+export type WorkshopEntry = {
+    id: string;
+    title: string;
+    body: string;
+    status: string;
+    tags: string[];
+    sourceKind?: string;
+    promotedTo?: string;
+};
+export type WorkshopDocument = {
+    path: string;
+    title: string;
+    bucket: string;
+    bodyHtml: string;
+    entries: WorkshopEntry[];
+};
+export type WorkshopDraftChapter = {
+    slug: string;
+    title: string;
+    summary: string;
+    bodyHtml: string;
+    paragraphs: Array<{
+        slug: string;
+        title: string;
+        summary: string;
+    }>;
+    ideas: WorkshopDocument | null;
+    notes: WorkshopDocument | null;
+    promoted: WorkshopDocument | null;
+};
+export declare function loadWorkshopPageData(): Promise<{
+    ready: boolean;
+    root: string;
+    global: null;
+    draftChapters: never[];
+} | {
+    ready: boolean;
+    root: string;
+    global: {
+        context: WorkshopDocument | null;
+        ideas: WorkshopDocument | null;
+        notes: WorkshopDocument | null;
+        storyDesign: WorkshopDocument | null;
+        promoted: WorkshopDocument | null;
+    };
+    draftChapters: WorkshopDraftChapter[];
+}>;
+export declare function countDraftChapters(root: string): Promise<number>;
+//# sourceMappingURL=workshop.d.ts.map

package/cli-dist/lib/workshop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workshop.d.ts","sourceRoot":"","sources":["../../src/lib/workshop.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,wBAAsB,oBAAoB;;;;;;;;;;;;;;;;GAkCzC;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE"}

package/cli-dist/lib/workshop.js

@@ -0,0 +1,113 @@
+import path from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { marked } from "marked";
+import { parseNarrariumMarkdownDocument, pathExists, readChapterDraft } from "narrarium";
+import { getBookRoot } from "./book.js";
+export async function loadWorkshopPageData() {
+    const root = getBookRoot();
+    const ready = await pathExists(path.join(root, "book.md"));
+    if (!ready) {
+        return {
+            ready: false,
+            root,
+            global: null,
+            draftChapters: [],
+        };
+    }
+    const [context, ideas, notes, storyDesign, promoted, draftChapters] = await Promise.all([
+        readWorkshopDocument(root, "context.md"),
+        readWorkshopDocument(root, "ideas.md"),
+        readWorkshopDocument(root, "notes.md"),
+        readWorkshopDocument(root, "story-design.md"),
+        readWorkshopDocument(root, "promoted.md"),
+        listDraftChapters(root),
+    ]);
+    return {
+        ready: true,
+        root,
+        global: {
+            context,
+            ideas,
+            notes,
+            storyDesign,
+            promoted,
+        },
+        draftChapters,
+    };
+}
+export async function countDraftChapters(root) {
+    return (await listDraftChapters(root)).length;
+}
+async function listDraftChapters(root) {
+    const draftsRoot = path.join(root, "drafts");
+    const entries = await readdir(draftsRoot, { withFileTypes: true }).catch(() => []);
+    const slugs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+    const chapters = await Promise.all(slugs.map(async (slug) => {
+        const chapterFile = path.join(draftsRoot, slug, "chapter.md");
+        if (!(await pathExists(chapterFile))) {
+            return null;
+        }
+        const chapter = await readChapterDraft(root, slug);
+        const [ideas, notes, promoted] = await Promise.all([
+            readWorkshopDocument(root, path.posix.join("drafts", slug, "ideas.md")),
+            readWorkshopDocument(root, path.posix.join("drafts", slug, "notes.md")),
+            readWorkshopDocument(root, path.posix.join("drafts", slug, "promoted.md")),
+        ]);
+        return {
+            slug,
+            title: chapter.metadata.title,
+            summary: chapter.metadata.summary ?? "Draft chapter in progress.",
+            bodyHtml: await toHtml(chapter.body || "No chapter draft body yet."),
+            paragraphs: chapter.paragraphs.map((paragraph) => ({
+                slug: path.basename(paragraph.path, ".md"),
+                title: paragraph.metadata.title,
+                summary: paragraph.metadata.summary ?? "Draft scene.",
+            })),
+            ideas,
+            notes,
+            promoted,
+        };
+    }));
+    return chapters.filter((chapter) => Boolean(chapter));
+}
+async function readWorkshopDocument(root, relativePath) {
+    const absolutePath = path.join(root, relativePath);
+    const raw = await readFile(absolutePath, "utf8").catch(() => null);
+    if (!raw) {
+        return null;
+    }
+    const document = parseNarrariumMarkdownDocument(relativePath, raw);
+    const frontmatter = document.frontmatter;
+    const title = typeof frontmatter.title === "string" && frontmatter.title.trim() ? frontmatter.title : relativePath;
+    const bucket = typeof frontmatter.bucket === "string" ? frontmatter.bucket : document.kind;
+    return {
+        path: relativePath,
+        title,
+        bucket,
+        bodyHtml: await toHtml(document.body || "No content yet."),
+        entries: readWorkshopEntries(frontmatter),
+    };
+}
+function readWorkshopEntries(frontmatter) {
+    if (!Array.isArray(frontmatter.entries)) {
+        return [];
+    }
+    return frontmatter.entries
+        .filter((entry) => Boolean(entry && typeof entry === "object"))
+        .map((entry) => ({
+        id: typeof entry.id === "string" ? entry.id : "",
+        title: typeof entry.title === "string" ? entry.title : "Untitled",
+        body: typeof entry.body === "string" ? entry.body : "",
+        status: typeof entry.status === "string" ? entry.status : "active",
+        tags: Array.isArray(entry.tags) ? entry.tags.filter((tag) => typeof tag === "string") : [],
+        sourceKind: typeof entry.source_kind === "string" ? entry.source_kind : undefined,
+        promotedTo: typeof entry.promoted_to === "string" ? entry.promoted_to : undefined,
+    }))
+        .filter((entry) => entry.id.length > 0)
+        .sort((left, right) => left.title.localeCompare(right.title));
+}
+async function toHtml(markdown) {
+    const rendered = await marked.parse(markdown);
+    return typeof rendered === "string" ? rendered : String(rendered);
+}
+//# sourceMappingURL=workshop.js.map

package/cli-dist/lib/workshop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workshop.js","sourceRoot":"","sources":["../../src/lib/workshop.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,8BAA8B,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA+BxC,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,IAAI;YACJ,MAAM,EAAE,IAAI;YACZ,aAAa,EAAE,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtF,oBAAoB,CAAC,IAAI,EAAE,YAAY,CAAC;QACxC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC;QACtC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC;QACtC,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,CAAC;QAC7C,oBAAoB,CAAC,IAAI,EAAE,aAAa,CAAC;QACzC,iBAAiB,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI;QACJ,MAAM,EAAE;YACN,OAAO;YACP,KAAK;YACL,KAAK;YACL,WAAW;YACX,QAAQ;SACT;QACD,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,OAAO,CAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/F,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACvE,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACvE,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;SAC3E,CAAC,CAAC;QAEH,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;YAC7B,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,4BAA4B;YACjE,QAAQ,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,4BAA4B,CAAC;YACpE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC1C,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK;gBAC/B,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,cAAc;aACtD,CAAC,CAAC;YACH,KAAK;YACL,KAAK;YACL,QAAQ;SACsB,CAAC;IACnC,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAmC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,YAAoB;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,8BAA8B,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAsC,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;IACnH,MAAM,MAAM,GAAG,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAE3F,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,iBAAiB,CAAC;QAC1D,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAoC;IAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,OAAO;SACvB,MAAM,CAAC,CAAC,KAAK,EAAoC,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;SAChG,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAChD,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;QACjE,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACtD,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QAClE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACzG,UAAU,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QACjF,UAAU,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAClF,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "narrarium-astro-reader",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "type": "module",
   "description": "Astro reader and scaffolding CLI for Narrarium book repositories.",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "test": "npm run build:cli && node --test test/**/*.test.mjs"
   },
   "dependencies": {
-    "narrarium": "^0.1.20",
+    "narrarium": "^0.1.22",
     "astro": "^5.14.1",
     "chokidar": "^4.0.3",
     "marked": "^16.3.0"

package/src/components/ReaderRuntime.astro

@@ -144,7 +144,9 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
 <script type="application/json" id="canon-glossary-data" set:html={glossaryJson}></script>
 <script type="application/json" id="reader-chapter-data" set:html={chaptersJson}></script>
 
-<script is:inline>
+<script>
+  import { buildCanonHrefIndex, normalizeCanonEntityHref } from "../lib/canon-mentions.js";
+
   const themeStorageKey = "narrarium-reader-theme";
   const canonModeStorageKey = "narrarium-reader-canon";
   const progressStorageKey = "narrarium-reader-progress";
@@ -354,6 +356,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     const limit = getSelectedSpoilerLimit();
     const visibleEntries = glossaryEntries.filter((entry) => isEntryVisible(entry, limit));
     const glossaryById = new Map(visibleEntries.map((entry) => [entry.id, entry]));
+    const hrefIndex = buildCanonHrefIndex(visibleEntries);
     const termMap = new Map();
 
     for (const entry of visibleEntries) {
@@ -368,15 +371,15 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     }
 
     const terms = [...termMap.keys()].sort((left, right) => right.length - left.length);
-    if (terms.length === 0) return;
-
-    const pattern = new RegExp(`(^|[^\\p{L}\\p{N}])(${terms.map(escapeRegex).join("|")})(?=$|[^\\p{L}\\p{N}])`, "giu");
+    const pattern = terms.length > 0
+      ? new RegExp(`(^|[^\\p{L}\\p{N}])(${terms.map(escapeRegex).join("|")})(?=$|[^\\p{L}\\p{N}])`, "giu")
+      : null;
 
-    enhanceCanonRoot(document, pattern, termMap);
-    initializeCanonOverlay(pattern, termMap, glossaryById, limit);
+    enhanceCanonRoot(document, pattern, termMap, hrefIndex);
+    initializeCanonOverlay(pattern, termMap, hrefIndex, glossaryById, limit);
   }
 
-  function enhanceCanonRoot(root, pattern, termMap) {
+  function enhanceCanonRoot(root, pattern, termMap, hrefIndex) {
     const containers = root instanceof Document
       ? root.querySelectorAll(".prose p, .prose li, .prose blockquote")
       : root.matches?.(".prose")
@@ -385,7 +388,11 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
 
     containers.forEach((container) => {
       if (container.dataset.canonEnhanced === "true") return;
+      rewriteLegacyCanonLinks(container, hrefIndex);
       container.dataset.canonEnhanced = "true";
+      if (!pattern) {
+        return;
+      }
       const walker = document.createTreeWalker(container, NodeFilter.SHOW_TEXT);
       const textNodes = [];
       while (walker.nextNode()) {
@@ -430,12 +437,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
       }
 
       if (entryId) {
-        const button = document.createElement("button");
-        button.type = "button";
-        button.className = "canon-mention";
-        button.dataset.canonId = entryId;
-        button.textContent = term;
-        fragment.append(button);
+        fragment.append(createCanonMentionButton(entryId, term));
       } else {
         fragment.append(term);
       }
@@ -450,7 +452,33 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     textNode.replaceWith(fragment);
   }
 
-  function initializeCanonOverlay(pattern, termMap, glossaryById, limit) {
+  function rewriteLegacyCanonLinks(container, hrefIndex) {
+    container.querySelectorAll("a[href]").forEach((anchor) => {
+      if (!(anchor instanceof HTMLAnchorElement) || anchor.closest("[data-no-canon]")) {
+        return;
+      }
+
+      const normalizedHref = normalizeCanonEntityHref(anchor.getAttribute("href") || "");
+      if (!normalizedHref) {
+        return;
+      }
+
+      const label = anchor.textContent || "";
+      const entryId = hrefIndex.get(normalizedHref);
+      anchor.replaceWith(entryId ? createCanonMentionButton(entryId, label) : document.createTextNode(label));
+    });
+  }
+
+  function createCanonMentionButton(entryId, label) {
+    const button = document.createElement("button");
+    button.type = "button";
+    button.className = "canon-mention";
+    button.dataset.canonId = entryId;
+    button.textContent = label;
+    return button;
+  }
+
+  function initializeCanonOverlay(pattern, termMap, hrefIndex, glossaryById, limit) {
     const overlay = document.querySelector("[data-canon-overlay]");
     if (!overlay || overlay.dataset.bound === "true") return;
     overlay.dataset.bound = "true";
@@ -482,7 +510,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
         link.href = entry.href;
         link.hidden = !revealed;
         body.innerHTML = revealed ? entry.bodyHtml || "" : "";
-        enhanceCanonRoot(body, pattern, termMap);
+        enhanceCanonRoot(body, pattern, termMap, hrefIndex);
         metadata.replaceChildren(...(entry.metadataEntries || []).map((item) => {
           const row = document.createElement("div");
           row.className = "meta-row";

package/src/layouts/BaseLayout.astro

@@ -14,6 +14,7 @@ interface Props {
   activeSection?:
     | "home"
     | "chapters"
+    | "workshop"
     | "characters"
     | "locations"
     | "factions"
@@ -75,6 +76,7 @@ const isChapterPage = Number.isFinite(currentChapterNumber);
         <nav class="site-nav">
           <a class:list={["nav-link", activeSection === "home" && "is-active"]} href="./">Book</a>
           <a class:list={["nav-link", activeSection === "chapters" && "is-active"]} href="./#chapters">Chapters</a>
+          {fullCanonMode && <a class:list={["nav-link", activeSection === "workshop" && "is-active"]} href="workshop/">Workshop</a>}
           <a class:list={["nav-link", activeSection === "characters" && "is-active"]} href="characters/">Characters</a>
           <a class:list={["nav-link", activeSection === "locations" && "is-active"]} href="locations/">Locations</a>
           <a class:list={["nav-link", activeSection === "factions" && "is-active"]} href="factions/">Factions</a>

package/src/lib/book.ts

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { readdir } from "node:fs/promises";
 import {
   listChapters,
   listEntities,
@@ -36,6 +37,7 @@ export async function loadHomePageData() {
       root,
       book: null,
       chapters: [],
+      draftChapterCount: 0,
       characters: [],
       locations: [],
       factions: [],
@@ -45,9 +47,10 @@ export async function loadHomePageData() {
     };
   }
 
-  const [book, chapters, characters, locations, factions, items, secrets, timelineEvents] = await Promise.all([
+  const [book, chapters, draftChapterCount, characters, locations, factions, items, secrets, timelineEvents] = await Promise.all([
     readBook(root),
     listChapters(root),
+    countDraftChapters(root),
     listEntities(root, "character"),
     listEntities(root, "location"),
     listEntities(root, "faction"),
@@ -61,6 +64,7 @@ export async function loadHomePageData() {
     root,
     book,
     chapters,
+    draftChapterCount,
     characters,
     locations,
     factions,
@@ -70,6 +74,12 @@ export async function loadHomePageData() {
   };
 }
 
+async function countDraftChapters(root: string): Promise<number> {
+  const draftsRoot = path.join(root, "drafts");
+  const entries = await readdir(draftsRoot, { withFileTypes: true }).catch(() => []);
+  return entries.filter((entry) => entry.isDirectory()).length;
+}
+
 export async function loadChapterPageData(chapterSlug: string) {
   const root = getBookRoot();
   return readChapter(root, chapterSlug);

package/src/lib/canon-mentions.ts

@@ -0,0 +1,105 @@
+export type CanonMentionEntry = {
+  id: string;
+  href: string;
+};
+
+export function buildCanonHrefIndex(entries: CanonMentionEntry[]): Map<string, string> {
+  const index = new Map<string, string>();
+
+  for (const entry of entries) {
+    const normalizedHref = normalizeCanonEntityHref(entry.href);
+    if (!normalizedHref) {
+      continue;
+    }
+
+    index.set(normalizedHref, entry.id);
+  }
+
+  return index;
+}
+
+export function resolveCanonEntryIdFromHref(href: string, entries: CanonMentionEntry[]): string | null {
+  const normalizedHref = normalizeCanonEntityHref(href);
+  if (!normalizedHref) {
+    return null;
+  }
+
+  return buildCanonHrefIndex(entries).get(normalizedHref) ?? null;
+}
+
+export function normalizeCanonEntityHref(href: string): string | null {
+  const strippedOrigin = href
+    .trim()
+    .replace(/^[a-z]+:\/\/[^/]+/i, "")
+    .split(/[?#]/, 1)[0]
+    .replace(/\\/g, "/");
+  if (!strippedOrigin) {
+    return null;
+  }
+
+  const segments = strippedOrigin
+    .split("/")
+    .filter(Boolean)
+    .filter((segment) => segment !== "." && segment !== "..");
+
+  for (let index = 0; index < segments.length; index += 1) {
+    const current = segments[index]?.toLowerCase();
+    if (!current) {
+      continue;
+    }
+
+    if (current === "timelines" && segments[index + 1]?.toLowerCase() === "events") {
+      const slug = normalizeSlugSegment(segments[index + 2]);
+      if (slug) {
+        return `timeline/${slug}/`;
+      }
+      continue;
+    }
+
+    const section = normalizeCanonSection(current);
+    if (!section) {
+      continue;
+    }
+
+    const slug = normalizeSlugSegment(segments[index + 1]);
+    if (slug) {
+      return `${section}/${slug}/`;
+    }
+  }
+
+  return null;
+}
+
+function normalizeCanonSection(segment: string): string | null {
+  switch (segment.toLowerCase()) {
+    case "character":
+    case "characters":
+      return "characters";
+    case "location":
+    case "locations":
+      return "locations";
+    case "faction":
+    case "factions":
+      return "factions";
+    case "item":
+    case "items":
+      return "items";
+    case "secret":
+    case "secrets":
+      return "secrets";
+    case "timeline":
+    case "timeline-event":
+      return "timeline";
+    default:
+      return null;
+  }
+}
+
+function normalizeSlugSegment(segment: string | undefined): string | null {
+  if (!segment) {
+    return null;
+  }
+
+  const normalized = segment.replace(/\.md$/i, "").trim().toLowerCase();
+  return /^[a-z0-9-]+$/.test(normalized) ? normalized : null;
+}

package/src/lib/workshop.ts

@@ -0,0 +1,159 @@
+import path from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { marked } from "marked";
+import { parseNarrariumMarkdownDocument, pathExists, readChapterDraft } from "narrarium";
+import { getBookRoot } from "./book.js";
+
+export type WorkshopEntry = {
+  id: string;
+  title: string;
+  body: string;
+  status: string;
+  tags: string[];
+  sourceKind?: string;
+  promotedTo?: string;
+};
+
+export type WorkshopDocument = {
+  path: string;
+  title: string;
+  bucket: string;
+  bodyHtml: string;
+  entries: WorkshopEntry[];
+};
+
+export type WorkshopDraftChapter = {
+  slug: string;
+  title: string;
+  summary: string;
+  bodyHtml: string;
+  paragraphs: Array<{ slug: string; title: string; summary: string }>;
+  ideas: WorkshopDocument | null;
+  notes: WorkshopDocument | null;
+  promoted: WorkshopDocument | null;
+};
+
+export async function loadWorkshopPageData() {
+  const root = getBookRoot();
+  const ready = await pathExists(path.join(root, "book.md"));
+
+  if (!ready) {
+    return {
+      ready: false,
+      root,
+      global: null,
+      draftChapters: [],
+    };
+  }
+
+  const [context, ideas, notes, storyDesign, promoted, draftChapters] = await Promise.all([
+    readWorkshopDocument(root, "context.md"),
+    readWorkshopDocument(root, "ideas.md"),
+    readWorkshopDocument(root, "notes.md"),
+    readWorkshopDocument(root, "story-design.md"),
+    readWorkshopDocument(root, "promoted.md"),
+    listDraftChapters(root),
+  ]);
+
+  return {
+    ready: true,
+    root,
+    global: {
+      context,
+      ideas,
+      notes,
+      storyDesign,
+      promoted,
+    },
+    draftChapters,
+  };
+}
+
+export async function countDraftChapters(root: string): Promise<number> {
+  return (await listDraftChapters(root)).length;
+}
+
+async function listDraftChapters(root: string): Promise<WorkshopDraftChapter[]> {
+  const draftsRoot = path.join(root, "drafts");
+  const entries = await readdir(draftsRoot, { withFileTypes: true }).catch(() => []);
+  const slugs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+
+  const chapters = await Promise.all(
+    slugs.map(async (slug) => {
+      const chapterFile = path.join(draftsRoot, slug, "chapter.md");
+      if (!(await pathExists(chapterFile))) {
+        return null;
+      }
+
+      const chapter = await readChapterDraft(root, slug);
+      const [ideas, notes, promoted] = await Promise.all([
+        readWorkshopDocument(root, path.posix.join("drafts", slug, "ideas.md")),
+        readWorkshopDocument(root, path.posix.join("drafts", slug, "notes.md")),
+        readWorkshopDocument(root, path.posix.join("drafts", slug, "promoted.md")),
+      ]);
+
+      return {
+        slug,
+        title: chapter.metadata.title,
+        summary: chapter.metadata.summary ?? "Draft chapter in progress.",
+        bodyHtml: await toHtml(chapter.body || "No chapter draft body yet."),
+        paragraphs: chapter.paragraphs.map((paragraph) => ({
+          slug: path.basename(paragraph.path, ".md"),
+          title: paragraph.metadata.title,
+          summary: paragraph.metadata.summary ?? "Draft scene.",
+        })),
+        ideas,
+        notes,
+        promoted,
+      } satisfies WorkshopDraftChapter;
+    }),
+  );
+
+  return chapters.filter((chapter): chapter is WorkshopDraftChapter => Boolean(chapter));
+}
+
+async function readWorkshopDocument(root: string, relativePath: string): Promise<WorkshopDocument | null> {
+  const absolutePath = path.join(root, relativePath);
+  const raw = await readFile(absolutePath, "utf8").catch(() => null);
+  if (!raw) {
+    return null;
+  }
+
+  const document = parseNarrariumMarkdownDocument(relativePath, raw);
+  const frontmatter = document.frontmatter as Record<string, unknown>;
+  const title = typeof frontmatter.title === "string" && frontmatter.title.trim() ? frontmatter.title : relativePath;
+  const bucket = typeof frontmatter.bucket === "string" ? frontmatter.bucket : document.kind;
+
+  return {
+    path: relativePath,
+    title,
+    bucket,
+    bodyHtml: await toHtml(document.body || "No content yet."),
+    entries: readWorkshopEntries(frontmatter),
+  };
+}
+
+function readWorkshopEntries(frontmatter: Record<string, unknown>): WorkshopEntry[] {
+  if (!Array.isArray(frontmatter.entries)) {
+    return [];
+  }
+
+  return frontmatter.entries
+    .filter((entry): entry is Record<string, unknown> => Boolean(entry && typeof entry === "object"))
+    .map((entry) => ({
+      id: typeof entry.id === "string" ? entry.id : "",
+      title: typeof entry.title === "string" ? entry.title : "Untitled",
+      body: typeof entry.body === "string" ? entry.body : "",
+      status: typeof entry.status === "string" ? entry.status : "active",
+      tags: Array.isArray(entry.tags) ? entry.tags.filter((tag): tag is string => typeof tag === "string") : [],
+      sourceKind: typeof entry.source_kind === "string" ? entry.source_kind : undefined,
+      promotedTo: typeof entry.promoted_to === "string" ? entry.promoted_to : undefined,
+    }))
+    .filter((entry) => entry.id.length > 0)
+    .sort((left, right) => left.title.localeCompare(right.title));
+}
+
+async function toHtml(markdown: string): Promise<string> {
+  const rendered = await marked.parse(markdown);
+  return typeof rendered === "string" ? rendered : String(rendered);
+}

package/src/pages/index.astro

@@ -6,7 +6,7 @@ import { loadAssetFigure } from "../lib/assets";
 import { countPublicCanonEntries } from "../lib/public-canon";
 import { isFullCanonMode } from "../lib/reader-mode";
 
-const { ready, root, book, chapters, characters, locations, factions, items, secrets, timelineEvents } = await loadHomePageData();
+const { ready, root, book, chapters, draftChapterCount, characters, locations, factions, items, secrets, timelineEvents } = await loadHomePageData();
 const title = book?.frontmatter.title ?? "Narrarium Reader";
 const coverFigure = await loadAssetFigure("book", `${title} cover`);
 const fullCanonMode = isFullCanonMode();
@@ -129,6 +129,16 @@ const chapterCards = await Promise.all(
               <div class="chip-row"><span class="chip">{visibleTimelineCount} visible</span></div>
             </a>
           </article>
+          {fullCanonMode && (
+            <article class="catalog-card">
+              <a href="workshop/">
+                <span class="browse-card-icon">🧭</span>
+                <h3 class="chapter-title">Workshop</h3>
+                <div class="chapter-meta">Inspect drafts, ideas, notes, story design, and promoted items.</div>
+                <div class="chip-row"><span class="chip">{draftChapterCount} draft chapters</span></div>
+              </a>
+            </article>
+          )}
         </div>
       </section>
 

package/src/pages/workshop/index.astro

@@ -0,0 +1,138 @@
+---
+import BaseLayout from "../../layouts/BaseLayout.astro";
+import { isFullCanonMode } from "../../lib/reader-mode";
+import { loadWorkshopPageData } from "../../lib/workshop";
+
+const fullCanonMode = isFullCanonMode();
+const { ready, global, draftChapters } = await loadWorkshopPageData();
+
+const globalDocuments = global
+  ? [
+      { label: "Context", document: global.context },
+      { label: "Story Design", document: global.storyDesign },
+      { label: "Ideas", document: global.ideas },
+      { label: "Notes", document: global.notes },
+      { label: "Promoted", document: global.promoted },
+    ]
+  : [];
+---
+
+<BaseLayout title="Workshop" description="Inspect drafts, ideas, notes, and story design." activeSection="workshop">
+  <section class="hero">
+    <p class="eyebrow">Workshop</p>
+    <h1>Drafts, Ideas, and Notes</h1>
+    <p class="lede">
+      {fullCanonMode
+        ? "Review global planning material, draft chapters, and promoted work items from one author-facing workspace."
+        : "Workshop content is available only in full canon mode."}
+    </p>
+  </section>
+
+  {!ready ? (
+    <div class="empty">No Narrarium book repository is connected yet.</div>
+  ) : !fullCanonMode ? (
+    <div class="empty">Switch the reader to full canon mode to inspect workshop material such as drafts, ideas, notes, and story design.</div>
+  ) : (
+    <>
+      <section class="section">
+        <h2>Global Workspace</h2>
+        <div class="chapter-list">
+          {globalDocuments.map(({ label, document }) => (
+            <article class="chapter-card workspace-card">
+              <div class="chapter-number">{label}</div>
+              <h3 class="chapter-title">{document?.title ?? `${label} unavailable`}</h3>
+              <div class="chapter-meta">{document ? document.path : "File not present in this book yet."}</div>
+              {document ? (
+                <>
+                  <div class="chip-row"><span class="chip">{document.entries.length} entries</span></div>
+                  <div class="prose" set:html={document.bodyHtml}></div>
+                  {document.entries.length > 0 && (
+                    <div class="workspace-entry-list">
+                      {document.entries.map((entry) => (
+                        <article class="workspace-entry">
+                          <div class="chip-row">
+                            <span class="chip">{entry.status}</span>
+                            {entry.tags.map((tag) => (
+                              <span class="chip">{tag}</span>
+                            ))}
+                            {entry.promotedTo && <span class="chip">to {entry.promotedTo}</span>}
+                          </div>
+                          <h4>{entry.title}</h4>
+                          <p>{entry.body || "No details yet."}</p>
+                        </article>
+                      ))}
+                    </div>
+                  )}
+                </>
+              ) : null}
+            </article>
+          ))}
+        </div>
+      </section>
+
+      <section class="section">
+        <h2>Draft Chapters</h2>
+        {draftChapters.length > 0 ? (
+          <div class="chapter-list">
+            {draftChapters.map((chapter) => (
+              <article class="chapter-card workspace-card">
+                <div class="chapter-number">Draft</div>
+                <h3 class="chapter-title">{chapter.title}</h3>
+                <div class="chapter-meta">{chapter.summary}</div>
+                <div class="chip-row">
+                  <span class="chip">{chapter.paragraphs.length} scenes</span>
+                  <span class="chip">{chapter.ideas?.entries.length ?? 0} ideas</span>
+                  <span class="chip">{chapter.notes?.entries.length ?? 0} notes</span>
+                  <span class="chip">{chapter.promoted?.entries.length ?? 0} promoted</span>
+                </div>
+                <div class="prose" set:html={chapter.bodyHtml}></div>
+                {chapter.paragraphs.length > 0 && (
+                  <div class="workspace-subsection">
+                    <h4>Draft Scenes</h4>
+                    <div class="workspace-entry-list">
+                      {chapter.paragraphs.map((paragraph) => (
+                        <article class="workspace-entry">
+                          <h5>{paragraph.title}</h5>
+                          <p>{paragraph.summary}</p>
+                        </article>
+                      ))}
+                    </div>
+                  </div>
+                )}
+
+                {[chapter.ideas, chapter.notes, chapter.promoted].map(
+                  (document, index) =>
+                    document && (
+                      <div class="workspace-subsection">
+                        <h4>{index === 0 ? "Ideas" : index === 1 ? "Notes" : "Promoted"}</h4>
+                        <div class="prose" set:html={document.bodyHtml}></div>
+                        {document.entries.length > 0 && (
+                          <div class="workspace-entry-list">
+                            {document.entries.map((entry) => (
+                              <article class="workspace-entry">
+                                <div class="chip-row">
+                                  <span class="chip">{entry.status}</span>
+                                  {entry.tags.map((tag) => (
+                                    <span class="chip">{tag}</span>
+                                  ))}
+                                  {entry.promotedTo && <span class="chip">to {entry.promotedTo}</span>}
+                                </div>
+                                <h5>{entry.title}</h5>
+                                <p>{entry.body || "No details yet."}</p>
+                              </article>
+                            ))}
+                          </div>
+                        )}
+                      </div>
+                    ),
+                )}
+              </article>
+            ))}
+          </div>
+        ) : (
+          <div class="empty">No chapter drafts exist yet.</div>
+        )}
+      </section>
+    </>
+  )}
+</BaseLayout>

package/src/styles/global.css

@@ -248,6 +248,42 @@ body.tts-enabled .shell {
   flex-wrap: wrap;
 }
 
+.workspace-card {
+  width: 100%;
+}
+
+.workspace-entry-list {
+  display: grid;
+  gap: 0.85rem;
+  margin-top: 1rem;
+}
+
+.workspace-entry {
+  padding: 1rem 1.1rem;
+  border: 1px solid var(--line);
+  border-radius: 14px;
+  background: var(--surface-muted);
+}
+
+.workspace-entry h4,
+.workspace-entry h5 {
+  margin: 0.35rem 0 0.45rem;
+  font-size: 1rem;
+}
+
+.workspace-entry p {
+  margin: 0;
+  color: var(--text-muted);
+}
+
+.workspace-subsection {
+  margin-top: 1.4rem;
+}
+
+.workspace-subsection h4 {
+  margin: 0 0 0.75rem;
+}
+
 /* ─── Icon buttons (masthead controls) ──────────────────────── */
 .masthead-btn {
   display: inline-flex;