agent-nuvira 3.3.1 → 3.3.3

package/dist/agents/artifact-verification.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Artifact verification — does the work actually exist?
+ *
+ * WHY THIS EXISTS (the live NVDA-addon failure):
+ * A WhatsApp task asked for an NVDA add-on packaged to
+ * /Users/dheeraj/Documents/kuttaaddon/. Over 19 attempts the pipeline never
+ * once produced the deliverable, and every attempt was reported as a SUCCESS.
+ * The trail, in order:
+ *
+ *   1. `write_file` was refused — the target is outside the workspace — so the
+ *      three planned files were never created.
+ *   2. The packaging step ran `zip -r kuttaaddon.nvda-addon manifest.ini
+ *      installTasks.py globalPlugins/` against files that did not exist. zip
+ *      printed `zip warning: name not matched: …` for every input and still
+ *      **exited 0**, emitting a valid 22-byte EMPTY archive.
+ *   3. `runResult.success` was derived from the exit code, so the step counted
+ *      as done and every task flipped to `completed` (5/5).
+ *   4. `deliverableAuthored: false` was written into the same checkpoint
+ *      metadata — the truth was recorded next to the false completion and
+ *      nothing acted on it.
+ *   5. `fileChanges` claimed `installTasks.py` was `created`. It does not exist.
+ *      The existing expectedFiles guard accepted that CLAIM as proof, so the one
+ *      check that could have caught the lie waived it.
+ *
+ * The contract this module enforces, in one line: **a step is not done because a
+ * command exited 0, and not because the agent said it wrote something — it is
+ * done because the artifact is on disk, and is not empty.**
+ *
+ * Deliberately deterministic and LLM-free: existence, size and archive entry
+ * counts are facts. Everything here is best-effort and must never throw — a
+ * verification failure reports, it does not crash a pipeline.
+ */
+/**
+ * The outcome of checking a set of declared artifacts.
+ *
+ * `missing` and `empty` are kept apart on purpose: "you never wrote it" and "you
+ * wrote an empty one" are different bugs with different repairs, and the live
+ * failure was the second one (a 22-byte archive that exists and holds nothing).
+ */
+export interface ArtifactCheck {
+    ok: boolean;
+    /** Declared paths that do not exist on disk. */
+    missing: string[];
+    /** Declared paths that exist but carry no content. */
+    empty: string[];
+    /** One line naming what is wrong, or undefined when ok. */
+    reason?: string;
+}
+/** Options for {@link verifyArtifacts}. */
+export interface VerifyOptions {
+    /**
+     * Files that are legitimately empty (touch-style markers). The add-on plan
+     * itself asked for "an empty installTasks.py", so treating every empty file
+     * as a failure would be wrong.
+     */
+    allowEmpty?: string[];
+}
+/** True when the path names a container format rather than a plain file. */
+export declare function isArchivePath(path: string): boolean;
+/**
+ * True when `file` is a zip that contains ZERO entries.
+ *
+ * This is the check that would have caught the live failure: an empty zip is a
+ * perfectly valid 22-byte file, so `existsSync` and a size check both pass it.
+ * The entry count lives in the End Of Central Directory record at the end of the
+ * file (the comment field can be up to 64KiB, so the record is searched from the
+ * tail rather than assumed to start at byte 0 of the trailer).
+ *
+ * Returns false for anything unreadable or not recognisably a zip — an
+ * unparseable archive is reported by the caller as unreadable, not as empty.
+ */
+export declare function isEmptyArchive(file: string): boolean;
+/** Resolve a declared path against the project root (absolute paths pass through). */
+export declare function resolveArtifact(declared: string, root: string): string;
+/**
+ * Verify that every declared path exists on disk, and that none of them is an
+ * empty shell.
+ *
+ * A declared path is satisfied ONLY by a real file. Callers must not pass in the
+ * agent's own report of what it wrote — that is exactly the substitution that
+ * let the live failure through, where `fileChanges` said a file had been created
+ * and the file did not exist.
+ */
+export declare function verifyArtifacts(declared: string[], root: string, options?: VerifyOptions): ArtifactCheck;
+/**
+ * Detect a command that finished successfully in the only sense the shell knows
+ * — exit code 0 — while provably doing nothing.
+ *
+ * Returns a human-readable reason (for the trace, the checkpoint and the user),
+ * or null when the command either genuinely ran or is not one we can judge.
+ *
+ * This exists because `zip` expresses "I matched none of your inputs" as a
+ * WARNING and still exits 0. Deriving success from the exit code therefore
+ * reports a fabricated deliverable as a finished one.
+ */
+export declare function detectNoOpCommand(command: string, stdout: string, stderr: string): string | null;
+/**
+ * Read a file's head for diagnostics, bounded. Never throws.
+ * Used to show what actually landed when a step's artifact is suspect.
+ */
+export declare function peekFile(file: string, maxChars?: number): string;
+//# sourceMappingURL=artifact-verification.d.ts.map

package/dist/agents/artifact-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-verification.d.ts","sourceRoot":"","sources":["../../src/agents/artifact-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAOH;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAaD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA8BpD;AAID,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,aAAa,CAqCf;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAQf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAM7D"}

package/dist/agents/artifact-verification.js

@@ -0,0 +1,216 @@
+/**
+ * Artifact verification — does the work actually exist?
+ *
+ * WHY THIS EXISTS (the live NVDA-addon failure):
+ * A WhatsApp task asked for an NVDA add-on packaged to
+ * /Users/dheeraj/Documents/kuttaaddon/. Over 19 attempts the pipeline never
+ * once produced the deliverable, and every attempt was reported as a SUCCESS.
+ * The trail, in order:
+ *
+ *   1. `write_file` was refused — the target is outside the workspace — so the
+ *      three planned files were never created.
+ *   2. The packaging step ran `zip -r kuttaaddon.nvda-addon manifest.ini
+ *      installTasks.py globalPlugins/` against files that did not exist. zip
+ *      printed `zip warning: name not matched: …` for every input and still
+ *      **exited 0**, emitting a valid 22-byte EMPTY archive.
+ *   3. `runResult.success` was derived from the exit code, so the step counted
+ *      as done and every task flipped to `completed` (5/5).
+ *   4. `deliverableAuthored: false` was written into the same checkpoint
+ *      metadata — the truth was recorded next to the false completion and
+ *      nothing acted on it.
+ *   5. `fileChanges` claimed `installTasks.py` was `created`. It does not exist.
+ *      The existing expectedFiles guard accepted that CLAIM as proof, so the one
+ *      check that could have caught the lie waived it.
+ *
+ * The contract this module enforces, in one line: **a step is not done because a
+ * command exited 0, and not because the agent said it wrote something — it is
+ * done because the artifact is on disk, and is not empty.**
+ *
+ * Deliberately deterministic and LLM-free: existence, size and archive entry
+ * counts are facts. Everything here is best-effort and must never throw — a
+ * verification failure reports, it does not crash a pipeline.
+ */
+import { closeSync, existsSync, openSync, readFileSync, readSync, statSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+// ─── Archive helpers ────────────────────────────────────────────────────────
+/** Zip End Of Central Directory signature — `PK\x05\x06`. */
+const ZIP_EOCD_SIGNATURE = 0x06054b50;
+/** An EOCD record is 22 bytes; the comment field can push it further back. */
+const ZIP_EOCD_MIN_SIZE = 22;
+const ZIP_MAX_COMMENT = 0xffff;
+/** Extensions whose whole purpose is to be a container of other files. */
+const ARCHIVE_EXTENSIONS = ['.zip', '.nvda-addon', '.jar', '.whl', '.vsix', '.epub', '.xpi'];
+/** True when the path names a container format rather than a plain file. */
+export function isArchivePath(path) {
+    const lower = path.toLowerCase();
+    return ARCHIVE_EXTENSIONS.some((ext) => lower.endsWith(ext));
+}
+/**
+ * True when `file` is a zip that contains ZERO entries.
+ *
+ * This is the check that would have caught the live failure: an empty zip is a
+ * perfectly valid 22-byte file, so `existsSync` and a size check both pass it.
+ * The entry count lives in the End Of Central Directory record at the end of the
+ * file (the comment field can be up to 64KiB, so the record is searched from the
+ * tail rather than assumed to start at byte 0 of the trailer).
+ *
+ * Returns false for anything unreadable or not recognisably a zip — an
+ * unparseable archive is reported by the caller as unreadable, not as empty.
+ */
+export function isEmptyArchive(file) {
+    let fd;
+    try {
+        const size = statSync(file).size;
+        // Smaller than an EOCD record cannot be a zip at all.
+        if (size < ZIP_EOCD_MIN_SIZE)
+            return false;
+        const readFrom = Math.max(0, size - ZIP_EOCD_MIN_SIZE - ZIP_MAX_COMMENT);
+        const length = size - readFrom;
+        const buffer = Buffer.alloc(length);
+        fd = openSync(file, 'r');
+        readSync(fd, buffer, 0, length, readFrom);
+        // Search backwards for the EOCD signature.
+        for (let i = buffer.length - ZIP_EOCD_MIN_SIZE; i >= 0; i -= 1) {
+            if (buffer.readUInt32LE(i) !== ZIP_EOCD_SIGNATURE)
+                continue;
+            // Offset 10 of the EOCD holds "total number of entries in the central
+            // directory" as a little-endian uint16.
+            return buffer.readUInt16LE(i + 10) === 0;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    }
+}
+// ─── Artifact verification ──────────────────────────────────────────────────
+/** Resolve a declared path against the project root (absolute paths pass through). */
+export function resolveArtifact(declared, root) {
+    return isAbsolute(declared) ? declared : resolve(root, declared);
+}
+/**
+ * Verify that every declared path exists on disk, and that none of them is an
+ * empty shell.
+ *
+ * A declared path is satisfied ONLY by a real file. Callers must not pass in the
+ * agent's own report of what it wrote — that is exactly the substitution that
+ * let the live failure through, where `fileChanges` said a file had been created
+ * and the file did not exist.
+ */
+export function verifyArtifacts(declared, root, options = {}) {
+    const allowEmpty = new Set((options.allowEmpty ?? []).map((p) => resolveArtifact(p, root)));
+    const missing = [];
+    const empty = [];
+    for (const path of declared) {
+        if (!path || !path.trim())
+            continue;
+        const abs = resolveArtifact(path, root);
+        try {
+            if (!existsSync(abs)) {
+                missing.push(path);
+                continue;
+            }
+            // A directory satisfies existence; only files can be empty shells.
+            const stat = statSync(abs);
+            if (stat.isDirectory())
+                continue;
+            if (stat.size === 0 && !allowEmpty.has(abs)) {
+                empty.push(path);
+                continue;
+            }
+            // The subtle case: non-zero size, but a container holding nothing.
+            if (isArchivePath(abs) && isEmptyArchive(abs)) {
+                empty.push(path);
+            }
+        }
+        catch {
+            // Unreadable is not the same as absent — report it as missing so the
+            // repair path is the same (re-do the step) rather than silently passing.
+            missing.push(path);
+        }
+    }
+    if (missing.length === 0 && empty.length === 0)
+        return { ok: true, missing, empty };
+    const parts = [];
+    if (missing.length)
+        parts.push(`not on disk: ${missing.join(', ')}`);
+    if (empty.length)
+        parts.push(`produced empty: ${empty.join(', ')}`);
+    return { ok: false, missing, empty, reason: parts.join(' | ') };
+}
+// ─── No-op command detection ────────────────────────────────────────────────
+/**
+ * Tools whose entire job is to turn inputs into a container. Only these are
+ * considered for no-op detection, because "matched nothing" is unambiguously a
+ * failure for them.
+ */
+const PRODUCER_TOOLS = ['zip', '7z', '7za', 'p7zip', 'tar', 'git'];
+/**
+ * Output signatures that mean an archive/lookup command matched NOTHING while
+ * still exiting 0. Kept deliberately short and literal: a broad pattern like
+ * `/no such file/` would fail legitimate commands (a `grep` that finds nothing
+ * is not a broken build), so each entry here must be unambiguous on its own.
+ */
+const NO_OP_SIGNATURES = [
+    // Info-ZIP's warning for an input that did not resolve. This is the exact line
+    // the live run produced, once per declared input, next to `exit code 0`.
+    { pattern: /zip warning: name not matched/i, what: 'zip matched none of its declared inputs' },
+    { pattern: /zip error: nothing to do/i, what: 'zip had nothing to add' },
+    { pattern: /nothing to commit|no changes added to commit/i, what: 'git found nothing to commit' },
+    { pattern: /nothing to do\b/i, what: 'the command had nothing to do' },
+    { pattern: /\b0 files? (?:added|archived|processed|packed)\b/i, what: 'the tool reported 0 files' },
+];
+/** True when the command line invokes one of the producer tools. */
+function invokesProducerTool(command) {
+    // First word of each shell segment, so `cd x && zip …` is recognised.
+    return command
+        .split(/\|\||&&|;|\|/)
+        .map((segment) => segment.trim().split(/\s+/)[0] ?? '')
+        .some((head) => PRODUCER_TOOLS.includes(head.replace(/^.*\//, '')));
+}
+/**
+ * Detect a command that finished successfully in the only sense the shell knows
+ * — exit code 0 — while provably doing nothing.
+ *
+ * Returns a human-readable reason (for the trace, the checkpoint and the user),
+ * or null when the command either genuinely ran or is not one we can judge.
+ *
+ * This exists because `zip` expresses "I matched none of your inputs" as a
+ * WARNING and still exits 0. Deriving success from the exit code therefore
+ * reports a fabricated deliverable as a finished one.
+ */
+export function detectNoOpCommand(command, stdout, stderr) {
+    if (!command)
+        return null;
+    if (!invokesProducerTool(command))
+        return null;
+    const output = `${stdout}\n${stderr}`;
+    for (const { pattern, what } of NO_OP_SIGNATURES) {
+        if (pattern.test(output))
+            return what;
+    }
+    return null;
+}
+/**
+ * Read a file's head for diagnostics, bounded. Never throws.
+ * Used to show what actually landed when a step's artifact is suspect.
+ */
+export function peekFile(file, maxChars = 200) {
+    try {
+        return readFileSync(file, 'utf-8').slice(0, maxChars);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=artifact-verification.js.map

package/dist/agents/artifact-verification.js.map

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

package/dist/agents/checkpoint-store.d.ts

@@ -46,6 +46,79 @@ export declare function checkpointIdFor(goal: string, workingDirectory: string):
 export declare function saveCheckpoint(context: AgentContext, id?: string): string | null;
 /** Load a checkpoint by id (null if missing/corrupt). */
 export declare function loadCheckpoint(id: string): CheckpointFile | null;
+/**
+ * The newest checkpoint for this project whose goal is the SAME ASK, possibly
+ * worded differently.
+ *
+ * `checkpointIdFor` hashes `workingDirectory + goal`, so a reworded ask hashes
+ * to a different id and finds nothing — which is why "do that addon thing"
+ * re-planned from zero while the previous attempt's plan sat on disk.
+ *
+ * The goal test is deliberately REQUIRED rather than taking the newest
+ * checkpoint in the directory. A bare "newest for this project" lookup would
+ * hand run B the plan of a completely unrelated run A that merely happened to
+ * use the same folder — and it would do so silently, which is worse than the
+ * re-plan it replaces. The caller reconciles whatever this returns against the
+ * filesystem before trusting a word of it (see `reconcileTaskPlan`).
+ *
+ * Newest-first among the matching goals, so the most recent attempt wins.
+ */
+export declare function findRelatedCheckpointFor(workingDirectory: string, goal: string, options?: {
+    excludeId?: string;
+}): CheckpointFile | null;
+/**
+ * Are these two the same ask, worded differently?
+ *
+ * Both a floor and a ratio are required. The ratio alone passes two long goals
+ * that share a boilerplate opening; the floor alone passes two short goals that
+ * share one incidental noun. Together they mean "most of the shorter ask's
+ * subject matter appears in the other", which is what rewording looks like and
+ * what two unrelated asks in one folder do not.
+ *
+ * The floor is capped at the shorter goal's own token count, so a SHORT ask
+ * still matches its own rewording: "Package the add-on" and "package the addon
+ * for me" are two tokens each, and demanding three shared tokens would refuse
+ * the pair the rule exists for. At two tokens that means both must match — which
+ * is still enough to keep "update the readme" and "update the dockerfile"
+ * apart.
+ */
+export declare function goalsLookSame(a: string, b: string): boolean;
+/** The outcome of checking a saved plan against the filesystem. */
+export interface PlanReconciliation {
+    /** The context with unverifiable completions demoted back to `pending`. */
+    context: AgentContext;
+    /** Steps that CLAIMED completion but whose artifacts are not on disk. */
+    demoted: Array<{
+        id: string;
+        reason: string;
+    }>;
+}
+/**
+ * Reconcile a saved task plan against what is actually on disk.
+ *
+ * WHY THIS EXISTS (the live NVDA-addon failure): the checkpoint for that goal
+ * said `5/5 tasks completed`, so "resume unless the user asks" looked correct —
+ * re-entering a finished plan would skip every task. But three of the five
+ * completions were false: the step claimed success, `zip` exited 0 on inputs
+ * that did not exist, and the packaged deliverable was a 22-byte empty archive.
+ * A checkpoint's statuses are therefore CLAIMS, and the only thing that makes
+ * them safe to skip is the artifact behind them.
+ *
+ * The rule, in one line: a completed step whose DECLARED files are not on disk
+ * (or are empty shells) is demoted to `pending`, so a resume re-runs exactly the
+ * work that is missing instead of skipping it.
+ *
+ * Deliberately narrow: only a step's explicit `expectedFiles` is checked. A
+ * description like "Delete legacy.js" would look like an unmet deliverable if we
+ * inferred artifacts from prose, so prose is never used to decide what re-runs —
+ * that stays the planner's declared contract. Steps with nothing declared are
+ * left exactly as they are rather than being demoted on a guess.
+ *
+ * Never throws: reconciliation failure reports, it does not break a resume.
+ */
+export declare function reconcileTaskPlan(context: AgentContext, workingDirectory?: string): PlanReconciliation;
+/** True when the plan still has work that can be run. */
+export declare function planHasPendingWork(context: AgentContext): boolean;
 /** List all saved checkpoints, newest first (for `nuvira execute --checkpoint-list`). */
 export declare function listCheckpoints(): CheckpointMeta[];
 //# sourceMappingURL=checkpoint-store.d.ts.map

package/dist/agents/checkpoint-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/agents/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa/C,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,OAAO,EAAE,YAAY,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBhF;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUhE;AAED,yFAAyF;AACzF,wBAAgB,eAAe,IAAI,cAAc,EAAE,CA0BlD"}
+{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/agents/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,YAAY,CAAC;AAazD,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,OAAO,EAAE,YAAY,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBhF;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,cAAc,GAAG,IAAI,CAWvB;AA0CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAS3D;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,OAAO,EAAE,YAAY,CAAC;IACtB,yEAAyE;IACzE,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,kBAAkB,CA8BpB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,yFAAyF;AACzF,wBAAgB,eAAe,IAAI,cAAc,EAAE,CA0BlD"}

package/dist/agents/checkpoint-store.js

@@ -19,6 +19,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from
 import { envBuff, resolveNuviraHome } from '../config/paths.js';
 import { join } from 'node:path';
 import { createHash } from 'node:crypto';
+import { verifyArtifacts } from './artifact-verification.js';
 // ─── Storage ────────────────────────────────────────────────────────────────
 const DEFAULT_MEMORY_DIR = join(resolveNuviraHome(), 'memory');
 function checkpointsDir() {
@@ -86,6 +87,166 @@ export function loadCheckpoint(id) {
         return null;
     }
 }
+/**
+ * The newest checkpoint for this project whose goal is the SAME ASK, possibly
+ * worded differently.
+ *
+ * `checkpointIdFor` hashes `workingDirectory + goal`, so a reworded ask hashes
+ * to a different id and finds nothing — which is why "do that addon thing"
+ * re-planned from zero while the previous attempt's plan sat on disk.
+ *
+ * The goal test is deliberately REQUIRED rather than taking the newest
+ * checkpoint in the directory. A bare "newest for this project" lookup would
+ * hand run B the plan of a completely unrelated run A that merely happened to
+ * use the same folder — and it would do so silently, which is worse than the
+ * re-plan it replaces. The caller reconciles whatever this returns against the
+ * filesystem before trusting a word of it (see `reconcileTaskPlan`).
+ *
+ * Newest-first among the matching goals, so the most recent attempt wins.
+ */
+export function findRelatedCheckpointFor(workingDirectory, goal, options = {}) {
+    const wanted = normalizeDir(workingDirectory);
+    const candidates = listCheckpoints()
+        .filter((c) => normalizeDir(c.workingDirectory) === wanted && c.id !== options.excludeId)
+        .sort((a, b) => b.savedAt - a.savedAt);
+    for (const meta of candidates) {
+        if (!goalsLookSame(meta.goal, goal))
+            continue;
+        const file = loadCheckpoint(meta.id);
+        if (file)
+            return file;
+    }
+    return null;
+}
+/** Compare working directories without caring about a trailing slash. */
+function normalizeDir(dir) {
+    return (dir || '').replace(/[\\/]+$/, '');
+}
+/** Words that carry no subject — dropped before comparing two goals. */
+const GOAL_STOPWORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'to', 'of', 'in', 'on', 'at', 'for', 'with', 'from',
+    'can', 'could', 'would', 'should', 'please', 'you', 'your', 'me', 'my', 'i', 'we', 'it', 'its',
+    'is', 'are', 'was', 'be', 'been', 'do', 'does', 'did', 'make', 'made', 'need', 'want', 'get',
+    'this', 'that', 'these', 'those', 'there', 'here', 'then', 'than', 'so', 'as', 'by', 'use',
+    'using', 'into', 'out', 'up', 'down', 'again', 'also', 'just', 'new', 'now', 'save',
+    'folder', 'file', 'path', 'directory', 'dir', 'create', 'build', 'develop', 'write',
+]);
+/**
+ * Subject tokens of a goal. Hyphens and underscores are JOINED, not split, so
+ * "add-on" and "addon" are the same token — the exact pair a user is most
+ * likely to vary when re-asking.
+ */
+function goalTokens(text) {
+    const flat = (text || '')
+        .toLowerCase()
+        .replace(/[-_]+/g, '')
+        .replace(/[^a-z0-9]+/g, ' ');
+    const tokens = new Set();
+    for (const raw of flat.split(' ')) {
+        const t = raw.trim();
+        if (!t || t.length < 3)
+            continue;
+        if (GOAL_STOPWORDS.has(t))
+            continue;
+        tokens.add(t);
+    }
+    return tokens;
+}
+/** Shared subject tokens needed before two goals are treated as the same ask. */
+const MIN_SHARED_TOKENS = 3;
+/** Fraction of the SHORTER goal's tokens that must be shared. */
+const MIN_SHARED_RATIO = 0.6;
+/**
+ * Are these two the same ask, worded differently?
+ *
+ * Both a floor and a ratio are required. The ratio alone passes two long goals
+ * that share a boilerplate opening; the floor alone passes two short goals that
+ * share one incidental noun. Together they mean "most of the shorter ask's
+ * subject matter appears in the other", which is what rewording looks like and
+ * what two unrelated asks in one folder do not.
+ *
+ * The floor is capped at the shorter goal's own token count, so a SHORT ask
+ * still matches its own rewording: "Package the add-on" and "package the addon
+ * for me" are two tokens each, and demanding three shared tokens would refuse
+ * the pair the rule exists for. At two tokens that means both must match — which
+ * is still enough to keep "update the readme" and "update the dockerfile"
+ * apart.
+ */
+export function goalsLookSame(a, b) {
+    const ta = goalTokens(a);
+    const tb = goalTokens(b);
+    if (ta.size === 0 || tb.size === 0)
+        return false;
+    let shared = 0;
+    for (const t of ta)
+        if (tb.has(t))
+            shared += 1;
+    const smaller = Math.min(ta.size, tb.size);
+    if (shared < Math.min(MIN_SHARED_TOKENS, smaller))
+        return false;
+    return shared / smaller >= MIN_SHARED_RATIO;
+}
+/**
+ * Reconcile a saved task plan against what is actually on disk.
+ *
+ * WHY THIS EXISTS (the live NVDA-addon failure): the checkpoint for that goal
+ * said `5/5 tasks completed`, so "resume unless the user asks" looked correct —
+ * re-entering a finished plan would skip every task. But three of the five
+ * completions were false: the step claimed success, `zip` exited 0 on inputs
+ * that did not exist, and the packaged deliverable was a 22-byte empty archive.
+ * A checkpoint's statuses are therefore CLAIMS, and the only thing that makes
+ * them safe to skip is the artifact behind them.
+ *
+ * The rule, in one line: a completed step whose DECLARED files are not on disk
+ * (or are empty shells) is demoted to `pending`, so a resume re-runs exactly the
+ * work that is missing instead of skipping it.
+ *
+ * Deliberately narrow: only a step's explicit `expectedFiles` is checked. A
+ * description like "Delete legacy.js" would look like an unmet deliverable if we
+ * inferred artifacts from prose, so prose is never used to decide what re-runs —
+ * that stays the planner's declared contract. Steps with nothing declared are
+ * left exactly as they are rather than being demoted on a guess.
+ *
+ * Never throws: reconciliation failure reports, it does not break a resume.
+ */
+export function reconcileTaskPlan(context, workingDirectory) {
+    const demoted = [];
+    let plan;
+    try {
+        plan = structuredClone(context.taskPlan ?? []);
+    }
+    catch {
+        // An unclonable plan is not a verdict — hand it back untouched.
+        return { context, demoted };
+    }
+    const root = workingDirectory || context.workingDirectory || process.cwd();
+    for (const step of plan) {
+        if (step.status !== 'completed')
+            continue;
+        const declared = (step.expectedFiles ?? []).filter((f) => f && f.trim());
+        if (declared.length === 0)
+            continue;
+        try {
+            const check = verifyArtifacts(declared, root);
+            if (check.ok)
+                continue;
+            step.status = 'pending';
+            step.result =
+                `re-opened on resume — the step reported success but its deliverable is not on disk (${check.reason})`;
+            demoted.push({ id: step.id, reason: check.reason ?? 'deliverable missing' });
+        }
+        catch {
+            // Best-effort: a filesystem error must not demote a step on a guess.
+        }
+    }
+    if (demoted.length === 0)
+        return { context, demoted };
+    return { context: { ...context, taskPlan: plan }, demoted };
+}
+/** True when the plan still has work that can be run. */
+export function planHasPendingWork(context) {
+    return (context.taskPlan ?? []).some((s) => s.status === 'pending');
+}
 /** List all saved checkpoints, newest first (for `nuvira execute --checkpoint-list`). */
 export function listCheckpoints() {
     try {

package/dist/agents/checkpoint-store.js.map

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