stego-cli 0.3.3 → 0.4.0

package/projects/stego-docs/spine/integrations/INT-PANDOC.md

@@ -0,0 +1,9 @@
+---
+label: Pandoc is used for optional export formats such as docx, pdf, and epub.
+---
+
+# Pandoc is used for optional export formats such as docx, pdf, and epub.
+
+- Pandoc is used for optional export formats such as docx, pdf, and epub.
+- Related commands: CMD-EXPORT.
+- Related workflows: FLOW-BUILD-EXPORT.

package/projects/stego-docs/spine/integrations/INT-SAURUS-EXTENSION.md

@@ -0,0 +1,9 @@
+---
+label: The Saurus extension complements prose editing and research workflows in project folders.
+---
+
+# The Saurus extension complements prose editing and research workflows in project folders.
+
+- The Saurus extension complements prose editing and research workflows in project folders.
+- Related integrations: INT-VSCODE.
+- Related workflows: FLOW-DAILY-WRITING.

package/projects/stego-docs/spine/integrations/INT-STEGO-EXTENSION.md

@@ -0,0 +1,9 @@
+---
+label: The Stego VS Code extension is the official UI for Stego projects, including status controls, checks, and Spine Browser navigation.
+---
+
+# The Stego VS Code extension is the official UI for Stego projects, including status controls, checks, and Spine Browser navigation.
+
+- The Stego VS Code extension is the official UI for Stego projects, including status controls, checks, and Spine Browser navigation.
+- Related concepts: CON-SPINE, CON-STAGE-GATE.
+- Related workflows: FLOW-DAILY-WRITING, FLOW-STAGE-PROMOTION.

package/projects/stego-docs/spine/integrations/INT-VSCODE.md

@@ -0,0 +1,9 @@
+---
+label: VS Code is the primary editor environment for Stego projects.
+---
+
+# VS Code is the primary editor environment for Stego projects.
+
+- VS Code is the primary editor environment for Stego projects.
+- Related workflows: FLOW-INIT-WORKSPACE, FLOW-DAILY-WRITING.
+- Related commands: CMD-INIT.

package/projects/stego-docs/spine/integrations/_category.md

@@ -0,0 +1,6 @@
+---
+label: Integrations
+---
+
+# Integrations
+

package/projects/stego-docs/spine/workflows/FLOW-BUILD-EXPORT.md

@@ -0,0 +1,10 @@
+---
+label: Build a compiled markdown manuscript and export distribution formats.
+---
+
+# Build a compiled markdown manuscript and export distribution formats.
+
+- Build a compiled markdown manuscript and export distribution formats.
+- Related commands: CMD-BUILD, CMD-EXPORT.
+- Related concepts: CON-DIST, CON-COMPILE-STRUCTURE.
+- Related integrations: INT-PANDOC.

package/projects/stego-docs/spine/workflows/FLOW-DAILY-WRITING.md

@@ -0,0 +1,10 @@
+---
+label: Open one project, write in manuscript files, validate, build, and commit progress.
+---
+
+# Open one project, write in manuscript files, validate, build, and commit progress.
+
+- Open one project, write in manuscript files, validate, build, and commit progress.
+- Related commands: CMD-VALIDATE, CMD-BUILD.
+- Related concepts: CON-MANUSCRIPT, CON-METADATA, CON-DIST.
+- Related integrations: INT-VSCODE.

package/projects/stego-docs/spine/workflows/FLOW-INIT-WORKSPACE.md

@@ -0,0 +1,9 @@
+---
+label: Install the CLI, initialize a workspace, install local dev tools, and inspect scaffolded projects.
+---
+
+# Install the CLI, initialize a workspace, install local dev tools, and inspect scaffolded projects.
+
+- Install the CLI, initialize a workspace, install local dev tools, and inspect scaffolded projects.
+- Related commands: CMD-INIT, CMD-LIST-PROJECTS.
+- Related concepts: CON-WORKSPACE, CON-PROJECT.

package/projects/stego-docs/spine/workflows/FLOW-NEW-PROJECT.md

@@ -0,0 +1,10 @@
+---
+label: Create a new project, review generated folders, and configure project metadata rules.
+---
+
+# Create a new project, review generated folders, and configure project metadata rules.
+
+- Create a new project, review generated folders, and configure project metadata rules.
+- Related commands: CMD-NEW-PROJECT, CMD-VALIDATE.
+- Related concepts: CON-PROJECT, CON-MANUSCRIPT, CON-SPINE.
+- Related configuration: CFG-STEGO-PROJECT.

package/projects/stego-docs/spine/workflows/FLOW-PROOF-RELEASE.md

@@ -0,0 +1,10 @@
+---
+label: Run strict checks, build outputs, export artifacts, and archive release files.
+---
+
+# Run strict checks, build outputs, export artifacts, and archive release files.
+
+- Run strict checks, build outputs, export artifacts, and archive release files.
+- Related commands: CMD-CHECK-STAGE, CMD-BUILD, CMD-EXPORT.
+- Related concepts: CON-STAGE-GATE, CON-DIST.
+- Related integrations: INT-MARKDOWNLINT, INT-CSPELL.

package/projects/stego-docs/spine/workflows/FLOW-STAGE-PROMOTION.md

@@ -0,0 +1,10 @@
+---
+label: Move files through statuses and verify readiness with stage checks.
+---
+
+# Move files through statuses and verify readiness with stage checks.
+
+- Move files through statuses and verify readiness with stage checks.
+- Related commands: CMD-CHECK-STAGE, CMD-VALIDATE.
+- Related concepts: CON-STAGE-GATE, CON-METADATA.
+- Related configuration: CFG-STAGE-POLICIES, CFG-ALLOWED-STATUSES.

package/projects/stego-docs/spine/workflows/_category.md

@@ -0,0 +1,6 @@
+---
+label: Workflows
+---
+
+# Workflows
+

package/projects/stego-docs/stego-project.json

@@ -19,32 +19,5 @@
         "pageBreak": "between-groups"
       }
     ]
-  },
-  "spineCategories": [
-    {
-      "key": "commands",
-      "prefix": "CMD",
-      "notesFile": "commands.md"
-    },
-    {
-      "key": "concepts",
-      "prefix": "CON",
-      "notesFile": "concepts.md"
-    },
-    {
-      "key": "workflows",
-      "prefix": "FLOW",
-      "notesFile": "workflows.md"
-    },
-    {
-      "key": "configuration",
-      "prefix": "CFG",
-      "notesFile": "configuration.md"
-    },
-    {
-      "key": "integrations",
-      "prefix": "INT",
-      "notesFile": "integrations.md"
-    }
-  ]
+  }
 }

package/dist/comments/add-comment.js

@@ -1,382 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { CommentsCommandError } from "./errors.js";
-const COMMENT_DELIMITER_REGEX = /^<!--\s*comment:\s*(CMT-(\d{4,}))\s*-->\s*$/i;
-const LEGACY_COMMENT_HEADING_REGEX = /^###\s+(CMT-(\d{4,}))\s*$/i;
-const START_SENTINEL = "<!-- stego-comments:start -->";
-const END_SENTINEL = "<!-- stego-comments:end -->";
-/** Adds one stego comment entry to a manuscript and writes the updated file. */
-export function addCommentToManuscript(request) {
-    const absolutePath = path.resolve(request.cwd, request.manuscriptPath);
-    if (!fs.existsSync(absolutePath) || !fs.statSync(absolutePath).isFile()) {
-        throw new CommentsCommandError("INVALID_USAGE", 2, `Manuscript file not found: ${request.manuscriptPath}`);
-    }
-    const raw = fs.readFileSync(absolutePath, "utf8");
-    const lineEnding = raw.includes("\r\n") ? "\r\n" : "\n";
-    const lines = raw.split(/\r?\n/);
-    const sentinelState = resolveSentinelState(lines);
-    const hasYamlFrontmatter = raw.startsWith(`---${lineEnding}`) || raw.startsWith("---\n");
-    if (!sentinelState.hasSentinels && !hasYamlFrontmatter) {
-        throw new CommentsCommandError("NOT_STEGO_MANUSCRIPT", 3, "File is not recognized as a Stego manuscript (missing frontmatter and comments sentinels).");
-    }
-    const commentId = getNextCommentId(lines, sentinelState);
-    const now = new Date();
-    const createdAt = now.toISOString();
-    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;
-    const timezoneOffsetMinutes = -now.getTimezoneOffset();
-    const paragraphIndex = request.range
-        ? resolveParagraphIndex(lines, lineEnding, sentinelState, request.range)
-        : undefined;
-    const excerpt = request.range
-        ? extractExcerptForRange(lines, request.range)
-        : undefined;
-    const meta = buildMetaPayload({
-        createdAt,
-        timezone,
-        timezoneOffsetMinutes,
-        paragraphIndex,
-        range: request.range,
-        sourceMeta: request.sourceMeta
-    });
-    const meta64 = Buffer.from(JSON.stringify(meta), "utf8").toString("base64url");
-    const entryLines = buildCommentEntryLines({
-        commentId,
-        createdAt,
-        author: request.author,
-        message: request.message,
-        meta64,
-        paragraphIndex,
-        excerpt
-    });
-    const nextLines = applyCommentEntry(lines, sentinelState, entryLines);
-    const nextContent = `${nextLines.join(lineEnding)}${lineEnding}`;
-    try {
-        fs.writeFileSync(absolutePath, nextContent, "utf8");
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new CommentsCommandError("WRITE_FAILURE", 6, `Failed to update manuscript: ${message}`);
-    }
-    const result = {
-        ok: true,
-        manuscript: absolutePath,
-        commentId,
-        status: "open",
-        anchor: request.range
-            ? {
-                type: "selection",
-                excerptStartLine: request.range.startLine,
-                excerptStartCol: request.range.startCol,
-                excerptEndLine: request.range.endLine,
-                excerptEndCol: request.range.endCol
-            }
-            : { type: "file" },
-        createdAt
-    };
-    return result;
-}
-function buildMetaPayload(input) {
-    const payload = {
-        status: "open",
-        created_at: input.createdAt,
-        timezone_offset_minutes: input.timezoneOffsetMinutes
-    };
-    if (input.timezone) {
-        payload.timezone = input.timezone;
-    }
-    if (input.paragraphIndex !== undefined) {
-        payload.paragraph_index = input.paragraphIndex;
-    }
-    if (input.range) {
-        payload.excerpt_start_line = input.range.startLine;
-        payload.excerpt_start_col = input.range.startCol;
-        payload.excerpt_end_line = input.range.endLine;
-        payload.excerpt_end_col = input.range.endCol;
-    }
-    if (input.sourceMeta && Object.keys(input.sourceMeta).length > 0) {
-        payload.signature = input.sourceMeta;
-    }
-    return payload;
-}
-function buildCommentEntryLines(input) {
-    const safeAuthor = input.author.trim() || "Saurus";
-    const normalizedMessageLines = input.message
-        .replace(/\r\n/g, "\n")
-        .split("\n")
-        .map((line) => line.trimEnd());
-    const displayTimestamp = formatHumanTimestamp(input.createdAt);
-    const headerTimestamp = escapeThreadHeaderPart(displayTimestamp);
-    const headerAuthor = escapeThreadHeaderPart(safeAuthor);
-    const lines = [
-        `<!-- comment: ${input.commentId} -->`,
-        `<!-- meta64: ${input.meta64} -->`,
-        `> _${headerTimestamp} — ${headerAuthor}_`,
-        ">"
-    ];
-    if (input.paragraphIndex !== undefined && input.excerpt) {
-        const truncatedExcerpt = input.excerpt.length > 100
-            ? `${input.excerpt.slice(0, 100).trimEnd()}…`
-            : input.excerpt;
-        lines.push(`> > “${truncatedExcerpt}”`);
-        lines.push(">");
-    }
-    lines.push(...normalizedMessageLines.map((line) => `> ${line}`));
-    return lines;
-}
-function applyCommentEntry(lines, sentinelState, entryLines) {
-    if (!sentinelState.hasSentinels) {
-        const baseLines = trimTrailingBlankLines(lines);
-        return [
-            ...baseLines,
-            "",
-            START_SENTINEL,
-            "",
-            ...entryLines,
-            "",
-            END_SENTINEL
-        ];
-    }
-    const startIndex = sentinelState.startIndex;
-    const endIndex = sentinelState.endIndex;
-    const block = lines.slice(startIndex + 1, endIndex);
-    const trimmedBlock = trimOuterBlankLines(block);
-    const nextBlock = trimmedBlock.length > 0
-        ? [...trimmedBlock, "", ...entryLines]
-        : [...entryLines];
-    return [
-        ...lines.slice(0, startIndex + 1),
-        ...nextBlock,
-        ...lines.slice(endIndex)
-    ];
-}
-function resolveSentinelState(lines) {
-    const startIndexes = findTrimmedLineIndexes(lines, START_SENTINEL);
-    const endIndexes = findTrimmedLineIndexes(lines, END_SENTINEL);
-    const hasAnySentinel = startIndexes.length > 0 || endIndexes.length > 0;
-    if (!hasAnySentinel) {
-        return {
-            hasSentinels: false,
-            startIndex: -1,
-            endIndex: -1
-        };
-    }
-    if (startIndexes.length !== 1 || endIndexes.length !== 1) {
-        throw new CommentsCommandError("COMMENT_APPENDIX_INVALID", 5, `Expected exactly one '${START_SENTINEL}' and one '${END_SENTINEL}' marker.`);
-    }
-    const startIndex = startIndexes[0];
-    const endIndex = endIndexes[0];
-    if (endIndex <= startIndex) {
-        throw new CommentsCommandError("COMMENT_APPENDIX_INVALID", 5, `'${END_SENTINEL}' must appear after '${START_SENTINEL}'.`);
-    }
-    return {
-        hasSentinels: true,
-        startIndex,
-        endIndex
-    };
-}
-function findTrimmedLineIndexes(lines, target) {
-    const indexes = [];
-    for (let index = 0; index < lines.length; index += 1) {
-        if (lines[index].trim() === target) {
-            indexes.push(index);
-        }
-    }
-    return indexes;
-}
-function getNextCommentId(lines, sentinelState) {
-    const candidateLines = sentinelState.hasSentinels
-        ? lines.slice(sentinelState.startIndex + 1, sentinelState.endIndex)
-        : lines;
-    let maxId = 0;
-    for (const line of candidateLines) {
-        const trimmed = line.trim();
-        const match = trimmed.match(COMMENT_DELIMITER_REGEX) ?? trimmed.match(LEGACY_COMMENT_HEADING_REGEX);
-        if (!match || !match[2]) {
-            continue;
-        }
-        const numeric = Number.parseInt(match[2], 10);
-        if (Number.isFinite(numeric) && numeric > maxId) {
-            maxId = numeric;
-        }
-    }
-    const next = maxId + 1;
-    return `CMT-${String(next).padStart(4, "0")}`;
-}
-function resolveParagraphIndex(lines, lineEnding, sentinelState, range) {
-    const markdownWithoutComments = stripCommentsAppendix(lines, sentinelState, lineEnding);
-    const { body, lineOffset } = splitFrontmatterForAnchors(markdownWithoutComments);
-    const paragraphs = extractParagraphs(body).map((paragraph) => ({
-        ...paragraph,
-        startLine: paragraph.startLine + lineOffset,
-        endLine: paragraph.endLine + lineOffset
-    }));
-    const matched = findParagraphForLine(paragraphs, range.startLine) ?? findPreviousParagraphForLine(paragraphs, range.startLine);
-    return matched?.index;
-}
-function extractExcerptForRange(lines, range) {
-    const startLineIndex = range.startLine - 1;
-    const endLineIndex = range.endLine - 1;
-    if (startLineIndex < 0 || endLineIndex < 0 || startLineIndex >= lines.length || endLineIndex >= lines.length) {
-        return undefined;
-    }
-    if (startLineIndex > endLineIndex || (startLineIndex === endLineIndex && range.startCol >= range.endCol)) {
-        return undefined;
-    }
-    const startLineText = lines[startLineIndex] ?? "";
-    const endLineText = lines[endLineIndex] ?? "";
-    const safeStartCol = clamp(range.startCol, 0, startLineText.length);
-    const safeEndCol = clamp(range.endCol, 0, endLineText.length);
-    let selected = "";
-    if (startLineIndex === endLineIndex) {
-        if (safeStartCol >= safeEndCol) {
-            return undefined;
-        }
-        selected = startLineText.slice(safeStartCol, safeEndCol);
-    }
-    else {
-        const segments = [];
-        segments.push(startLineText.slice(safeStartCol));
-        for (let lineIndex = startLineIndex + 1; lineIndex < endLineIndex; lineIndex += 1) {
-            segments.push(lines[lineIndex] ?? "");
-        }
-        segments.push(endLineText.slice(0, safeEndCol));
-        selected = segments.join("\n");
-    }
-    const compact = compactExcerpt(selected);
-    return compact || undefined;
-}
-function clamp(value, min, max) {
-    if (value < min) {
-        return min;
-    }
-    if (value > max) {
-        return max;
-    }
-    return value;
-}
-function compactExcerpt(value, max = 180) {
-    const compact = value.replace(/\s+/g, " ").trim();
-    if (compact.length <= max) {
-        return compact;
-    }
-    return `${compact.slice(0, max - 1)}…`;
-}
-function stripCommentsAppendix(lines, sentinelState, lineEnding) {
-    if (!sentinelState.hasSentinels) {
-        return lines.join(lineEnding);
-    }
-    let removeStart = sentinelState.startIndex;
-    if (removeStart > 0 && lines[removeStart - 1].trim().length === 0) {
-        removeStart -= 1;
-    }
-    const keptLines = [...lines.slice(0, removeStart), ...lines.slice(sentinelState.endIndex + 1)];
-    while (keptLines.length > 0 && keptLines[keptLines.length - 1].trim().length === 0) {
-        keptLines.pop();
-    }
-    return keptLines.join(lineEnding);
-}
-function splitFrontmatterForAnchors(markdownText) {
-    const frontmatterMatch = markdownText.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
-    if (!frontmatterMatch) {
-        return {
-            body: markdownText,
-            lineOffset: 0
-        };
-    }
-    const consumed = frontmatterMatch[0];
-    return {
-        body: markdownText.slice(consumed.length),
-        lineOffset: countLineBreaks(consumed)
-    };
-}
-function countLineBreaks(value) {
-    const matches = value.match(/\r?\n/g);
-    return matches ? matches.length : 0;
-}
-function extractParagraphs(markdownText) {
-    const lines = markdownText.split(/\r?\n/);
-    const paragraphs = [];
-    let currentStart = -1;
-    const currentLines = [];
-    const flush = (endIndex) => {
-        if (currentStart < 0 || currentLines.length === 0) {
-            return;
-        }
-        const joined = currentLines.join(" ").replace(/\s+/g, " ").trim();
-        if (joined.length > 0) {
-            paragraphs.push({
-                index: paragraphs.length,
-                startLine: currentStart + 1,
-                endLine: endIndex + 1,
-                text: joined
-            });
-        }
-        currentStart = -1;
-        currentLines.length = 0;
-    };
-    for (let index = 0; index < lines.length; index += 1) {
-        const trimmed = lines[index].trim();
-        if (!trimmed) {
-            flush(index - 1);
-            continue;
-        }
-        if (currentStart < 0) {
-            currentStart = index;
-        }
-        currentLines.push(trimmed);
-    }
-    flush(lines.length - 1);
-    return paragraphs;
-}
-function findParagraphForLine(paragraphs, lineNumber) {
-    return paragraphs.find((paragraph) => lineNumber >= paragraph.startLine && lineNumber <= paragraph.endLine);
-}
-function findPreviousParagraphForLine(paragraphs, lineNumber) {
-    for (let index = paragraphs.length - 1; index >= 0; index -= 1) {
-        if (paragraphs[index].endLine < lineNumber) {
-            return paragraphs[index];
-        }
-    }
-    return undefined;
-}
-function formatHumanTimestamp(raw) {
-    if (!/^\d{4}-\d{2}-\d{2}T/.test(raw)) {
-        return raw;
-    }
-    const date = new Date(raw);
-    if (Number.isNaN(date.getTime())) {
-        return raw;
-    }
-    const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
-    const month = months[date.getUTCMonth()];
-    const day = date.getUTCDate();
-    const year = date.getUTCFullYear();
-    const hours24 = date.getUTCHours();
-    const hours = hours24 % 12 || 12;
-    const minutes = String(date.getUTCMinutes()).padStart(2, "0");
-    const ampm = hours24 < 12 ? "AM" : "PM";
-    return `${month} ${day}, ${year}, ${hours}:${minutes} ${ampm}`;
-}
-function escapeThreadHeaderPart(value) {
-    return value
-        .replace(/\\/g, "\\\\")
-        .replace(/_/g, "\\_");
-}
-function trimTrailingBlankLines(lines) {
-    const copy = [...lines];
-    while (copy.length > 0 && copy[copy.length - 1].trim().length === 0) {
-        copy.pop();
-    }
-    return copy;
-}
-function trimOuterBlankLines(lines) {
-    let start = 0;
-    let end = lines.length;
-    while (start < end && lines[start].trim().length === 0) {
-        start += 1;
-    }
-    while (end > start && lines[end - 1].trim().length === 0) {
-        end -= 1;
-    }
-    return lines.slice(start, end);
-}

package/projects/fiction-example/spine/characters.md

@@ -1,35 +0,0 @@
-# Characters
-
-## CHAR-MATTHAEUS
-label: Magister Matthaeus de Rota
-
-- Magister Matthaeus de Rota
-- Role: Scholar of medicine and astrology at the University of Paris
-- Disposition: Methodical, sincere, incapable of leaving an observation outside his system; treats coherence as a moral obligation
-- Sources: Works primarily from the conjunction theory (SRC-CONJUNCTION) and Galenic tradition (SRC-GALEN); consults a prohibited astrological quire privately for its method of reasoning from hidden correspondences
-- Arc: Builds a total explanation of the {{pestilence}} and dies at peace inside it; the question is whether his peace is understanding or its most sophisticated substitute
-
-## CHAR-ETIENNE
-label: Etienne of Saint-Marcel
-
-- Etienne of Saint-Marcel
-- Role: Young cleric-scribe attached to Matthaeus (CHAR-MATTHAEUS)
-- Disposition: Careful, loyal, doctrinally cautious; sees everything his master does and says nothing about the parts that trouble him
-- Function: The story's witness; records the system without fully believing it, but also without offering an alternative
-
-## CHAR-AGNES
-label: Agnes the apothecary
-
-- Agnes the apothecary
-- Role: Compounder and practical healer near the Petit Pont; supplies Hôtel-Dieu (LOC-HOTELDIEU)
-- Disposition: Empirical, blunt, uninterested in frameworks that don't predict which street sickens next
-- Sources: Her own ward observations (SRC-WARD-DATA); she has no name for her method, which is part of its strength and its institutional weakness
-- Function: The counterweight; asks whether a system that can absorb any evidence without changing is a system or a habit
-
-## CHAR-RAOUL
-label: Canon Raoul de Villiers
-
-- Canon Raoul de Villiers
-- Role: Cathedral canon and royal intermediary overseeing the inquiry
-- Disposition: Pragmatic, literate, concerned with language fit for governance; judges arguments by their civic effects, not their truth
-- Relationship: Commissioned Matthaeus (CHAR-MATTHAEUS) and will approve or suppress his conclusions; represents the institution's need for a single authorized account

package/projects/fiction-example/spine/locations.md

@@ -1,37 +0,0 @@
-# Locations
-
-## LOC-COLLEGE
-label: College chamber near the Rue Saint-Jacques
-
-- College chamber near the Rue Saint-Jacques
-- Study and disputation room
-- Reference: [University of Paris](https://en.wikipedia.org/wiki/University_of_Paris), [Rue Saint-Jacques](https://en.wikipedia.org/wiki/Rue_Saint-Jacques_(Paris))
-- Stone-walled, poorly lit, dominated by a long table covered in manuscripts; the room where Matthaeus (CHAR-MATTHAEUS) and Etienne (CHAR-ETIENNE) compile the memorandum
-- Significance: The space where the system is built; physically separated from the wards and streets where the plague actually operates
-
-## LOC-HOTELDIEU
-label: "Hôtel-Dieu"
-
-- Hôtel-Dieu
-- Hospital ward near Notre-Dame
-- Reference: [Hôtel-Dieu de Paris](https://en.wikipedia.org/wiki/H%C3%B4tel-Dieu_de_Paris)
-- Crowded, loud, smelling of vinegar and linen; priests read offices while surgeons open buboes; Agnes (CHAR-AGNES) manages the supply lines
-- Significance: Where data is collected; the distance between this room and the college chamber is the distance between observation and explanation
-
-## LOC-QUAY
-label: Grain quay on the Seine
-
-- Grain quay on the Seine
-- River unloading zone
-- Reference: [Port de la Grève](https://en.wikipedia.org/wiki/Place_de_Gr%C3%A8ve) (medieval commercial riverfront)
-- Torn sackcloth, heavy foot traffic, commercial contact between upstream suppliers and the city's markets
-- Significance: Agnes's observations (SRC-WARD-DATA) trace infection along this route; it is the strongest evidence for material transmission and the hardest for the celestial framework (SRC-CONJUNCTION) to accommodate
-
-## LOC-CHARNEL
-label: Charnel precinct at the cemetery edge
-
-- Charnel precinct at the cemetery edge
-- Overflow burial ground
-- Reference: [Holy Innocents' Cemetery](https://en.wikipedia.org/wiki/Saints_Innocents%27_Cemetery)
-- Where the dead go when the dead outnumber the rites; compressed ritual, civic exhaustion
-- Significance: The place that makes the need for an explanation urgent — not because understanding will stop the dying, but because the alternative is dying without a frame

package/projects/fiction-example/spine/sources.md

@@ -1,31 +0,0 @@
-# Sources
-
-## SRC-CONJUNCTION
-label: The Great Conjunction theory
-
-- The Great Conjunction theory
-- Tradition: University astrology ([Paris faculty opinion of 1348](https://en.wikipedia.org/wiki/Black_Death#Medical_knowledge))
-- Reference: [Great Conjunction](https://en.wikipedia.org/wiki/Great_conjunction)
-- Claim: The conjunction of Saturn, Jupiter, and Mars in Aquarius corrupted the atmosphere universally; local outbreaks are secondary effects of a celestial primary cause
-- Used by: Matthaeus (CHAR-MATTHAEUS) as the apex of his causal hierarchy; Raoul (CHAR-RAOUL) as the politically safest framing
-- Limitation: Explains everything at once, which means it predicts nothing in particular
-
-## SRC-GALEN
-label: Galenic humoral medicine
-
-- Galenic humoral medicine
-- Tradition: Greco-Arabic medical inheritance
-- Reference: [Humorism](https://en.wikipedia.org/wiki/Humorism), [Galen](https://en.wikipedia.org/wiki/Galen)
-- Claim: Individual susceptibility depends on bodily complexion (balance of humors); treatment involves restoring balance through diet, purgation, and environment
-- Used by: Matthaeus (CHAR-MATTHAEUS) as the middle layer of his framework — celestial disposition selects who is vulnerable, humoral constitution determines who actually sickens
-- Limitation: Cannot explain why entire neighborhoods fall at once regardless of individual constitution
-
-## SRC-WARD-DATA
-label: "Agnes's ward observations"
-
-- Agnes's ward observations
-- Tradition: None; empirical record-keeping without institutional backing
-- Reference: [Miasma theory](https://en.wikipedia.org/wiki/Miasma_theory) (the contemporary framework Agnes's data implicitly challenges)
-- Claim: Infection follows grain traffic and commercial contact; neighborhoods tied to the quay (LOC-QUAY) sicken first, then adjacent streets, then the rest
-- Used by: Agnes (CHAR-AGNES) as practical knowledge; Matthaeus (CHAR-MATTHAEUS) acknowledges the pattern but classifies it as a secondary distributing cause, subordinate to celestial disposition
-- Limitation: No theoretical framework to explain why the pattern holds; accurate but institutionally weightless