agent-bober 0.15.0 → 0.17.0

package/dist/fleet/reporter.d.ts

@@ -0,0 +1,32 @@
+import type { ChildOutcome } from "./types.js";
+export interface PortfolioReport {
+    total: number;
+    completed: number;
+    failed: number;
+    other: number;
+    generatedAt: string;
+    children: ChildOutcome[];
+}
+export declare class PortfolioReporter {
+    /**
+     * Tally a list of ChildOutcome records into a PortfolioReport.
+     *
+     * - completed: status === "completed"
+     * - failed:    status === "failed"
+     * - other:     anything else (running / aborted / unknown)
+     * - generatedAt: ISO-8601 timestamp at call time
+     */
+    build(outcomes: ChildOutcome[]): PortfolioReport;
+    /**
+     * Atomically write the PortfolioReport to <rootDir>/.bober/fleet-report.json.
+     *
+     * Uses temp file + rename to prevent partial-write corruption (mirrors
+     * writeRunState in src/state/run-state.ts).
+     *
+     * This is the ONE place in the fleet subsystem allowed to throw on IO failure.
+     *
+     * @returns The absolute path of the written file.
+     */
+    write(rootDir: string, report: PortfolioReport): Promise<string>;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/dist/fleet/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/fleet/reporter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAID,qBAAa,iBAAiB;IAG5B;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,eAAe;IA2BhD;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBvE"}

package/dist/fleet/reporter.js

@@ -0,0 +1,71 @@
+// ── reporter.ts ───────────────────────────────────────────────────────
+//
+// PortfolioReporter: tally ChildOutcome[] into a PortfolioReport and
+// atomically write it to <rootDir>/.bober/fleet-report.json.
+//
+// Write strategy mirrors writeRunState in src/state/run-state.ts:
+// temp file + rename to prevent partial-write corruption.
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join, resolve } from "node:path";
+// ── PortfolioReporter ─────────────────────────────────────────────────
+export class PortfolioReporter {
+    // ── build ───────────────────────────────────────────────────────────
+    /**
+     * Tally a list of ChildOutcome records into a PortfolioReport.
+     *
+     * - completed: status === "completed"
+     * - failed:    status === "failed"
+     * - other:     anything else (running / aborted / unknown)
+     * - generatedAt: ISO-8601 timestamp at call time
+     */
+    build(outcomes) {
+        let completed = 0;
+        let failed = 0;
+        let other = 0;
+        for (const o of outcomes) {
+            if (o.status === "completed") {
+                completed++;
+            }
+            else if (o.status === "failed") {
+                failed++;
+            }
+            else {
+                other++;
+            }
+        }
+        return {
+            total: outcomes.length,
+            completed,
+            failed,
+            other,
+            generatedAt: new Date().toISOString(),
+            children: outcomes,
+        };
+    }
+    // ── write ────────────────────────────────────────────────────────────
+    /**
+     * Atomically write the PortfolioReport to <rootDir>/.bober/fleet-report.json.
+     *
+     * Uses temp file + rename to prevent partial-write corruption (mirrors
+     * writeRunState in src/state/run-state.ts).
+     *
+     * This is the ONE place in the fleet subsystem allowed to throw on IO failure.
+     *
+     * @returns The absolute path of the written file.
+     */
+    async write(rootDir, report) {
+        const dir = resolve(join(rootDir, ".bober"));
+        await mkdir(dir, { recursive: true });
+        const filePath = join(dir, "fleet-report.json");
+        const rnd = randomBytes(4).toString("hex");
+        const tmp = `${filePath}.${process.pid}.${Date.now()}.${rnd}.tmp`;
+        await writeFile(tmp, JSON.stringify(report, null, 2) + "\n", {
+            encoding: "utf-8",
+            mode: 0o600,
+        });
+        await rename(tmp, filePath);
+        return filePath;
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/fleet/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/fleet/reporter.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,qEAAqE;AACrE,6DAA6D;AAC7D,EAAE;AACF,kEAAkE;AAClE,0DAA0D;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAe1C,yEAAyE;AAEzE,MAAM,OAAO,iBAAiB;IAC5B,uEAAuE;IAEvE;;;;;;;OAOG;IACH,KAAK,CAAC,QAAwB;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC7B,SAAS,EAAE,CAAC;YACd,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,SAAS;YACT,MAAM;YACN,KAAK;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,QAAQ,EAAE,QAAQ;SACnB,CAAC;IACJ,CAAC;IAED,wEAAwE;IAExE;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,MAAuB;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;QAElE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE5B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/fleet/runner.d.ts

@@ -0,0 +1,48 @@
+export declare function resolveCliEntry(): string;
+export interface ChildRunSpec {
+    cwd: string;
+    task: string;
+    timeoutMs?: number;
+}
+export interface ChildSpawnResult {
+    cwd: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut?: boolean;
+    spawnError?: string;
+}
+/**
+ * Probe the CLI binary for a successful --version response.
+ * Returns true if the entry file responds with exitCode 0, false otherwise.
+ * Never throws.
+ */
+export declare function probeCliVersion(cliEntry: string): Promise<boolean>;
+export declare class ChildRunner {
+    /**
+     * Optional override for the CLI entry path.
+     * Production code leaves this undefined (defaults to resolveCliEntry()).
+     * Tests inject the stub fixture path via the constructor to avoid
+     * requiring a built dist/cli/index.js during unit testing.
+     */
+    private readonly _cliEntry?;
+    /**
+     * Optional override for the Node.js binary path.
+     * Production code leaves this undefined (defaults to process.execPath).
+     * Tests may inject a bad path to exercise the spawn-failure / ENOENT path.
+     */
+    private readonly _nodeBin?;
+    constructor(options?: {
+        cliEntry?: string;
+        nodeBin?: string;
+    });
+    /**
+     * Spawn one `agent-bober run <task>` child process in spec.cwd.
+     * Uses process.execPath (the current Node binary) + the parent's own
+     * dist/cli/index.js — never a bare PATH lookup.
+     *
+     * Never throws: spawn errors are captured in spawnError.
+     */
+    run(spec: ChildRunSpec): Promise<ChildSpawnResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/fleet/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/fleet/runner.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUxE;AAID,qBAAa,WAAW;IACtB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IAEpC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAK7D;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmDzD"}

package/dist/fleet/runner.js

@@ -0,0 +1,104 @@
+import { execa } from "execa";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+// ── Entry resolution (ADR-4) ─────────────────────────────────────────
+// At runtime this file is dist/fleet/runner.js → CLI is dist/cli/index.js.
+// From dirname(runner.js) = dist/fleet, go ".." to dist, then "cli/index.js".
+export function resolveCliEntry() {
+    const here = dirname(fileURLToPath(import.meta.url)); // dist/fleet
+    return join(here, "..", "cli", "index.js"); // dist/cli/index.js
+}
+// ── Constants ────────────────────────────────────────────────────────
+const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+const MAX_BUFFER = 10 * 1024 * 1024; // 10 MiB
+// ── Version probe (ADR-4) ────────────────────────────────────────────
+/**
+ * Probe the CLI binary for a successful --version response.
+ * Returns true if the entry file responds with exitCode 0, false otherwise.
+ * Never throws.
+ */
+export async function probeCliVersion(cliEntry) {
+    try {
+        const r = await execa(process.execPath, [cliEntry, "--version"], {
+            reject: false,
+            timeout: 5_000,
+        });
+        return r.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Runner ───────────────────────────────────────────────────────────
+export class ChildRunner {
+    /**
+     * Optional override for the CLI entry path.
+     * Production code leaves this undefined (defaults to resolveCliEntry()).
+     * Tests inject the stub fixture path via the constructor to avoid
+     * requiring a built dist/cli/index.js during unit testing.
+     */
+    _cliEntry;
+    /**
+     * Optional override for the Node.js binary path.
+     * Production code leaves this undefined (defaults to process.execPath).
+     * Tests may inject a bad path to exercise the spawn-failure / ENOENT path.
+     */
+    _nodeBin;
+    constructor(options) {
+        this._cliEntry = options?.cliEntry;
+        this._nodeBin = options?.nodeBin;
+    }
+    /**
+     * Spawn one `agent-bober run <task>` child process in spec.cwd.
+     * Uses process.execPath (the current Node binary) + the parent's own
+     * dist/cli/index.js — never a bare PATH lookup.
+     *
+     * Never throws: spawn errors are captured in spawnError.
+     */
+    async run(spec) {
+        const cliEntry = this._cliEntry ?? resolveCliEntry();
+        const nodeBin = this._nodeBin ?? process.execPath;
+        const timeout = spec.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        try {
+            const result = await execa(nodeBin, [cliEntry, "run", spec.task], {
+                cwd: spec.cwd,
+                reject: false,
+                timeout,
+                maxBuffer: MAX_BUFFER,
+            });
+            // With reject:false, execa resolves even on spawn-level failures (e.g. ENOENT).
+            // Detect a spawn failure by checking whether exitCode is absent and the process
+            // did not actually start (originalMessage contains the spawn error details).
+            if (result.exitCode === undefined && result.failed && result.originalMessage) {
+                return {
+                    cwd: spec.cwd,
+                    exitCode: null,
+                    stdout: result.stdout ?? "",
+                    stderr: result.stderr ?? "",
+                    spawnError: result.originalMessage,
+                };
+            }
+            const spawnResult = {
+                cwd: spec.cwd,
+                exitCode: result.exitCode ?? null,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            };
+            if (result.timedOut) {
+                spawnResult.timedOut = true;
+            }
+            return spawnResult;
+        }
+        catch (err) {
+            // Fallback: if execa throws despite reject:false (older execa versions)
+            return {
+                cwd: spec.cwd,
+                exitCode: null,
+                stdout: "",
+                stderr: "",
+                spawnError: err.message,
+            };
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/fleet/runner.js.map

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

package/dist/fleet/scaffolder.d.ts

@@ -0,0 +1,12 @@
+import type { FleetChild } from "./manifest.js";
+export interface ScaffoldResult {
+    folder: string;
+    absPath: string;
+    configWritten: boolean;
+    gitInitialized: boolean;
+    error?: string;
+}
+export declare class ChildScaffolder {
+    scaffold(rootDir: string, child: FleetChild): Promise<ScaffoldResult>;
+}
+//# sourceMappingURL=scaffolder.d.ts.map

package/dist/fleet/scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../../src/fleet/scaffolder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,eAAe;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;CA0E5E"}

package/dist/fleet/scaffolder.js

@@ -0,0 +1,82 @@
+import { mkdir, writeFile, readdir, stat } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { execa } from "execa";
+import { buildChildConfig } from "./child-config.js";
+// ── Scaffolder ───────────────────────────────────────────────────────
+export class ChildScaffolder {
+    async scaffold(rootDir, child) {
+        const absPath = resolve(rootDir, child.folder);
+        // 1. Non-empty safety check — bail untouched if folder exists and has entries
+        try {
+            const statResult = await stat(absPath);
+            if (statResult.isDirectory()) {
+                const entries = await readdir(absPath);
+                if (entries.length > 0) {
+                    return {
+                        folder: child.folder,
+                        absPath,
+                        configWritten: false,
+                        gitInitialized: false,
+                        error: "folder exists and is non-empty",
+                    };
+                }
+            }
+        }
+        catch {
+            // stat failed → folder does not exist, proceed to create
+        }
+        // 2. Create the directory (recursive so intermediate dirs are made)
+        try {
+            await mkdir(absPath, { recursive: true });
+        }
+        catch (err) {
+            return {
+                folder: child.folder,
+                absPath,
+                configWritten: false,
+                gitInitialized: false,
+                error: `mkdir failed: ${err.message}`,
+            };
+        }
+        // 3. Write bober.config.json using the Zod-valid config from buildChildConfig
+        try {
+            const configJson = JSON.stringify(buildChildConfig(child), null, 2);
+            await writeFile(join(absPath, "bober.config.json"), configJson, "utf-8");
+        }
+        catch (err) {
+            return {
+                folder: child.folder,
+                absPath,
+                configWritten: false,
+                gitInitialized: false,
+                error: `writeFile failed: ${err.message}`,
+            };
+        }
+        // 4. git init — reject:false so a non-zero exit is captured, not thrown
+        let gitInitialized = false;
+        let gitError;
+        try {
+            const gitResult = await execa("git", ["init"], {
+                cwd: absPath,
+                reject: false,
+            });
+            if (gitResult.exitCode === 0) {
+                gitInitialized = true;
+            }
+            else {
+                gitError = `git init exited ${gitResult.exitCode}: ${gitResult.stderr}`;
+            }
+        }
+        catch (err) {
+            gitError = `git init spawn error: ${err.message}`;
+        }
+        return {
+            folder: child.folder,
+            absPath,
+            configWritten: true,
+            gitInitialized,
+            ...(gitError !== undefined ? { error: gitError } : {}),
+        };
+    }
+}
+//# sourceMappingURL=scaffolder.js.map

package/dist/fleet/scaffolder.js.map

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

package/dist/fleet/types.d.ts

@@ -0,0 +1,21 @@
+import type { ScaffoldResult } from "./scaffolder.js";
+import type { ChildSpawnResult } from "./runner.js";
+import type { RunState } from "../mcp/run-manager.js";
+/** Result of fanning one child through scaffold → run. Produced by FleetCoordinator. */
+export interface ChildExecution {
+    folder: string;
+    scaffold: ScaffoldResult;
+    spawn?: ChildSpawnResult;
+}
+export type ChildStatus = "completed" | "failed" | "other";
+export type OutcomeSource = "disk" | "exit-code";
+/** Resolved status for one child, produced by OutcomeAggregator. */
+export interface ChildOutcome {
+    folder: string;
+    status: ChildStatus;
+    source: OutcomeSource;
+    exitCode?: number;
+    runId?: string;
+    runState?: RunState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fleet/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fleet/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAID,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjD,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/fleet/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/fleet/types.js.map

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

package/dist/graph/cli.d.ts

@@ -21,12 +21,16 @@ export declare class TokensaveCli {
     private readonly binary;
     constructor(cwd: string, store?: GraphArtifactStore | null, binary?: string);
     /**
-     * Run `tokensave init --tier <tier>`.
+     * Run `tokensave init` (full index of the project at `cwd`).
+     *
+     * NOTE: tokensave's `init` has no `--tier` flag (that was a pre-6.x API).
+     * `languageTier` is now a bober-level concept recorded in the manifest only,
+     * so it is accepted for caller convenience but NOT forwarded to the binary.
      * Resolves on exit code 0; throws a structured Error on non-zero.
      */
     init(opts: {
         cwd?: string;
-        languageTier: string;
+        languageTier?: string;
     }): Promise<void>;
     /**
      * Run `tokensave sync <paths...>` with a timeout.

package/dist/graph/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/graph/cli.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;GAOG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,kBAAkB,GAAG,IAAW,EACvC,MAAM,GAAE,MAAoB;IAG/C;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE;;;;;;;;OAQG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA6CnE;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;CAkCtC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/graph/cli.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;GAOG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,kBAAkB,GAAG,IAAW,EACvC,MAAM,GAAE,MAAoB;IAG/C;;;;;;;OAOG;IACG,IAAI,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxE;;;;;;;;OAQG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA+CnE;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;CA+CtC"}

package/dist/graph/cli.js

@@ -18,18 +18,28 @@ export class TokensaveCli {
         this.binary = binary;
     }
     /**
-     * Run `tokensave init --tier <tier>`.
+     * Run `tokensave init` (full index of the project at `cwd`).
+     *
+     * NOTE: tokensave's `init` has no `--tier` flag (that was a pre-6.x API).
+     * `languageTier` is now a bober-level concept recorded in the manifest only,
+     * so it is accepted for caller convenience but NOT forwarded to the binary.
      * Resolves on exit code 0; throws a structured Error on non-zero.
      */
     async init(opts) {
         const effectiveCwd = opts.cwd ?? this.cwd;
-        const result = await execa(this.binary, ["init", "--tier", opts.languageTier], {
+        const result = await execa(this.binary, ["init"], {
             cwd: effectiveCwd,
             reject: false,
             all: true,
+            // tokensave prompts to create/gitignore; with no TTY it auto-accepts.
+            input: "",
         });
         if (result.exitCode !== 0) {
             const output = result.all ?? result.stdout ?? result.stderr ?? "";
+            // `init` is idempotent from bober's perspective: an already-initialised
+            // project is a success, not an error (caller refreshes the manifest).
+            if (/already initialized/i.test(output))
+                return;
             throw new Error(`tokensave init failed (exit ${result.exitCode ?? -1}): ${output.slice(0, 500)}`);
         }
     }
@@ -57,8 +67,10 @@ export class TokensaveCli {
             const output = result.all ?? result.stdout ?? result.stderr ?? "";
             throw new Error(`tokensave sync failed (exit ${result.exitCode ?? -1}): ${output.slice(0, 500)}`);
         }
-        const stdout = result.stdout ?? "";
-        const indexed = parseSyncOutput(stdout);
+        // tokensave prints its summary ("N added, M modified, K removed") to
+        // stderr, so parse the combined `all` stream rather than stdout alone.
+        const combined = result.all ?? result.stdout ?? "";
+        const indexed = parseSyncOutput(combined);
         // Update manifest via store if injected
         if (this.store) {
             try {
@@ -101,9 +113,21 @@ export class TokensaveCli {
         }
         try {
             const parsed = JSON.parse(stdout);
+            // tokensave `status --json` returns {node_count, edge_count, file_count,
+            // nodes_by_kind, ...}. There is no `ready`/`indexedFileCount` field and no
+            // version, so derive `ready` from the presence of an index (file_count).
+            // Tolerate the legacy {ready, indexedFileCount, tokensaveVersion} shape too.
+            const fileCount = typeof parsed.file_count === "number"
+                ? parsed.file_count
+                : typeof parsed.indexedFileCount === "number"
+                    ? parsed.indexedFileCount
+                    : 0;
+            const ready = parsed.ready === true ||
+                typeof parsed.file_count === "number" ||
+                typeof parsed.node_count === "number";
             return {
-                ready: parsed.ready === true,
-                indexedFileCount: typeof parsed.indexedFileCount === "number" ? parsed.indexedFileCount : 0,
+                ready,
+                indexedFileCount: fileCount,
                 tokensaveVersion: typeof parsed.tokensaveVersion === "string" ? parsed.tokensaveVersion : "",
             };
         }
@@ -115,14 +139,20 @@ export class TokensaveCli {
 }
 // ── Helpers ────────────────────────────────────────────────────────
 /**
- * Parse `{indexed: N}` from tokensave sync stdout.
- * Accepts both plain JSON and a JSON object embedded in other text.
+ * Parse the number of indexed files from tokensave sync output.
+ *
+ * tokensave 6.x prints a human summary like
+ *   "✔ sync done — 3 added, 1 modified, 0 removed in 41ms"
+ * (with ANSI colour codes), so we sum added + modified. Legacy JSON
+ * (`{"indexed": N}`) and `indexed: N` key-value forms are still accepted.
  */
-function parseSyncOutput(stdout) {
-    const trimmed = stdout.trim();
+function parseSyncOutput(output) {
+    // Strip ANSI escape sequences before matching.
+    // eslint-disable-next-line no-control-regex
+    const trimmed = output.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, "").trim();
     if (!trimmed)
         return 0;
-    // Try direct JSON parse
+    // Try direct JSON parse (legacy shape)
     try {
         const obj = JSON.parse(trimmed);
         if (typeof obj.indexed === "number")
@@ -131,7 +161,18 @@ function parseSyncOutput(stdout) {
     catch {
         // Fall through
     }
-    // Try to extract a number from a key-value pattern like "indexed: 42"
+    // Incremental sync summary: "N added, M modified, K removed"
+    const added = /(\d+)\s+added/.exec(trimmed);
+    const modified = /(\d+)\s+modified/.exec(trimmed);
+    if (added || modified) {
+        return ((added ? parseInt(added[1], 10) : 0) +
+            (modified ? parseInt(modified[1], 10) : 0));
+    }
+    // Full re-index summary (--force): "indexing done — N files, ... nodes"
+    const files = /(\d+)\s+files\b/.exec(trimmed);
+    if (files)
+        return parseInt(files[1], 10);
+    // Legacy key-value pattern like "indexed: 42"
     const match = /indexed["\s:]+(\d+)/.exec(trimmed);
     if (match)
         return parseInt(match[1], 10);

package/dist/graph/cli.js.map

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

package/dist/graph/pipeline-lifecycle.d.ts

@@ -42,6 +42,15 @@ declare class GraphPipelineLifecycleImpl {
      */
     stop(): Promise<void>;
     engineHealth(): string;
+    /**
+     * Project root of the active pipeline, or null when not started.
+     *
+     * Used by PreflightContextInjector to resolve a telemetry sink when the
+     * injector was constructed without an explicit projectRoot (the common case
+     * at most agent call sites). Lets graph-preflight telemetry fire for every
+     * role with zero changes to the call sites.
+     */
+    projectRootOrNull(): string | null;
     /**
      * Lazy accessor for the GraphClient instance.
      * Returns null if the engine is not 'ready'.

package/dist/graph/pipeline-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-lifecycle.d.ts","sourceRoot":"","sources":["../../src/graph/pipeline-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAc9C,cAAM,0BAA0B;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAA6B;IAI/C;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkFpE;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC3B,YAAY,IAAI,MAAM;IAQtB;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA4B;IAEhD,cAAc,IAAI,WAAW,GAAG,IAAI;IAuCpC;;;OAGG;IACH,YAAY,IAAI;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAUvE;;;OAGG;IACH,MAAM,IAAI,IAAI;YAiBA,YAAY;YAyDZ,YAAY;YAaZ,aAAa;IAS3B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,wBAAwB;CAMjC;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,4BAAmC,CAAC;AAGvE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"pipeline-lifecycle.d.ts","sourceRoot":"","sources":["../../src/graph/pipeline-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAc9C,cAAM,0BAA0B;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAA6B;IAI/C;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkFpE;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC3B,YAAY,IAAI,MAAM;IAQtB;;;;;;;OAOG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAMlC;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA4B;IAEhD,cAAc,IAAI,WAAW,GAAG,IAAI;IAuCpC;;;OAGG;IACH,YAAY,IAAI;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAUvE;;;OAGG;IACH,MAAM,IAAI,IAAI;YAiBA,YAAY;YAyDZ,YAAY;YAaZ,aAAa;IAS3B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,wBAAwB;CAMjC;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,4BAAmC,CAAC;AAGvE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/graph/pipeline-lifecycle.js

@@ -140,6 +140,18 @@ class GraphPipelineLifecycleImpl {
             return "starting";
         return this.mcpClient.health();
     }
+    // ── projectRootOrNull ─────────────────────────────────────────────
+    /**
+     * Project root of the active pipeline, or null when not started.
+     *
+     * Used by PreflightContextInjector to resolve a telemetry sink when the
+     * injector was constructed without an explicit projectRoot (the common case
+     * at most agent call sites). Lets graph-preflight telemetry fire for every
+     * role with zero changes to the call sites.
+     */
+    projectRootOrNull() {
+        return this.projectRoot;
+    }
     // ── getGraphClient ────────────────────────────────────────────────
     /**
      * Lazy accessor for the GraphClient instance.