poly-weaver 0.10.5 → 0.10.6

package/dist/agents/reviewers/handler.js

@@ -2,7 +2,8 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { formatUserDecisionsInline } from "./prompts.js";
 import { readVerdictFromContract, removeFileIfExists, } from "../../orchestrator.js";
-import { bindSessionReporter, bindDriverRuntime, bindPtyBufferReporter, bindAttemptFailureReporter } from "../runner.js";
+import { bindAttemptFailureReporter, bindDriverRuntime, bindPtyBufferReporter, bindSessionReporter, flushDriverSidecar, } from "../runner.js";
+import { bindStepLiveSidecar, cleanupStepLiveSidecar, resolveResumeSessionId, } from "../session-resume.js";
 export class ReviewerRoleHandler {
     driver;
     constructor(driver) {
@@ -31,11 +32,12 @@ export class ReviewerRoleHandler {
             throw new Error("ReviewerRoleHandler: plan artifact missing");
         const stepAny = step;
         const sessionKey = stepAny.sessionShareKey ?? step.id;
-        if (stepAny.sessionBoundary?.(ctx)) {
+        const boundaryFired = stepAny.sessionBoundary?.(ctx) === true;
+        if (boundaryFired) {
             ctx.sessionIds.delete(sessionKey);
         }
         const outputVerdictFile = join(ctx.sessionDir, "verdict.json");
-        const resumeSessionId = ctx.sessionIds.get(sessionKey);
+        const resumeSessionId = await resolveResumeSessionId(ctx, stepAny, this.driver, sessionKey, ctx.sessionIds.get(sessionKey), boundaryFired);
         const verdictArtifact = step.reads.verdict
             ? ctx.artifacts.get(step.reads.verdict)
             : undefined;
@@ -46,36 +48,37 @@ export class ReviewerRoleHandler {
         bindPtyBufferReporter(this.driver, ctx);
         bindAttemptFailureReporter(this.driver, ctx);
         bindDriverRuntime(this.driver, { output: ctx.output, terminalHost: ctx.terminalHost });
+        const sidecarPath = bindStepLiveSidecar(this.driver, ctx, sessionKey, stepAny.driver);
         const decisionsAllowed = step.reads.userDecisions != null &&
             (stepAny.userDecisionsWhen == null || stepAny.userDecisionsWhen(ctx));
         const userDecisionsFile = decisionsAllowed
             ? ctx.artifacts.getFile(step.reads.userDecisions)
             : undefined;
         let decisionsInline;
-        let planText;
         let prevVerdictText;
-        if (userDecisionsFile != null &&
-            resumeSessionId != null) {
+        let verdictSource;
+        const verdictKey = step.reads.verdict ?? step.writes.verdict;
+        const revisionVerdictArtifact = verdictKey
+            ? ctx.artifacts.get(verdictKey)
+            : undefined;
+        const revisionVerdictText = revisionVerdictArtifact?.text;
+        if (revisionVerdictText != null && revisionVerdictText.length > 0) {
+            prevVerdictText = revisionVerdictText;
+            const source = revisionVerdictArtifact?.meta?.source;
+            if (source === "reviewer" || source === "user") {
+                verdictSource = source;
+            }
+        }
+        if (userDecisionsFile != null) {
             try {
                 const sidecarRaw = await readFile(userDecisionsFile, "utf-8");
                 const sidecar = JSON.parse(sidecarRaw);
                 const inline = formatUserDecisionsInline(sidecar.decisions);
-                const verdictKey = step.reads.verdict ?? step.writes.verdict;
-                const verdictText = verdictKey
-                    ? ctx.artifacts.getText(verdictKey)
-                    : undefined;
-                const planKey = step.reads.plan;
-                let pText = ctx.artifacts.getText(planKey);
-                if (pText == null && planFile) {
-                    pText = await readFile(planFile, "utf-8");
-                }
-                if (inline && verdictText && pText) {
+                if (inline && prevVerdictText) {
                     decisionsInline = inline;
-                    planText = pText;
-                    prevVerdictText = verdictText;
                 }
                 else {
-                    throw new Error("missing inline decisions, plan text, or prior verdict text");
+                    throw new Error("missing inline decisions or prior verdict text");
                 }
             }
             catch (err) {
@@ -87,30 +90,38 @@ export class ReviewerRoleHandler {
                     console.warn(`[poly-weaver] ${msg}`);
                 }
                 decisionsInline = undefined;
-                planText = undefined;
                 prevVerdictText = undefined;
+                verdictSource = undefined;
             }
         }
-        const planLineCountText = planText ?? await readFile(planFile, "utf-8");
+        const planLineCountText = ctx.artifacts.getText(step.reads.plan) ?? await readFile(planFile, "utf-8");
         const planLineCount = planLineCountText.split(/\r?\n/).length;
-        const { reviewResult, verdictRaw, verdictData } = await retry("reviewer", async (attempt) => {
-            // Stale-file guard: never re-read a prior verdict if the reviewer fails to write.
-            await removeFileIfExists(outputVerdictFile);
-            const reviewResult = await this.driver.run(baselineFile, planFile, {
-                outputVerdictFile,
-                resumeSessionId: attempt === 1 ? resumeSessionId : undefined,
-                variant: step.variant,
-                baselineKind,
-                userDecisionsFile,
-                decisionsInline,
-                planText,
-                prevVerdictText,
-                userFeedbackFile,
-            });
-            const verdictData = await readVerdictFromContract(outputVerdictFile, planLineCount);
-            const verdictRaw = await readFile(outputVerdictFile, "utf-8");
-            return { reviewResult, verdictRaw, verdictData };
-        });
+        let reviewResult;
+        let verdictRaw;
+        let verdictData;
+        try {
+            ({ reviewResult, verdictRaw, verdictData } = await retry("reviewer", async (attempt) => {
+                // Stale-file guard: never re-read a prior verdict if the reviewer fails to write.
+                await removeFileIfExists(outputVerdictFile);
+                const reviewResult = await this.driver.run(baselineFile, planFile, {
+                    outputVerdictFile,
+                    resumeSessionId: attempt === 1 ? resumeSessionId : undefined,
+                    variant: step.variant,
+                    baselineKind,
+                    userDecisionsFile,
+                    decisionsInline,
+                    prevVerdictText,
+                    verdictSource,
+                    userFeedbackFile,
+                });
+                const verdictData = await readVerdictFromContract(outputVerdictFile, planLineCount);
+                const verdictRaw = await readFile(outputVerdictFile, "utf-8");
+                return { reviewResult, verdictRaw, verdictData };
+            }));
+        }
+        finally {
+            await flushDriverSidecar(this.driver);
+        }
         // Record session file for dump
         if (reviewResult.sessionFilePath) {
             ctx.lastStepSessionFilePaths?.push(reviewResult.sessionFilePath);
@@ -127,6 +138,7 @@ export class ReviewerRoleHandler {
         if (reviewResult.sessionId) {
             ctx.sessionIds.set(sessionKey, reviewResult.sessionId);
         }
+        await cleanupStepLiveSidecar(sidecarPath);
         return { kind: "continue" };
     }
 }

package/dist/agents/reviewers/handler.js.map

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

package/dist/agents/reviewers/index.d.ts

@@ -1,10 +1,10 @@
 import type { ProviderStrategy } from "../../providers/types.js";
-import type { ReviewerDriver, ReviewPromptBuilder, FreshFallbackReviewPromptBuilder } from "./types.js";
+import type { ReviewerDriver, ReviewPromptBuilder, FreshRevisionReviewPromptBuilder } from "./types.js";
 import type { DriverName } from "../../flow/types.js";
 export { review } from "./dsl.js";
 export { ReviewerRoleHandler } from "./handler.js";
-export type { ReviewerDriver, ReviewPromptBuilder, FreshFallbackReviewPromptBuilder, } from "./types.js";
-export type ReviewerFactory = (workdir: string, promptBuilder?: ReviewPromptBuilder, resumePromptBuilder?: ReviewPromptBuilder, freshFallbackPromptBuilder?: FreshFallbackReviewPromptBuilder) => ReviewerDriver;
+export type { ReviewerDriver, ReviewPromptBuilder, FreshRevisionReviewPromptBuilder, } from "./types.js";
+export type ReviewerFactory = (workdir: string, promptBuilder?: ReviewPromptBuilder, resumePromptBuilder?: ReviewPromptBuilder, freshRevisionPromptBuilder?: FreshRevisionReviewPromptBuilder) => ReviewerDriver;
 export declare const registerProvider: (name: DriverName, strategy: ProviderStrategy) => void;
 export declare const registerFactory: (name: string, factory: ReviewerFactory) => void, availableDrivers: () => string[];
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/reviewers/index.js

@@ -1,7 +1,7 @@
 import { ReviewerAdapter } from "./adapter.js";
 import { ReviewerRoleHandler } from "./handler.js";
 import { createRoleModule } from "../registry.js";
-import { buildReviewerPrompt, buildResumeReviewerPrompt, buildImplementationReviewerPrompt, buildResumeImplementationReviewerPrompt, buildInContextFreshFallbackReviewerPrompt, } from "./prompts.js";
+import { buildReviewerPrompt, buildResumeReviewerPrompt, buildImplementationReviewerPrompt, buildResumeImplementationReviewerPrompt, buildFreshRevisionReviewerPrompt, } from "./prompts.js";
 export { review } from "./dsl.js";
 export { ReviewerRoleHandler } from "./handler.js";
 function resolveReviewerPrompts(opts) {
@@ -9,24 +9,24 @@ function resolveReviewerPrompts(opts) {
         return {
             pb: buildImplementationReviewerPrompt,
             rpb: buildResumeImplementationReviewerPrompt,
-            ffpb: undefined,
+            frpb: undefined,
         };
     }
     return {
         pb: buildReviewerPrompt,
         rpb: buildResumeReviewerPrompt,
-        ffpb: buildInContextFreshFallbackReviewerPrompt,
+        frpb: buildFreshRevisionReviewerPrompt,
     };
 }
 const mod = createRoleModule({
     roleName: "reviewer",
     fromFactory: (factory, workdir, opts) => {
-        const { pb, rpb, ffpb } = resolveReviewerPrompts(opts);
-        return factory(workdir, pb, rpb, ffpb);
+        const { pb, rpb, frpb } = resolveReviewerPrompts(opts);
+        return factory(workdir, pb, rpb, frpb);
     },
     fromProvider: (strategy, workdir, opts) => {
-        const { pb, rpb, ffpb } = resolveReviewerPrompts(opts);
-        return new ReviewerAdapter(strategy, workdir, pb, rpb, ffpb, opts?.yolo, opts?.model, opts?.effort, opts?.sessionFileWaitMs);
+        const { pb, rpb, frpb } = resolveReviewerPrompts(opts);
+        return new ReviewerAdapter(strategy, workdir, pb, rpb, frpb, opts?.yolo, opts?.model, opts?.effort, opts?.sessionFileWaitMs);
     },
     toHandler: (driver) => new ReviewerRoleHandler(driver),
 });

package/dist/agents/reviewers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/reviewers/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iCAAiC,EACjC,uCAAuC,EACvC,yCAAyC,GAC1C,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcnD,SAAS,sBAAsB,CAAC,IAAkB;IAKhD,IAAI,IAAI,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,iCAAiC;YACrC,GAAG,EAAE,uCAAuC;YAC5C,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,yCAAyC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,GAAG,gBAAgB,CAAkC;IAC5D,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACxC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,eAAe,CACxB,QAAQ,EACR,OAAO,EACP,EAAE,EACF,GAAG,EACH,IAAI,EACJ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,CACxB,CAAC;IACJ,CAAC;IACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAA0E,CAAC;AAC/G,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/reviewers/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iCAAiC,EACjC,uCAAuC,EACvC,gCAAgC,GACjC,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAcnD,SAAS,sBAAsB,CAAC,IAAkB;IAKhD,IAAI,IAAI,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,iCAAiC;YACrC,GAAG,EAAE,uCAAuC;YAC5C,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,gCAAgC;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,GAAG,gBAAgB,CAAkC;IAC5D,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACxC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,eAAe,CACxB,QAAQ,EACR,OAAO,EACP,EAAE,EACF,GAAG,EACH,IAAI,EACJ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,CACxB,CAAC;IACJ,CAAC;IACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAA0E,CAAC;AAC/G,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC"}

package/dist/agents/reviewers/prompts.d.ts

@@ -3,7 +3,7 @@ export declare function truncateWords(text: string, n: number): string;
 export declare function formatUserDecisionsInline(decisions: UserDecisionsSidecar["decisions"]): string;
 export declare function buildReviewerPrompt(baselineFile: string, planFile: string, outputVerdictFile: string, _userDecisionsFile?: string, _decisionsInline?: string, baselineKind?: "spec" | "task", _userFeedbackFile?: string): Promise<string>;
 export declare function buildResumeReviewerPrompt(_baselineFile: string, planFile: string, outputVerdictFile: string, userDecisionsFile?: string, decisionsInline?: string, _baselineKind?: "spec" | "task", userFeedbackFile?: string): Promise<string>;
-export declare function buildInContextFreshFallbackReviewerPrompt(planText: string, prevVerdictText: string, decisionsInline: string, outputVerdictFile: string): Promise<string>;
+export declare function buildFreshRevisionReviewerPrompt(baselineFile: string, planFile: string, outputVerdictFile: string, prevVerdictText: string, verdictSource: "reviewer" | "user" | undefined, decisionsInline?: string, baselineKind?: "spec" | "task"): Promise<string>;
 export declare function buildImplementationReviewerPrompt(_baselineFile: string, planFile: string, outputVerdictFile: string): Promise<string>;
 export declare function buildResumeImplementationReviewerPrompt(_baselineFile: string, _planFile: string, outputVerdictFile: string): Promise<string>;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/agents/reviewers/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/agents/reviewers/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,GAC3C,MAAM,CAiBR;AAyDD,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,gBAAgB,CAAC,EAAE,MAAM,EACzB,YAAY,GAAE,MAAM,GAAG,MAAe,EACtC,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAC/B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED,wBAAsB,yCAAyC,CAC7D,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,iCAAiC,CACrD,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,uCAAuC,CAC3D,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAMjB"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/agents/reviewers/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,GAC3C,MAAM,CAiBR;AAyDD,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,gBAAgB,CAAC,EAAE,MAAM,EACzB,YAAY,GAAE,MAAM,GAAG,MAAe,EACtC,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAC/B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,EAC9C,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,GAAE,MAAM,GAAG,MAAe,GACrC,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED,wBAAsB,iCAAiC,CACrD,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,uCAAuC,CAC3D,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/agents/reviewers/prompts.js

@@ -117,18 +117,48 @@ export async function buildResumeReviewerPrompt(_baselineFile, planFile, outputV
         `Write your verdict as JSON to: ${outputVerdictFile}`,
     ].join("\n");
 }
-export async function buildInContextFreshFallbackReviewerPrompt(planText, prevVerdictText, decisionsInline, outputVerdictFile) {
-    return [
-        "Original plan:",
-        planText,
+export async function buildFreshRevisionReviewerPrompt(baselineFile, planFile, outputVerdictFile, prevVerdictText, verdictSource, decisionsInline, baselineKind = "task") {
+    const label = baselineKind === "spec" ? "spec" : "task";
+    const head = [
+        `Read the ${label}: ${baselineFile}`,
+        `Read the revised plan: ${planFile}`,
         "",
-        "Previous verdict:",
+    ];
+    if (decisionsInline) {
+        return [
+            ...head,
+            "Your previous verdict on the earlier plan:",
+            prevVerdictText,
+            "",
+            "Apply these user-requested verdict changes:",
+            decisionsInline,
+            "",
+            `Write your verdict as JSON to: ${outputVerdictFile}`,
+            "",
+            ...reviewerSchemaAndRules("plan"),
+        ].join("\n");
+    }
+    if (verdictSource === "user") {
+        return [
+            ...head,
+            "The user's feedback on the earlier plan:",
+            prevVerdictText,
+            "",
+            `The plan was revised to address the user's feedback. Re-evaluate the revised plan against the ${label}.`,
+            "",
+            `Write your verdict as JSON to: ${outputVerdictFile}`,
+            "",
+            ...reviewerSchemaAndRules("plan"),
+        ].join("\n");
+    }
+    return [
+        ...head,
+        "Your previous verdict on the earlier plan:",
         prevVerdictText,
         "",
-        "Apply these user-requested verdict changes:",
-        decisionsInline,
+        `Re-evaluate the revised plan against the ${label}, checking whether the issues in your previous verdict are addressed.`,
         "",
-        `Write the revised verdict as JSON to: ${outputVerdictFile}`,
+        `Write your verdict as JSON to: ${outputVerdictFile}`,
         "",
         ...reviewerSchemaAndRules("plan"),
     ].join("\n");

package/dist/agents/reviewers/prompts.js.map

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

package/dist/agents/reviewers/types.d.ts

@@ -17,22 +17,16 @@ export type ReviewerRunOpts = {
     userDecisionsFile?: string;
     /** Numbered, inline-rendered user decisions for same-plan verdict refinement.
      *  Formatted by the handler from the sidecar so the adapter can build a terse
-     *  resume prompt or a fresh-fallback prompt without the model rereading the file. */
+     *  resume prompt or a fresh revision prompt without the model rereading the file. */
     decisionsInline?: string;
-    /** Original plan text — supplied by the handler so the adapter can build a
-     *  fresh-fallback prompt that inlines the plan when resume fails. */
-    planText?: string;
     /** Prior unapproved verdict text — supplied by the handler so the adapter can
-     *  build a fresh-fallback prompt that inlines the verdict when resume fails. */
+     *  build a complete fresh revision prompt when no provider session is present. */
     prevVerdictText?: string;
+    /** Source of the prior verdict text, if known. */
+    verdictSource?: "reviewer" | "user";
 };
 export type ReviewPromptBuilder = (baselineFile: string, planFile: string, outputVerdictFile: string, userDecisionsFile?: string, decisionsInline?: string, baselineKind?: "spec" | "task", userFeedbackFile?: string) => Promise<string>;
-/**
- * Builds a fresh-session prompt used by the runner when an in-context resume
- * fails. Inputs are textual blobs (not file paths) so the model sees the plan
- * and prior verdict inline alongside the same numbered decision list.
- */
-export type FreshFallbackReviewPromptBuilder = (planText: string, prevVerdictText: string, decisionsInline: string, outputVerdictFile: string) => Promise<string>;
+export type FreshRevisionReviewPromptBuilder = (baselineFile: string, planFile: string, outputVerdictFile: string, prevVerdictText: string, verdictSource?: "reviewer" | "user", decisionsInline?: string, baselineKind?: "spec" | "task") => Promise<string>;
 /**
  * Select the appropriate prompt builder based on whether this is a resume.
  */

package/dist/agents/reviewers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/reviewers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,GAAG,CACD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,iDAAiD;IACjD,YAAY,IAAI,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;yFAEqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;yEACqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;oFACgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,CAC7C,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,mBAAmB,EAClC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,mBAAmB,CAKrB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/reviewers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,GAAG,CACD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,iDAAiD;IACjD,YAAY,IAAI,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;yFAEqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;sFACkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,gCAAgC,GAAG,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,EACnC,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,KAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,mBAAmB,EAClC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,mBAAmB,CAKrB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/agents/reviewers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/reviewers/types.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAAkC,EAClC,mBAAoD,EACpD,eAAmC;IAEnC,IAAI,eAAe,IAAI,mBAAmB,EAAE,CAAC;QAC3C,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/reviewers/types.ts"],"names":[],"mappings":"AAuDA;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAAkC,EAClC,mBAAoD,EACpD,eAAmC;IAEnC,IAAI,eAAe,IAAI,mBAAmB,EAAE,CAAC;QAC3C,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/agents/runner.d.ts

@@ -64,6 +64,10 @@ export interface RunResult {
     /** Line offset into the session file where this turn's data starts. */
     lineOffset: number;
 }
+export interface LiveSidecarMeta {
+    driver: string;
+    sessionKey: string;
+}
 /**
  * Thrown when the user interrupts a run via Ctrl+C while the orchestration
  * host owns raw stdin. Distinguished from ordinary failures so the
@@ -98,11 +102,16 @@ export declare abstract class BaseAdapter {
     protected readonly runner: AgentRunner;
     protected sessionId: string | undefined;
     protected sessionFilePath: string | undefined;
+    private pendingSidecarWrite;
     /** Runtime context attached by the role handler before each driver.run() call. */
     protected runtimeOutput: OrchestrationOutput | undefined;
     protected runtimeHost: TerminalHost | undefined;
     constructor(strategy: ProviderStrategy, workdir: string, yolo?: boolean, model?: string | undefined, effort?: string | undefined, sessionFileWaitMs?: number);
     getSessionId(): string | undefined;
+    locateSessionFile(sessionId: string): Promise<string | undefined>;
+    primeResumeSessionFile(sessionFilePath: string): void;
+    setLiveSidecar(sidecarPath: string, meta: LiveSidecarMeta): void;
+    flushPendingSidecar(): Promise<void>;
     /**
      * Inject orchestration runtime references. Called by role handlers
      * before driver.run() so the runner can route warnings to the host
@@ -124,8 +133,13 @@ export declare abstract class BaseAdapter {
     ptyBufferCallback?: (buffer: PtyTailBuffer) => void;
     /** Optional callback invoked with per-attempt process failure diagnostics. */
     attemptFailureCallback?: (record: AttemptFailureRecord) => void;
+    private writeSidecar;
     protected runAgent(request: RunRequest): Promise<RunResult>;
 }
+export declare function bindLiveSidecar(driver: unknown, sidecarPath: string, meta: LiveSidecarMeta): void;
+export declare function flushDriverSidecar(driver: unknown): Promise<void>;
+export declare function locateDriverSessionFile(driver: unknown, sessionId: string): Promise<string | undefined>;
+export declare function primeDriverResumeSessionFile(driver: unknown, sessionFilePath: string): void;
 /**
  * Inject runtime references (orchestration sink + terminal host) onto a
  * BaseAdapter-backed driver. No-ops for non-BaseAdapter drivers (e.g. mocks

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

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

package/dist/agents/runner.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { writeFile } from "node:fs/promises";
 import { resolveSpawnCommand, spawnPty } from "../pty/spawn.js";
 import { sendExit } from "../pty/exit.js";
 import { readSessionFile } from "../session/reader.js";
@@ -53,6 +54,7 @@ export class BaseAdapter {
     runner;
     sessionId;
     sessionFilePath;
+    pendingSidecarWrite;
     /** Runtime context attached by the role handler before each driver.run() call. */
     runtimeOutput;
     runtimeHost;
@@ -67,6 +69,31 @@ export class BaseAdapter {
     getSessionId() {
         return this.sessionId;
     }
+    async locateSessionFile(sessionId) {
+        return await this.strategy.session.locateSessionById?.(this.workdir, sessionId);
+    }
+    primeResumeSessionFile(sessionFilePath) {
+        this.sessionFilePath = sessionFilePath;
+    }
+    setLiveSidecar(sidecarPath, meta) {
+        const previous = this.sessionFileCallback;
+        this.sessionFileCallback = (path) => {
+            previous?.(path);
+            const prior = this.pendingSidecarWrite ?? Promise.resolve();
+            this.pendingSidecarWrite = prior.then(() => this.writeSidecar(sidecarPath, meta, path));
+            void this.pendingSidecarWrite.catch(() => { });
+        };
+    }
+    async flushPendingSidecar() {
+        if (!this.pendingSidecarWrite)
+            return;
+        try {
+            await this.pendingSidecarWrite;
+        }
+        catch {
+            /* best-effort */
+        }
+    }
     /**
      * Inject orchestration runtime references. Called by role handlers
      * before driver.run() so the runner can route warnings to the host
@@ -91,6 +118,20 @@ export class BaseAdapter {
     ptyBufferCallback;
     /** Optional callback invoked with per-attempt process failure diagnostics. */
     attemptFailureCallback;
+    async writeSidecar(sidecarPath, meta, sessionFilePath) {
+        try {
+            const sessionId = await this.strategy.session.extractSessionId(sessionFilePath);
+            await writeFile(sidecarPath, JSON.stringify({
+                sessionId,
+                driver: meta.driver,
+                sessionKey: meta.sessionKey,
+                lastUpdated: new Date().toISOString(),
+            }), "utf8");
+        }
+        catch {
+            /* best-effort */
+        }
+    }
     async runAgent(request) {
         const merged = {
             ...request,
@@ -110,6 +151,30 @@ export class BaseAdapter {
         return result;
     }
 }
+export function bindLiveSidecar(driver, sidecarPath, meta) {
+    if (driver != null && typeof driver.setLiveSidecar === "function") {
+        driver
+            .setLiveSidecar(sidecarPath, meta);
+    }
+}
+export async function flushDriverSidecar(driver) {
+    if (driver != null && typeof driver.flushPendingSidecar === "function") {
+        await driver.flushPendingSidecar();
+    }
+}
+export async function locateDriverSessionFile(driver, sessionId) {
+    if (driver != null && typeof driver.locateSessionFile === "function") {
+        return await driver
+            .locateSessionFile(sessionId);
+    }
+    return undefined;
+}
+export function primeDriverResumeSessionFile(driver, sessionFilePath) {
+    if (driver != null && typeof driver.primeResumeSessionFile === "function") {
+        driver
+            .primeResumeSessionFile(sessionFilePath);
+    }
+}
 /**
  * Inject runtime references (orchestration sink + terminal host) onto a
  * BaseAdapter-backed driver. No-ops for non-BaseAdapter drivers (e.g. mocks