agent-bober 0.11.6 → 0.15.0

package/dist/contracts/sprint-contract.js

@@ -1,4 +1,33 @@
 import { z } from "zod";
+// ── Constants ───────────────────────────────────────────────────────
+/**
+ * Minimum length for a success criterion description.
+ * Short descriptions are usually vague ("works correctly", "looks good").
+ * Opus 4.7 takes prompts literally — vague criteria produce vague verification.
+ */
+export const MIN_CRITERION_DESCRIPTION_LENGTH = 25;
+/**
+ * Minimum length for definitionOfDone.
+ * Single-sentence summaries leak too much intent that the model has to guess.
+ */
+export const MIN_DEFINITION_OF_DONE_LENGTH = 20;
+/**
+ * Phrases that almost always indicate a vague criterion.
+ * Match is case-insensitive and substring-based.
+ */
+export const BANNED_VAGUE_PHRASES = [
+    "works correctly",
+    "works as expected",
+    "looks good",
+    "looks nice",
+    "is reasonable",
+    "behaves properly",
+    "behaves correctly",
+    "is correct",
+    "appears correct",
+    "as needed",
+    "if appropriate",
+];
 // ── Enums ───────────────────────────────────────────────────────────
 export const ContractStatusSchema = z.enum([
     "proposed",
@@ -9,55 +38,120 @@ export const ContractStatusSchema = z.enum([
     "passed",
     "failed",
     "needs-rework",
+    "completed",
+]);
+/**
+ * Strict enum of verification methods the evaluator can actually execute.
+ * Free-form strings here cause the evaluator to silently skip checks.
+ */
+export const VerificationMethodSchema = z.enum([
+    "manual",
+    "typecheck",
+    "lint",
+    "unit-test",
+    "playwright",
+    "api-check",
+    "build",
+    "agent-evaluation",
 ]);
-export const FileActionSchema = z.enum(["create", "modify", "delete"]);
+export const EstimatedDurationSchema = z.enum(["small", "medium", "large"]);
 // ── Sub-types ───────────────────────────────────────────────────────
 export const SuccessCriterionSchema = z.object({
-    id: z.string().min(1),
-    description: z.string().min(1),
-    verificationMethod: z.string().min(1),
-    passed: z.boolean(),
-    notes: z.string().optional(),
-});
-export const FileChangeSchema = z.object({
-    path: z.string().min(1),
-    action: FileActionSchema,
-    description: z.string().min(1),
+    criterionId: z.string().min(1),
+    description: z.string().min(MIN_CRITERION_DESCRIPTION_LENGTH),
+    verificationMethod: VerificationMethodSchema,
+    required: z.boolean(),
 });
 // ── Sprint Contract ─────────────────────────────────────────────────
 export const SprintContractSchema = z.object({
-    id: z.string().min(1),
-    feature: z.string().min(1),
+    // Identity
+    contractId: z.string().min(1),
+    specId: z.string().min(1),
+    sprintNumber: z.number().int().min(1),
+    title: z.string().min(1),
     description: z.string().min(1),
-    successCriteria: z.array(SuccessCriterionSchema),
-    expectedChanges: z.array(FileChangeSchema),
-    dependsOn: z.array(z.string()),
     status: ContractStatusSchema,
-    evalResults: z.array(z.unknown()).optional(),
+    // Dependencies and feature linkage
+    dependsOn: z.array(z.string()).default([]),
+    features: z.array(z.string()).default([]),
+    // Success criteria (must include at least one)
+    successCriteria: z.array(SuccessCriterionSchema).min(1),
+    // ── Precision fields (added to combat Opus 4.7 literal-following) ──
+    /** Things the generator MUST NOT do, even if tempting. Forces explicit scope. */
+    nonGoals: z.array(z.string().min(1)).min(1),
+    /** Concrete signals that the sprint is finished. "Stop when X" beats "stop when done". */
+    stopConditions: z.array(z.string().min(1)).min(1),
+    /** Plain-English paragraph the generator can re-read mid-task to recenter. */
+    definitionOfDone: z.string().min(MIN_DEFINITION_OF_DONE_LENGTH),
+    /** Assumptions the planner made (often self-answered clarifications). */
+    assumptions: z.array(z.string()).default([]),
+    /** Items explicitly outside this sprint's scope (deferred or never). */
+    outOfScope: z.array(z.string()).default([]),
+    /**
+     * Self-rated ambiguity, 0 (fully specified) to 10 (very ambiguous).
+     * In autonomous mode the planner should refuse to emit contracts with
+     * scores >= 7 and instead surface clarification questions.
+     */
+    ambiguityScore: z.number().int().min(0).max(10).optional(),
+    // Implementation guidance
     generatorNotes: z.string().optional(),
+    evaluatorNotes: z.string().optional(),
+    estimatedFiles: z.array(z.string()).default([]),
+    estimatedDuration: EstimatedDurationSchema.optional(),
+    // Runtime / iteration state
     evaluatorFeedback: z.string().optional(),
-    startedAt: z.string().datetime().optional(),
-    completedAt: z.string().datetime().optional(),
+    iterationHistory: z.array(z.unknown()).default([]),
+    lastEvalId: z.string().nullable().optional(),
+    evalResults: z.array(z.unknown()).optional(),
+    // Timestamps
+    createdAt: z.string().datetime({ offset: true }).optional(),
+    updatedAt: z.string().datetime({ offset: true }).optional(),
+    startedAt: z.string().datetime({ offset: true }).optional(),
+    completedAt: z.string().datetime({ offset: true }).optional(),
 });
 // ── Helpers ─────────────────────────────────────────────────────────
 let contractCounter = 0;
 /**
  * Create a new sprint contract in "proposed" status.
+ *
+ * Auto-generated contracts (e.g. one-feature-per-sprint pipelines) get
+ * placeholder precision fields that explicitly signal they were not authored
+ * by a planner agent. The generator preflight check should treat these as
+ * incomplete and request clarification before implementing.
  */
-export function createContract(feature, description, criteria) {
+export function createContract(title, description, criteria, options = {}) {
     contractCounter++;
-    const id = `sprint-${Date.now()}-${contractCounter}`;
+    const contractId = `sprint-${Date.now()}-${contractCounter}`;
+    const now = new Date().toISOString();
     return {
-        id,
-        feature,
+        contractId,
+        specId: options.specId ?? "spec-unknown",
+        sprintNumber: options.sprintNumber ?? 1,
+        title,
         description,
+        status: "proposed",
+        dependsOn: [],
+        features: options.features ?? [],
         successCriteria: criteria.map((c) => ({
             ...c,
-            passed: false,
+            required: true,
         })),
-        expectedChanges: [],
-        dependsOn: [],
-        status: "proposed",
+        nonGoals: options.nonGoals ?? [
+            "Auto-generated contract — planner did not specify non-goals",
+        ],
+        stopConditions: options.stopConditions ?? [
+            "All required success criteria pass evaluation",
+        ],
+        definitionOfDone: options.definitionOfDone ??
+            `Sprint is done when the success criteria for "${title}" all pass evaluation and no regressions are introduced.`,
+        assumptions: [],
+        outOfScope: [],
+        estimatedFiles: options.estimatedFiles ?? [],
+        estimatedDuration: options.estimatedDuration,
+        iterationHistory: [],
+        lastEvalId: null,
+        createdAt: now,
+        updatedAt: now,
     };
 }
 /**
@@ -67,14 +161,67 @@ export function createContract(feature, description, criteria) {
  */
 export function updateContractStatus(contract, status) {
     const now = new Date().toISOString();
-    const updates = { status };
+    const updates = { status, updatedAt: now };
     if (status === "in-progress" && !contract.startedAt) {
         updates.startedAt = now;
     }
-    if ((status === "passed" || status === "failed") &&
+    if ((status === "passed" ||
+        status === "failed" ||
+        status === "completed") &&
         !contract.completedAt) {
         updates.completedAt = now;
     }
     return { ...contract, ...updates };
 }
+/**
+ * Check a contract for precision issues that the Zod schema can't express:
+ * banned vague phrases, etc. Returns an empty array when the contract is clean.
+ *
+ * Schema-level constraints (min lengths, required fields) are enforced
+ * separately by SprintContractSchema.parse().
+ */
+export function findPrecisionIssues(contract) {
+    const issues = [];
+    function checkPhrases(text, field) {
+        const lower = text.toLowerCase();
+        for (const phrase of BANNED_VAGUE_PHRASES) {
+            if (lower.includes(phrase)) {
+                issues.push({
+                    field,
+                    message: `contains vague phrase "${phrase}" — be specific about observable behavior`,
+                });
+            }
+        }
+    }
+    checkPhrases(contract.description, "description");
+    checkPhrases(contract.definitionOfDone, "definitionOfDone");
+    for (const c of contract.successCriteria) {
+        checkPhrases(c.description, `successCriteria[${c.criterionId}].description`);
+    }
+    for (let i = 0; i < contract.nonGoals.length; i++) {
+        checkPhrases(contract.nonGoals[i], `nonGoals[${i}]`);
+    }
+    for (let i = 0; i < contract.stopConditions.length; i++) {
+        checkPhrases(contract.stopConditions[i], `stopConditions[${i}]`);
+    }
+    return issues;
+}
+/**
+ * Check whether a contract has the precision fields populated with substance,
+ * not just placeholders from createContract(). Use this in the generator
+ * preflight to refuse to start work on incomplete contracts.
+ */
+export function isContractPrecise(contract) {
+    if (contract.nonGoals.length === 1 &&
+        contract.nonGoals[0].startsWith("Auto-generated contract")) {
+        return false;
+    }
+    if (findPrecisionIssues(contract).length > 0) {
+        return false;
+    }
+    if (contract.ambiguityScore !== undefined && contract.ambiguityScore >= 7) {
+        return false;
+    }
+    return true;
+}
 //# sourceMappingURL=sprint-contract.js.map

package/dist/contracts/sprint-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"sprint-contract.js","sourceRoot":"","sources":["../../src/contracts/sprint-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uEAAuE;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,UAAU;IACV,aAAa;IACb,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGvE,uEAAuE;AAEvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAGH,uEAAuE;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAChD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,oBAAoB;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAGH,uEAAuE;AAEvE,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,WAAmB,EACnB,QAA4C;IAE5C,eAAe,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,eAAe,EAAE,CAAC;IAErD,OAAO;QACL,EAAE;QACF,OAAO;QACP,WAAW;QACX,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,GAAG,CAAC;YACJ,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,eAAe,EAAE,EAAE;QACnB,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,MAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAA4B,EAAE,MAAM,EAAE,CAAC;IAEpD,IAAI,MAAM,KAAK,aAAa,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACpD,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,IACE,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,CAAC;QAC5C,CAAC,QAAQ,CAAC,WAAW,EACrB,CAAC;QACD,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"sprint-contract.js","sourceRoot":"","sources":["../../src/contracts/sprint-contract.ts"],"names":[],"mappings":"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"}

package/dist/evaluators/builtin/api-check.js

@@ -9,7 +9,7 @@ function inferEndpointsFromContract(contract) {
     const allText = [
         contract.description,
         ...contract.successCriteria.map((c) => c.description),
-        ...contract.expectedChanges.map((c) => c.description),
+        ...contract.estimatedFiles,
     ].join("\n");
     // Match patterns like "GET /api/users", "POST /api/items"
     const httpPattern = /\b(GET|POST|PUT|PATCH|DELETE)\s+(\/\S+)/gi;

package/dist/evaluators/builtin/api-check.js.map

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

package/dist/graph/artifact-store.d.ts

@@ -0,0 +1,14 @@
+import type { GraphManifest, StalenessVerdict } from "./types.js";
+export declare class GraphArtifactStore {
+    private readonly projectRoot;
+    private readonly graphDir;
+    private readonly manifestPath;
+    constructor(projectRoot: string, manifestRelPath?: string);
+    ensureLayout(): Promise<void>;
+    readManifest(): Promise<GraphManifest | null>;
+    writeManifest(m: GraphManifest): Promise<void>;
+    staleness(): Promise<StalenessVerdict>;
+    private gitHeadSha;
+    private filesNewerThan;
+}
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/graph/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/graph/artifact-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,WAAW,EAAE,MAAM,EACpC,eAAe,SAA+B;IAM1C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAa7C,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAgC9B,UAAU;YAcV,cAAc;CAmB7B"}

package/dist/graph/artifact-store.js

@@ -0,0 +1,100 @@
+import { stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { execa } from "execa";
+import { glob } from "glob";
+import { ensureDir, fileExists, readJson, writeJson } from "../utils/fs.js";
+export class GraphArtifactStore {
+    projectRoot;
+    graphDir;
+    manifestPath;
+    constructor(projectRoot, manifestRelPath = ".bober/graph/manifest.json") {
+        this.projectRoot = projectRoot;
+        this.manifestPath = resolve(projectRoot, manifestRelPath);
+        this.graphDir = resolve(projectRoot, ".bober/graph");
+    }
+    async ensureLayout() {
+        await ensureDir(this.graphDir);
+    }
+    async readManifest() {
+        if (!(await fileExists(this.manifestPath)))
+            return null;
+        try {
+            return await readJson(this.manifestPath);
+        }
+        catch (err) {
+            console.error(`[GraphArtifactStore] Malformed manifest at ${this.manifestPath}:`, err instanceof Error ? err.message : err);
+            return null;
+        }
+    }
+    async writeManifest(m) {
+        await this.ensureLayout();
+        await writeJson(this.manifestPath, m);
+    }
+    async staleness() {
+        const manifest = await this.readManifest();
+        if (!manifest) {
+            return { stale: true, reason: "NO_MANIFEST", detail: "No manifest exists yet" };
+        }
+        // ── Git HEAD-SHA path ──
+        const head = await this.gitHeadSha();
+        if (head) {
+            if (manifest.lastSyncedHeadSha === head) {
+                return { stale: false };
+            }
+            return {
+                stale: true,
+                reason: "HEAD_DIFFERS",
+                detail: `HEAD ${head} != lastSyncedHeadSha ${manifest.lastSyncedHeadSha ?? "null"}`,
+            };
+        }
+        // ── mtime fallback (non-git repo or git unavailable) ──
+        const newer = await this.filesNewerThan(manifest.lastSyncAt);
+        if (newer.length > 0) {
+            return {
+                stale: true,
+                reason: "NEWER_MTIME",
+                detail: `${newer.length} file(s) modified after lastSyncAt`,
+                newerFiles: newer.slice(0, 20),
+            };
+        }
+        return { stale: false };
+    }
+    async gitHeadSha() {
+        try {
+            const r = await execa("git", ["rev-parse", "HEAD"], {
+                cwd: this.projectRoot,
+                reject: false,
+                timeout: 2000,
+            });
+            if (r.exitCode !== 0)
+                return null;
+            return r.stdout.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async filesNewerThan(isoTime) {
+        const cutoff = Date.parse(isoTime);
+        if (Number.isNaN(cutoff))
+            return [];
+        const candidates = await glob("**/*", {
+            cwd: this.projectRoot,
+            nodir: true,
+            ignore: ["node_modules/**", ".git/**", "dist/**", ".bober/**"],
+        });
+        const newer = [];
+        for (const rel of candidates) {
+            try {
+                const s = await stat(join(this.projectRoot, rel));
+                if (s.mtimeMs > cutoff)
+                    newer.push(rel);
+            }
+            catch {
+                /* skip */
+            }
+        }
+        return newer;
+    }
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/graph/artifact-store.js.map

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

package/dist/graph/cli.d.ts

@@ -0,0 +1,49 @@
+import type { GraphArtifactStore } from "./artifact-store.js";
+export interface SyncResult {
+    indexed: number;
+}
+export interface StatusResult {
+    ready: boolean;
+    indexedFileCount: number;
+    tokensaveVersion: string;
+}
+/**
+ * Short-lived execa wrapper for `tokensave init/sync/status`.
+ *
+ * Each method spawns a child process and waits for it to exit.
+ * Use `TokensaveMcpClient` for long-lived JSON-RPC calls.
+ *
+ * Constructor pattern mirrors `TokensavePrereqCheck` (src/graph/prereq.ts:7-8).
+ */
+export declare class TokensaveCli {
+    private readonly cwd;
+    private readonly store;
+    private readonly binary;
+    constructor(cwd: string, store?: GraphArtifactStore | null, binary?: string);
+    /**
+     * Run `tokensave init --tier <tier>`.
+     * Resolves on exit code 0; throws a structured Error on non-zero.
+     */
+    init(opts: {
+        cwd?: string;
+        languageTier: string;
+    }): Promise<void>;
+    /**
+     * Run `tokensave sync <paths...>` with a timeout.
+     * Returns `{indexed}` parsed from stdout JSON.
+     * Throws on timeout, non-zero exit, or unparseable output.
+     *
+     * After a successful sync, updates the manifest via the injected
+     * GraphArtifactStore (if provided), setting lastSyncAt and clearing
+     * pendingFiles (evaluator note #10).
+     */
+    sync(paths: string[], timeoutMs: number): Promise<SyncResult>;
+    /**
+     * Run `tokensave status --json`.
+     * Returns `{ready: false, indexedFileCount: 0, tokensaveVersion: ""}` when
+     * tokensave has not been initialised — does NOT throw in that case.
+     * Throws only on binary execution failure (ENOENT etc.).
+     */
+    status(): Promise<StatusResult>;
+}
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +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"}

package/dist/graph/cli.js

@@ -0,0 +1,140 @@
+import { execa } from "execa";
+// ── TokensaveCli ───────────────────────────────────────────────────
+/**
+ * Short-lived execa wrapper for `tokensave init/sync/status`.
+ *
+ * Each method spawns a child process and waits for it to exit.
+ * Use `TokensaveMcpClient` for long-lived JSON-RPC calls.
+ *
+ * Constructor pattern mirrors `TokensavePrereqCheck` (src/graph/prereq.ts:7-8).
+ */
+export class TokensaveCli {
+    cwd;
+    store;
+    binary;
+    constructor(cwd, store = null, binary = "tokensave") {
+        this.cwd = cwd;
+        this.store = store;
+        this.binary = binary;
+    }
+    /**
+     * Run `tokensave init --tier <tier>`.
+     * 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], {
+            cwd: effectiveCwd,
+            reject: false,
+            all: true,
+        });
+        if (result.exitCode !== 0) {
+            const output = result.all ?? result.stdout ?? result.stderr ?? "";
+            throw new Error(`tokensave init failed (exit ${result.exitCode ?? -1}): ${output.slice(0, 500)}`);
+        }
+    }
+    /**
+     * Run `tokensave sync <paths...>` with a timeout.
+     * Returns `{indexed}` parsed from stdout JSON.
+     * Throws on timeout, non-zero exit, or unparseable output.
+     *
+     * After a successful sync, updates the manifest via the injected
+     * GraphArtifactStore (if provided), setting lastSyncAt and clearing
+     * pendingFiles (evaluator note #10).
+     */
+    async sync(paths, timeoutMs) {
+        const result = await execa(this.binary, ["sync", ...paths], {
+            cwd: this.cwd,
+            timeout: timeoutMs,
+            reject: false,
+            all: true,
+        });
+        // Detect timeout — execa sets timedOut flag or ETIMEDOUT in message
+        if (result.timedOut) {
+            throw new Error(`tokensave sync timed out after ${timeoutMs}ms`);
+        }
+        if (result.exitCode !== 0) {
+            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);
+        // Update manifest via store if injected
+        if (this.store) {
+            try {
+                const existing = await this.store.readManifest();
+                if (existing) {
+                    await this.store.writeManifest({
+                        ...existing,
+                        lastSyncAt: new Date().toISOString(),
+                        indexedFileCount: indexed,
+                        pendingFiles: [],
+                    });
+                }
+            }
+            catch {
+                // Manifest update is best-effort; sync result is still valid
+            }
+        }
+        return { indexed };
+    }
+    /**
+     * Run `tokensave status --json`.
+     * Returns `{ready: false, indexedFileCount: 0, tokensaveVersion: ""}` when
+     * tokensave has not been initialised — does NOT throw in that case.
+     * Throws only on binary execution failure (ENOENT etc.).
+     */
+    async status() {
+        const result = await execa(this.binary, ["status", "--json"], {
+            cwd: this.cwd,
+            reject: false,
+            all: true,
+        });
+        // If the binary can't be found at all, propagate the error
+        if (result.failed && result.exitCode === null) {
+            throw new Error(`tokensave binary not found or could not execute: ${result.stderr ?? ""}`);
+        }
+        // Any non-zero exit (e.g. "not initialised") → not-ready, don't throw
+        const stdout = result.stdout ?? "";
+        if (!stdout.trim()) {
+            return { ready: false, indexedFileCount: 0, tokensaveVersion: "" };
+        }
+        try {
+            const parsed = JSON.parse(stdout);
+            return {
+                ready: parsed.ready === true,
+                indexedFileCount: typeof parsed.indexedFileCount === "number" ? parsed.indexedFileCount : 0,
+                tokensaveVersion: typeof parsed.tokensaveVersion === "string" ? parsed.tokensaveVersion : "",
+            };
+        }
+        catch {
+            // Unparseable output → treat as not-ready, not an error
+            return { ready: false, indexedFileCount: 0, tokensaveVersion: "" };
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────
+/**
+ * Parse `{indexed: N}` from tokensave sync stdout.
+ * Accepts both plain JSON and a JSON object embedded in other text.
+ */
+function parseSyncOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return 0;
+    // Try direct JSON parse
+    try {
+        const obj = JSON.parse(trimmed);
+        if (typeof obj.indexed === "number")
+            return obj.indexed;
+    }
+    catch {
+        // Fall through
+    }
+    // Try to extract a number from a key-value pattern like "indexed: 42"
+    const match = /indexed["\s:]+(\d+)/.exec(trimmed);
+    if (match)
+        return parseInt(match[1], 10);
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/graph/cli.js.map

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