@kenkaiiii/ggcoder 4.3.212 → 4.3.214

package/dist/core/goal-lifecycle-smoke.test.js

@@ -58,10 +58,9 @@ describe("goal lifecycle smoke", () => {
                     label: "Persisted state proof",
                     mechanism: "test",
                     description: "Vitest asserts transitions and JSON persistence",
-                    status: "ready",
+                    status: "planned",
                     command: "pnpm --filter @kenkaiiii/ggcoder test -- goal-lifecycle-smoke",
                     path: "packages/ggcoder/src/core/goal-lifecycle-smoke.test.ts",
-                    evidence: "This test inspects persisted Goal state after each tool call.",
                 },
             ],
             verifier_command: "pnpm --filter @kenkaiiii/ggcoder test -- goal-lifecycle-smoke",
@@ -81,7 +80,7 @@ describe("goal lifecycle smoke", () => {
             expect.objectContaining({ id: "local-harness", command: expect.any(String) }),
         ]);
         expect(persisted.evidencePlan).toEqual([
-            expect.objectContaining({ id: "state-proof", status: "ready" }),
+            expect.objectContaining({ id: "state-proof", status: "planned" }),
         ]);
         expect((await loadGoalRuns(tmpProject)).map((item) => item.id)).toContain("smoke-goal");
         await goals({
@@ -103,6 +102,19 @@ describe("goal lifecycle smoke", () => {
             evidence_content: "fixture persisted in temp-only smoke flow",
         });
         persisted = await run();
+        expect(decideGoalNextAction(persisted)).toMatchObject({
+            kind: "create_task",
+            title: "Build Goal evidence path",
+            reason: "Goal evidence plan requires local instrumentation or exact prerequisite handling before verification.",
+        });
+        await goals({
+            action: "evidence_plan",
+            run_id: "smoke-goal",
+            evidence_plan_item_id: "state-proof",
+            evidence_plan_status: "ready",
+            evidence_content: "This test inspects persisted Goal state after each tool call.",
+        });
+        persisted = await run();
         expect(decideGoalNextAction(persisted)).toEqual({
             kind: "run_verifier",
             command: "pnpm --filter @kenkaiiii/ggcoder test -- goal-lifecycle-smoke",
@@ -175,20 +187,50 @@ describe("goal lifecycle smoke", () => {
             output_path: "artifacts/goal-lifecycle-smoke-pass.log",
         });
         persisted = await run();
+        expect(canCompleteGoalRun(persisted)).toEqual({
+            ok: false,
+            reason: "Final completion audit status is unknown.",
+        });
+        const auditDecision = decideGoalNextAction({ ...persisted, status: "ready" });
+        expect(auditDecision).toMatchObject({
+            kind: "create_task",
+            title: "Audit Goal completion evidence",
+        });
+        await goals({
+            action: "task",
+            run_id: "smoke-goal",
+            task_id: "final-audit",
+            task_title: "Audit Goal completion evidence",
+            task_prompt: auditDecision.kind === "create_task" ? auditDecision.prompt : "Audit completion.",
+            task_status: "done",
+            attempts: 1,
+            summary: "Final audit compared persisted artifacts and verifier output.",
+        });
+        persisted = await run();
+        const verifierCheckedAt = persisted.verifier?.lastResult?.checkedAt;
+        expect(verifierCheckedAt).toBeTruthy();
+        await goals({
+            action: "audit",
+            run_id: "smoke-goal",
+            verification_status: "pass",
+            summary: `FINAL_AUDIT_PASS verifier_checked_at=${verifierCheckedAt}; artifact=artifacts/goal-lifecycle-smoke-pass.log matches the latest smoke verifier pass.`,
+            output_path: "artifacts/goal-lifecycle-smoke-pass.log",
+        });
+        persisted = await run();
         expect(canCompleteGoalRun(persisted)).toEqual({
             ok: true,
-            reason: "All tasks are done and verifier evidence passed.",
+            reason: "All tasks are done, verifier evidence passed, and final completion audit passed.",
         });
         expect(decideGoalNextAction({ ...persisted, status: "ready" })).toEqual({
             kind: "complete",
-            reason: "All tasks are done and verifier evidence passed.",
+            reason: "All tasks are done, verifier evidence passed, and final completion audit passed.",
         });
         expect(await goals({ action: "complete", run_id: "smoke-goal" })).toBe('Goal "Lifecycle smoke" is now passed.');
         persisted = await run();
         expect(persisted.status).toBe("passed");
         expect(decideGoalNextAction(persisted)).toEqual({
             kind: "complete",
-            reason: "All tasks are done and verifier evidence passed.",
+            reason: "All tasks are done, verifier evidence passed, and final completion audit passed.",
         });
         expect(persisted.evidence).toEqual(expect.arrayContaining([
             expect.objectContaining({ label: "Local fixture artifact" }),

package/dist/core/goal-lifecycle-smoke.test.js.map

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

package/dist/core/goal-prerequisites.d.ts

@@ -4,10 +4,15 @@ export interface GoalPrerequisiteCheckResult {
     status: GoalPrerequisiteStatus;
     evidence: string;
 }
+export interface PrerequisiteCommandSafetyResult {
+    safe: boolean;
+    reason?: string;
+}
 export interface RunGoalPrerequisiteChecksResult {
     run: GoalRun;
     checkedCount: number;
 }
+export declare function validateGoalPrerequisiteCheckCommand(command: string): PrerequisiteCommandSafetyResult;
 export declare function runGoalPrerequisiteCheckCommand({ cwd, command, timeoutMs, }: {
     cwd: string;
     command: string;

package/dist/core/goal-prerequisites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goal-prerequisites.d.ts","sourceRoot":"","sources":["../../src/core/goal-prerequisites.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEzF,eAAO,MAAM,0CAA0C,QAAS,CAAC;AAGjE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B;IAC9C,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAeD,wBAAsB,+BAA+B,CAAC,EACpD,GAAG,EACH,OAAO,EACP,SAAsD,GACvD,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAkCvC;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE9E;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,+BAA+B,CAAC,CAsB1C"}
+{"version":3,"file":"goal-prerequisites.d.ts","sourceRoot":"","sources":["../../src/core/goal-prerequisites.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEzF,eAAO,MAAM,0CAA0C,QAAS,CAAC;AAGjE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAeD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,MAAM,GACd,+BAA+B,CA2BjC;AAED,wBAAsB,+BAA+B,CAAC,EACpD,GAAG,EACH,OAAO,EACP,SAAsD,GACvD,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAyCvC;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE9E;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,+BAA+B,CAAC,CAsB1C"}

package/dist/core/goal-prerequisites.js

@@ -12,7 +12,44 @@ function summarizePrerequisiteCheck(command, exitCode, output) {
     const suffix = normalizedOutput ? `; output: ${normalizedOutput}` : "";
     return `Checked locally: \`${command}\` exited ${exitCode}${suffix}`;
 }
+export function validateGoalPrerequisiteCheckCommand(command) {
+    const normalized = command.trim();
+    if (!normalized)
+        return { safe: false, reason: "empty prerequisite check command" };
+    const checks = [
+        [/\brm\s+(?:-[^\s]*r[^\s]*f|-f[^\s]*r|-rf|-fr)\b/i, "destructive rm -rf command"],
+        [
+            /\b(?:npm|pnpm|yarn|bun)\s+(?:i|install|add|remove|uninstall|update|upgrade)\b/i,
+            "package mutation command",
+        ],
+        [
+            /\b(?:apt|apt-get|brew|pip|pip3|gem|cargo)\s+(?:install|add|remove|uninstall|update|upgrade)\b/i,
+            "system/package mutation command",
+        ],
+        [/(^|[^<])>>?\s*[^\s&|;]/, "shell redirection that writes files"],
+        [/\b(?:tee)\b(?!\s+-a?\s*\/dev\/null)/i, "tee file write command"],
+        [/\b(?:touch|mkdir|mv|cp|chmod|chown|truncate)\b/i, "file mutation command"],
+        [
+            /\b(?:serve|vite|next\s+dev|npm\s+run\s+dev|pnpm\s+dev|yarn\s+dev)\b/i,
+            "background/dev server command",
+        ],
+        [/[;&|]\s*$/, "trailing shell control operator"],
+        [/&\s*(?:$|[#;])/, "background command"],
+    ];
+    for (const [pattern, reason] of checks) {
+        if (pattern.test(normalized))
+            return { safe: false, reason };
+    }
+    return { safe: true };
+}
 export async function runGoalPrerequisiteCheckCommand({ cwd, command, timeoutMs = DEFAULT_GOAL_PREREQUISITE_CHECK_TIMEOUT_MS, }) {
+    const safety = validateGoalPrerequisiteCheckCommand(command);
+    if (!safety.safe) {
+        return {
+            status: "missing",
+            evidence: `Prerequisite check rejected as unsafe: ${safety.reason}. Command was not executed: \`${command}\``,
+        };
+    }
     return await new Promise((resolve) => {
         const child = spawn(command, {
             cwd,

package/dist/core/goal-prerequisites.js.map

@@ -1 +1 @@
-{"version":3,"file":"goal-prerequisites.js","sourceRoot":"","sources":["../../src/core/goal-prerequisites.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"goal-prerequisites.js","sourceRoot":"","sources":["../../src/core/goal-prerequisites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,MAAM,CAAC,MAAM,0CAA0C,GAAG,MAAM,CAAC;AACjE,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAiB5C,SAAS,YAAY,CAAC,MAAc,EAAE,KAAa;IACjD,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,+BAA+B;QAClD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,+BAA+B,CAAC;QAC3D,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAe,EAAE,QAAgB,EAAE,MAAc;IACnF,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,aAAa,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,sBAAsB,OAAO,aAAa,QAAQ,GAAG,MAAM,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,OAAe;IAEf,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IACpF,MAAM,MAAM,GAA4B;QACtC,CAAC,iDAAiD,EAAE,4BAA4B,CAAC;QACjF;YACE,gFAAgF;YAChF,0BAA0B;SAC3B;QACD;YACE,gGAAgG;YAChG,iCAAiC;SAClC;QACD,CAAC,wBAAwB,EAAE,qCAAqC,CAAC;QACjE,CAAC,sCAAsC,EAAE,wBAAwB,CAAC;QAClE,CAAC,iDAAiD,EAAE,uBAAuB,CAAC;QAC5E;YACE,sEAAsE;YACtE,+BAA+B;SAChC;QACD,CAAC,WAAW,EAAE,iCAAiC,CAAC;QAChD,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;KACzC,CAAC;IACF,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,EACpD,GAAG,EACH,OAAO,EACP,SAAS,GAAG,0CAA0C,GAKvD;IACC,MAAM,MAAM,GAAG,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,0CAA0C,MAAM,CAAC,MAAM,iCAAiC,OAAO,IAAI;SAC9G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,IAAI,OAAO,CAA8B,CAAC,OAAO,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG;YACH,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,YAAqB,EAAE,EAAE;YAC5D,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC;gBACN,MAAM,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC1C,QAAQ,EAAE,0BAA0B,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,IAAI,MAAM,CAAC;aAChF,CAAC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,KAAK,CAAC,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,EAAE,sCAAsC,SAAS,KAAK,CAAC,CAAC;QACpE,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAClB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,qCAAqC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAsB;IACnE,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAW,EACX,GAAY,EACZ,SAAkB;IAElB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAA6B,EAAE;QAC9D,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAC7E,YAAY,IAAI,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAAC;YACnD,GAAG;YACH,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,SAAS;SACV,CAAC,CAAC;QACH,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY;gBACnD,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,IAAI,CAAC,YAAY,kBAAkB,EAAE;gBACjE,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,EAAE,YAAY,EAAE,CAAC;AAC1D,CAAC"}

package/dist/core/goal-prerequisites.test.js

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { runGoalPrerequisiteCheckCommand, runGoalPrerequisiteChecks, shouldRunGoalPrerequisiteCheck, } from "./goal-prerequisites.js";
+import { runGoalPrerequisiteCheckCommand, runGoalPrerequisiteChecks, shouldRunGoalPrerequisiteCheck, validateGoalPrerequisiteCheckCommand, } from "./goal-prerequisites.js";
 function goalRun(overrides = {}) {
     return {
         id: "goal-a",
@@ -23,6 +23,34 @@ function goalRun(overrides = {}) {
     };
 }
 describe("goal prerequisite checks", () => {
+    it("rejects unsafe prerequisite commands without executing mutations", async () => {
+        expect(validateGoalPrerequisiteCheckCommand("rm -rf .goal-evidence")).toEqual({
+            safe: false,
+            reason: "destructive rm -rf command",
+        });
+        expect(validateGoalPrerequisiteCheckCommand("pnpm install left-pad")).toEqual({
+            safe: false,
+            reason: "package mutation command",
+        });
+        expect(validateGoalPrerequisiteCheckCommand("echo secret > leaked.txt")).toEqual({
+            safe: false,
+            reason: "shell redirection that writes files",
+        });
+        expect(validateGoalPrerequisiteCheckCommand("test -f package.json")).toEqual({ safe: true });
+        const tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "goal-prereq-safety-project-"));
+        try {
+            const result = await runGoalPrerequisiteCheckCommand({
+                cwd: tmpProject,
+                command: "echo unsafe > should-not-exist.txt",
+            });
+            expect(result.status).toBe("missing");
+            expect(result.evidence).toContain("rejected as unsafe");
+            await expect(fs.access(path.join(tmpProject, "should-not-exist.txt"))).rejects.toThrow();
+        }
+        finally {
+            await fs.rm(tmpProject, { recursive: true, force: true });
+        }
+    });
     it("runs cheap local check commands and records non-secret evidence", async () => {
         const tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "goal-prereq-test-project-"));
         try {

package/dist/core/goal-prerequisites.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"goal-prerequisites.test.js","sourceRoot":"","sources":["../../src/core/goal-prerequisites.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"goal-prerequisites.test.js","sourceRoot":"","sources":["../../src/core/goal-prerequisites.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,yBAAyB,CAAC;AAEjC,SAAS,OAAO,CAAC,YAA8B,EAAE;IAC/C,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,oCAAoC;QAC1C,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,WAAW,EAAE,cAAc;QAC3B,eAAe,EAAE,EAAE;QACnB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,oCAAoC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5E,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,4BAA4B;SACrC,CAAC,CAAC;QACH,MAAM,CAAC,oCAAoC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5E,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,0BAA0B;SACnC,CAAC,CAAC;QACH,MAAM,CAAC,oCAAoC,CAAC,0BAA0B,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/E,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,qCAAqC;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,oCAAoC,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7F,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAAC;gBACnD,GAAG,EAAE,UAAU;gBACf,OAAO,EAAE,oCAAoC;aAC9C,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YACxD,MAAM,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3F,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE3E,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAAC;gBACnD,GAAG,EAAE,UAAU;gBACf,OAAO,EAAE,qBAAqB;aAC/B,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACtE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CACJ,8BAA8B,CAAC;YAC7B,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,kBAAkB;YAC5B,YAAY,EAAE,MAAM;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,MAAM,CACJ,8BAA8B,CAAC;YAC7B,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,MAAM;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,CACJ,8BAA8B,CAAC;YAC7B,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,MAAM;SACrB,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C,UAAU,EACV,OAAO,CAAC;gBACN,aAAa,EAAE;oBACb,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE;oBAC/E,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE;iBACjF;aACF,CAAC,CACH,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC;gBACvC,MAAM,CAAC,gBAAgB,CAAC;oBACtB,EAAE,EAAE,MAAM;oBACV,MAAM,EAAE,KAAK;oBACb,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC;iBAC9C,CAAC;gBACF,MAAM,CAAC,gBAAgB,CAAC;oBACtB,EAAE,EAAE,MAAM;oBACV,MAAM,EAAE,SAAS;oBACjB,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC;iBAC9C,CAAC;aACH,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/goal-references.d.ts

@@ -0,0 +1,14 @@
+import type { GoalReference } from "./goal-store.js";
+import type { ImageAttachment } from "../utils/image.js";
+export interface GoalReferenceContext {
+    references: GoalReference[];
+    promptSection: string;
+}
+export declare function buildGoalReferenceContext({ cwd, originalGoalPrompt, attachments, }: {
+    cwd: string;
+    originalGoalPrompt: string;
+    attachments: readonly ImageAttachment[];
+}): Promise<GoalReferenceContext>;
+export declare function formatGoalReferencesForPrompt(references: readonly GoalReference[]): string;
+export declare function referencesRequiringAcknowledgement(references: readonly GoalReference[]): GoalReference[];
+//# sourceMappingURL=goal-references.d.ts.map

package/dist/core/goal-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-references.d.ts","sourceRoot":"","sources":["../../src/core/goal-references.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQzD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAkGD,wBAAsB,yBAAyB,CAAC,EAC9C,GAAG,EACH,kBAAkB,EAClB,WAAW,GACZ,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CACzC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwBhC;AAuBD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAW1F;AAED,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,aAAa,EAAE,CAEjB"}

package/dist/core/goal-references.js

@@ -0,0 +1,153 @@
+import { createHash } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+const GOAL_REFERENCES_DIR = ".gg/goal-references";
+const MAX_PROMPT_REFERENCE_CHARS = 12_000;
+const MAX_INLINE_REFERENCE_CHARS = 6_000;
+const MAX_FORMATTED_REFERENCE_CHARS = 18_000;
+const URL_PATTERN = /https?:\/\/[^\s<>()"']+/g;
+function hashText(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 12);
+}
+function truncateMiddle(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    const keep = Math.max(0, Math.floor((maxChars - 32) / 2));
+    return `${text.slice(0, keep)}\n[reference truncated]\n${text.slice(text.length - keep)}`;
+}
+function safeFileName(fileName) {
+    const base = path.basename(fileName).replace(/[^a-zA-Z0-9._-]+/g, "-");
+    return base || "reference";
+}
+function extensionForAttachment(attachment) {
+    const fromName = path.extname(attachment.fileName);
+    if (fromName)
+        return fromName;
+    if (attachment.kind === "text")
+        return ".txt";
+    if (attachment.mediaType === "image/jpeg")
+        return ".jpg";
+    if (attachment.mediaType === "image/webp")
+        return ".webp";
+    if (attachment.mediaType === "image/gif")
+        return ".gif";
+    return ".png";
+}
+function toProjectRelativePath(cwd, absolutePath) {
+    return path.relative(cwd, absolutePath).split(path.sep).join("/");
+}
+function classifyUrl(url) {
+    return /^https?:\/\/(?:www\.)?github\.com\/[^\s/]+\/[^\s/#?]+/i.test(url) ? "repo" : "url";
+}
+function normalizeUrlToken(url) {
+    return url.replace(/[),.;!?]+$/g, "");
+}
+function extractUrlReferences(text) {
+    const urls = Array.from(new Set((text.match(URL_PATTERN) ?? []).map(normalizeUrlToken)));
+    return urls.map((url) => {
+        const kind = classifyUrl(url);
+        const id = `${kind}-${hashText(url)}`;
+        return {
+            id,
+            kind,
+            label: kind === "repo" ? `Reference repository ${url}` : `Reference URL ${url}`,
+            value: url,
+            description: kind === "repo"
+                ? "Repository supplied in the original Goal prompt; workers/verifier must compare against it when relevant."
+                : "URL supplied in the original Goal prompt; workers/verifier must use it when relevant.",
+            source: "original-goal-prompt",
+        };
+    });
+}
+async function persistAttachmentReference(cwd, attachment) {
+    const digest = hashText(`${attachment.fileName}\n${attachment.mediaType}\n${attachment.data}`);
+    const id = `${attachment.kind}-${digest}`;
+    const ext = extensionForAttachment(attachment);
+    const fileName = `${id}-${safeFileName(attachment.fileName).replace(/\.[^.]*$/, "")}${ext}`;
+    const absoluteDir = path.join(cwd, GOAL_REFERENCES_DIR);
+    const absolutePath = path.join(absoluteDir, fileName);
+    await mkdir(absoluteDir, { recursive: true });
+    if (attachment.kind === "text") {
+        await writeFile(absolutePath, attachment.data, "utf-8");
+        return {
+            id,
+            kind: "text",
+            label: `Attached text reference ${attachment.fileName}`,
+            path: toProjectRelativePath(cwd, absolutePath),
+            mediaType: attachment.mediaType,
+            content: truncateMiddle(attachment.data, MAX_INLINE_REFERENCE_CHARS),
+            source: attachment.filePath,
+            description: "Text/document supplied with the original Goal prompt; setup, workers, verifier, and final audit must account for it.",
+        };
+    }
+    await writeFile(absolutePath, Buffer.from(attachment.data, "base64"));
+    return {
+        id,
+        kind: "image",
+        label: `Attached image reference ${attachment.fileName}`,
+        path: toProjectRelativePath(cwd, absolutePath),
+        mediaType: attachment.mediaType,
+        source: attachment.filePath,
+        description: "Image/screenshot supplied with the original Goal prompt; workers/verifier must inspect or compare against it when relevant.",
+    };
+}
+export async function buildGoalReferenceContext({ cwd, originalGoalPrompt, attachments, }) {
+    const references = [];
+    const trimmedPrompt = originalGoalPrompt.trim();
+    if (trimmedPrompt) {
+        references.push({
+            id: "original-goal-prompt",
+            kind: "prompt",
+            label: "Original Goal prompt",
+            content: truncateMiddle(trimmedPrompt, MAX_PROMPT_REFERENCE_CHARS),
+            source: "user",
+            description: "The exact /goal prompt text that started this run. Preserve its reference requirements in criteria, tasks, verifier, and audit.",
+        });
+        references.push(...extractUrlReferences(trimmedPrompt));
+    }
+    for (const attachment of attachments) {
+        references.push(await persistAttachmentReference(cwd, attachment));
+    }
+    return {
+        references,
+        promptSection: formatGoalReferencesForPrompt(references),
+    };
+}
+function formatReferenceValue(reference) {
+    const parts = [
+        `- [${reference.id}] kind=${reference.kind}; label=${JSON.stringify(reference.label)}`,
+    ];
+    if (reference.value)
+        parts.push(`  value: ${reference.value}`);
+    if (reference.path)
+        parts.push(`  path: ${reference.path}`);
+    if (reference.mediaType)
+        parts.push(`  media_type: ${reference.mediaType}`);
+    if (reference.description)
+        parts.push(`  why_it_matters: ${reference.description}`);
+    if (reference.source)
+        parts.push(`  source: ${reference.source}`);
+    if (reference.content) {
+        parts.push("  content_excerpt:");
+        parts.push(truncateMiddle(reference.content, MAX_INLINE_REFERENCE_CHARS)
+            .split("\n")
+            .map((line) => `    ${line}`)
+            .join("\n"));
+    }
+    return parts.join("\n");
+}
+export function formatGoalReferencesForPrompt(references) {
+    if (references.length === 0)
+        return "";
+    const formatted = references.map(formatReferenceValue).join("\n");
+    const body = truncateMiddle(formatted, MAX_FORMATTED_REFERENCE_CHARS);
+    return (`## Goal References (MANDATORY)\n\n` +
+        `These references came from the user's original /goal prompt, URLs/repos, screenshots, or attached documents. ` +
+        `They are not optional context: success criteria, worker tasks, evidence paths, verifier, and final audit must use the relevant reference IDs. ` +
+        `If a reference cannot be accessed or compared locally, block the Goal with exact user instructions instead of silently ignoring it.\n\n` +
+        body);
+}
+export function referencesRequiringAcknowledgement(references) {
+    return references.filter((reference) => reference.kind !== "prompt");
+}
+//# sourceMappingURL=goal-references.js.map

package/dist/core/goal-references.js.map

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

package/dist/core/goal-references.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=goal-references.test.d.ts.map

package/dist/core/goal-references.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-references.test.d.ts","sourceRoot":"","sources":["../../src/core/goal-references.test.ts"],"names":[],"mappings":""}

package/dist/core/goal-references.test.js

@@ -0,0 +1,77 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { buildGoalReferenceContext, referencesRequiringAcknowledgement, } from "./goal-references.js";
+let tmpProject;
+beforeEach(async () => {
+    tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "goal-references-test-"));
+});
+afterEach(async () => {
+    await fs.rm(tmpProject, { recursive: true, force: true });
+});
+describe("goal reference context", () => {
+    it("extracts URLs, persists attachments, and formats mandatory prompt context", async () => {
+        const attachment = {
+            kind: "text",
+            fileName: "notes.md",
+            filePath: path.join(tmpProject, "notes.md"),
+            mediaType: "text/markdown",
+            data: "Match this documented behavior.",
+        };
+        const context = await buildGoalReferenceContext({
+            cwd: tmpProject,
+            originalGoalPrompt: "Build this like https://github.com/acme/reference-ui and explain https://example.com/docs.",
+            attachments: [attachment],
+        });
+        const kinds = context.references.map((reference) => reference.kind);
+        expect(kinds).toEqual(expect.arrayContaining(["prompt", "repo", "url", "text"]));
+        expect(context.promptSection).toContain("## Goal References (MANDATORY)");
+        expect(context.promptSection).toContain("https://github.com/acme/reference-ui");
+        expect(context.promptSection).toContain("Match this documented behavior.");
+        const textReference = context.references.find((reference) => reference.kind === "text");
+        expect(textReference?.path).toMatch(/^\.gg\/goal-references\/text-/);
+        expect(await fs.readFile(path.join(tmpProject, textReference?.path ?? ""), "utf-8")).toBe("Match this documented behavior.");
+        expect(referencesRequiringAcknowledgement(context.references).map((reference) => reference.kind)).toEqual(expect.arrayContaining(["repo", "url", "text"]));
+        expect(referencesRequiringAcknowledgement(context.references).map((reference) => reference.kind)).not.toContain("prompt");
+    });
+    it("covers prompt, URL/repo, screenshot image, attached document, and X/Y/Z feature-fix references", async () => {
+        const imageAttachment = {
+            kind: "image",
+            fileName: "liked-ui.png",
+            filePath: path.join(tmpProject, "liked-ui.png"),
+            mediaType: "image/png",
+            data: Buffer.from("fake-png-reference").toString("base64"),
+        };
+        const documentAttachment = {
+            kind: "text",
+            fileName: "feature-fix-x-y-z.md",
+            filePath: path.join(tmpProject, "feature-fix-x-y-z.md"),
+            mediaType: "text/markdown",
+            data: "Fix feature based on X: keyboard flow, Y: empty state copy, Z: error recovery.",
+        };
+        const context = await buildGoalReferenceContext({
+            cwd: tmpProject,
+            originalGoalPrompt: "Fix this feature based off X, Y, Z. Match https://example.com/design-system and repo https://github.com/acme/product-reference.",
+            attachments: [imageAttachment, documentAttachment],
+        });
+        expect(context.references.map((reference) => reference.kind)).toEqual(expect.arrayContaining(["prompt", "url", "repo", "image", "text"]));
+        expect(context.promptSection).toContain("Goal References (MANDATORY)");
+        expect(context.promptSection).toContain("success criteria, worker tasks, evidence paths, verifier, and final audit");
+        expect(context.promptSection).toContain("https://example.com/design-system");
+        expect(context.promptSection).toContain("https://github.com/acme/product-reference");
+        expect(context.promptSection).toContain("Attached image reference liked-ui.png");
+        expect(context.promptSection).toContain("feature-fix-x-y-z.md");
+        expect(context.promptSection).toContain("X: keyboard flow, Y: empty state copy, Z: error recovery");
+        const imageReference = context.references.find((reference) => reference.kind === "image");
+        const textReference = context.references.find((reference) => reference.kind === "text");
+        expect(imageReference?.path).toMatch(/^\.gg\/goal-references\/image-/);
+        expect(textReference?.path).toMatch(/^\.gg\/goal-references\/text-/);
+        await expect(fs.stat(path.join(tmpProject, imageReference?.path ?? ""))).resolves.toMatchObject({
+            size: Buffer.from("fake-png-reference").length,
+        });
+        await expect(fs.readFile(path.join(tmpProject, textReference?.path ?? ""), "utf-8")).resolves.toContain("X: keyboard flow, Y: empty state copy, Z: error recovery");
+        expect(referencesRequiringAcknowledgement(context.references).map((reference) => reference.kind)).toEqual(expect.arrayContaining(["url", "repo", "image", "text"]));
+    });
+});
+//# sourceMappingURL=goal-references.test.js.map

package/dist/core/goal-references.test.js.map

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

package/dist/core/goal-store.d.ts

@@ -12,6 +12,13 @@ export interface GoalVerificationResult {
     outputPath?: string;
     checkedAt: string;
 }
+export interface GoalCompletionAudit {
+    status: GoalVerificationStatus;
+    summary: string;
+    checkedAt: string;
+    verifierCheckedAt?: string;
+    outputPath?: string;
+}
 export interface GoalPrerequisite {
     id: string;
     label: string;
@@ -39,6 +46,18 @@ export interface GoalEvidencePlan {
     instructions?: string;
     evidence?: string;
 }
+export type GoalReferenceKind = "prompt" | "url" | "repo" | "file" | "image" | "text";
+export interface GoalReference {
+    id: string;
+    kind: GoalReferenceKind;
+    label: string;
+    value?: string;
+    path?: string;
+    mediaType?: string;
+    description?: string;
+    content?: string;
+    source?: string;
+}
 export interface GoalTask {
     id: string;
     title: string;
@@ -74,9 +93,11 @@ export interface GoalRun {
     prerequisites: GoalPrerequisite[];
     harness: GoalHarnessItem[];
     evidencePlan: GoalEvidencePlan[];
+    references?: GoalReference[];
     tasks: GoalTask[];
     evidence: GoalEvidence[];
     verifier?: GoalVerifier;
+    completionAudit?: GoalCompletionAudit;
     blockers: string[];
     activeWorkerId?: string;
     continueRequestedAt?: string;
@@ -108,9 +129,11 @@ export interface GoalRunInput {
     prerequisites?: GoalPrerequisite[];
     harness?: GoalHarnessItem[];
     evidencePlan?: GoalEvidencePlan[];
+    references?: GoalReference[];
     tasks?: GoalTask[];
     evidence?: GoalEvidence[];
     verifier?: GoalVerifier;
+    completionAudit?: GoalCompletionAudit;
     blockers?: string[];
     activeWorkerId?: string;
     continueRequestedAt?: string;
@@ -134,6 +157,8 @@ export interface GoalEvidenceInput {
     createdAt?: string;
 }
 export declare function normalizeProjectPath(cwd: string): string;
+export declare function dedupeGoalBlockers(blockers: readonly string[]): string[];
+export declare function appendGoalBlockers(blockers: readonly string[], nextBlockers: string | readonly string[] | undefined): string[];
 export declare function hashPath(cwd: string): string;
 export declare function projectDir(cwd: string): string;
 export declare function createGoalTask(input: GoalTaskInput): GoalTask;