agent-bober 0.12.0 → 0.17.0

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"}

package/dist/utils/git.js

@@ -62,6 +62,56 @@ export async function hasUncommittedChanges(cwd) {
     });
     return stdout.trim().length > 0;
 }
+/**
+ * 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 async function addWorktree(projectRoot, worktreePath, branch, baseBranch) {
+    const args = ["worktree", "add", worktreePath, "-b", branch];
+    if (baseBranch)
+        args.push(baseBranch);
+    await execa("git", args, { cwd: projectRoot });
+}
+/**
+ * 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 async function removeWorktree(projectRoot, worktreePath, force) {
+    const args = ["worktree", "remove"];
+    if (force)
+        args.push("-f");
+    args.push(worktreePath);
+    await execa("git", args, { cwd: projectRoot, reject: false });
+}
+/**
+ * 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 async function isClean(cwd) {
+    const { stdout } = await execa("git", ["status", "--porcelain"], {
+        cwd,
+        reject: false,
+    });
+    const lines = stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+    if (lines.length === 0) {
+        return { clean: true, dirtyFiles: [] };
+    }
+    // Porcelain format: "XY path" — strip the leading "XY " (3 chars)
+    const dirtyFiles = lines.map((l) => l.slice(3).trim());
+    return { clean: false, dirtyFiles };
+}
 /**
  * Stash any current changes, run the provided function, then restore.
  *

package/dist/utils/git.js.map

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

package/hooks/hooks.json

@@ -1,9 +1,35 @@
 {
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT:-.}/hooks/session-start",
+            "async": false
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Edit|Write",
-        "command": "echo 'Files modified \u2014 run /bober:eval to verify'"
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'Files modified — run /bober:eval to verify'"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT:-.}/scripts/graph-hook.mjs"
+          }
+        ]
       }
     ]
   }

package/hooks/session-start

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# session-start — SessionStart hook for agent-bober
+# Injects the bober.using-bober bootstrap skill into the model's first-turn context.
+#
+# Structural pattern from obra/superpowers (MIT). https://github.com/obra/superpowers
+
+set -euo pipefail
+
+# Determine project root directory
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+# Read bober.using-bober skill content
+using_bober_content=$(cat "${PROJECT_ROOT}/skills/bober.using-bober/SKILL.md" 2>&1 || echo "Error reading bober.using-bober skill")
+
+# Escape string for JSON embedding using bash parameter substitution.
+# Each ${s//old/new} is a single C-level pass - orders of magnitude
+# faster than the character-by-character loop this replaces.
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+using_bober_escaped=$(escape_for_json "$using_bober_content")
+session_context="<EXTREMELY_IMPORTANT>\nYou are agent-bober.\n\n**Below is the full content of your 'bober-using-bober' skill - your introduction to using bober skills. For all other skills, use the 'Skill' tool:**\n\n${using_bober_escaped}\n\n</EXTREMELY_IMPORTANT>"
+
+# Output context injection as JSON.
+# Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
+# See: https://github.com/obra/superpowers/issues/571
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+else
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context"
+fi
+
+exit 0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-bober",
-  "version": "0.12.0",
-  "description": "Multi-agent harness for building applications autonomously with any LLM. Researcher, Planner, Curator, Generator, Evaluator pipeline. Supports Claude, GPT, Gemini, Ollama. MCP server for Cursor/Windsurf.",
+  "version": "0.17.0",
+  "description": "Multi-agent harness for building applications autonomously with any LLM. Researcher, Planner, Curator, Generator, Evaluator, Documenter pipeline. Supports Claude, GPT, Gemini, DeepSeek, Ollama, and Claude Code subscriptions. MCP server for Cursor/Windsurf.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,6 +14,8 @@
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
+    "update-all": "node scripts/update-all.mjs",
+    "update-all:check": "node scripts/update-all.mjs --check",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -28,6 +30,7 @@
     "claude",
     "openai",
     "gemini",
+    "deepseek",
     "ollama",
     "plugin"
   ],
@@ -57,7 +60,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
+    "@anthropic-ai/sdk": "^0.100.1",
     "@modelcontextprotocol/sdk": "^1.28.0",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
@@ -65,11 +68,13 @@
     "glob": "^11.0.1",
     "ora": "^8.1.1",
     "prompts": "^2.4.2",
-    "zod": "^3.24.2"
+    "semver": "^7.8.1",
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.25.2"
   },
   "peerDependencies": {
     "@google/generative-ai": ">=0.21.0",
-    "openai": ">=4.0.0"
+    "openai": "^6.42.0"
   },
   "peerDependenciesMeta": {
     "openai": {
@@ -83,9 +88,11 @@
     "@eslint/js": "^10.0.1",
     "@types/node": "^22.13.0",
     "@types/prompts": "^2.4.9",
+    "@types/semver": "^7.7.1",
     "@typescript-eslint/eslint-plugin": "^8.22.0",
     "@typescript-eslint/parser": "^8.22.0",
-    "eslint": "^9.19.0",
+    "eslint": "^10.0.0",
+    "markdownlint-cli": "^0.48.0",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"
   }

package/scripts/check-prereqs.sh

@@ -54,6 +54,18 @@ else
   add_check "{\"name\":\"bober_dir\",\"status\":\"missing\",\"path\":\".bober/\",\"message\":\"No .bober/ directory. Run /bober-plan first.\"}"
 fi
 
+# ── Optional check: tokensave (only if installed) ─────────────────
+if command -v agent-bober &>/dev/null; then
+  ts_json=$(agent-bober graph check-prereq 2>/dev/null || echo '{"ok":false,"reason":"MISSING","hint":"agent-bober graph check-prereq failed"}')
+  # Normalize to the {name,status} shape used by other checks
+  if echo "$ts_json" | grep -q '"ok":true'; then
+    add_check "{\"name\":\"tokensave\",\"status\":\"ok\",\"detail\":$ts_json}"
+  else
+    # Tokensave missing is NOT a hard blocker for any current command — emit info-only
+    CHECKS+=("{\"name\":\"tokensave\",\"status\":\"optional\",\"detail\":$ts_json}")
+  fi
+fi
+
 # ── Command-specific checks ───────────────────────────────────────
 
 case "$COMMAND" in