muonroi-cli 1.2.0

package/dist/flow/compaction/index.js

@@ -0,0 +1,63 @@
+/**
+ * Two-pass compaction orchestrator.
+ *
+ * Pass 1: Extract decisions/facts/constraints to decisions.md (deterministic).
+ * Pass 2: Compress chat within token budget, preserving verbatim blocks.
+ * Snapshot full chat to history/<timestamp>.md before compressing.
+ */
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { estimateConversationTokens, serializeConversation } from "../../orchestrator/compaction.js";
+import { atomicWriteText } from "../../storage/atomic-io.js";
+import { readArtifact, writeArtifact } from "../artifact-io.js";
+import { compressChat } from "./compress.js";
+import { extractDecisions } from "./extract.js";
+/**
+ * Orchestrate two-pass deliberate compaction.
+ *
+ * 1. Pass 1: extractDecisions -> append to decisions.md
+ * 2. Snapshot: full chat -> history/<ISO-timestamp>.md
+ * 3. Pass 2: compressChat -> compressed output
+ * 4. Return metrics
+ */
+export async function deliberateCompact(flowDir, messages, systemPrompt, tokenBudget, provider, modelId) {
+    // Pass 1: Extract decisions/facts/constraints
+    const extracted = extractDecisions(messages);
+    const totalExtracted = extracted.decisions.length + extracted.facts.length + extracted.constraints.length;
+    // Append to decisions.md
+    if (totalExtracted > 0) {
+        let existing = await readArtifact(flowDir, "decisions.md");
+        if (!existing) {
+            existing = { preamble: "", sections: new Map() };
+        }
+        const appendItems = (heading, items) => {
+            if (items.length === 0)
+                return;
+            const current = existing.sections.get(heading) ?? "";
+            const newContent = items.map((i) => `- ${i}`).join("\n");
+            existing.sections.set(heading, current ? `${current}\n${newContent}` : newContent);
+        };
+        appendItems("Decisions", extracted.decisions);
+        appendItems("Facts", extracted.facts);
+        appendItems("Constraints", extracted.constraints);
+        await writeArtifact(flowDir, "decisions.md", existing, ["Decisions", "Facts", "Constraints"]);
+    }
+    // Snapshot full chat to history/
+    const historyDir = path.join(flowDir, "history");
+    await fs.mkdir(historyDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const historyPath = path.join(historyDir, `${timestamp}.md`);
+    const fullSerialized = serializeConversation(messages);
+    await atomicWriteText(historyPath, fullSerialized);
+    // Token estimation before
+    const tokensBefore = estimateConversationTokens(systemPrompt, messages);
+    // Pass 2: Compress
+    const compressed = await compressChat(messages, systemPrompt, tokenBudget, provider, modelId);
+    return {
+        decisionsExtracted: totalExtracted,
+        tokensBeforeCompress: tokensBefore,
+        tokensAfterCompress: compressed.tokensAfter,
+        historyPath,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/flow/compaction/index.js.map

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

package/dist/flow/compaction/preserve.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Preserve-verbatim marker handling for two-pass compaction.
+ *
+ * Content between <!-- preserve --> and <!-- /preserve --> markers
+ * survives compaction regardless of token budget.
+ */
+export declare const PRESERVE_OPEN = "<!-- preserve -->";
+export declare const PRESERVE_CLOSE = "<!-- /preserve -->";
+export interface PreservedBlock {
+    id: string;
+    content: string;
+}
+/**
+ * Extract content between preserve markers, replacing with placeholders.
+ * Unmatched (unclosed) markers are left as-is.
+ */
+export declare function extractPreservedBlocks(text: string): {
+    cleaned: string;
+    blocks: PreservedBlock[];
+};
+/**
+ * Replace placeholders with original content wrapped in preserve markers.
+ */
+export declare function restorePreservedBlocks(text: string, blocks: PreservedBlock[]): string;

package/dist/flow/compaction/preserve.js

@@ -0,0 +1,35 @@
+/**
+ * Preserve-verbatim marker handling for two-pass compaction.
+ *
+ * Content between <!-- preserve --> and <!-- /preserve --> markers
+ * survives compaction regardless of token budget.
+ */
+export const PRESERVE_OPEN = "<!-- preserve -->";
+export const PRESERVE_CLOSE = "<!-- /preserve -->";
+const PRESERVE_RE = /<!-- preserve -->([\s\S]*?)<!-- \/preserve -->/g;
+/**
+ * Extract content between preserve markers, replacing with placeholders.
+ * Unmatched (unclosed) markers are left as-is.
+ */
+export function extractPreservedBlocks(text) {
+    const blocks = [];
+    let index = 0;
+    const cleaned = text.replace(PRESERVE_RE, (_match, content) => {
+        const id = `__PRESERVED_${index}__`;
+        blocks.push({ id, content });
+        index++;
+        return id;
+    });
+    return { cleaned, blocks };
+}
+/**
+ * Replace placeholders with original content wrapped in preserve markers.
+ */
+export function restorePreservedBlocks(text, blocks) {
+    let result = text;
+    for (const block of blocks) {
+        result = result.replace(block.id, `${PRESERVE_OPEN}${block.content}${PRESERVE_CLOSE}`);
+    }
+    return result;
+}
+//# sourceMappingURL=preserve.js.map

package/dist/flow/compaction/preserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preserve.js","sourceRoot":"","sources":["../../../src/flow/compaction/preserve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAOnD,MAAM,WAAW,GAAG,iDAAiD,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAIjD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,eAAe,KAAK,IAAI,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7B,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAwB;IAC3E,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,aAAa,GAAG,KAAK,CAAC,OAAO,GAAG,cAAc,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/flow/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Flow module — .muonroi-flow/ artifact system.
+ *
+ * Re-exports public API from parser, scaffold, artifact-io, run-manager, migration.
+ */
+export { readArtifact, writeArtifact } from "./artifact-io.js";
+export { detectLegacyFlow, migrateQuickCodexFlow } from "./migration.js";
+export type { SectionMap } from "./parser.js";
+export { getSection, parseSections, serializeSections } from "./parser.js";
+export type { RunState } from "./run-manager.js";
+export { createRun, getActiveRunId, loadRun, setActiveRunId, updateRunFile } from "./run-manager.js";
+export { ensureFlowDir, FLOW_DIR_NAME } from "./scaffold.js";

package/dist/flow/index.js

@@ -0,0 +1,16 @@
+/**
+ * Flow module — .muonroi-flow/ artifact system.
+ *
+ * Re-exports public API from parser, scaffold, artifact-io, run-manager, migration.
+ */
+// Artifact I/O
+export { readArtifact, writeArtifact } from "./artifact-io.js";
+// Migration
+export { detectLegacyFlow, migrateQuickCodexFlow } from "./migration.js";
+// Parser
+export { getSection, parseSections, serializeSections } from "./parser.js";
+// Run manager
+export { createRun, getActiveRunId, loadRun, setActiveRunId, updateRunFile } from "./run-manager.js";
+// Scaffold
+export { ensureFlowDir, FLOW_DIR_NAME } from "./scaffold.js";
+//# sourceMappingURL=index.js.map

package/dist/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE3E,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/flow/migration.d.ts

@@ -0,0 +1,23 @@
+/**
+ * .quick-codex-flow/ -> .muonroi-flow/ migration.
+ *
+ * Detects legacy QC flow directory and migrates it one-shot to the new format.
+ * Original .quick-codex-flow/ is NOT deleted after migration.
+ */
+/**
+ * Detect whether a legacy .quick-codex-flow/ directory exists.
+ */
+export declare function detectLegacyFlow(cwd: string): Promise<boolean>;
+/**
+ * Migrate .quick-codex-flow/ to .muonroi-flow/.
+ *
+ * - Top-level: STATE.md -> state.md, PROJECT-ROADMAP.md -> roadmap.md, BACKLOG.md -> backlog.md
+ * - Run files (non-top-level .md): split by heading into per-aspect files
+ * - Decision Register sections -> appended to decisions.md
+ * - Unknown sections -> preserved in runs/<id>/state.md
+ * - Original .quick-codex-flow/ is NOT deleted
+ */
+export declare function migrateQuickCodexFlow(cwd: string): Promise<{
+    runsCreated: number;
+    filesCopied: number;
+}>;

package/dist/flow/migration.js

@@ -0,0 +1,126 @@
+/**
+ * .quick-codex-flow/ -> .muonroi-flow/ migration.
+ *
+ * Detects legacy QC flow directory and migrates it one-shot to the new format.
+ * Original .quick-codex-flow/ is NOT deleted after migration.
+ */
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { atomicWriteText } from "../storage/atomic-io.js";
+import { parseSections, serializeSections } from "./parser.js";
+import { ensureFlowDir } from "./scaffold.js";
+/** QC top-level file -> muonroi-flow file mapping */
+const TOP_LEVEL_MAP = {
+    "STATE.md": "state.md",
+    "PROJECT-ROADMAP.md": "roadmap.md",
+    "BACKLOG.md": "backlog.md",
+};
+/** QC run section heading -> target file in runs/<id>/ */
+const SECTION_TO_FILE = {
+    "Delivery Roadmap": "roadmap.md",
+    "Delegation State": "delegations.md",
+    "Gray Area Register": "gray-areas.md",
+};
+/** Sections that go into runs/<id>/state.md */
+const _STATE_SECTIONS = new Set(["Resume Digest", "Compact-Safe Summary", "Experience Snapshot", "Workflow State"]);
+/** Sections that go into the top-level decisions.md */
+const DECISIONS_SECTIONS = new Set(["Decision Register"]);
+/**
+ * Detect whether a legacy .quick-codex-flow/ directory exists.
+ */
+export async function detectLegacyFlow(cwd) {
+    try {
+        const stat = await fs.stat(path.join(cwd, ".quick-codex-flow"));
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Migrate .quick-codex-flow/ to .muonroi-flow/.
+ *
+ * - Top-level: STATE.md -> state.md, PROJECT-ROADMAP.md -> roadmap.md, BACKLOG.md -> backlog.md
+ * - Run files (non-top-level .md): split by heading into per-aspect files
+ * - Decision Register sections -> appended to decisions.md
+ * - Unknown sections -> preserved in runs/<id>/state.md
+ * - Original .quick-codex-flow/ is NOT deleted
+ */
+export async function migrateQuickCodexFlow(cwd) {
+    const qcDir = path.join(cwd, ".quick-codex-flow");
+    const flowDir = await ensureFlowDir(cwd);
+    let runsCreated = 0;
+    let filesCopied = 0;
+    // 1. Copy top-level files with renames
+    for (const [qcName, flowName] of Object.entries(TOP_LEVEL_MAP)) {
+        const srcPath = path.join(qcDir, qcName);
+        try {
+            const content = await fs.readFile(srcPath, "utf8");
+            await atomicWriteText(path.join(flowDir, flowName), content);
+            filesCopied++;
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            // Missing top-level file is OK — skip
+        }
+    }
+    // 2. Find and split run files (non-top-level .md files)
+    const topLevelNames = new Set(Object.keys(TOP_LEVEL_MAP));
+    const entries = await fs.readdir(qcDir);
+    const runFiles = entries.filter((e) => e.endsWith(".md") && !topLevelNames.has(e));
+    // Accumulate decisions from all run files
+    let decisionsContent = "";
+    for (const runFile of runFiles) {
+        const content = await fs.readFile(path.join(qcDir, runFile), "utf8");
+        const parsed = parseSections(content);
+        // Derive run ID from filename slug (lowercase, dashes, no extension)
+        const runId = runFile
+            .replace(/\.md$/i, "")
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-");
+        const runDir = path.join(flowDir, "runs", runId);
+        await fs.mkdir(runDir, { recursive: true });
+        // Buckets for per-file sections
+        const roadmapSections = new Map();
+        const delegationsSections = new Map();
+        const grayAreasSections = new Map();
+        const stateSections = new Map();
+        for (const [heading, body] of parsed.sections) {
+            if (SECTION_TO_FILE[heading] === "roadmap.md") {
+                roadmapSections.set(heading, body);
+            }
+            else if (SECTION_TO_FILE[heading] === "delegations.md") {
+                delegationsSections.set(heading, body);
+            }
+            else if (SECTION_TO_FILE[heading] === "gray-areas.md") {
+                grayAreasSections.set(heading, body);
+            }
+            else if (DECISIONS_SECTIONS.has(heading)) {
+                decisionsContent += `## ${heading}\n\n${body}\n\n`;
+            }
+            else {
+                // STATE_SECTIONS + unknown sections -> state.md (tolerant)
+                stateSections.set(heading, body);
+            }
+        }
+        // Write per-aspect files
+        const writeMap = async (filePath, sections) => {
+            const map = { preamble: "", sections };
+            await atomicWriteText(filePath, serializeSections(map));
+        };
+        await writeMap(path.join(runDir, "roadmap.md"), roadmapSections);
+        await writeMap(path.join(runDir, "state.md"), stateSections);
+        await writeMap(path.join(runDir, "delegations.md"), delegationsSections);
+        await writeMap(path.join(runDir, "gray-areas.md"), grayAreasSections);
+        runsCreated++;
+        filesCopied += 4;
+    }
+    // 3. Append decisions to top-level decisions.md
+    if (decisionsContent) {
+        const existingDecisions = await fs.readFile(path.join(flowDir, "decisions.md"), "utf8").catch(() => "");
+        await atomicWriteText(path.join(flowDir, "decisions.md"), existingDecisions + decisionsContent);
+    }
+    return { runsCreated, filesCopied };
+}
+//# sourceMappingURL=migration.js.map

package/dist/flow/migration.js.map

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

package/dist/flow/parser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Heading-delimited section parser/writer for .muonroi-flow/ markdown files.
+ *
+ * All reads are tolerant: missing sections return undefined, empty input returns
+ * empty map, malformed input never throws. All writes are deterministic: same
+ * sections produce same output.
+ */
+export interface SectionMap {
+    sections: Map<string, string>;
+    preamble: string;
+}
+/**
+ * Parse heading-delimited markdown into a SectionMap.
+ * Splits on `## Heading` lines. Content before the first heading is the preamble.
+ * Empty or malformed input returns empty map with empty preamble (never throws).
+ */
+export declare function parseSections(markdown: string): SectionMap;
+/**
+ * Serialize a SectionMap back to heading-delimited markdown.
+ * Preamble comes first, then headings in the specified order.
+ * Headings not in the order array are appended at the end.
+ */
+export declare function serializeSections(map: SectionMap, order?: string[]): string;
+/**
+ * Tolerant getter — returns undefined for missing sections, never throws.
+ */
+export declare function getSection(map: SectionMap, heading: string): string | undefined;

package/dist/flow/parser.js

@@ -0,0 +1,68 @@
+/**
+ * Heading-delimited section parser/writer for .muonroi-flow/ markdown files.
+ *
+ * All reads are tolerant: missing sections return undefined, empty input returns
+ * empty map, malformed input never throws. All writes are deterministic: same
+ * sections produce same output.
+ */
+/**
+ * Parse heading-delimited markdown into a SectionMap.
+ * Splits on `## Heading` lines. Content before the first heading is the preamble.
+ * Empty or malformed input returns empty map with empty preamble (never throws).
+ */
+export function parseSections(markdown) {
+    const sections = new Map();
+    let preamble = "";
+    let currentHeading = null;
+    let currentLines = [];
+    const lines = markdown.split("\n");
+    for (const line of lines) {
+        const match = line.match(/^##\s+(.+)$/);
+        if (match) {
+            if (currentHeading !== null) {
+                sections.set(currentHeading, currentLines.join("\n").trim());
+            }
+            else {
+                preamble = currentLines.join("\n").trim();
+            }
+            currentHeading = match[1].trim();
+            currentLines = [];
+        }
+        else {
+            currentLines.push(line);
+        }
+    }
+    // Flush last section or preamble
+    if (currentHeading !== null) {
+        sections.set(currentHeading, currentLines.join("\n").trim());
+    }
+    else {
+        preamble = currentLines.join("\n").trim();
+    }
+    return { sections, preamble };
+}
+/**
+ * Serialize a SectionMap back to heading-delimited markdown.
+ * Preamble comes first, then headings in the specified order.
+ * Headings not in the order array are appended at the end.
+ */
+export function serializeSections(map, order) {
+    const parts = [];
+    if (map.preamble)
+        parts.push(map.preamble);
+    const headings = order ? [...new Set([...order, ...map.sections.keys()])] : [...map.sections.keys()];
+    for (const h of headings) {
+        const content = map.sections.get(h);
+        if (content !== undefined) {
+            parts.push(`## ${h}\n\n${content}`);
+        }
+    }
+    return `${parts.join("\n\n")}\n`;
+}
+/**
+ * Tolerant getter — returns undefined for missing sections, never throws.
+ */
+export function getSection(map, heading) {
+    return map.sections.get(heading);
+}
+//# sourceMappingURL=parser.js.map

package/dist/flow/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/flow/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,CAAC;YACD,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,YAAY,GAAG,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAAE,KAAgB;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAErG,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAe,EAAE,OAAe;IACzD,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/flow/run-manager.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Create/load/update runs/<run-id>/ subdirectories in .muonroi-flow/.
+ *
+ * Run IDs are sortable (Date.now().toString(36)) + collision-safe
+ * (randomBytes(2).toString('hex')).
+ */
+import type { SectionMap } from "./parser.js";
+export interface RunState {
+    id: string;
+    roadmap: SectionMap;
+    state: SectionMap;
+    delegations: SectionMap;
+    grayAreas: SectionMap;
+}
+/**
+ * Create a new run directory with 4 empty .md files.
+ * Initializes state.md with Resume Digest and Experience Snapshot headings.
+ */
+export declare function createRun(flowDir: string): Promise<RunState>;
+/**
+ * Load a run by ID. Returns null if the run directory does not exist.
+ */
+export declare function loadRun(flowDir: string, runId: string): Promise<RunState | null>;
+/**
+ * Read the active run ID from the top-level state.md "Active Run" section.
+ * Returns null if no active run is set or section is missing/empty.
+ */
+export declare function getActiveRunId(flowDir: string): Promise<string | null>;
+/**
+ * Write the active run ID to the top-level state.md "Active Run" section.
+ */
+export declare function setActiveRunId(flowDir: string, id: string): Promise<void>;
+/**
+ * Write a run file atomically.
+ */
+export declare function updateRunFile(flowDir: string, runId: string, filename: string, map: SectionMap): Promise<void>;

package/dist/flow/run-manager.js

@@ -0,0 +1,110 @@
+/**
+ * Create/load/update runs/<run-id>/ subdirectories in .muonroi-flow/.
+ *
+ * Run IDs are sortable (Date.now().toString(36)) + collision-safe
+ * (randomBytes(2).toString('hex')).
+ */
+import { randomBytes } from "node:crypto";
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { readArtifact, writeArtifact } from "./artifact-io.js";
+const RUN_FILES = ["roadmap.md", "state.md", "delegations.md", "gray-areas.md"];
+/**
+ * Generate a sortable, human-readable, collision-safe run ID.
+ * Format: Date.now().toString(36) + randomBytes(2).toString('hex')
+ */
+function generateRunId() {
+    return Date.now().toString(36) + randomBytes(2).toString("hex");
+}
+/**
+ * Create a new run directory with 4 empty .md files.
+ * Initializes state.md with Resume Digest and Experience Snapshot headings.
+ */
+export async function createRun(flowDir) {
+    const id = generateRunId();
+    const runDir = path.join(flowDir, "runs", id);
+    await fs.mkdir(runDir, { recursive: true });
+    // Create empty files
+    for (const file of RUN_FILES) {
+        await fs.writeFile(path.join(runDir, file), "", "utf8");
+    }
+    // Initialize state.md with required headings
+    const stateMap = {
+        preamble: "",
+        sections: new Map([
+            ["Resume Digest", ""],
+            ["Experience Snapshot", ""],
+        ]),
+    };
+    await writeArtifact(path.join(flowDir, "runs", id), "state.md", stateMap);
+    // Return the initial RunState
+    const emptyMap = { preamble: "", sections: new Map() };
+    return {
+        id,
+        roadmap: emptyMap,
+        state: stateMap,
+        delegations: emptyMap,
+        grayAreas: emptyMap,
+    };
+}
+/**
+ * Load a run by ID. Returns null if the run directory does not exist.
+ */
+export async function loadRun(flowDir, runId) {
+    const runDir = path.join(flowDir, "runs", runId);
+    try {
+        await fs.access(runDir);
+    }
+    catch {
+        return null;
+    }
+    const roadmap = (await readArtifact(runDir, "roadmap.md")) ?? {
+        preamble: "",
+        sections: new Map(),
+    };
+    const state = (await readArtifact(runDir, "state.md")) ?? {
+        preamble: "",
+        sections: new Map(),
+    };
+    const delegations = (await readArtifact(runDir, "delegations.md")) ?? {
+        preamble: "",
+        sections: new Map(),
+    };
+    const grayAreas = (await readArtifact(runDir, "gray-areas.md")) ?? {
+        preamble: "",
+        sections: new Map(),
+    };
+    return { id: runId, roadmap, state, delegations, grayAreas };
+}
+/**
+ * Read the active run ID from the top-level state.md "Active Run" section.
+ * Returns null if no active run is set or section is missing/empty.
+ */
+export async function getActiveRunId(flowDir) {
+    const stateMap = await readArtifact(flowDir, "state.md");
+    if (!stateMap)
+        return null;
+    const section = stateMap.sections.get("Active Run");
+    if (!section?.trim())
+        return null;
+    return section.trim();
+}
+/**
+ * Write the active run ID to the top-level state.md "Active Run" section.
+ */
+export async function setActiveRunId(flowDir, id) {
+    let stateMap = await readArtifact(flowDir, "state.md");
+    if (!stateMap) {
+        stateMap = { preamble: "", sections: new Map() };
+    }
+    stateMap.sections.set("Active Run", id);
+    await writeArtifact(flowDir, "state.md", stateMap);
+}
+/**
+ * Write a run file atomically.
+ */
+export async function updateRunFile(flowDir, runId, filename, map) {
+    const runDir = path.join(flowDir, "runs", runId);
+    await writeArtifact(runDir, filename, map);
+}
+//# sourceMappingURL=run-manager.js.map

package/dist/flow/run-manager.js.map

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

package/dist/flow/scaffold.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Directory scaffolding for .muonroi-flow/.
+ *
+ * Creates the locked directory structure on first access. Idempotent —
+ * second call does not overwrite existing files.
+ */
+export declare const FLOW_DIR_NAME = ".muonroi-flow";
+/**
+ * Ensure the .muonroi-flow/ directory exists with the locked structure:
+ *
+ * .muonroi-flow/
+ * ├── roadmap.md
+ * ├── state.md
+ * ├── backlog.md
+ * ├── decisions.md
+ * ├── history/
+ * └── runs/
+ *
+ * Returns the absolute path to the .muonroi-flow/ directory.
+ * Only creates files if they do NOT already exist (idempotent).
+ */
+export declare function ensureFlowDir(cwd: string): Promise<string>;