mewkit 1.7.0 → 1.8.0

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

@@ -0,0 +1,148 @@
+/**
+ * listPlans — enumerate all non-archived plan dirs in tasks/plans/.
+ *
+ * Per red-team SEC#6: realpath boundary check is applied to EVERY subdir before
+ * any file inside is read. This mirrors the check in findActivePlan.
+ *
+ * Returns up to `limit` (default 100) PlanSummary objects sorted by plan.md
+ * mtimeMs descending (most recently modified first).
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { FRONTMATTER_RE, PHASE_FILE_RE, SLUG_RE } from "./plan-constants.js";
+const DEFAULT_LIMIT = 100;
+const VALID_PLAN_STATUSES = new Set([
+    "draft",
+    "in_progress",
+    "active",
+    "completed",
+    "archived",
+    "blocked",
+    "unknown",
+]);
+function normalizePlanStatus(raw) {
+    if (typeof raw !== "string")
+        return "unknown";
+    const lower = raw.toLowerCase().replace(/[-\s]+/g, "_").trim();
+    if (VALID_PLAN_STATUSES.has(lower))
+        return lower;
+    return "unknown";
+}
+function parsePlanFrontmatter(planFile) {
+    let raw;
+    try {
+        raw = fs.readFileSync(planFile, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const slug = path.basename(path.dirname(planFile));
+    const fmMatch = raw.match(FRONTMATTER_RE);
+    if (!fmMatch) {
+        return { title: slug, status: "unknown", created: "", effort: "?" };
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(fmMatch[1], { schema: yaml.FAILSAFE_SCHEMA });
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object") {
+        return { title: slug, status: "unknown", created: "", effort: "?" };
+    }
+    const obj = parsed;
+    const status = normalizePlanStatus(obj.status);
+    const title = typeof obj.title === "string" ? obj.title : slug;
+    const created = typeof obj.created === "string"
+        ? obj.created
+        : typeof obj.created === "number"
+            ? String(obj.created)
+            : "";
+    const effort = typeof obj.effort === "string"
+        ? obj.effort
+        : typeof obj.effort === "number"
+            ? String(obj.effort)
+            : "?";
+    return { title, status, created, effort };
+}
+/**
+ * List all non-archived plans in projectRoot/tasks/plans/.
+ * Each candidate subdir is realpath-checked against the boundary before read.
+ */
+export function listPlans(projectRoot, opts = {}) {
+    const limit = opts.limit ?? DEFAULT_LIMIT;
+    const plansDir = path.join(projectRoot, "tasks", "plans");
+    let resolvedPlansDir;
+    try {
+        resolvedPlansDir = fs.realpathSync(plansDir);
+    }
+    catch {
+        return [];
+    }
+    const boundary = resolvedPlansDir + path.sep;
+    let entries;
+    try {
+        entries = fs.readdirSync(plansDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (!SLUG_RE.test(entry.name))
+            continue;
+        const dir = path.join(plansDir, entry.name);
+        let resolved;
+        try {
+            resolved = fs.realpathSync(dir);
+        }
+        catch {
+            continue;
+        }
+        if (!(resolved + path.sep).startsWith(boundary))
+            continue;
+        // One readdir per plan dir — covers both phase-count and (later, if needed)
+        // any other phase-aware checks. Avoids a second readdirSync.
+        let dirEntries;
+        try {
+            dirEntries = fs.readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        if (!dirEntries.includes("plan.md"))
+            continue;
+        const planFile = path.join(dir, "plan.md");
+        let planStat;
+        try {
+            planStat = fs.statSync(planFile);
+        }
+        catch {
+            continue;
+        }
+        if (!planStat.isFile())
+            continue;
+        const fm = parsePlanFrontmatter(planFile);
+        if (!fm)
+            continue;
+        if (fm.status === "archived")
+            continue;
+        const phaseCount = dirEntries.filter((name) => PHASE_FILE_RE.test(name)).length;
+        results.push({
+            slug: entry.name,
+            title: fm.title,
+            status: fm.status,
+            created: fm.created,
+            effort: fm.effort,
+            mtimeMs: planStat.mtimeMs,
+            phaseCount,
+        });
+    }
+    results.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return results.slice(0, limit);
+}
+//# sourceMappingURL=list-plans.js.map

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

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

package/dist/orchviz/plan/parse-phase-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * parse-phase-file — extract status + todos + metadata from a phase-NN-*.md file.
+ *
+ * Per red-team H1: status extraction tries 3 sources (frontmatter, permissive
+ * regex against `## Overview`, lowercase scan) before falling back to "unknown"
+ * — never silently coerce to "pending".
+ *
+ * Per red-team C1: caller is responsible for boundary checks before this runs.
+ * Per red-team M2: frontmatter regex tolerates `\r\n`.
+ */
+import type { PhaseState } from "./types.js";
+export declare function parsePhaseFile(filePath: string): PhaseState | null;
+//# sourceMappingURL=parse-phase-file.d.ts.map

package/dist/orchviz/plan/parse-phase-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-phase-file.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/parse-phase-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAC;AA2BpE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgElE"}

package/dist/orchviz/plan/parse-phase-file.js

@@ -0,0 +1,136 @@
+/**
+ * parse-phase-file — extract status + todos + metadata from a phase-NN-*.md file.
+ *
+ * Per red-team H1: status extraction tries 3 sources (frontmatter, permissive
+ * regex against `## Overview`, lowercase scan) before falling back to "unknown"
+ * — never silently coerce to "pending".
+ *
+ * Per red-team C1: caller is responsible for boundary checks before this runs.
+ * Per red-team M2: frontmatter regex tolerates `\r\n`.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { FRONTMATTER_RE } from "./plan-constants.js";
+const STATUS_BOLD_RE = /\*+\s*Status\s*:?\s*\*+\s*([A-Za-z_-]+)/i;
+const STATUS_PLAIN_RE = /\bstatus\s*:\s*([a-z_-]+)/i;
+const TODO_RE = /^\s*-\s*\[(\s|x|X|~|✓)\]\s+(.+?)\s*$/;
+const PHASE_NUM_RE = /^phase-(\d+)/;
+const HEADING_RE = /^#\s+Phase\s+\d+\s*[:.\-—]?\s*(.+?)\s*$/im;
+const VALID_STATUSES = new Set([
+    "pending",
+    "active",
+    "in_progress",
+    "completed",
+    "failed",
+    "abandoned",
+    "unknown",
+]);
+function normalizeStatus(raw) {
+    const lower = raw.toLowerCase().replace(/\s+/g, "_");
+    if (VALID_STATUSES.has(lower))
+        return lower;
+    if (lower === "in-progress")
+        return "in_progress";
+    if (lower === "done")
+        return "completed";
+    return "unknown";
+}
+export function parsePhaseFile(filePath) {
+    const fileName = path.basename(filePath);
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const numMatch = fileName.match(PHASE_NUM_RE);
+    const number = numMatch ? parseInt(numMatch[1], 10) : 0;
+    const abandonedFromName = fileName.toUpperCase().includes("ABANDONED");
+    let frontmatter = {};
+    const fmMatch = raw.match(FRONTMATTER_RE);
+    if (fmMatch) {
+        try {
+            const parsed = yaml.load(fmMatch[1], { schema: yaml.FAILSAFE_SCHEMA });
+            if (parsed && typeof parsed === "object") {
+                frontmatter = parsed;
+            }
+        }
+        catch {
+            /* malformed frontmatter; treat as absent */
+        }
+    }
+    const fmStatus = typeof frontmatter.status === "string" ? frontmatter.status.toLowerCase() : null;
+    const abandoned = abandonedFromName || fmStatus === "abandoned";
+    let status = "unknown";
+    if (abandoned) {
+        status = "abandoned";
+    }
+    else if (fmStatus) {
+        status = normalizeStatus(fmStatus);
+    }
+    else {
+        const boldMatch = raw.match(STATUS_BOLD_RE);
+        if (boldMatch) {
+            status = normalizeStatus(boldMatch[1]);
+        }
+        else {
+            const plainMatch = raw.match(STATUS_PLAIN_RE);
+            if (plainMatch)
+                status = normalizeStatus(plainMatch[1]);
+        }
+    }
+    const headingMatch = raw.match(HEADING_RE);
+    const title = headingMatch ? headingMatch[1].trim() : fileName.replace(/\.md$/, "");
+    const effort = typeof frontmatter.effort === "string"
+        ? frontmatter.effort
+        : extractEffort(raw) ?? "?";
+    const todos = extractTodos(raw);
+    return {
+        number,
+        title,
+        status,
+        effort,
+        todos,
+        filePath,
+        abandoned,
+    };
+}
+function extractEffort(raw) {
+    const match = raw.match(/\*+\s*Effort\s*:?\s*\*+\s*([^\n*]+?)\s*(?:\(|$)/im);
+    return match ? match[1].trim() : null;
+}
+/**
+ * Extract todos from the ## Todo List section.
+ *
+ * Per red-team C1: tracks ``` fence depth and skips checkbox lines inside
+ * fenced code blocks. This makes the reader's todoIdx consistent with the
+ * writer's applyTodoToggle walk (Phase 2). Reader and writer use the SAME
+ * counting logic — only checkboxes OUTSIDE fences are counted.
+ */
+function extractTodos(raw) {
+    const todoSection = raw.match(/##\s+Todo\s+List\s*\n([\s\S]*?)(?=\n##\s|\n#\s|$)/i);
+    if (!todoSection)
+        return [];
+    const out = [];
+    let fenceDepth = 0;
+    for (const line of todoSection[1].split(/\r?\n/)) {
+        if (/^```/.test(line)) {
+            fenceDepth = fenceDepth === 0 ? 1 : 0;
+            continue;
+        }
+        if (fenceDepth > 0)
+            continue;
+        const m = line.match(TODO_RE);
+        if (!m)
+            continue;
+        const marker = m[1];
+        const text = m[2].trim();
+        if (!text)
+            continue;
+        out.push({ checked: marker !== " " && marker !== "", text });
+    }
+    return out;
+}
+//# sourceMappingURL=parse-phase-file.js.map

package/dist/orchviz/plan/parse-phase-file.js.map

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

package/dist/orchviz/plan/parse-plan-file.d.ts

@@ -0,0 +1,19 @@
+/**
+ * parse-plan-file — read plan.md frontmatter into a PlanState scaffold.
+ *
+ * Per red-team M2: frontmatter regex tolerates `\r\n` (Windows checkouts).
+ * Per red-team C1: caller is responsible for boundary checks before this runs.
+ */
+import type { PlanState } from "./types.js";
+export interface PlanScaffold {
+    slug: string;
+    title: string;
+    status: string;
+    effort: string;
+    created: string;
+    path: string;
+}
+export declare function parsePlanFile(planDir: string): PlanScaffold | null;
+/** Combine a scaffold + parsed phases into a PlanState. */
+export declare function buildPlanState(scaffold: PlanScaffold, phases: PlanState["phases"]): PlanState;
+//# sourceMappingURL=parse-plan-file.d.ts.map

package/dist/orchviz/plan/parse-plan-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-plan-file.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/parse-plan-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAUD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAsClE;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE7F"}

package/dist/orchviz/plan/parse-plan-file.js

@@ -0,0 +1,62 @@
+/**
+ * parse-plan-file — read plan.md frontmatter into a PlanState scaffold.
+ *
+ * Per red-team M2: frontmatter regex tolerates `\r\n` (Windows checkouts).
+ * Per red-team C1: caller is responsible for boundary checks before this runs.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { FRONTMATTER_RE } from "./plan-constants.js";
+function asString(v, fallback = "") {
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number")
+        return String(v);
+    return fallback;
+}
+export function parsePlanFile(planDir) {
+    const planFile = path.join(planDir, "plan.md");
+    let raw;
+    try {
+        raw = fs.readFileSync(planFile, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const slug = path.basename(planDir);
+    const fmMatch = raw.match(FRONTMATTER_RE);
+    if (!fmMatch) {
+        return {
+            slug,
+            title: slug,
+            status: "unknown",
+            effort: "?",
+            created: "",
+            path: planDir,
+        };
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(fmMatch[1], { schema: yaml.FAILSAFE_SCHEMA });
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const obj = parsed;
+    return {
+        slug,
+        title: asString(obj.title, slug),
+        status: asString(obj.status, "unknown"),
+        effort: asString(obj.effort, "?"),
+        created: asString(obj.created, ""),
+        path: planDir,
+    };
+}
+/** Combine a scaffold + parsed phases into a PlanState. */
+export function buildPlanState(scaffold, phases) {
+    return { ...scaffold, phases };
+}
+//# sourceMappingURL=parse-plan-file.js.map

package/dist/orchviz/plan/parse-plan-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-plan-file.js","sourceRoot":"","sources":["../../../src/orchviz/plan/parse-plan-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,IAAI,MAAM,SAAS,CAAC;AAY3B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,SAAS,QAAQ,CAAC,CAAU,EAAE,QAAQ,GAAG,EAAE;IAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO;YACN,IAAI;YACJ,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,OAAO;SACb,CAAC;IACH,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC;QAChC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;QACvC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;QACjC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,EAAE,OAAO;KACb,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,QAAsB,EAAE,MAA2B;IACjF,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC"}

package/dist/orchviz/plan/plan-constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared constants for the plan module — regexes used across multiple
+ * files (parser, collector, listPlans, etag, find-active-plan).
+ *
+ * Single source of truth eliminates drift if naming conventions change.
+ */
+export declare const FRONTMATTER_RE: RegExp;
+export declare const PHASE_FILE_RE: RegExp;
+export declare const PHASE_FILE_NUM_RE: RegExp;
+export declare const SLUG_RE: RegExp;
+/**
+ * Build a regex matching `phase-NN-*.md` for a specific phase number,
+ * tolerating zero-padding (R2-1): phase=1 matches both `phase-01-x.md`
+ * and `phase-1-x.md`. Excludes leading-dot files (orphan tmps).
+ */
+export declare function buildPhaseNumberRe(phase: number): RegExp;
+//# sourceMappingURL=plan-constants.d.ts.map

package/dist/orchviz/plan/plan-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-constants.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/plan-constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,cAAc,QAAgC,CAAC;AAC5D,eAAO,MAAM,aAAa,QAAwB,CAAC;AACnD,eAAO,MAAM,iBAAiB,QAA0B,CAAC;AACzD,eAAO,MAAM,OAAO,QAA0B,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/orchviz/plan/plan-constants.js

@@ -0,0 +1,19 @@
+/**
+ * Shared constants for the plan module — regexes used across multiple
+ * files (parser, collector, listPlans, etag, find-active-plan).
+ *
+ * Single source of truth eliminates drift if naming conventions change.
+ */
+export const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+export const PHASE_FILE_RE = /^phase-\d+-.+\.md$/i;
+export const PHASE_FILE_NUM_RE = /^phase-(\d+)-.+\.md$/i;
+export const SLUG_RE = /^[a-zA-Z0-9_-]{1,80}$/;
+/**
+ * Build a regex matching `phase-NN-*.md` for a specific phase number,
+ * tolerating zero-padding (R2-1): phase=1 matches both `phase-01-x.md`
+ * and `phase-1-x.md`. Excludes leading-dot files (orphan tmps).
+ */
+export function buildPhaseNumberRe(phase) {
+    return new RegExp(`^phase-0*${phase}-.*\\.md$`, "i");
+}
+//# sourceMappingURL=plan-constants.js.map

package/dist/orchviz/plan/plan-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-constants.js","sourceRoot":"","sources":["../../../src/orchviz/plan/plan-constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,uBAAuB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,OAAO,IAAI,MAAM,CAAC,YAAY,KAAK,WAAW,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Plan parser types — describes the shape of an active plan + its phases for
+ * the /api/plan endpoint. Pure data; no logic.
+ */
+export type PhaseStatus = "pending" | "active" | "in_progress" | "completed" | "failed" | "abandoned" | "unknown";
+/**
+ * Plan-level status vocabulary (red-team H3).
+ * Used by listPlans and PlanSummary. "unknown" is the fallback for unrecognized strings.
+ */
+export type PlanStatus = "draft" | "in_progress" | "active" | "completed" | "archived" | "blocked" | "unknown";
+/**
+ * Lightweight summary of a plan — returned by GET /api/plans.
+ * Full plan state (with phases + todos) is returned by GET /api/plan?slug=<slug>.
+ */
+export interface PlanSummary {
+    slug: string;
+    title: string;
+    status: PlanStatus;
+    created: string;
+    effort: string;
+    mtimeMs: number;
+    phaseCount: number;
+}
+export interface TodoItem {
+    checked: boolean;
+    text: string;
+}
+export interface PhaseState {
+    number: number;
+    title: string;
+    status: PhaseStatus;
+    effort: string;
+    todos: TodoItem[];
+    filePath: string;
+    abandoned: boolean;
+}
+export interface PlanState {
+    slug: string;
+    title: string;
+    status: string;
+    effort: string;
+    created: string;
+    phases: PhaseState[];
+    path: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/orchviz/plan/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEb;;;GAGG;AACH,MAAM,MAAM,UAAU,GACnB,OAAO,GACP,aAAa,GACb,QAAQ,GACR,WAAW,GACX,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEb;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACb"}

package/dist/orchviz/plan/types.js

@@ -0,0 +1,6 @@
+/**
+ * Plan parser types — describes the shape of an active plan + its phases for
+ * the /api/plan endpoint. Pure data; no logic.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/orchviz/plan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/orchviz/plan/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/orchviz/protocol.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Agent event protocol — types describing live Claude Code session events.
+ *
+ * Ported (in part) from patoles/agent-flow @ 59ccf4e
+ *   Original: extension/src/protocol.ts
+ *   License:  Apache-2.0 (see ../../NOTICE)
+ *
+ * Modifications: dropped VS Code extension/webview message types;
+ * replaced FSWatcher import path; pruned helper signatures unused server-side.
+ */
+import type { FSWatcher } from "node:fs";
+export type AgentEventType = "agent_spawn" | "agent_complete" | "agent_idle" | "message" | "context_update" | "model_detected" | "tool_call_start" | "tool_call_end" | "subagent_dispatch" | "subagent_return" | "permission_requested" | "error";
+export interface AgentEvent {
+    time: number;
+    type: AgentEventType;
+    payload: Record<string, unknown>;
+    sessionId?: string;
+}
+export interface SessionInfo {
+    id: string;
+    label: string;
+    status: "active" | "completed";
+    startTime: number;
+    lastActivityTime: number;
+}
+export interface TranscriptEntry {
+    sessionId: string;
+    type: string;
+    uuid?: string;
+    message: {
+        role: string;
+        model?: string;
+        content: Array<TranscriptContentBlock> | string;
+    };
+}
+export interface ToolUseBlock {
+    type: "tool_use";
+    name: string;
+    id: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string | Array<{
+        text?: string;
+        type?: string;
+    }>;
+}
+export interface ThinkingBlock {
+    type: "thinking";
+    thinking: string;
+}
+export interface TextBlock {
+    type: "text";
+    text: string;
+}
+export type TranscriptContentBlock = ToolUseBlock | ToolResultBlock | ThinkingBlock | TextBlock | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface AgentEventEmitter {
+    emit(event: AgentEvent, sessionId?: string): void;
+    elapsed(sessionId?: string): number;
+}
+export declare function emitSubagentSpawn(emitter: AgentEventEmitter, parent: string, child: string, task: string, sessionId?: string): void;
+export interface PendingToolCall {
+    name: string;
+    args: string;
+    filePath?: string;
+    startTime: number;
+}
+export interface SubagentState {
+    watcher: FSWatcher | null;
+    fileSize: number;
+    agentName: string;
+    pendingToolCalls: Map<string, PendingToolCall>;
+    seenToolUseIds: Set<string>;
+    permissionTimer: NodeJS.Timeout | null;
+    permissionEmitted: boolean;
+    spawnEmitted: boolean;
+}
+export interface ContextBreakdown {
+    systemPrompt: number;
+    userMessages: number;
+    toolResults: number;
+    reasoning: number;
+    subagentResults: number;
+}
+export interface WatchedSession {
+    sessionId: string;
+    filePath: string;
+    fileWatcher: FSWatcher | null;
+    pollTimer: NodeJS.Timeout | null;
+    fileSize: number;
+    sessionStartTime: number;
+    pendingToolCalls: Map<string, PendingToolCall>;
+    seenToolUseIds: Set<string>;
+    seenMessageHashes: Set<string>;
+    sessionDetected: boolean;
+    sessionCompleted: boolean;
+    lastActivityTime: number;
+    inactivityTimer: NodeJS.Timeout | null;
+    subagentWatchers: Map<string, SubagentState>;
+    spawnedSubagents: Set<string>;
+    inlineProgressAgents: Set<string>;
+    subagentsDirWatcher: FSWatcher | null;
+    subagentsDir: string | null;
+    label: string;
+    labelSet: boolean;
+    model: string | null;
+    permissionTimer: NodeJS.Timeout | null;
+    permissionEmitted: boolean;
+    contextBreakdown: ContextBreakdown;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/orchviz/protocol.d.ts.map

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