mewkit 1.7.1 → 1.8.0

package/dist/orchviz/plan/__tests__/list-plans.test.js

@@ -0,0 +1,154 @@
+/**
+ * Unit tests for list-plans.ts — listPlans().
+ *
+ * Coverage:
+ *   - 3-plan fixture: returns all non-archived plans
+ *   - Archived plan is filtered out
+ *   - Sorted by plan.md mtimeMs descending
+ *   - limit cap respected
+ *   - Boundary rejection (symlink outside plansDir)
+ *   - Missing tasks/plans/ returns []
+ *   - Invalid slug name rejected (not returned)
+ */
+import { describe, expect, it, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { listPlans } from "../list-plans.js";
+let tmpDir = null;
+afterEach(() => {
+    if (tmpDir) {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+        tmpDir = null;
+    }
+});
+function makeProjectRoot() {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "list-plans-test-"));
+    const root = tmpDir;
+    const plansDir = path.join(root, "tasks", "plans");
+    fs.mkdirSync(plansDir, { recursive: true });
+    return { root, plansDir };
+}
+function writePlanDir(plansDir, slug, opts = {}) {
+    const dir = path.join(plansDir, slug);
+    fs.mkdirSync(dir, { recursive: true });
+    const status = opts.status ?? "draft";
+    const title = opts.title ?? `Plan ${slug}`;
+    const frontmatter = [
+        "---",
+        `title: "${title}"`,
+        `status: ${status}`,
+        `created: "${opts.created ?? "260501"}"`,
+        `effort: "${opts.effort ?? "m"}"`,
+        "---",
+        "",
+        `# ${title}`,
+    ].join("\n");
+    fs.writeFileSync(path.join(dir, "plan.md"), frontmatter, "utf-8");
+    for (let i = 1; i <= (opts.phaseCount ?? 0); i++) {
+        fs.writeFileSync(path.join(dir, `phase-0${i}-step.md`), `# Phase ${i}\n\n## Todo List\n\n- [ ] Do something\n`, "utf-8");
+    }
+    return dir;
+}
+describe("listPlans", () => {
+    it("returns [] when tasks/plans/ does not exist", () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "list-plans-no-dir-"));
+        const result = listPlans(tmpDir);
+        expect(result).toEqual([]);
+    });
+    it("returns all non-archived plans", () => {
+        const { root, plansDir } = makeProjectRoot();
+        writePlanDir(plansDir, "260501-alpha", { status: "draft" });
+        writePlanDir(plansDir, "260501-beta", { status: "in_progress" });
+        writePlanDir(plansDir, "260501-gamma", { status: "active" });
+        const result = listPlans(root);
+        expect(result).toHaveLength(3);
+        const slugs = result.map((p) => p.slug);
+        expect(slugs).toContain("260501-alpha");
+        expect(slugs).toContain("260501-beta");
+        expect(slugs).toContain("260501-gamma");
+    });
+    it("filters out archived plans", () => {
+        const { root, plansDir } = makeProjectRoot();
+        writePlanDir(plansDir, "260501-active", { status: "draft" });
+        writePlanDir(plansDir, "260501-archived", { status: "archived" });
+        const result = listPlans(root);
+        expect(result).toHaveLength(1);
+        expect(result[0].slug).toBe("260501-active");
+    });
+    it("sorts by plan.md mtimeMs descending", () => {
+        const { root, plansDir } = makeProjectRoot();
+        const dirA = writePlanDir(plansDir, "260501-first", { status: "draft" });
+        // Small delay or touch to ensure different mtime
+        const dirB = writePlanDir(plansDir, "260501-second", { status: "draft" });
+        // Touch the first plan so it becomes most recent
+        const now = new Date();
+        fs.utimesSync(path.join(dirA, "plan.md"), now, new Date(Date.now() + 2000));
+        // We need the second plan to have an older mtime — set it explicitly in the past
+        const past = new Date(Date.now() - 10000);
+        fs.utimesSync(path.join(dirB, "plan.md"), past, past);
+        const result = listPlans(root);
+        expect(result).toHaveLength(2);
+        expect(result[0].slug).toBe("260501-first");
+        expect(result[1].slug).toBe("260501-second");
+        // Confirm descending order
+        expect(result[0].mtimeMs).toBeGreaterThan(result[1].mtimeMs);
+    });
+    it("respects the limit option", () => {
+        const { root, plansDir } = makeProjectRoot();
+        writePlanDir(plansDir, "260501-plan-a", { status: "draft" });
+        writePlanDir(plansDir, "260501-plan-b", { status: "draft" });
+        writePlanDir(plansDir, "260501-plan-c", { status: "active" });
+        const result = listPlans(root, { limit: 2 });
+        expect(result).toHaveLength(2);
+    });
+    it("includes phaseCount from phase-NN-*.md files", () => {
+        const { root, plansDir } = makeProjectRoot();
+        writePlanDir(plansDir, "260501-three-phases", { status: "draft", phaseCount: 3 });
+        const result = listPlans(root);
+        expect(result).toHaveLength(1);
+        expect(result[0].phaseCount).toBe(3);
+    });
+    it("returns slug, title, status, created, effort fields", () => {
+        const { root, plansDir } = makeProjectRoot();
+        writePlanDir(plansDir, "260501-full-fields", {
+            title: "My Test Plan",
+            status: "active",
+            created: "260501",
+            effort: "l",
+        });
+        const result = listPlans(root);
+        expect(result).toHaveLength(1);
+        const plan = result[0];
+        expect(plan.slug).toBe("260501-full-fields");
+        expect(plan.title).toBe("My Test Plan");
+        expect(plan.status).toBe("active");
+        expect(plan.created).toBe("260501");
+        expect(plan.effort).toBe("l");
+        expect(typeof plan.mtimeMs).toBe("number");
+    });
+    it("rejects symlinks pointing outside the boundary", () => {
+        const { root, plansDir } = makeProjectRoot();
+        // Create a valid plan for baseline
+        writePlanDir(plansDir, "260501-legit", { status: "draft" });
+        // Create a symlink that points to a temp dir outside the boundary
+        const outsideDir = fs.mkdtempSync(path.join(os.tmpdir(), "outside-boundary-"));
+        // Write a valid plan.md in outside dir so it would pass other checks
+        fs.writeFileSync(path.join(outsideDir, "plan.md"), "---\ntitle: Sneaky\nstatus: active\n---\n");
+        const symlinkPath = path.join(plansDir, "evil-symlink");
+        try {
+            fs.symlinkSync(outsideDir, symlinkPath);
+        }
+        catch {
+            // If symlink creation fails (e.g., Windows restrictions), skip boundary test
+            return;
+        }
+        const result = listPlans(root);
+        const slugs = result.map((p) => p.slug);
+        // The symlink plan should be rejected by realpath boundary check
+        expect(slugs).not.toContain("evil-symlink");
+        // The legit plan should still be present
+        expect(slugs).toContain("260501-legit");
+    });
+});
+//# sourceMappingURL=list-plans.test.js.map

package/dist/orchviz/plan/__tests__/list-plans.test.js.map

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

package/dist/orchviz/plan/apply-todo-toggle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * apply-todo-toggle — pure function that flips a single checkbox marker
+ * inside the ## Todo List section of a phase file's content string.
+ *
+ * Contract:
+ *   - No fs, no http, no side effects. Pure transformation only.
+ *   - Mirrors extractTodos fence-aware walk exactly (per red-team C1).
+ *   - CRLF preserved: majority-EOL detection applied to full content.
+ *   - Idempotent: marker already matches desired → {changed: false}.
+ *   - Error tags are static strings, NEVER interpolated content (R2-14).
+ */
+/** Static error tags returned when applyTodoToggle cannot apply the flip. */
+export type TodoToggleErrorTag = "section-missing" | "out-of-range" | "fence-overflow";
+export type TodoToggleResult = {
+    content: string;
+    changed: boolean;
+} | {
+    error: TodoToggleErrorTag;
+};
+/**
+ * Flip the Nth (0-based) checkbox marker in ## Todo List section.
+ *
+ * Fence-aware walk matches extractTodos in parse-phase-file.ts exactly:
+ *   - Lines matching /^```/ toggle fenceDepth 0→1 or 1→0.
+ *   - Checkbox lines inside fences (fenceDepth > 0) are skipped/not counted.
+ *   - Only `^phase-` regex used in server, NOT here — caller decides glob.
+ */
+export declare function applyTodoToggle(content: string, todoIdx: number, checked: boolean): TodoToggleResult;
+//# sourceMappingURL=apply-todo-toggle.d.ts.map

package/dist/orchviz/plan/apply-todo-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-todo-toggle.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/apply-todo-toggle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC3B,iBAAiB,GACjB,cAAc,GACd,gBAAgB,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAyBjC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACd,gBAAgB,CAqGlB"}

package/dist/orchviz/plan/apply-todo-toggle.js

@@ -0,0 +1,129 @@
+/**
+ * apply-todo-toggle — pure function that flips a single checkbox marker
+ * inside the ## Todo List section of a phase file's content string.
+ *
+ * Contract:
+ *   - No fs, no http, no side effects. Pure transformation only.
+ *   - Mirrors extractTodos fence-aware walk exactly (per red-team C1).
+ *   - CRLF preserved: majority-EOL detection applied to full content.
+ *   - Idempotent: marker already matches desired → {changed: false}.
+ *   - Error tags are static strings, NEVER interpolated content (R2-14).
+ */
+const TODO_RE = /^(\s*-\s*\[)(\s|x|X|~|✓)(\]\s+.+?)\s*$/;
+const FENCE_RE = /^```/;
+/**
+ * Detect the dominant line ending character.
+ * Returns "\r\n" if CRLF count > LF-only count, else "\n".
+ */
+function detectEol(content) {
+    const crlfCount = (content.match(/\r\n/g) ?? []).length;
+    const lfCount = (content.match(/(?<!\r)\n/g) ?? []).length;
+    // Detect mixed-EOL (meaningful mix: both > 0 and neither dominates by 2:1)
+    if (crlfCount > 0 && lfCount > 0) {
+        // Accept minor contamination (≤20% minority) as "effectively uniform"
+        const total = crlfCount + lfCount;
+        const minority = Math.min(crlfCount, lfCount);
+        if (minority / total > 0.2) {
+            // Genuinely mixed — caller may want to warn, but we proceed with majority
+            // and let the eol-mixed error tag be used if the caller needs it.
+        }
+    }
+    return crlfCount >= lfCount ? "\r\n" : "\n";
+}
+/**
+ * Flip the Nth (0-based) checkbox marker in ## Todo List section.
+ *
+ * Fence-aware walk matches extractTodos in parse-phase-file.ts exactly:
+ *   - Lines matching /^```/ toggle fenceDepth 0→1 or 1→0.
+ *   - Checkbox lines inside fences (fenceDepth > 0) are skipped/not counted.
+ *   - Only `^phase-` regex used in server, NOT here — caller decides glob.
+ */
+export function applyTodoToggle(content, todoIdx, checked) {
+    // Split preserving original EOL on each line for later reassembly.
+    // We split on \n and check if each line ends with \r (for CRLF lines).
+    const eol = detectEol(content);
+    // Split into raw lines (without any EOL); we'll reassemble with detected eol.
+    // Handle CRLF: split on \n, strip trailing \r from each line for processing,
+    // then reattach the correct EOL on reassembly.
+    const rawLines = content.split("\n");
+    const lines = rawLines.map((l) => (l.endsWith("\r") ? l.slice(0, -1) : l));
+    // Locate ## Todo List section start
+    const todoSectionRe = /^##\s+Todo\s+List\s*$/i;
+    const nextSectionRe = /^##?\s/;
+    let sectionStart = -1;
+    let sectionEnd = lines.length;
+    for (let i = 0; i < lines.length; i++) {
+        if (todoSectionRe.test(lines[i])) {
+            sectionStart = i + 1;
+            continue;
+        }
+        if (sectionStart !== -1 && i > sectionStart && nextSectionRe.test(lines[i])) {
+            sectionEnd = i;
+            break;
+        }
+    }
+    if (sectionStart === -1) {
+        return { error: "section-missing" };
+    }
+    // Walk todo section with fence tracker (must match extractTodos exactly)
+    let fenceDepth = 0;
+    let count = 0;
+    let targetLineIdx = -1;
+    for (let i = sectionStart; i < sectionEnd; i++) {
+        const line = lines[i];
+        if (FENCE_RE.test(line)) {
+            fenceDepth = fenceDepth === 0 ? 1 : 0;
+            continue;
+        }
+        if (fenceDepth > 0)
+            continue;
+        const m = line.match(TODO_RE);
+        if (!m)
+            continue;
+        if (count === todoIdx) {
+            targetLineIdx = i;
+            break;
+        }
+        count++;
+    }
+    // Fence depth not closed: error (malformed doc)
+    if (fenceDepth > 0) {
+        return { error: "fence-overflow" };
+    }
+    if (targetLineIdx === -1) {
+        return { error: "out-of-range" };
+    }
+    // Check idempotency: does current marker already match desired state?
+    const m = lines[targetLineIdx].match(TODO_RE);
+    if (!m) {
+        // Shouldn't happen since we matched above, but guard defensively
+        return { error: "out-of-range" };
+    }
+    const currentMarker = m[2];
+    const currentChecked = currentMarker !== " " && currentMarker !== "";
+    if (currentChecked === checked) {
+        // Already in desired state — idempotent no-op
+        return { content, changed: false };
+    }
+    // Flip: replace marker char
+    const newMarker = checked ? "x" : " ";
+    const newLine = m[1] + newMarker + m[3];
+    lines[targetLineIdx] = newLine;
+    // Reassemble with original EOL type
+    // If original was CRLF, rawLines had \r on each line; we stripped them above.
+    // Now rebuild: join with detected EOL. Last line may or may not have trailing EOL.
+    const hasTrailingNewline = content.endsWith("\n") || content.endsWith("\r\n");
+    let newContent;
+    if (eol === "\r\n") {
+        newContent = lines.join("\r\n");
+    }
+    else {
+        newContent = lines.join("\n");
+    }
+    // Preserve trailing newline if original had one
+    if (hasTrailingNewline && !newContent.endsWith("\n")) {
+        newContent += eol;
+    }
+    return { content: newContent, changed: true };
+}
+//# sourceMappingURL=apply-todo-toggle.js.map

package/dist/orchviz/plan/apply-todo-toggle.js.map

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

package/dist/orchviz/plan/atomic-write.d.ts

@@ -0,0 +1,25 @@
+/**
+ * atomic-write — same-dir tmp + renameSync for crash-safe file writes.
+ *
+ * Security: tmp filename uses .orchviz-tmp- prefix so phase-glob regex
+ * (/^phase-0*N-.*\.md$/i) never matches orphaned temps (R2-1, R2-13).
+ *
+ * Reliability:
+ *   - renameSync is atomic on POSIX (same filesystem guaranteed by same-dir tmp).
+ *   - Windows EPERM (file open in another process) → single 50ms retry.
+ *   - try/finally unlinks tmp on every error path — no orphan on throw.
+ *
+ * Orphan cleanup: cleanOrphanedTmps(planDir) removes .orchviz-tmp-* files
+ * older than 5 minutes. Called on first write per slug (R2-13).
+ */
+/**
+ * Write `content` to `targetPath` atomically via a same-directory temp file.
+ * Throws on persistent failure (after Windows EPERM retry).
+ */
+export declare function atomicWriteFileSync(targetPath: string, content: string): void;
+/**
+ * Remove .orchviz-tmp-* files older than ORPHAN_AGE_MS in planDir.
+ * Silently skips if dir doesn't exist or entry stat fails (R2-13).
+ */
+export declare function cleanOrphanedTmps(planDir: string): void;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/orchviz/plan/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6B7E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAoBvD"}

package/dist/orchviz/plan/atomic-write.js

@@ -0,0 +1,85 @@
+/**
+ * atomic-write — same-dir tmp + renameSync for crash-safe file writes.
+ *
+ * Security: tmp filename uses .orchviz-tmp- prefix so phase-glob regex
+ * (/^phase-0*N-.*\.md$/i) never matches orphaned temps (R2-1, R2-13).
+ *
+ * Reliability:
+ *   - renameSync is atomic on POSIX (same filesystem guaranteed by same-dir tmp).
+ *   - Windows EPERM (file open in another process) → single 50ms retry.
+ *   - try/finally unlinks tmp on every error path — no orphan on throw.
+ *
+ * Orphan cleanup: cleanOrphanedTmps(planDir) removes .orchviz-tmp-* files
+ * older than 5 minutes. Called on first write per slug (R2-13).
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+const TMP_PREFIX = ".orchviz-tmp-";
+const ORPHAN_AGE_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Write `content` to `targetPath` atomically via a same-directory temp file.
+ * Throws on persistent failure (after Windows EPERM retry).
+ */
+export function atomicWriteFileSync(targetPath, content) {
+    const dir = path.dirname(targetPath);
+    const rand = crypto.randomBytes(6).toString("hex");
+    const tmpPath = path.join(dir, `${TMP_PREFIX}${rand}`);
+    fs.writeFileSync(tmpPath, content, "utf-8");
+    try {
+        try {
+            fs.renameSync(tmpPath, targetPath);
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === "EPERM") {
+                // Windows: file may be open in another process. Single 50ms retry.
+                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50);
+                fs.renameSync(tmpPath, targetPath);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    catch (err) {
+        // Clean up tmp on any rename failure
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            // Best-effort; suppress secondary error
+        }
+        throw err;
+    }
+    // renameSync succeeded — tmp no longer exists (renamed to target), nothing to unlink.
+}
+/**
+ * Remove .orchviz-tmp-* files older than ORPHAN_AGE_MS in planDir.
+ * Silently skips if dir doesn't exist or entry stat fails (R2-13).
+ */
+export function cleanOrphanedTmps(planDir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(planDir);
+    }
+    catch {
+        return;
+    }
+    const now = Date.now();
+    for (const name of entries) {
+        if (!name.startsWith(TMP_PREFIX))
+            continue;
+        const fullPath = path.join(planDir, name);
+        try {
+            const stat = fs.statSync(fullPath);
+            if (now - stat.mtimeMs > ORPHAN_AGE_MS) {
+                fs.unlinkSync(fullPath);
+            }
+        }
+        catch {
+            // Skip — file may already be gone or inaccessible
+        }
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/orchviz/plan/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/orchviz/plan/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,UAAU,GAAG,eAAe,CAAC;AACnC,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAEjD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,OAAe;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC,CAAC;IAEvD,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC;QACJ,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,GAA4B,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACxB,mEAAmE;gBACnE,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACP,MAAM,GAAG,CAAC;YACX,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,qCAAqC;QACrC,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACR,wCAAwC;QACzC,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;IACD,sFAAsF;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAChD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACJ,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;IACR,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,aAAa,EAAE,CAAC;gBACxC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,kDAAkD;QACnD,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/orchviz/plan/collector.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PlanCollector — read the active plan (or a slug-targeted plan) with mtime-keyed cache.
+ *
+ * Per red-team H3 (orchviz redesign): cache key is `(planDirMtime, max(phaseFileMtime))`.
+ * Cache invalidates the moment any plan file is touched on disk — no stale window.
+ * A 60s time-based fallback exists for paranoia (e.g., filesystems with broken mtime).
+ *
+ * Per R2-3: cache is plain Map<string, CacheEntry> keyed by slug-or-"__active".
+ * Soft-reset if map.size > 50. NO LRU, NO 16-entry cap, NO evict-oldest.
+ *
+ * Per R2-8: PlanSnapshot shape includes phaseEtags (not etag) and error tag.
+ * Read-only is the default behavior. Set MEOWKIT_ORCHVIZ_WRITABLE=1 to opt
+ * into write mode. Legacy MEOWKIT_ORCHVIZ_READONLY=0 continues to enable
+ * writes for backwards compatibility with existing user setups.
+ */
+import type { PlanState } from "./types.js";
+/**
+ * Read-only is the default. Precedence (highest first):
+ *   1. MEOWKIT_ORCHVIZ_READONLY=1   forces readonly (defensive lock)
+ *   2. MEOWKIT_ORCHVIZ_WRITABLE=1   opts into writes (preferred opt-in)
+ *   3. MEOWKIT_ORCHVIZ_READONLY=0   opts into writes (legacy compat)
+ *   4. otherwise                   readonly
+ */
+export declare function isOrchvizReadonly(): boolean;
+/** Error tags for PlanSnapshot failure cases (R2-8). */
+export type PlanSnapshotError = "invalid-slug" | "forbidden-path" | "not-found";
+export interface PlanSnapshot {
+    plan: PlanState | null;
+    /** Per-phase etags keyed by phase number. null on error. */
+    phaseEtags: Record<number, string> | null;
+    /** Whether the server is in read-only mode (default true; see isOrchvizReadonly). */
+    readonly: boolean;
+    generatedAt: string;
+    error?: PlanSnapshotError;
+}
+export declare class PlanCollector {
+    private readonly projectRoot;
+    private readonly cache;
+    /** Cached `realpathSync(plansDir)` — constant per-projectRoot, avoids syscall per slug poll. */
+    private resolvedPlansDir;
+    constructor(projectRoot: string);
+    snapshot(slug?: string): PlanSnapshot;
+    private snapshotActive;
+    private snapshotBySlug;
+    /** Soft-reset the cache if it grows too large, then insert the new entry (R2-3). */
+    private writeCache;
+    invalidate(): void;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/orchviz/plan/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1C,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAQD,qBAAa,aAAa;IAKb,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,gGAAgG;IAChG,OAAO,CAAC,gBAAgB,CAAuB;gBAElB,WAAW,EAAE,MAAM;IAEhD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAUrC,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,cAAc;IA2FtB,oFAAoF;IACpF,OAAO,CAAC,UAAU;IAYlB,UAAU,IAAI,IAAI;CAIlB"}