agent-bober 0.12.0 → 0.15.0

package/dist/state/approval-state.d.ts

@@ -0,0 +1,74 @@
+export interface PendingMarker {
+    checkpointId: string;
+    runId?: string;
+    artifact: {
+        type?: string;
+        path?: string;
+        summary?: string;
+        lines?: number;
+    };
+    prompt: string;
+    requestedAt: string;
+    timeoutAt: string;
+}
+export interface ApprovedMarker {
+    approvedAt: string;
+    approverId: string;
+    editDelta?: unknown;
+}
+export interface RejectedMarker {
+    rejectedAt: string;
+    rejecterId: string;
+    feedback: string;
+}
+/**
+ * Write a pending approval marker to disk.
+ */
+export declare function savePending(projectRoot: string, m: PendingMarker): Promise<void>;
+/**
+ * Read a pending approval marker from disk. Returns null if not found.
+ */
+export declare function readPending(projectRoot: string, id: string): Promise<PendingMarker | null>;
+/**
+ * List all pending approval markers.
+ */
+export declare function listPending(projectRoot: string): Promise<PendingMarker[]>;
+/**
+ * Write an approved marker to disk.
+ */
+export declare function saveApproved(projectRoot: string, id: string, m: ApprovedMarker): Promise<void>;
+/**
+ * Write a rejected marker to disk.
+ */
+export declare function saveRejected(projectRoot: string, id: string, m: RejectedMarker): Promise<void>;
+/**
+ * Delete a pending marker from disk (after resolution). Best-effort — does not throw.
+ */
+export declare function deletePending(projectRoot: string, id: string): Promise<void>;
+/**
+ * Check whether a pending marker exists for the given checkpoint id.
+ */
+export declare function pendingExists(projectRoot: string, id: string): Promise<boolean>;
+/**
+ * Cockpit-shape pending row — what both the CLI (--json) and the MCP
+ * tool bober_list_pending_approvals should return.
+ */
+export interface PendingApprovalRow {
+    checkpointId: string;
+    ageMs: number;
+    prompt: string;
+}
+/**
+ * List all pending checkpoints in cockpit-row shape.
+ *
+ * Mirrors the row-builder loop in src/cli/commands/list-approvals.ts
+ * but lives in state/ so both the CLI and the MCP tool can share it.
+ * Reads .bober/approvals/*.pending.json.
+ *
+ * Behavior:
+ * - Missing approvals dir → returns [].
+ * - Corrupted JSON files → skipped silently (matches CLI behavior).
+ * - ageMs = Date.now() - Date.parse(requestedAt).
+ */
+export declare function listPendingApprovals(projectRoot: string): Promise<PendingApprovalRow[]>;
+//# sourceMappingURL=approval-state.d.ts.map

package/dist/state/approval-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-state.d.ts","sourceRoot":"","sources":["../../src/state/approval-state.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,CAAC,EAAE,aAAa,GACf,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAqB/E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,cAAc,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,cAAc,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0B/B"}

package/dist/state/approval-state.js

@@ -0,0 +1,127 @@
+import { readFile, writeFile, readdir, unlink, access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const APPROVAL_DIR = ".bober/approvals";
+function approvalsDir(projectRoot) {
+    return join(projectRoot, APPROVAL_DIR);
+}
+function pendingPath(projectRoot, id) {
+    return join(approvalsDir(projectRoot), `${id}.pending.json`);
+}
+function approvedPath(projectRoot, id) {
+    return join(approvalsDir(projectRoot), `${id}.approved.json`);
+}
+function rejectedPath(projectRoot, id) {
+    return join(approvalsDir(projectRoot), `${id}.rejected.json`);
+}
+/**
+ * Write a pending approval marker to disk.
+ */
+export async function savePending(projectRoot, m) {
+    await ensureDir(approvalsDir(projectRoot));
+    await writeFile(pendingPath(projectRoot, m.checkpointId), JSON.stringify(m, null, 2) + "\n", "utf-8");
+}
+/**
+ * Read a pending approval marker from disk. Returns null if not found.
+ */
+export async function readPending(projectRoot, id) {
+    try {
+        return JSON.parse(await readFile(pendingPath(projectRoot, id), "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all pending approval markers.
+ */
+export async function listPending(projectRoot) {
+    let entries;
+    try {
+        entries = await readdir(approvalsDir(projectRoot));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const f of entries.filter((x) => x.endsWith(".pending.json"))) {
+        try {
+            out.push(JSON.parse(await readFile(join(approvalsDir(projectRoot), f), "utf-8")));
+        }
+        catch {
+            // skip corrupted files
+        }
+    }
+    return out;
+}
+/**
+ * Write an approved marker to disk.
+ */
+export async function saveApproved(projectRoot, id, m) {
+    await ensureDir(approvalsDir(projectRoot));
+    await writeFile(approvedPath(projectRoot, id), JSON.stringify(m, null, 2) + "\n", "utf-8");
+}
+/**
+ * Write a rejected marker to disk.
+ */
+export async function saveRejected(projectRoot, id, m) {
+    await ensureDir(approvalsDir(projectRoot));
+    await writeFile(rejectedPath(projectRoot, id), JSON.stringify(m, null, 2) + "\n", "utf-8");
+}
+/**
+ * Delete a pending marker from disk (after resolution). Best-effort — does not throw.
+ */
+export async function deletePending(projectRoot, id) {
+    await unlink(pendingPath(projectRoot, id)).catch(() => { });
+}
+/**
+ * Check whether a pending marker exists for the given checkpoint id.
+ */
+export async function pendingExists(projectRoot, id) {
+    try {
+        await access(pendingPath(projectRoot, id), constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all pending checkpoints in cockpit-row shape.
+ *
+ * Mirrors the row-builder loop in src/cli/commands/list-approvals.ts
+ * but lives in state/ so both the CLI and the MCP tool can share it.
+ * Reads .bober/approvals/*.pending.json.
+ *
+ * Behavior:
+ * - Missing approvals dir → returns [].
+ * - Corrupted JSON files → skipped silently (matches CLI behavior).
+ * - ageMs = Date.now() - Date.parse(requestedAt).
+ */
+export async function listPendingApprovals(projectRoot) {
+    let entries;
+    try {
+        entries = await readdir(approvalsDir(projectRoot));
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const f of entries.filter((x) => x.endsWith(".pending.json"))) {
+        try {
+            const raw = await readFile(join(approvalsDir(projectRoot), f), "utf-8");
+            const parsed = JSON.parse(raw);
+            rows.push({
+                checkpointId: parsed.checkpointId,
+                ageMs: Date.now() - Date.parse(parsed.requestedAt),
+                prompt: parsed.prompt,
+            });
+        }
+        catch {
+            // skip corrupted files
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=approval-state.js.map

package/dist/state/approval-state.js.map

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

package/dist/state/index.d.ts

@@ -6,6 +6,9 @@ export { saveDesign, readDesign, } from "./design-state.js";
 export { saveOutline, readOutline, } from "./outline-state.js";
 export { saveArchitecture, readArchitecture, saveADR, readADRs, listArchitectures, } from "./architect-state.js";
 export { saveBriefing, readBriefing, listBriefings, } from "./briefing-state.js";
+export { saveReview, readReview, listReviews, } from "./review-state.js";
+export { savePending, readPending, listPending, listPendingApprovals, saveApproved, saveRejected, deletePending, pendingExists, type PendingMarker, type ApprovedMarker, type RejectedMarker, type PendingApprovalRow, } from "./approval-state.js";
+export { writeRunState, readRunState, listRunStateFiles, readRunStatesFromDisk, } from "./run-state.js";
 /**
  * Ensure the `.bober/` directory and all required subdirectories exist,
  * including the `research/` subdirectory for research documents.

package/dist/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,WAAW,EACX,kBAAkB,EAElB,KAAK,KAAK,EACV,KAAK,YAAY,EAEjB,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC;AAK7B;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,WAAW,EACX,kBAAkB,EAElB,KAAK,KAAK,EACV,KAAK,YAAY,EAEjB,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAKxB;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE"}

package/dist/state/index.js

@@ -12,8 +12,11 @@ export { saveDesign, readDesign, } from "./design-state.js";
 export { saveOutline, readOutline, } from "./outline-state.js";
 export { saveArchitecture, readArchitecture, saveADR, readADRs, listArchitectures, } from "./architect-state.js";
 export { saveBriefing, readBriefing, listBriefings, } from "./briefing-state.js";
+export { saveReview, readReview, listReviews, } from "./review-state.js";
+export { savePending, readPending, listPending, listPendingApprovals, saveApproved, saveRejected, deletePending, pendingExists, } from "./approval-state.js";
+export { writeRunState, readRunState, listRunStateFiles, readRunStatesFromDisk, } from "./run-state.js";
 const BOBER_DIR = ".bober";
-const SUBDIRS = ["contracts", "specs", "research", "designs", "outlines", "architecture", "briefings"];
+const SUBDIRS = ["contracts", "specs", "research", "designs", "outlines", "architecture", "briefings", "reviews", "approvals", "runs", "audits"];
 /**
  * Ensure the `.bober/` directory and all required subdirectories exist,
  * including the `research/` subdirectory for research documents.

package/dist/state/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,cAAc;AACd,WAAW,EACX,kBAAkB;AAIlB,YAAY;AACZ,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAEhH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,cAAc;AACd,WAAW,EACX,kBAAkB;AAIlB,YAAY;AACZ,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE1J;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/state/review-state.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Save a sprint review markdown file to disk.
+ * Uses mkdir -p semantics (idempotent). Overwrites any existing review for the same contract.
+ */
+export declare function saveReview(projectRoot: string, contractId: string, content: string): Promise<void>;
+/**
+ * Read a sprint review by contract ID.
+ * Returns null if not found (reviews may not exist for all sprints).
+ */
+export declare function readReview(projectRoot: string, contractId: string): Promise<string | null>;
+/**
+ * List all saved review contract IDs, sorted by filename.
+ */
+export declare function listReviews(projectRoot: string): Promise<string[]>;
+//# sourceMappingURL=review-state.d.ts.map

package/dist/state/review-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../src/state/review-state.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcxE"}

package/dist/state/review-state.js

@@ -0,0 +1,51 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+const REVIEW_DIR = ".bober/reviews";
+function reviewDir(projectRoot) {
+    return join(projectRoot, REVIEW_DIR);
+}
+function reviewPath(projectRoot, contractId) {
+    const safeId = contractId.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return join(reviewDir(projectRoot), `${safeId}-review.md`);
+}
+/**
+ * Save a sprint review markdown file to disk.
+ * Uses mkdir -p semantics (idempotent). Overwrites any existing review for the same contract.
+ */
+export async function saveReview(projectRoot, contractId, content) {
+    await ensureDir(reviewDir(projectRoot));
+    const filePath = reviewPath(projectRoot, contractId);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Read a sprint review by contract ID.
+ * Returns null if not found (reviews may not exist for all sprints).
+ */
+export async function readReview(projectRoot, contractId) {
+    const filePath = reviewPath(projectRoot, contractId);
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all saved review contract IDs, sorted by filename.
+ */
+export async function listReviews(projectRoot) {
+    const dir = reviewDir(projectRoot);
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((f) => f.endsWith("-review.md"))
+        .sort()
+        .map((f) => f.slice(0, -("-review.md".length)));
+}
+//# sourceMappingURL=review-state.js.map

package/dist/state/review-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-state.js","sourceRoot":"","sources":["../../src/state/review-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,SAAS,SAAS,CAAC,WAAmB;IACpC,OAAO,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,UAAkB;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,UAAkB,EAClB,OAAe;IAEf,MAAM,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,UAAkB;IAElB,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEnC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;SACvC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/state/run-state.d.ts

@@ -0,0 +1,39 @@
+import type { RunState } from "../mcp/run-manager.js";
+/**
+ * Atomically write a RunState to .bober/runs/<runId>/state.json
+ * via a temp-file + rename to prevent partial-write corruption.
+ *
+ * Uses process.pid + Date.now() in the temp filename to avoid collisions
+ * when multiple writes to the same runId race (e.g. concurrent progress
+ * updates in tests).
+ */
+export declare function writeRunState(projectRoot: string, state: RunState): Promise<void>;
+/**
+ * Read a RunState from disk. Returns null if the file does not exist
+ * or contains invalid JSON — never throws.
+ */
+export declare function readRunState(projectRoot: string, runId: string): Promise<RunState | null>;
+/**
+ * Enumerate all RunState files under .bober/runs/.
+ *
+ * Returns an empty array if the directory does not exist.
+ * Silently skips any entry whose state.json is missing or malformed.
+ */
+export declare function listRunStateFiles(projectRoot: string): Promise<RunState[]>;
+/**
+ * Cross-project read-only RunState enumeration for the cockpit
+ * discovery tools (get-project-state, list-projects).
+ *
+ * UNLIKE the RunManager-backed APIs, this helper does NOT use the
+ * in-memory singleton — it always walks .bober/runs/<runId>/state.json
+ * on the supplied projectRoot. The discovery tools call it with
+ * arbitrary projectPath values; we cannot assume RunManager has been
+ * load()'d for that root.
+ *
+ * Implementation: delegates to listRunStateFiles. Provided as a named
+ * alias because:
+ *   1. It documents the cockpit intent (cross-project, read-only).
+ *   2. Future call sites can filter without touching listRunStateFiles.
+ */
+export declare function readRunStatesFromDisk(projectRoot: string): Promise<RunState[]>;
+//# sourceMappingURL=run-state.d.ts.map

package/dist/state/run-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/state/run-state.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkBtD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvF;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAO/F;AAID;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAehF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB"}

package/dist/state/run-state.js

@@ -0,0 +1,101 @@
+// ── run-state.ts ─────────────────────────────────────────────────────
+//
+// Disk-persistence helpers for RunState objects.
+//
+// Layout: .bober/runs/<runId>/state.json
+//
+// Every write is atomic via temp-file + rename
+// (mirrors src/incident/timeline.ts:86-92 atomicWriteJson pattern).
+import { readFile, writeFile, readdir, rename } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+import { ensureDir } from "./helpers.js";
+// ── Path helpers ─────────────────────────────────────────────────────
+function runsRoot(projectRoot) {
+    return join(projectRoot, ".bober", "runs");
+}
+function runDir(projectRoot, runId) {
+    return join(runsRoot(projectRoot), runId);
+}
+function statePath(projectRoot, runId) {
+    return join(runDir(projectRoot, runId), "state.json");
+}
+// ── Atomic write ─────────────────────────────────────────────────────
+/**
+ * Atomically write a RunState to .bober/runs/<runId>/state.json
+ * via a temp-file + rename to prevent partial-write corruption.
+ *
+ * Uses process.pid + Date.now() in the temp filename to avoid collisions
+ * when multiple writes to the same runId race (e.g. concurrent progress
+ * updates in tests).
+ */
+export async function writeRunState(projectRoot, state) {
+    await ensureDir(runDir(projectRoot, state.runId));
+    const filePath = statePath(projectRoot, state.runId);
+    // Include a random hex suffix to avoid collisions when two writes
+    // for the same runId race within the same millisecond (same pid + timestamp).
+    const rnd = randomBytes(4).toString("hex");
+    const tmp = `${filePath}.${process.pid}.${Date.now()}.${rnd}.tmp`;
+    await writeFile(tmp, JSON.stringify(state, null, 2) + "\n", {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+    await rename(tmp, filePath);
+}
+// ── Read ─────────────────────────────────────────────────────────────
+/**
+ * Read a RunState from disk. Returns null if the file does not exist
+ * or contains invalid JSON — never throws.
+ */
+export async function readRunState(projectRoot, runId) {
+    try {
+        const raw = await readFile(statePath(projectRoot, runId), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ── List ─────────────────────────────────────────────────────────────
+/**
+ * Enumerate all RunState files under .bober/runs/.
+ *
+ * Returns an empty array if the directory does not exist.
+ * Silently skips any entry whose state.json is missing or malformed.
+ */
+export async function listRunStateFiles(projectRoot) {
+    let entries;
+    try {
+        entries = await readdir(runsRoot(projectRoot));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const id of entries) {
+        const s = await readRunState(projectRoot, id);
+        if (s)
+            out.push(s);
+        // malformed / missing state.json → skip silently
+    }
+    return out;
+}
+/**
+ * Cross-project read-only RunState enumeration for the cockpit
+ * discovery tools (get-project-state, list-projects).
+ *
+ * UNLIKE the RunManager-backed APIs, this helper does NOT use the
+ * in-memory singleton — it always walks .bober/runs/<runId>/state.json
+ * on the supplied projectRoot. The discovery tools call it with
+ * arbitrary projectPath values; we cannot assume RunManager has been
+ * load()'d for that root.
+ *
+ * Implementation: delegates to listRunStateFiles. Provided as a named
+ * alias because:
+ *   1. It documents the cockpit intent (cross-project, read-only).
+ *   2. Future call sites can filter without touching listRunStateFiles.
+ */
+export async function readRunStatesFromDisk(projectRoot) {
+    return listRunStateFiles(projectRoot);
+}
+//# sourceMappingURL=run-state.js.map

package/dist/state/run-state.js.map

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

package/dist/telemetry/emit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Opt-in local-only telemetry event emitter (Sprint 28).
+ *
+ * When config.telemetry.enabled === true, appends one newline-terminated JSON
+ * line to .bober/telemetry/<YYYY-MM-DD>.jsonl. When disabled (default), emit()
+ * is a no-op and performs ZERO file IO.
+ *
+ * File is created with mode 0600 on first append via fs.open(O_WRONLY|O_APPEND|
+ * O_CREAT). Mirrors the Sprint 13 audit pattern verbatim (see audit.ts:86 for
+ * the rationale on why fs.appendFile is NOT used).
+ *
+ * NETWORK EGRESS: forbidden by design. No import of node:http, node:https,
+ * node:net, node:tls, undici, or fetch — enforced by ESLint no-restricted-imports
+ * rule scoped to src/telemetry/** in eslint.config.js.
+ *
+ * PRIVACY: event payloads MUST be IDs / counts / enum outcomes only. NEVER pass
+ * user-content strings (feedbackText, prompts, file contents, MCP response
+ * bodies). Reviewers grep `emit(` across src/ to enforce this discipline.
+ *
+ * Sprint 28 — src/telemetry/emit.ts
+ */
+import type { BoberConfig } from "../config/schema.js";
+export type TelemetryEventType = "checkpoint-approved" | "checkpoint-rejected" | "checkpoint-edited" | "sprint-pass" | "sprint-fail-retry" | "incident-resolved" | "incident-aborted" | "agent-spawn" | "agent-error";
+/** Allowed payload fields. NO string values from user input. */
+export interface TelemetryEventData {
+    runId?: string;
+    incidentId?: string;
+    specId?: string;
+    sprintId?: string;
+    contractId?: string;
+    agentName?: string;
+    checkpointId?: string;
+    iteration?: number;
+    durationMs?: number;
+    outcome?: string;
+    retryCount?: number;
+    errorKind?: string;
+}
+/** Emit a telemetry event. No-op when telemetry.enabled !== true. */
+export declare function emit(projectRoot: string, config: BoberConfig, eventType: TelemetryEventType, data?: TelemetryEventData): Promise<void>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/telemetry/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/telemetry/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,MAAM,kBAAkB,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,aAAa,GACb,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,GACb,aAAa,CAAC;AAElB,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,qEAAqE;AACrE,wBAAsB,IAAI,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,kBAAkB,EAC7B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/telemetry/emit.js

@@ -0,0 +1,65 @@
+/**
+ * Opt-in local-only telemetry event emitter (Sprint 28).
+ *
+ * When config.telemetry.enabled === true, appends one newline-terminated JSON
+ * line to .bober/telemetry/<YYYY-MM-DD>.jsonl. When disabled (default), emit()
+ * is a no-op and performs ZERO file IO.
+ *
+ * File is created with mode 0600 on first append via fs.open(O_WRONLY|O_APPEND|
+ * O_CREAT). Mirrors the Sprint 13 audit pattern verbatim (see audit.ts:86 for
+ * the rationale on why fs.appendFile is NOT used).
+ *
+ * NETWORK EGRESS: forbidden by design. No import of node:http, node:https,
+ * node:net, node:tls, undici, or fetch — enforced by ESLint no-restricted-imports
+ * rule scoped to src/telemetry/** in eslint.config.js.
+ *
+ * PRIVACY: event payloads MUST be IDs / counts / enum outcomes only. NEVER pass
+ * user-content strings (feedbackText, prompts, file contents, MCP response
+ * bodies). Reviewers grep `emit(` across src/ to enforce this discipline.
+ *
+ * Sprint 28 — src/telemetry/emit.ts
+ */
+import { open, mkdir } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+import { logger } from "../utils/logger.js";
+const writeChain = new Map();
+function telemetryDir(projectRoot) {
+    return join(projectRoot, ".bober", "telemetry");
+}
+function telemetryPath(projectRoot) {
+    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    return join(telemetryDir(projectRoot), `${date}.jsonl`);
+}
+/** Emit a telemetry event. No-op when telemetry.enabled !== true. */
+export async function emit(projectRoot, config, eventType, data = {}) {
+    if (config.telemetry?.enabled !== true)
+        return;
+    const event = {
+        timestamp: new Date().toISOString(),
+        eventType,
+        ...data,
+    };
+    const filePath = telemetryPath(projectRoot);
+    const prev = writeChain.get(filePath) ?? Promise.resolve();
+    const next = prev
+        .then(async () => {
+        await mkdir(telemetryDir(projectRoot), { recursive: true });
+        const flags = constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT;
+        const fh = await open(filePath, flags, 0o600);
+        try {
+            // Guarantee mode 0600 even if umask would have reduced it.
+            await fh.chmod(0o600);
+            await fh.write(JSON.stringify(event) + "\n");
+        }
+        finally {
+            await fh.close();
+        }
+    })
+        .catch((err) => {
+        logger.warn(`[telemetry] Failed to emit ${eventType}: ${err instanceof Error ? err.message : String(err)}`);
+    });
+    writeChain.set(filePath, next);
+    return next;
+}
+//# sourceMappingURL=emit.js.map

package/dist/telemetry/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/telemetry/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6B5C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEpD,SAAS,YAAY,CAAC,WAAmB;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,WAAmB;IACxC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IACjE,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,WAAmB,EACnB,MAAmB,EACnB,SAA6B,EAC7B,OAA2B,EAAE;IAE7B,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI;QAAE,OAAO;IAE/C,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;QACT,GAAG,IAAI;KACR,CAAC;IAEF,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI;SACd,IAAI,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;QAC1E,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,2DAA2D;YAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,MAAM,CAAC,IAAI,CACT,8BAA8B,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/git.d.ts

@@ -26,6 +26,33 @@ export declare function getDiff(cwd: string, since?: string): Promise<string>;
  * Check whether the working tree has uncommitted changes (staged or unstaged).
  */
 export declare function hasUncommittedChanges(cwd: string): Promise<boolean>;
+/**
+ * Add a new git worktree at the given path on a new branch.
+ *
+ * Shells out to: git worktree add <path> -b <branch> [<baseBranch>]
+ * Throws on non-zero exit (a failed worktree-add must surface as an error).
+ */
+export declare function addWorktree(projectRoot: string, worktreePath: string, branch: string, baseBranch?: string): Promise<void>;
+/**
+ * Remove a git worktree by path.
+ *
+ * Shells out to: git worktree remove [-f] <path>
+ * Uses reject: false so that removing a worktree that no longer exists
+ * does not crash cleanup paths.
+ */
+export declare function removeWorktree(projectRoot: string, worktreePath: string, force?: boolean): Promise<void>;
+/**
+ * Check whether the working tree is clean (no staged or unstaged changes).
+ *
+ * Returns { clean: true, dirtyFiles: [] } when the tree is clean.
+ * Returns { clean: false, dirtyFiles: [...] } listing each dirty path
+ * (parsed from `git status --porcelain` — columns 0-1 are the XY status
+ * codes, column 2 is a space, then the path starts at column 3).
+ */
+export declare function isClean(cwd: string): Promise<{
+    clean: boolean;
+    dirtyFiles: string[];
+}>;
 /**
  * Stash any current changes, run the provided function, then restore.
  *

package/dist/utils/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAenD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}