poly-weaver 0.13.1 → 0.13.3

package/dist/session/session-store.js

@@ -76,21 +76,31 @@ export class SessionStore {
             completedAt: new Date().toISOString(),
         };
         await atomicWriteJson(join(this.persistentDir, "steps", stepFilename(seq)), entry);
-        this.manifest = {
-            ...this.manifest,
+        await this.updateManifest({
             lastCompletedSeq: seq,
             lastActivityAt: entry.completedAt,
-        };
-        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+        });
     };
     /** Mark this session complete so the picker hides it; pruner deletes after 7d. */
     async markComplete() {
-        this.manifest = {
-            ...this.manifest,
+        await this.updateManifest({
             status: "complete",
             lastActivityAt: new Date().toISOString(),
-        };
-        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+        });
+    }
+    /**
+     * Durably complete the delayed working-tree capture without changing
+     * checkpoint or resume state.
+     */
+    async completeUncommittedSnapshot(state) {
+        if (this.manifest.uncommittedSnapshot !== "pending") {
+            throw new Error(`Cannot complete uncommitted snapshot from state ` +
+                `${this.manifest.uncommittedSnapshot ?? "omitted"}`);
+        }
+        await this.updateManifest({
+            uncommittedSnapshot: state,
+            lastActivityAt: new Date().toISOString(),
+        });
     }
     /**
      * During resume fast-forward, ctx.sessionIds is intentionally left empty so
@@ -113,25 +123,39 @@ export class SessionStore {
     async snapshotArtifact(seq, storeKey, artifact) {
         const ref = { storeKey };
         if (artifact.file) {
-            const ext = extname(artifact.file);
-            const safeKey = storeKey.replace(/[^A-Za-z0-9._-]/g, "_");
-            const dest = join(this.persistentDir, "artifacts", `step-${String(seq).padStart(4, "0")}-${safeKey}${ext}`);
-            try {
-                await copyFile(artifact.file, dest);
-                ref.persistentPath = dest;
+            if (artifact.immutablePersistentFile) {
+                ref.persistentPath = artifact.file;
             }
-            catch {
-                // Source may have been cleaned up; fall through with text/data only.
+            else {
+                const ext = extname(artifact.file);
+                const safeKey = storeKey.replace(/[^A-Za-z0-9._-]/g, "_");
+                const dest = join(this.persistentDir, "artifacts", `step-${String(seq).padStart(4, "0")}-${safeKey}${ext}`);
+                try {
+                    await copyFile(artifact.file, dest);
+                    ref.persistentPath = dest;
+                }
+                catch {
+                    // Source may have been cleaned up; fall through with text/data only.
+                }
             }
         }
-        if (artifact.text !== undefined)
+        if (artifact.text !== undefined &&
+            !(artifact.file && artifact.immutablePersistentFile)) {
             ref.text = artifact.text;
+        }
         if (artifact.data !== undefined)
             ref.dataJson = JSON.stringify(artifact.data);
         if (artifact.meta !== undefined)
             ref.meta = artifact.meta;
         return ref;
     }
+    async updateManifest(patch) {
+        this.manifest = {
+            ...this.manifest,
+            ...patch,
+        };
+        await atomicWriteJson(join(this.persistentDir, "manifest.json"), this.manifest);
+    }
     /**
      * Build a per-step input/output ref. Prefer the already-snapshotted artifact
      * store entry (so persistentPath matches), but fall back to a minimal ref

package/dist/session/session-store.js.map

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

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjE"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,wBAAwB,+BAAwB,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjE"}

package/dist/update-check.js

@@ -2,7 +2,8 @@ import https from "node:https";
 import { APP_VERSION } from "./version.js";
 import { compareSemver } from "./auto-update/semver.js";
 import { REGISTRY_HTTPS_TIMEOUT_MS } from "./auto-update/timeouts.js";
-export const POLY_WEAVER_NPM_REGISTRY = "https://registry.npmjs.org";
+import { OFFICIAL_NPM_REGISTRY } from "./auto-update/npm-commands.js";
+export const POLY_WEAVER_NPM_REGISTRY = OFFICIAL_NPM_REGISTRY;
 /**
  * Check the npm registry for a newer version of poly-weaver.
  * Returns `{ current, latest }` when an update is available, or `null`

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAOrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CACnB,GAAG,wBAAwB,cAAc,EACzC;YACE,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE;gBACP,MAAM,EAAE,qCAAqC;aAC9C;SACF,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;gBAClF,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,UAAU,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YAED,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAE3B,CAAC;oBACF,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAClD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;oBACpC,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;oBACtD,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAO9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CACnB,GAAG,wBAAwB,cAAc,EACzC;YACE,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE;gBACP,MAAM,EAAE,qCAAqC;aAC9C;SACF,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;gBAClF,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,UAAU,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YAED,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAE3B,CAAC;oBACF,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAClD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;oBACpC,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;oBACtD,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/user/host-curate-prompt.d.ts

@@ -25,7 +25,9 @@ export declare const KDR_HINT: string;
  *   - k/d/r toggles the cursor row's decision.
  *   - Tab cycles keep → drop → revise → keep.
  *   - Enter on editable rows opens an inline editor; Esc cancels.
- *   - PageUp/PageDown/Home/End/wheel scrolls the plan.
+ *   - PageUp/PageDown/Home/End scrolls the plan. Wheel input scrolls the plan
+ *     over that pane and moves at most one logical row per input batch over
+ *     the issues pane, based on the batch's net wheel direction.
  *   - Up/Down moves the cursor among all navigable rows.
  *   - Ctrl+D submits; Ctrl+C quits poly-weaver (exit code 130). Inside the
  *     inline revise editor (`state.editing`), Ctrl+C cancels the edit only.

package/dist/user/host-curate-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-curate-prompt.d.ts","sourceRoot":"","sources":["../../src/user/host-curate-prompt.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAUL,KAAK,cAAc,EAEnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,qBAAqB,CAAC;AAOzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAQzE,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAEzC,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;CAiezB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,EAAE,UAAU,CAAC;QACnB,WAAW,EAAE,iBAAiB,CAAC;QAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,GAAG,SAAS,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,OAAO,CAAC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,OAAO,EACrB,YAAY,GAAE;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAAO,EAClE,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAsBV;AAWD,KAAK,UAAU,GACX;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C,kBAAkB,CAAC;AAgoBvB,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,YAAY,UAAO,GAAG,MAAM,CAWpF;AAMD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,SAAS,EAAE,MAAM,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,WAAW,EAAE,2BAA2B,CAAC,CAAC,CA4BvE"}
+{"version":3,"file":"host-curate-prompt.d.ts","sourceRoot":"","sources":["../../src/user/host-curate-prompt.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAUL,KAAK,cAAc,EAEnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,qBAAqB,CAAC;AAOzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAQzE,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAEzC,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;CA0mBzB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,EAAE,UAAU,CAAC;QACnB,WAAW,EAAE,iBAAiB,CAAC;QAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,GAAG,SAAS,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,OAAO,CAAC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,EAC1E,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,OAAO,EACrB,YAAY,GAAE;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAAO,EAClE,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAsBV;AAWD,KAAK,UAAU,GACX;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C,kBAAkB,CAAC;AAopBvB,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,YAAY,UAAO,GAAG,MAAM,CAWpF;AAMD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,SAAS,EAAE,MAAM,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,WAAW,EAAE,2BAA2B,CAAC,CAAC,CA4BvE"}

package/dist/user/host-curate-prompt.js

@@ -38,7 +38,9 @@ export const KDR_HINT = decisionHintFor();
  *   - k/d/r toggles the cursor row's decision.
  *   - Tab cycles keep → drop → revise → keep.
  *   - Enter on editable rows opens an inline editor; Esc cancels.
- *   - PageUp/PageDown/Home/End/wheel scrolls the plan.
+ *   - PageUp/PageDown/Home/End scrolls the plan. Wheel input scrolls the plan
+ *     over that pane and moves at most one logical row per input batch over
+ *     the issues pane, based on the batch's net wheel direction.
  *   - Up/Down moves the cursor among all navigable rows.
  *   - Ctrl+D submits; Ctrl+C quits poly-weaver (exit code 130). Inside the
  *     inline revise editor (`state.editing`), Ctrl+C cancels the edit only.
@@ -220,9 +222,143 @@ export class HostBackedCuratePrompt {
                     this.host.scheduleParentUiRender();
                 });
             };
+            const moveCursor = (direction) => {
+                const total = navigableCount(issues.length, state, profile);
+                const cursor = direction === "up"
+                    ? (state.cursor - 1 + total) % total
+                    : (state.cursor + 1) % total;
+                setCursor(cursor);
+            };
+            const setCursor = (cursor) => {
+                state.cursor = cursor;
+                if (state.cursor < issues.length)
+                    state.nextCycle[state.cursor] = 0;
+                state.issueScrollPinnedToCursor = true;
+                if (profile?.autoScrollOnCursorMove) {
+                    scrollPlanToFirstCitation(state, issues[state.cursor], plan, this.host);
+                }
+            };
+            const scrollPlanLines = (delta) => {
+                const m = planMetrics(plan, this.host);
+                const max = Math.max(0, m.planLines - m.planHeight);
+                state.planScrollTop = Math.min(max, Math.max(0, state.planScrollTop + delta));
+            };
             const processEvents = (events) => {
                 let dirty = false;
                 let finished = false;
+                let geometry;
+                const wheelGeometry = () => {
+                    if (!geometry) {
+                        const layout = this.host.getLayout();
+                        const cols = Math.max(20, layout.columns);
+                        const rows = Math.max(1, layout.childRows);
+                        geometry = curateSelectionGeometry(cols, rows);
+                    }
+                    return geometry;
+                };
+                const isItemListWheel = (event) => event.type === "scroll-lines" &&
+                    pointInRegion(event.column, event.row, wheelGeometry().issueList?.region);
+                let itemListWheelNet = 0;
+                let appliedItemListWheelDirection = 0;
+                let wheelEffects = [];
+                let explicitPlanEffectsAfterCursorMove = [];
+                const applyExplicitPlanEffect = (effect) => {
+                    if (effect.type === "lines") {
+                        scrollPlanLines(effect.delta);
+                        dirty = true;
+                        return;
+                    }
+                    const m = planMetrics(plan, this.host);
+                    const max = Math.max(0, m.planLines - m.planHeight);
+                    if (effect.type === "page") {
+                        const step = Math.max(1, m.planHeight - PLAN_PAGE_OVERLAP);
+                        state.planScrollTop = effect.direction === "up"
+                            ? Math.max(0, state.planScrollTop - step)
+                            : Math.min(max, state.planScrollTop + step);
+                    }
+                    else if (effect.type === "home") {
+                        state.planScrollTop = 0;
+                    }
+                    else if (effect.type === "end") {
+                        state.planScrollTop = max;
+                    }
+                    else {
+                        state.planScrollTop = Math.min(max, Math.max(0, effect.top));
+                    }
+                    dirty = true;
+                };
+                const applyAndRecordExplicitPlanEffect = (effect) => {
+                    applyExplicitPlanEffect(effect);
+                    if (profile?.autoScrollOnCursorMove) {
+                        explicitPlanEffectsAfterCursorMove.push(effect);
+                    }
+                };
+                const noteCursorAutoScroll = () => {
+                    if (profile?.autoScrollOnCursorMove) {
+                        explicitPlanEffectsAfterCursorMove = [];
+                    }
+                };
+                const syncItemListWheel = () => {
+                    const direction = Math.sign(itemListWheelNet);
+                    if (direction === appliedItemListWheelDirection)
+                        return;
+                    const effectsToReplay = appliedItemListWheelDirection === 0
+                        ? []
+                        : explicitPlanEffectsAfterCursorMove;
+                    const total = navigableCount(issues.length, state, profile);
+                    const displacement = direction - appliedItemListWheelDirection;
+                    const cursor = ((state.cursor + displacement) % total + total) % total;
+                    setCursor(cursor);
+                    dirty = true;
+                    noteCursorAutoScroll();
+                    for (const effect of effectsToReplay)
+                        applyAndRecordExplicitPlanEffect(effect);
+                    appliedItemListWheelDirection = direction;
+                };
+                const flushWheelEffects = () => {
+                    for (const effect of wheelEffects) {
+                        if (effect.type === "plan") {
+                            applyAndRecordExplicitPlanEffect({
+                                type: "lines",
+                                delta: effect.delta,
+                            });
+                        }
+                        else {
+                            syncItemListWheel();
+                        }
+                    }
+                    wheelEffects = [];
+                };
+                const insertRequiresWheelCommit = (event) => {
+                    const key = event.text.toLowerCase();
+                    if (key === "a" && allowUserAdded(profile))
+                        return true;
+                    if (key === "n")
+                        return state.cursor < issues.length;
+                    if (allowUserAdded(profile) &&
+                        state.cursor === issues.length + state.userAdded.length)
+                        return false;
+                    if (state.cursor >= issues.length) {
+                        return allowUserAdded(profile) && key === "d";
+                    }
+                    const keyBindings = profile?.keyBindings ?? DEFAULT_CURATE_KEY_BINDINGS;
+                    return keyBindings[key] !== undefined;
+                };
+                const eventRequiresWheelCommit = (event) => {
+                    if (state.editing)
+                        return false;
+                    if (event.type === "insert")
+                        return insertRequiresWheelCommit(event);
+                    return event.type === "ctrl-c" ||
+                        event.type === "ctrl-d" ||
+                        (event.type === "arrow" &&
+                            (event.direction === "up" || event.direction === "down")) ||
+                        event.type === "scroll-page" ||
+                        event.type === "scroll-home" ||
+                        event.type === "scroll-end" ||
+                        event.type === "enter" ||
+                        event.type === "tab";
+                };
                 for (const rawEvent of events) {
                     if (finished)
                         break;
@@ -230,6 +366,23 @@ export class HostBackedCuratePrompt {
                     const event = state.editing
                         ? rawEvent
                         : aliasSelectionNavEvent(rawEvent);
+                    if (event.type === "scroll-lines" && isItemListWheel(event)) {
+                        if (!state.editing) {
+                            if (!wheelEffects.some((effect) => effect.type === "item-list")) {
+                                wheelEffects.push({ type: "item-list" });
+                            }
+                            itemListWheelNet += Math.sign(event.delta);
+                        }
+                        continue;
+                    }
+                    if (event.type === "scroll-lines" &&
+                        !state.editing &&
+                        pointInRegion(event.column, event.row, wheelGeometry().plan?.region)) {
+                        wheelEffects.push({ type: "plan", delta: event.delta });
+                        continue;
+                    }
+                    if (eventRequiresWheelCommit(event))
+                        flushWheelEffects();
                     if (state.editing) {
                         if (settlingEdit) {
                             dirty = true;
@@ -291,6 +444,7 @@ export class HostBackedCuratePrompt {
                                 state.issueScrollPinnedToCursor = true;
                             continue;
                         }
+                        // Wheel-while-editing and other unhandled events are intentionally inert.
                         continue;
                     }
                     if (event.type === "ctrl-c") {
@@ -304,58 +458,29 @@ export class HostBackedCuratePrompt {
                         continue;
                     }
                     if (event.type === "arrow") {
-                        const total = navigableCount(issues.length, state, profile);
-                        if (event.direction === "up") {
-                            state.cursor = (state.cursor - 1 + total) % total;
-                            if (state.cursor < issues.length)
-                                state.nextCycle[state.cursor] = 0;
-                            state.issueScrollPinnedToCursor = true;
-                            if (profile?.autoScrollOnCursorMove) {
-                                dirty = scrollPlanToFirstCitation(state, issues[state.cursor], plan, this.host) || dirty;
-                            }
-                            dirty = true;
-                        }
-                        else if (event.direction === "down") {
-                            state.cursor = (state.cursor + 1) % total;
-                            if (state.cursor < issues.length)
-                                state.nextCycle[state.cursor] = 0;
-                            state.issueScrollPinnedToCursor = true;
-                            if (profile?.autoScrollOnCursorMove) {
-                                dirty = scrollPlanToFirstCitation(state, issues[state.cursor], plan, this.host) || dirty;
-                            }
+                        if (event.direction === "up" || event.direction === "down") {
+                            moveCursor(event.direction);
+                            noteCursorAutoScroll();
                             dirty = true;
                         }
                         continue;
                     }
                     if (event.type === "scroll-page") {
-                        const m = planMetrics(plan, this.host);
-                        const step = Math.max(1, m.planHeight - PLAN_PAGE_OVERLAP);
-                        const max = Math.max(0, m.planLines - m.planHeight);
-                        if (event.direction === "up") {
-                            state.planScrollTop = Math.max(0, state.planScrollTop - step);
-                        }
-                        else {
-                            state.planScrollTop = Math.min(max, state.planScrollTop + step);
-                        }
-                        dirty = true;
+                        applyAndRecordExplicitPlanEffect({
+                            type: "page",
+                            direction: event.direction,
+                        });
                         continue;
                     }
                     if (event.type === "scroll-home") {
-                        state.planScrollTop = 0;
-                        dirty = true;
+                        applyAndRecordExplicitPlanEffect({ type: "home" });
                         continue;
                     }
                     if (event.type === "scroll-end") {
-                        const m = planMetrics(plan, this.host);
-                        state.planScrollTop = Math.max(0, m.planLines - m.planHeight);
-                        dirty = true;
+                        applyAndRecordExplicitPlanEffect({ type: "end" });
                         continue;
                     }
                     if (event.type === "scroll-lines") {
-                        const m = planMetrics(plan, this.host);
-                        const max = Math.max(0, m.planLines - m.planHeight);
-                        state.planScrollTop = Math.min(max, Math.max(0, state.planScrollTop + event.delta));
-                        dirty = true;
                         continue;
                     }
                     if (event.type === "enter") {
@@ -426,8 +551,10 @@ export class HostBackedCuratePrompt {
                             }
                             if (scrollUnchanged && onlyOne)
                                 continue;
-                            state.planScrollTop = newScrollTop;
-                            dirty = true;
+                            applyAndRecordExplicitPlanEffect({
+                                type: "absolute",
+                                top: newScrollTop,
+                            });
                             continue;
                         }
                         if (allowUserAdded(profile) &&
@@ -457,6 +584,7 @@ export class HostBackedCuratePrompt {
                             dirty = true;
                     }
                 }
+                flushWheelEffects();
                 if (dirty && !finished)
                     this.host.scheduleParentUiRender();
                 return finished;
@@ -539,6 +667,11 @@ function navigableCount(issueCount, state, profile) {
 function clampCursor(issueCount, state, profile) {
     state.cursor = Math.max(0, Math.min(state.cursor, navigableCount(issueCount, state, profile) - 1));
 }
+function activeCurateRowIndex(issueCount, state) {
+    return state.editing?.target.kind === "user-add"
+        ? issueCount + state.userAdded.length
+        : state.cursor;
+}
 function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, profile) {
     const issues = verdict.issues;
     const lines = [];
@@ -556,11 +689,23 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
     const rowEnds = [];
     let editorRow;
     let editorCol = 0;
+    const activeRowIndex = activeCurateRowIndex(issues.length, state);
+    const contextualHint = renderShortcutHints(curateHelpTokens(state, issues.length, citationLive, issueInquiry, profile));
+    const itemContentIndent = " ".repeat(visibleLength(`${bold}❯${reset} `));
+    const appendContextualHints = (rowIndex) => {
+        if (rowIndex !== activeRowIndex || contextualHint.length === 0)
+            return;
+        const hintWidth = Math.max(1, width - visibleLength(itemContentIndent));
+        lines.push("");
+        for (const hintLine of wrapToWidth(contextualHint, hintWidth)) {
+            lines.push(clipToWidth(`${itemContentIndent}${hintLine}`, width));
+        }
+    };
     for (let i = 0; i < issues.length; i++) {
         if (i > 0)
             lines.push("");
         const rowIndex = i;
-        const isCursor = rowIndex === state.cursor;
+        const isCursor = rowIndex === activeRowIndex;
         const arrow = isCursor ? `${bold}❯${reset}` : " ";
         const tag = tagFor(state.decisions[i], profile);
         const issue = issues[i];
@@ -613,6 +758,7 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
                 }
             }
         }
+        appendContextualHints(rowIndex);
         rowEnds[rowIndex] = lines.length;
     }
     if (allowUserAdded(profile)) {
@@ -620,7 +766,7 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
             const rowIndex = issues.length + i;
             if (rowIndex > 0)
                 lines.push("");
-            const isCursor = rowIndex === state.cursor;
+            const isCursor = rowIndex === activeRowIndex;
             const arrow = isCursor ? `${bold}❯${reset}` : " ";
             const head = `${arrow} ${userAddedTag()} `;
             const headWidth = visibleLength(head);
@@ -646,6 +792,7 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
                     }
                 }
             }
+            appendContextualHints(rowIndex);
             rowEnds[rowIndex] = lines.length;
         }
     }
@@ -653,7 +800,7 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
         const rowIndex = issues.length + state.userAdded.length;
         if (rowIndex > 0)
             lines.push("");
-        const isCursor = rowIndex === state.cursor;
+        const isCursor = rowIndex === activeRowIndex;
         const arrow = isCursor ? `${bold}❯${reset}` : " ";
         rowStarts[rowIndex] = lines.length;
         if (state.editing?.target.kind === "user-add") {
@@ -667,13 +814,10 @@ function buildIssueListRows(verdict, state, width, citationLive, issueInquiry, p
         else {
             lines.push(clipToWidth(`${arrow} ${dim}+ Add feedback${reset}`, width));
         }
+        appendContextualHints(rowIndex);
         rowEnds[rowIndex] = lines.length;
     }
-    lines.push("");
-    for (const l of wrapToWidth(renderShortcutHints(curateHelpTokens(state, issues.length, citationLive, issueInquiry, profile)), width)) {
-        lines.push(l);
-    }
-    return { lines, rowStarts, rowEnds, editorRow, editorCol };
+    return { lines, rowStarts, rowEnds, activeRowIndex, editorRow, editorCol };
 }
 function buildLeftPane(verdict, state, width, rows, globalHintText, citationLive, issueInquiry, profile) {
     const pinnedHint = clipToWidth(globalHintText, width);
@@ -684,9 +828,9 @@ function buildLeftPane(verdict, state, width, rows, globalHintText, citationLive
             cursor: { row: 0, col: 0 },
         };
     }
-    const { lines, rowStarts, rowEnds, editorRow, editorCol } = buildIssueListRows(verdict, state, width, citationLive, issueInquiry, profile);
-    const activeStart = rowStarts[state.cursor] ?? 0;
-    const activeEndExclusive = rowEnds[state.cursor] ?? lines.length;
+    const { lines, rowStarts, rowEnds, activeRowIndex, editorRow, editorCol, } = buildIssueListRows(verdict, state, width, citationLive, issueInquiry, profile);
+    const activeStart = rowStarts[activeRowIndex] ?? 0;
+    const activeEndExclusive = rowEnds[activeRowIndex] ?? lines.length;
     // Prefer to show the entire active block; if it is taller than `rows`,
     // fall back to the editor row (when editing) or the header row.
     const total = lines.length;