muonroi-cli 1.2.0

package/dist/flow/__tests__/scaffold.test.js

@@ -0,0 +1,47 @@
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { ensureFlowDir, FLOW_DIR_NAME } from "../scaffold.js";
+describe("scaffold", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "flow-scaffold-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("FLOW_DIR_NAME equals .muonroi-flow", () => {
+        expect(FLOW_DIR_NAME).toBe(".muonroi-flow");
+    });
+    it("creates .muonroi-flow/ with all required files and directories", async () => {
+        const flowDir = await ensureFlowDir(tmpDir);
+        expect(flowDir).toBe(path.join(tmpDir, ".muonroi-flow"));
+        // Check files exist
+        const roadmap = await fs.stat(path.join(flowDir, "roadmap.md"));
+        expect(roadmap.isFile()).toBe(true);
+        const state = await fs.stat(path.join(flowDir, "state.md"));
+        expect(state.isFile()).toBe(true);
+        const backlog = await fs.stat(path.join(flowDir, "backlog.md"));
+        expect(backlog.isFile()).toBe(true);
+        const decisions = await fs.stat(path.join(flowDir, "decisions.md"));
+        expect(decisions.isFile()).toBe(true);
+        // Check directories exist
+        const history = await fs.stat(path.join(flowDir, "history"));
+        expect(history.isDirectory()).toBe(true);
+        const runs = await fs.stat(path.join(flowDir, "runs"));
+        expect(runs.isDirectory()).toBe(true);
+    });
+    it("is idempotent (second call does not overwrite existing files)", async () => {
+        await ensureFlowDir(tmpDir);
+        const flowDir = path.join(tmpDir, ".muonroi-flow");
+        // Write custom content to roadmap.md
+        await fs.writeFile(path.join(flowDir, "roadmap.md"), "custom content", "utf8");
+        // Call again
+        await ensureFlowDir(tmpDir);
+        // Verify custom content preserved
+        const content = await fs.readFile(path.join(flowDir, "roadmap.md"), "utf8");
+        expect(content).toBe("custom content");
+    });
+});
+//# sourceMappingURL=scaffold.test.js.map

package/dist/flow/__tests__/scaffold.test.js.map

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

package/dist/flow/__tests__/warning-persist.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for warning-persist.ts — persistWarning appends EE hook warnings
+ * to run state.md Experience Snapshot section.
+ */
+export {};

package/dist/flow/__tests__/warning-persist.test.js

@@ -0,0 +1,96 @@
+/**
+ * Tests for warning-persist.ts — persistWarning appends EE hook warnings
+ * to run state.md Experience Snapshot section.
+ */
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import * as path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { getSection } from "../parser.js";
+import { createRun, loadRun, setActiveRunId } from "../run-manager.js";
+import { ensureFlowDir } from "../scaffold.js";
+import { persistWarning } from "../warning-persist.js";
+let tempDirs = [];
+async function makeTempDir(prefix) {
+    const dir = await mkdtemp(path.join(tmpdir(), prefix));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(async () => {
+    for (const d of tempDirs) {
+        await rm(d, { recursive: true, force: true }).catch(() => { });
+    }
+    tempDirs = [];
+});
+function makeMatch(overrides) {
+    return {
+        principle_uuid: "test-uuid",
+        embedding_model_version: "v1",
+        confidence: 0.85,
+        why: "Test reason",
+        message: "Test warning message",
+        scope_label: "repo:test",
+        last_matched_at: "2026-04-30T00:00:00Z",
+        ...overrides,
+    };
+}
+describe("persistWarning", () => {
+    it("appends rendered warning to state.md Experience Snapshot section", async () => {
+        const cwd = await makeTempDir("warn-persist-");
+        const flowDir = await ensureFlowDir(cwd);
+        const run = await createRun(flowDir);
+        await setActiveRunId(flowDir, run.id);
+        const match = makeMatch({ message: "Do not force push", why: "Destroys history" });
+        await persistWarning(cwd, match);
+        const restored = await loadRun(flowDir, run.id);
+        expect(restored).not.toBeNull();
+        const snapshot = getSection(restored.state, "Experience Snapshot");
+        expect(snapshot).toContain("Do not force push");
+        expect(snapshot).toContain("Destroys history");
+    });
+    it("is a no-op when no active run exists (does not throw)", async () => {
+        const cwd = await makeTempDir("warn-no-run-");
+        await ensureFlowDir(cwd);
+        // No active run set
+        await expect(persistWarning(cwd, makeMatch())).resolves.toBeUndefined();
+    });
+    it("is a no-op when .muonroi-flow/ does not exist", async () => {
+        const cwd = await makeTempDir("warn-no-flow-");
+        await expect(persistWarning(cwd, makeMatch())).resolves.toBeUndefined();
+    });
+    it("accumulates multiple warnings (not overwrite)", async () => {
+        const cwd = await makeTempDir("warn-accum-");
+        const flowDir = await ensureFlowDir(cwd);
+        const run = await createRun(flowDir);
+        await setActiveRunId(flowDir, run.id);
+        await persistWarning(cwd, makeMatch({ message: "Warning A", principle_uuid: "uuid-a" }));
+        await persistWarning(cwd, makeMatch({ message: "Warning B", principle_uuid: "uuid-b" }));
+        await persistWarning(cwd, makeMatch({ message: "Warning C", principle_uuid: "uuid-c" }));
+        const restored = await loadRun(flowDir, run.id);
+        const snapshot = getSection(restored.state, "Experience Snapshot");
+        expect(snapshot).toContain("Warning A");
+        expect(snapshot).toContain("Warning B");
+        expect(snapshot).toContain("Warning C");
+    });
+    it("uses renderInterceptWarning format", async () => {
+        const cwd = await makeTempDir("warn-format-");
+        const flowDir = await ensureFlowDir(cwd);
+        const run = await createRun(flowDir);
+        await setActiveRunId(flowDir, run.id);
+        const match = makeMatch({
+            confidence: 0.92,
+            message: "Avoid rm -rf",
+            why: "Dangerous command",
+            scope_label: "global",
+        });
+        await persistWarning(cwd, match);
+        const restored = await loadRun(flowDir, run.id);
+        const snapshot = getSection(restored.state, "Experience Snapshot");
+        // renderInterceptWarning format: boxed 5-line warning with percentage confidence
+        expect(snapshot).toContain("92%");
+        expect(snapshot).toContain("Avoid rm -rf");
+        expect(snapshot).toContain("Dangerous command");
+        expect(snapshot).toContain("global");
+    });
+});
+//# sourceMappingURL=warning-persist.test.js.map

package/dist/flow/__tests__/warning-persist.test.js.map

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

package/dist/flow/artifact-io.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Read/write .muonroi-flow/ top-level files via atomic-rename.
+ *
+ * All reads parse heading-delimited markdown via parseSections.
+ * All writes serialize via serializeSections then atomicWriteText.
+ */
+import type { SectionMap } from "./parser.js";
+/**
+ * Read a .muonroi-flow/ file and parse it into a SectionMap.
+ * Returns null if the file does not exist (ENOENT).
+ */
+export declare function readArtifact(flowDir: string, filename: string): Promise<SectionMap | null>;
+/**
+ * Write a SectionMap to a .muonroi-flow/ file using atomic-rename.
+ */
+export declare function writeArtifact(flowDir: string, filename: string, map: SectionMap, order?: string[]): Promise<void>;

package/dist/flow/artifact-io.js

@@ -0,0 +1,35 @@
+/**
+ * Read/write .muonroi-flow/ top-level files via atomic-rename.
+ *
+ * All reads parse heading-delimited markdown via parseSections.
+ * All writes serialize via serializeSections then atomicWriteText.
+ */
+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";
+/**
+ * Read a .muonroi-flow/ file and parse it into a SectionMap.
+ * Returns null if the file does not exist (ENOENT).
+ */
+export async function readArtifact(flowDir, filename) {
+    const filePath = path.join(flowDir, filename);
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return parseSections(content);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+/**
+ * Write a SectionMap to a .muonroi-flow/ file using atomic-rename.
+ */
+export async function writeArtifact(flowDir, filename, map, order) {
+    const filePath = path.join(flowDir, filename);
+    const content = serializeSections(map, order);
+    await atomicWriteText(filePath, content);
+}
+//# sourceMappingURL=artifact-io.js.map

package/dist/flow/artifact-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-io.js","sourceRoot":"","sources":["../../src/flow/artifact-io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,QAAgB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB,EAChB,GAAe,EACf,KAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/flow/compaction/__tests__/compress.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/flow/compaction/__tests__/compress.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it, vi } from "vitest";
+import { compressChat } from "../compress.js";
+// Mock the existing compaction engine
+vi.mock("../../../orchestrator/compaction.js", () => ({
+    serializeConversation: (msgs) => {
+        // Simple serialization for tests
+        return msgs
+            .map((m) => {
+            const text = typeof m.content === "string" ? m.content : "";
+            return `[${m.role}]: ${text}`;
+        })
+            .join("\n\n");
+    },
+    estimateMessageTokens: (msg) => {
+        const text = typeof msg.content === "string" ? msg.content : "";
+        return Math.ceil(text.length / 4);
+    },
+    prepareCompaction: vi.fn().mockReturnValue(null),
+    generateCompactionSummary: vi.fn().mockResolvedValue("Compressed summary"),
+    DEFAULT_RESERVE_TOKENS: 16_384,
+    DEFAULT_KEEP_RECENT_TOKENS: 20_000,
+}));
+describe("compressChat", () => {
+    const shortMessages = [
+        { role: "user", content: "Hello" },
+        { role: "assistant", content: "Hi there" },
+    ];
+    it("returns messages unchanged when under token budget", async () => {
+        const result = await compressChat(shortMessages, "system prompt", 10000);
+        expect(result.summary).toContain("Hello");
+        expect(result.summary).toContain("Hi there");
+        expect(result.tokensAfter).toBeLessThanOrEqual(10000);
+    });
+    it("preserves <!-- preserve --> blocks verbatim in output", async () => {
+        const messages = [
+            {
+                role: "user",
+                content: "Some chat\n<!-- preserve -->\nCritical verbatim block\n<!-- /preserve -->\nMore chat",
+            },
+        ];
+        const result = await compressChat(messages, "system", 10000);
+        expect(result.summary).toContain("<!-- preserve -->");
+        expect(result.summary).toContain("Critical verbatim block");
+        expect(result.summary).toContain("<!-- /preserve -->");
+    });
+    it("returns preservedBlocks array", async () => {
+        const messages = [
+            {
+                role: "user",
+                content: "Text\n<!-- preserve -->\nBlock content\n<!-- /preserve -->\nRest",
+            },
+        ];
+        const result = await compressChat(messages, "system", 10000);
+        expect(result.preservedBlocks).toHaveLength(1);
+        expect(result.preservedBlocks[0].content).toBe("\nBlock content\n");
+    });
+    it("returns estimated tokensAfter", async () => {
+        const result = await compressChat(shortMessages, "system prompt", 10000);
+        expect(result.tokensAfter).toBeGreaterThan(0);
+        expect(typeof result.tokensAfter).toBe("number");
+    });
+});
+//# sourceMappingURL=compress.test.js.map

package/dist/flow/compaction/__tests__/compress.test.js.map

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

package/dist/flow/compaction/__tests__/extract.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/flow/compaction/__tests__/extract.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "vitest";
+import { extractDecisions } from "../extract.js";
+describe("extractDecisions", () => {
+    it("extracts Decision: lines from messages", () => {
+        const messages = [
+            { role: "user", content: "Decision: Use JWT for auth" },
+            { role: "assistant", content: "Understood. I'll implement JWT." },
+        ];
+        const result = extractDecisions(messages);
+        expect(result.decisions).toContain("Use JWT for auth");
+    });
+    it("extracts Decided: lines", () => {
+        const messages = [{ role: "user", content: "Decided: Go with PostgreSQL" }];
+        const result = extractDecisions(messages);
+        expect(result.decisions).toContain("Go with PostgreSQL");
+    });
+    it("extracts Fact: lines", () => {
+        const messages = [{ role: "assistant", content: "Fact: The API rate limit is 100 req/min" }];
+        const result = extractDecisions(messages);
+        expect(result.facts).toContain("The API rate limit is 100 req/min");
+    });
+    it("extracts Constraint: lines", () => {
+        const messages = [{ role: "user", content: "Constraint: Must run on Windows and Linux" }];
+        const result = extractDecisions(messages);
+        expect(result.constraints).toContain("Must run on Windows and Linux");
+    });
+    it("extracts content inside preserve blocks as decisions", () => {
+        const messages = [
+            {
+                role: "user",
+                content: "Some text\n<!-- preserve -->\nImportant preserved content\n<!-- /preserve -->\nMore text",
+            },
+        ];
+        const result = extractDecisions(messages);
+        expect(result.decisions).toContain("\nImportant preserved content\n");
+    });
+    it("returns empty arrays for empty messages", () => {
+        const result = extractDecisions([]);
+        expect(result.decisions).toEqual([]);
+        expect(result.facts).toEqual([]);
+        expect(result.constraints).toEqual([]);
+    });
+    it("returns empty arrays when no patterns match", () => {
+        const messages = [
+            { role: "user", content: "Hello, how are you?" },
+            { role: "assistant", content: "I'm doing well!" },
+        ];
+        const result = extractDecisions(messages);
+        expect(result.decisions).toEqual([]);
+        expect(result.facts).toEqual([]);
+        expect(result.constraints).toEqual([]);
+    });
+    it("extracts multiple patterns from a single message", () => {
+        const messages = [
+            {
+                role: "user",
+                content: "Decision: Use TypeScript\nFact: Project uses Bun runtime\nConstraint: No new dependencies",
+            },
+        ];
+        const result = extractDecisions(messages);
+        expect(result.decisions).toContain("Use TypeScript");
+        expect(result.facts).toContain("Project uses Bun runtime");
+        expect(result.constraints).toContain("No new dependencies");
+    });
+});
+//# sourceMappingURL=extract.test.js.map

package/dist/flow/compaction/__tests__/extract.test.js.map

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

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

@@ -0,0 +1 @@
+export {};

package/dist/flow/compaction/__tests__/preserve.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+import { extractPreservedBlocks, PRESERVE_CLOSE, PRESERVE_OPEN, restorePreservedBlocks } from "../preserve.js";
+describe("extractPreservedBlocks", () => {
+    it("extracts single preserve block and replaces with placeholder", () => {
+        const text = `Before\n${PRESERVE_OPEN}\nKeep this verbatim\n${PRESERVE_CLOSE}\nAfter`;
+        const { cleaned, blocks } = extractPreservedBlocks(text);
+        expect(blocks).toHaveLength(1);
+        expect(blocks[0].content).toBe("\nKeep this verbatim\n");
+        expect(cleaned).toContain("__PRESERVED_0__");
+        expect(cleaned).not.toContain(PRESERVE_OPEN);
+        expect(cleaned).not.toContain("Keep this verbatim");
+        expect(cleaned).toContain("Before");
+        expect(cleaned).toContain("After");
+    });
+    it("extracts multiple preserve blocks", () => {
+        const text = `A\n${PRESERVE_OPEN}\nBlock1\n${PRESERVE_CLOSE}\nB\n${PRESERVE_OPEN}\nBlock2\n${PRESERVE_CLOSE}\nC`;
+        const { cleaned, blocks } = extractPreservedBlocks(text);
+        expect(blocks).toHaveLength(2);
+        expect(blocks[0].content).toBe("\nBlock1\n");
+        expect(blocks[1].content).toBe("\nBlock2\n");
+        expect(cleaned).toContain("__PRESERVED_0__");
+        expect(cleaned).toContain("__PRESERVED_1__");
+    });
+    it("returns empty blocks for text without markers", () => {
+        const text = "No markers here";
+        const { cleaned, blocks } = extractPreservedBlocks(text);
+        expect(blocks).toHaveLength(0);
+        expect(cleaned).toBe(text);
+    });
+    it("handles empty text", () => {
+        const { cleaned, blocks } = extractPreservedBlocks("");
+        expect(blocks).toHaveLength(0);
+        expect(cleaned).toBe("");
+    });
+    it("handles malformed markers gracefully (open without close)", () => {
+        const text = `Before\n${PRESERVE_OPEN}\nUnclosed content`;
+        const { cleaned, blocks } = extractPreservedBlocks(text);
+        // Unclosed marker is NOT extracted
+        expect(blocks).toHaveLength(0);
+        expect(cleaned).toBe(text);
+    });
+});
+describe("restorePreservedBlocks", () => {
+    it("round-trips extract + restore", () => {
+        const original = `Start\n${PRESERVE_OPEN}\nVerbatim content\n${PRESERVE_CLOSE}\nEnd`;
+        const { cleaned, blocks } = extractPreservedBlocks(original);
+        const restored = restorePreservedBlocks(cleaned, blocks);
+        expect(restored).toBe(original);
+    });
+    it("restores multiple blocks in order", () => {
+        const original = `A\n${PRESERVE_OPEN}\nFirst\n${PRESERVE_CLOSE}\nB\n${PRESERVE_OPEN}\nSecond\n${PRESERVE_CLOSE}\nC`;
+        const { cleaned, blocks } = extractPreservedBlocks(original);
+        const restored = restorePreservedBlocks(cleaned, blocks);
+        expect(restored).toBe(original);
+    });
+    it("returns text unchanged when no blocks provided", () => {
+        const text = "No placeholders here";
+        const restored = restorePreservedBlocks(text, []);
+        expect(restored).toBe(text);
+    });
+});
+//# sourceMappingURL=preserve.test.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Pass 2: Token-budget chat compression using existing compaction engine.
+ *
+ * Serializes messages, extracts preserved blocks, compresses if over budget,
+ * then restores preserved blocks into the output.
+ */
+import type { ModelMessage } from "ai";
+import { type PreservedBlock } from "./preserve.js";
+export interface CompressResult {
+    summary: string;
+    preservedBlocks: PreservedBlock[];
+    tokensAfter: number;
+}
+/**
+ * Compress chat messages within a token budget.
+ *
+ * 1. Serialize messages via serializeConversation().
+ * 2. Extract preserved blocks.
+ * 3. If under budget, return as-is (with preserved blocks restored).
+ * 4. If over budget, truncate/compress and restore preserved blocks.
+ */
+export declare function compressChat(messages: ModelMessage[], _systemPrompt: string, tokenBudget: number, _provider?: unknown, _modelId?: string): Promise<CompressResult>;

package/dist/flow/compaction/compress.js

@@ -0,0 +1,47 @@
+/**
+ * Pass 2: Token-budget chat compression using existing compaction engine.
+ *
+ * Serializes messages, extracts preserved blocks, compresses if over budget,
+ * then restores preserved blocks into the output.
+ */
+import { serializeConversation } from "../../orchestrator/compaction.js";
+import { extractPreservedBlocks, restorePreservedBlocks } from "./preserve.js";
+/**
+ * Compress chat messages within a token budget.
+ *
+ * 1. Serialize messages via serializeConversation().
+ * 2. Extract preserved blocks.
+ * 3. If under budget, return as-is (with preserved blocks restored).
+ * 4. If over budget, truncate/compress and restore preserved blocks.
+ */
+export async function compressChat(messages, _systemPrompt, tokenBudget, _provider, _modelId) {
+    const serialized = serializeConversation(messages);
+    const { cleaned, blocks } = extractPreservedBlocks(serialized);
+    // Estimate tokens of cleaned text
+    const estimatedTokens = Math.ceil(cleaned.length / 4);
+    if (estimatedTokens <= tokenBudget) {
+        // Under budget — restore preserved blocks and return as-is
+        const restored = restorePreservedBlocks(cleaned, blocks);
+        return {
+            summary: restored,
+            preservedBlocks: blocks,
+            tokensAfter: Math.ceil(restored.length / 4),
+        };
+    }
+    // Over budget — truncate to fit budget while keeping preserved blocks
+    // Calculate space taken by preserved blocks
+    const preservedTokens = blocks.reduce((sum, b) => sum + Math.ceil(b.content.length / 4), 0);
+    const availableTokens = Math.max(0, tokenBudget - preservedTokens);
+    const availableChars = availableTokens * 4;
+    // Truncate the cleaned text to fit
+    const truncated = cleaned.length > availableChars
+        ? `${cleaned.slice(0, availableChars)}\n\n[... ${cleaned.length - availableChars} characters truncated]`
+        : cleaned;
+    const restored = restorePreservedBlocks(truncated, blocks);
+    return {
+        summary: restored,
+        preservedBlocks: blocks,
+        tokensAfter: Math.ceil(restored.length / 4),
+    };
+}
+//# sourceMappingURL=compress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../../src/flow/compaction/compress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAuB,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAQpG;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAwB,EACxB,aAAqB,EACrB,WAAmB,EACnB,SAAmB,EACnB,QAAiB;IAEjB,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE/D,kCAAkC;IAClC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtD,IAAI,eAAe,IAAI,WAAW,EAAE,CAAC;QACnC,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,MAAM;YACvB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,4CAA4C;IAC5C,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,eAAe,GAAG,CAAC,CAAC;IAE3C,mCAAmC;IACnC,MAAM,SAAS,GACb,OAAO,CAAC,MAAM,GAAG,cAAc;QAC7B,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,YAAY,OAAO,CAAC,MAAM,GAAG,cAAc,wBAAwB;QACxG,CAAC,CAAC,OAAO,CAAC;IAEd,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,eAAe,EAAE,MAAM;QACvB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Pass 1: Decision/fact/constraint extraction from messages.
+ *
+ * Deterministic regex-based extraction — no LLM dependency.
+ * Scans for "Decision:", "Decided:", "Fact:", "Constraint:" patterns
+ * and content inside <!-- preserve --> blocks.
+ */
+import type { ModelMessage } from "ai";
+export interface ExtractedDecisions {
+    decisions: string[];
+    facts: string[];
+    constraints: string[];
+}
+/**
+ * Extract decisions, facts, and constraints from messages.
+ *
+ * Scans serialized conversation text for:
+ * - Lines matching "Decision:" or "Decided:" -> decisions
+ * - Lines matching "Fact:" -> facts
+ * - Lines matching "Constraint:" -> constraints
+ * - All content inside <!-- preserve --> blocks -> decisions (verbatim)
+ */
+export declare function extractDecisions(messages: ModelMessage[]): ExtractedDecisions;

package/dist/flow/compaction/extract.js

@@ -0,0 +1,46 @@
+/**
+ * Pass 1: Decision/fact/constraint extraction from messages.
+ *
+ * Deterministic regex-based extraction — no LLM dependency.
+ * Scans for "Decision:", "Decided:", "Fact:", "Constraint:" patterns
+ * and content inside <!-- preserve --> blocks.
+ */
+import { serializeConversation } from "../../orchestrator/compaction.js";
+import { extractPreservedBlocks } from "./preserve.js";
+const DECISION_RE = /(?:Decision|Decided):\s*(.+)/gi;
+const FACT_RE = /Fact:\s*(.+)/gi;
+const CONSTRAINT_RE = /Constraint:\s*(.+)/gi;
+function matchAll(text, re) {
+    const results = [];
+    let match;
+    // Reset lastIndex for safety
+    re.lastIndex = 0;
+    while ((match = re.exec(text)) !== null) {
+        results.push(match[1].trim());
+    }
+    return results;
+}
+/**
+ * Extract decisions, facts, and constraints from messages.
+ *
+ * Scans serialized conversation text for:
+ * - Lines matching "Decision:" or "Decided:" -> decisions
+ * - Lines matching "Fact:" -> facts
+ * - Lines matching "Constraint:" -> constraints
+ * - All content inside <!-- preserve --> blocks -> decisions (verbatim)
+ */
+export function extractDecisions(messages) {
+    if (messages.length === 0) {
+        return { decisions: [], facts: [], constraints: [] };
+    }
+    const serialized = serializeConversation(messages);
+    // Extract preserved blocks as decisions
+    const { blocks } = extractPreservedBlocks(serialized);
+    const preservedDecisions = blocks.map((b) => b.content);
+    // Pattern-match for explicit markers
+    const decisions = [...matchAll(serialized, DECISION_RE), ...preservedDecisions];
+    const facts = matchAll(serialized, FACT_RE);
+    const constraints = matchAll(serialized, CONSTRAINT_RE);
+    return { decisions, facts, constraints };
+}
+//# sourceMappingURL=extract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/flow/compaction/extract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAQvD,MAAM,WAAW,GAAG,gCAAgC,CAAC;AACrD,MAAM,OAAO,GAAG,gBAAgB,CAAC;AACjC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C,SAAS,QAAQ,CAAC,IAAY,EAAE,EAAU;IACxC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAA6B,CAAC;IAClC,6BAA6B;IAC7B,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;IACjB,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAwB;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEnD,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAExD,qCAAqC;IACrC,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,GAAG,kBAAkB,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAExD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC3C,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * 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 type { ModelMessage } from "ai";
+export interface CompactionResult {
+    decisionsExtracted: number;
+    tokensBeforeCompress: number;
+    tokensAfterCompress: number;
+    historyPath: string;
+}
+/**
+ * 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 declare function deliberateCompact(flowDir: string, messages: ModelMessage[], systemPrompt: string, tokenBudget: number, provider?: unknown, modelId?: string): Promise<CompactionResult>;