poly-weaver 1.0.0 → 1.1.0

package/dist/user/review-feedback.js

@@ -0,0 +1,184 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export const REVIEW_FEEDBACK = "default-review-feedback";
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function strings(value) {
+    return Array.isArray(value) && value.every((v) => typeof v === "string");
+}
+export function validateUserDecisions(value) {
+    if (!record(value) || !Array.isArray(value.decisions)) {
+        throw new Error("Invalid recorded user decisions: missing decisions");
+    }
+    for (const d of value.decisions) {
+        if (!record(d) || (d.comment !== undefined && typeof d.comment !== "string")) {
+            throw new Error("Invalid recorded user decision");
+        }
+        if (d.decision === "add") {
+            if (typeof d.comment === "string" && d.comment.trim())
+                continue;
+        }
+        else if ((d.decision === "keep" || d.decision === "drop" || d.decision === "revise") &&
+            Number.isInteger(d.index) && Number(d.index) >= 0 &&
+            record(d.issue) && typeof d.issue.description === "string" &&
+            (d.issue.category === undefined || typeof d.issue.category === "string") &&
+            (d.issue.severity === undefined || typeof d.issue.severity === "string") &&
+            (d.issue.citations === undefined || (Array.isArray(d.issue.citations) &&
+                d.issue.citations.every((range) => Array.isArray(range) &&
+                    range.length === 2 && range.every((line) => Number.isInteger(line))))) &&
+            (d.decision !== "revise" || (typeof d.comment === "string" && !!d.comment.trim()))) {
+            continue;
+        }
+        throw new Error("Invalid recorded user decision or issue snapshot");
+    }
+}
+export async function readUserDecisions(artifact) {
+    const data = artifact.data ?? (artifact.text !== undefined
+        ? JSON.parse(artifact.text)
+        : artifact.file ? JSON.parse(await readFile(artifact.file, "utf-8")) : undefined);
+    validateUserDecisions(data);
+    return data;
+}
+export function reviewFeedback(ctx) {
+    if (!ctx.planSteering)
+        return undefined;
+    const artifact = ctx.artifacts.get(REVIEW_FEEDBACK);
+    if (!artifact)
+        return undefined;
+    const value = artifact.data;
+    validateReviewFeedback(value);
+    return value;
+}
+function validateReviewFeedback(value) {
+    if (!record(value) || value.version !== 1 || !Array.isArray(value.batches)) {
+        throw new Error("Invalid retained review feedback: structured context is missing");
+    }
+    const ids = new Set();
+    let previousSequence = -1;
+    for (const batch of value.batches) {
+        if (!record(batch) || typeof batch.id !== "string" || typeof batch.stepId !== "string" ||
+            !Number.isInteger(batch.sequence) || Number(batch.sequence) < 0 || Number(batch.sequence) < previousSequence ||
+            ids.has(batch.id)) {
+            throw new Error("Invalid retained review feedback batch identity/order");
+        }
+        if (batch.kind === "curation")
+            validateUserDecisions(batch);
+        else if (batch.kind !== "rejection" || !strings(batch.comments)) {
+            throw new Error("Invalid retained review feedback input");
+        }
+        if (batch.consumedByPlan !== undefined && (!record(batch.consumedByPlan) ||
+            typeof batch.consumedByPlan.stepId !== "string" ||
+            !Number.isInteger(batch.consumedByPlan.sequence) ||
+            Number(batch.consumedByPlan.sequence) < Number(batch.sequence)))
+            throw new Error("Invalid retained feedback plan consumption");
+        ids.add(batch.id);
+        previousSequence = Number(batch.sequence);
+    }
+}
+async function saveFeedback(ctx, data) {
+    validateReviewFeedback(data);
+    const file = join(ctx.sessionDir, "review-feedback.json");
+    const text = JSON.stringify(data, null, 2);
+    await writeFile(file, text, "utf-8");
+    ctx.artifacts.set(REVIEW_FEEDBACK, { file, text, data });
+    return file;
+}
+/** Rebuild the agent input from checkpointed data, never from baseline prose. */
+export async function materializeReviewFeedback(ctx) {
+    const data = reviewFeedback(ctx);
+    if (data)
+        await saveFeedback(ctx, data);
+}
+export async function recordReviewFeedback(ctx, step, input, sequence = ctx.currentStepSeq ?? ctx.totalIterations) {
+    if (!ctx.planSteering)
+        return;
+    if (input.kind === "curation")
+        validateUserDecisions(input);
+    const data = reviewFeedback(ctx) ?? { version: 1, batches: [] };
+    const id = `${sequence}:${step.id}`;
+    const previous = data.batches.find((batch) => batch.id === id);
+    if (previous) {
+        const { id: _id, stepId: _stepId, sequence: _sequence, consumedByPlan: _consumed, ...oldInput } = previous;
+        if (JSON.stringify(oldInput) !== JSON.stringify(input)) {
+            throw new Error(`Conflicting retained feedback for ${id}`);
+        }
+        return;
+    }
+    await saveFeedback(ctx, {
+        version: 1,
+        batches: [...data.batches, { id, stepId: step.id, sequence, ...input }],
+    });
+}
+export function pendingPlannerFeedback(ctx) {
+    return reviewFeedback(ctx)?.batches
+        .filter((batch) => !batch.consumedByPlan)
+        .map((batch) => batch.id) ?? [];
+}
+export function hasPendingAdditions(ctx) {
+    return reviewFeedback(ctx)?.batches.some((batch) => !batch.consumedByPlan && batch.kind === "curation" &&
+        batch.decisions.some((decision) => decision.decision === "add")) ?? false;
+}
+export async function consumePlannerFeedback(ctx, step, ids, sequence = ctx.currentStepSeq ?? ctx.totalIterations) {
+    const data = reviewFeedback(ctx);
+    if (!data || !ids.length)
+        return;
+    const consumed = new Set(ids);
+    await saveFeedback(ctx, {
+        version: 1,
+        batches: data.batches.map((batch) => consumed.has(batch.id)
+            ? { ...batch, consumedByPlan: { stepId: step.id, sequence } }
+            : batch),
+    });
+}
+export function recordedDrops(ctx) {
+    return reviewFeedback(ctx)?.batches.flatMap((batch) => batch.kind === "curation"
+        ? batch.decisions.flatMap((d) => d.decision === "drop"
+            ? [{ batchId: batch.id, issue: d.issue }] : [])
+        : []) ?? [];
+}
+export function isDefaultPlanApproval(step, ctx) {
+    return !!ctx.planSteering && step.role === "user" && !step.variant &&
+        step.reads.display === ctx.planSteering.mainPlanKey;
+}
+/** Import only originating completed steps, not sidecar copies in later snapshots. */
+export async function restoreLegacyReviewFeedback(snap, step, ctx) {
+    if (!ctx.planSteering || snap.artifactStore[REVIEW_FEEDBACK])
+        return;
+    if (step.role === "user" && step.variant === "curate-verdict") {
+        const key = step.writes.userDecisions;
+        const ref = key ? snap.artifactStore[key] : undefined;
+        if (ref) {
+            const data = await readUserDecisions({
+                data: ref.dataJson !== undefined ? JSON.parse(ref.dataJson) : undefined,
+                text: ref.text, file: ref.persistentPath,
+            });
+            await recordReviewFeedback(ctx, step, { kind: "curation", decisions: data.decisions }, snap.seq);
+            const restored = ctx.artifacts.get(key);
+            ctx.artifacts.set(key, { ...restored, data });
+            const verdictKey = step.writes.verdict ?? step.reads.verdict;
+            const verdict = ctx.artifacts.get(verdictKey);
+            if (verdict?.meta?.source === "reviewer") {
+                ctx.artifacts.set(verdictKey, { ...verdict, meta: { ...verdict.meta, source: "curated" } });
+            }
+        }
+    }
+    else if (isDefaultPlanApproval(step, ctx)) {
+        const ref = snap.artifactStore[step.writes.verdict];
+        const data = ref?.dataJson ? JSON.parse(ref.dataJson) : undefined;
+        const rejected = record(data) ? data.approved === false
+            : snap.signal?.kind === "restart-loop" || !!ref?.text;
+        if (ref?.meta?.source === "user" && rejected) {
+            const comments = record(data) && strings(data.feedbackItems) ? data.feedbackItems
+                : ref.text ? [ref.text]
+                    : ref.persistentPath ? [await readFile(ref.persistentPath, "utf-8")] : undefined;
+            if (!comments)
+                throw new Error(`Missing recorded rejection feedback at step ${snap.seq}`);
+            await recordReviewFeedback(ctx, step, { kind: "rejection", comments }, snap.seq);
+        }
+    }
+    else if (step.role === "planner" && ctx.artifacts.getFile(step.writes.plan)) {
+        await consumePlannerFeedback(ctx, step, pendingPlannerFeedback(ctx), snap.seq);
+    }
+}
+//# sourceMappingURL=review-feedback.js.map

package/dist/user/review-feedback.js.map

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

package/dist/user/review-plan-pane.d.ts

@@ -0,0 +1,5 @@
+import { type PlanPaneOutput } from "./plan-pane.js";
+import type { UserPromptContext } from "./prompt.js";
+/** One presentation model for rendering, scrolling and selection; plan sources stay intact. */
+export declare function buildReviewPlanPane(plan: string, context: UserPromptContext, width: number): PlanPaneOutput;
+//# sourceMappingURL=review-plan-pane.d.ts.map

package/dist/user/review-plan-pane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan-pane.d.ts","sourceRoot":"","sources":["../../src/user/review-plan-pane.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GACZ,cAAc,CAmBhB"}

package/dist/user/review-plan-pane.js

@@ -0,0 +1,26 @@
+import { bold, cyan, dim, reset } from "../ansi.js";
+import { wrapToWidth } from "./curate-prompt.js";
+import { buildPlanPane } from "./plan-pane.js";
+/** One presentation model for rendering, scrolling and selection; plan sources stay intact. */
+export function buildReviewPlanPane(plan, context, width) {
+    const pane = buildPlanPane(plan, context.phaseLabel, width, context.artifactKind ?? "plan");
+    if (!context.recordedDrops?.length)
+        return pane;
+    const contextLines = [
+        ...wrapToWidth("Recorded drop decisions (read-only)", width).map((line) => `${bold}${cyan}${line}${reset}`),
+        `${dim}${"-".repeat(Math.max(1, width))}${reset}`,
+        ...wrapToWidth("User decisions, not proof of fixes. Later explicit guidance may supersede them.", width),
+        "",
+        ...context.recordedDrops.flatMap((drop, index) => [
+            ...wrapToWidth(`${index + 1}. User decision: drop (batch ${drop.batchId})`, width),
+            ...wrapToWidth(`Reviewer concern: ${drop.issue.description}`, width),
+            "",
+        ]),
+    ];
+    return {
+        lines: [...contextLines, ...pane.lines],
+        sources: [...contextLines.map(() => undefined), ...pane.sources],
+        contentLines: contextLines.length + pane.contentLines,
+    };
+}
+//# sourceMappingURL=review-plan-pane.js.map

package/dist/user/review-plan-pane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan-pane.js","sourceRoot":"","sources":["../../src/user/review-plan-pane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AAGpE,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAA0B,EAC1B,KAAa;IAEb,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC;IAC5F,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,YAAY,GAAG;QACnB,GAAG,WAAW,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;QAC3G,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,EAAE;QACjD,GAAG,WAAW,CAAC,iFAAiF,EAAE,KAAK,CAAC;QACxG,EAAE;QACF,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChD,GAAG,WAAW,CAAC,GAAG,KAAK,GAAG,CAAC,gCAAgC,IAAI,CAAC,OAAO,GAAG,EAAE,KAAK,CAAC;YAClF,GAAG,WAAW,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC;YACpE,EAAE;SACH,CAAC;KACH,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACvC,OAAO,EAAE,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAChE,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY;KACtD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poly-weaver",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Orchestrates pluggable AI coding agents in an iterative plan-review loop",
   "license": "MIT",
   "repository": {