@runcofactor/cli 0.15.0 → 0.15.1

package/dist/{local-PUD24GGQ.js → local-VGYRSW22.js}

@@ -1,8 +1,8 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   hasFlag
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/local/index.ts
@@ -70,22 +70,22 @@ async function runLocal(argv) {
   }
   switch (subcommand) {
     case "init": {
-      const { runLocalInit } = await import("./init-OROOM4HF.js");
+      const { runLocalInit } = await import("./init-FFUZO5D7.js");
       await runLocalInit(rest);
       break;
     }
     case "start": {
-      const { runLocalStart } = await import("./start-3C7EEFW2.js");
+      const { runLocalStart } = await import("./start-IYKF3C3X.js");
       await runLocalStart(rest);
       break;
     }
     case "list": {
-      const { runLocalList } = await import("./list-ZMIKEC5P.js");
+      const { runLocalList } = await import("./list-PHC7VYNS.js");
       await runLocalList(rest);
       break;
     }
     case "login": {
-      const { runLocalLogin } = await import("./login-BSO7YX2D.js");
+      const { runLocalLogin } = await import("./login-QPU2BKG2.js");
       await runLocalLogin(rest);
       break;
     }
@@ -98,4 +98,4 @@ async function runLocal(argv) {
 export {
   runLocal
 };
-//# sourceMappingURL=local-PUD24GGQ.js.map
+//# sourceMappingURL=local-VGYRSW22.js.map

package/dist/{login-BSO7YX2D.js → login-QPU2BKG2.js}

@@ -10,15 +10,15 @@ import {
   promptChoice,
   selectProperty,
   uploadStorageState
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/local/login.ts
@@ -313,4 +313,4 @@ Opening browser at ${args.url}...`);
 export {
   runLocalLogin
 };
-//# sourceMappingURL=login-BSO7YX2D.js.map
+//# sourceMappingURL=login-QPU2BKG2.js.map

package/dist/{mcp-4LS7OJUT.js → mcp-LA452TOA.js}

@@ -6,7 +6,7 @@ import {
 import {
   LocalBrowserHost,
   USER_PAUSED_ERROR
-} from "./chunk-HDFYUFBI.js";
+} from "./chunk-UZ2ZA5A6.js";
 import {
   callTool,
   createSession,
@@ -18,26 +18,26 @@ import {
   fetchOrgs,
   openUrl,
   switchOrg
-} from "./chunk-CMGI7UZD.js";
+} from "./chunk-G5SXUXSU.js";
 import {
   clearUpdateCache
-} from "./chunk-46IUJXSD.js";
+} from "./chunk-AQPJQ5AE.js";
 import {
   ENV_URLS,
   envToProfile,
   readStoredToken,
   resolveAppUrl,
   saveAuth
-} from "./chunk-3X3NW7QA.js";
+} from "./chunk-IGHDIWZU.js";
 import {
   packageName,
   readBrandEnv
-} from "./chunk-JMJVGMXI.js";
+} from "./chunk-32P26BZT.js";
 import {
   getBrowserToolDefinitionsWithLifecycle
-} from "./chunk-VGYN2KU2.js";
+} from "./chunk-5R4HMSNX.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-6LEZCKKV.js";
 import "./chunk-KRWRUU6R.js";
 import "./chunk-VKVL7WBN.js";
@@ -1952,4 +1952,4 @@ async function runMcp(_argv) {
 export {
   runMcp
 };
-//# sourceMappingURL=mcp-4LS7OJUT.js.map
+//# sourceMappingURL=mcp-LA452TOA.js.map

package/dist/{product-3JKSJCBC.js → product-RSZV5HMB.js}

@@ -2,16 +2,16 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   apiRequest,
   fetchList
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/product.ts
@@ -343,4 +343,4 @@ async function runProduct(argv) {
 export {
   runProduct
 };
-//# sourceMappingURL=product-3JKSJCBC.js.map
+//# sourceMappingURL=product-RSZV5HMB.js.map

package/dist/{property-K5DBL4UE.js → property-YP4GHQAR.js}

@@ -3,16 +3,16 @@ import {
   apiRequest,
   fetchProperties,
   getApplicationArg
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/property.ts
@@ -770,4 +770,4 @@ async function runProperty(argv) {
 export {
   runProperty
 };
-//# sourceMappingURL=property-K5DBL4UE.js.map
+//# sourceMappingURL=property-YP4GHQAR.js.map

package/dist/{psql-PQFUFTSE.js → psql-XGLBI6T7.js}

@@ -4,8 +4,8 @@ import {
 } from "./chunk-3CZU7XCS.js";
 import {
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/psql.ts
@@ -113,4 +113,4 @@ Time: ${json.durationMs}ms`);
 export {
   runPsql
 };
-//# sourceMappingURL=psql-PQFUFTSE.js.map
+//# sourceMappingURL=psql-XGLBI6T7.js.map

package/dist/{record-EIIYLFJ4.js → record-KWKHP2ZY.js}

@@ -7,18 +7,18 @@ import {
   apiRequest,
   downloadStorageState,
   selectCredential
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import {
   getCanaryTmpDir
 } from "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/record.ts
@@ -86,7 +86,7 @@ async function runRecord(argv) {
     );
   }
   console.log("Launching browser...");
-  const { PlaywrightClient, consoleLogger, captureElementAtPoint } = await import("./src-CG52HEE7.js");
+  const { PlaywrightClient, consoleLogger, captureElementAtPoint } = await import("./src-CV57ZD6I.js");
   const client = new PlaywrightClient({ logger: consoleLogger });
   await client.connect({
     browserMode: "headed",
@@ -229,4 +229,4 @@ Output directory: ${outDir}`);
 export {
   runRecord
 };
-//# sourceMappingURL=record-EIIYLFJ4.js.map
+//# sourceMappingURL=record-KWKHP2ZY.js.map

package/dist/{redis-BU36EZZI.js → redis-VJGCUJPV.js}

@@ -4,8 +4,8 @@ import {
 } from "./chunk-3CZU7XCS.js";
 import {
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/redis.ts
@@ -114,4 +114,4 @@ Time: ${json_response.durationMs}ms`);
 export {
   runRedis
 };
-//# sourceMappingURL=redis-BU36EZZI.js.map
+//# sourceMappingURL=redis-VJGCUJPV.js.map

package/dist/{release-LYC2P7DZ.js → release-NDRHPW6V.js}

@@ -1,16 +1,16 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   getApplicationIdArg
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/release.ts
@@ -352,4 +352,4 @@ async function runRelease(argv) {
 export {
   runRelease
 };
-//# sourceMappingURL=release-LYC2P7DZ.js.map
+//# sourceMappingURL=release-NDRHPW6V.js.map

package/dist/{sandbox-CKHXXZHU.js → sandbox-OOCANWOG.js}

@@ -6,7 +6,7 @@ import {
 import {
   apiRequest,
   selectProperty
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import {
   apiFetch,
   exitOnFailure,
@@ -16,14 +16,14 @@ import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
 import {
   INSTANCE_SIZES,
   INSTANCE_SIZE_SPEC,
   parseInstanceSize
-} from "./chunk-JYGNMKZ5.js";
+} from "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/sandbox.ts
@@ -2088,4 +2088,4 @@ export {
   parseDockerPs,
   runSandbox
 };
-//# sourceMappingURL=sandbox-CKHXXZHU.js.map
+//# sourceMappingURL=sandbox-OOCANWOG.js.map

package/dist/{scenarios-2XJ2G3KR.js → scenarios-2HRLCGFY.js}

@@ -1,16 +1,16 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   apiRequest
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/scenarios.ts
@@ -278,4 +278,4 @@ async function handleReject(argv, apiUrl, token) {
 export {
   runScenarios
 };
-//# sourceMappingURL=scenarios-2XJ2G3KR.js.map
+//# sourceMappingURL=scenarios-2HRLCGFY.js.map

package/dist/{session-UTOD5ZYH.js → session-M4ULYDYP.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   LocalBrowserHost,
   USER_PAUSED_ERROR
-} from "./chunk-HDFYUFBI.js";
+} from "./chunk-UZ2ZA5A6.js";
 import "./chunk-G4UYGRZR.js";
 import {
   INTERACTION_CAPTURE_SCRIPT
@@ -24,23 +24,23 @@ import {
   downloadStorageState,
   selectCredential,
   uploadStorageState
-} from "./chunk-PRBRSIZP.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-3X3NW7QA.js";
-import "./chunk-JMJVGMXI.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import {
   BrowserToolExecutor,
   PlaywrightClient,
   captureElementAtPoint,
   dispatchBrowserTool,
   dispatchBrowserToolWithTimeout
-} from "./chunk-VGYN2KU2.js";
+} from "./chunk-5R4HMSNX.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-JYGNMKZ5.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-6LEZCKKV.js";
 import {
   consoleLogger
@@ -2478,4 +2478,4 @@ export {
   buildToolArgs,
   runSession
 };
-//# sourceMappingURL=session-UTOD5ZYH.js.map
+//# sourceMappingURL=session-M4ULYDYP.js.map

package/dist/{skill-GMAERMQL.js → skill-4DGPRDUC.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   brandSkillContentFor,
   command
-} from "./chunk-JMJVGMXI.js";
+} from "./chunk-32P26BZT.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/skill.ts
@@ -1986,4 +1986,4 @@ export {
   resolveInstallDir,
   runSkill
 };
-//# sourceMappingURL=skill-GMAERMQL.js.map
+//# sourceMappingURL=skill-4DGPRDUC.js.map

package/dist/skills/optimize-cache/SKILL.md

@@ -12,7 +12,7 @@ allowed-tools: Read, Grep, Glob, Bash(canary workflow debug:*), Bash(canary work
 
 You are building the deterministic cache + playbook for a workflow from the
 evidence of a real run — the same procedure the server's async cache-optimizer
-agent follows, driven manually through the canary CLI.
+agent follows, driven manually through the `canary` CLI.
 
 ## Materialize the workspace
 
@@ -124,16 +124,26 @@ future runs work with fresh data:
   produced the value — never anchor on the literal.
 - **App-generated values the live agent missed** are still recoverable here.
   If the app creates a value during this run (receipt number, confirmation
-  code, generated entity ID, URL slug) and a later locator, assertion, or
-  download check depends on it, call `declare_dynamic_variable` with the
-  observed value before building locators. Then add a cached `capture` action
-  that saves the same key before the first dependent cached action, and use
-  `$var.key` / `{{var.key}}` where the generated value appears later.
+  code, generated entity ID, auto-derived title or name, URL slug) and a
+  later locator, assertion, or download check depends on it, call
+  `declare_dynamic_variable` with the observed value before building
+  locators. Then add a cached `capture` action that saves the same key before
+  the first dependent cached action, and use `$var.key` / `{{var.key}}` where
+  the generated value appears later.
   Constants chosen by the workflow (names, dates, dropdown options, payment
   types) do not need this treatment unless they are app-generated.
+  This is a REQUIREMENT, not a suggestion: once you suspect a distinguishing
+  value is app-generated (you saw the app derive it, the workflow never typed
+  it, or it differs from what an earlier step entered), you may NOT anchor on
+  the literal and you may NOT silently gap the step. Find the value on-path
+  (a heading, breadcrumb, row cell, or the URL of a page the step already
+  visits), capture it, and bind the locator to the capture. Gap only when no
+  on-path capture source exists — and say so in the gap reason.
 - **Gaps** are honest: a `gap` compiled entry means "the replay agent performs
   this step live". A gap replays slower but correctly; a bad cached locator
-  replays fast and wrong. Prefer the gap.
+  replays fast and wrong. Prefer the gap — except where the only obstacle is
+  an app-generated value with a visible capture source (see above): there the
+  capture-bound locator is the correct outcome, not a gap.
 - **Volatile identifiers** (seeded entity numbers, ULIDs/UUIDs, timestamps,
   framework-generated class hashes) WILL differ next run even though they
   point at a real element today. Structural prefixes (e.g. a stable

package/dist/{spec-2NP36U3Y.js → spec-XZ2TKUFZ.js}

@@ -12,7 +12,7 @@ import {
   workflowToSpec,
   writeNodeIds,
   writeWorkflowId
-} from "./chunk-7VMO2WOZ.js";
+} from "./chunk-26U3DGUM.js";
 import {
   fetchOrExit
 } from "./chunk-3CZU7XCS.js";
@@ -20,15 +20,15 @@ import {
   getArgValue,
   hasFlag,
   resolveAppUrl
-} from "./chunk-3X3NW7QA.js";
+} from "./chunk-IGHDIWZU.js";
 import {
   isSpecFile,
   readableSpecDirs,
   specDir,
   specExtension,
   splitSpecExtension
-} from "./chunk-JMJVGMXI.js";
-import "./chunk-JYGNMKZ5.js";
+} from "./chunk-32P26BZT.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/spec/index.ts
@@ -977,4 +977,4 @@ export {
   stampedSpecPath,
   uniqueName
 };
-//# sourceMappingURL=spec-2NP36U3Y.js.map
+//# sourceMappingURL=spec-XZ2TKUFZ.js.map

package/dist/{src-UEOOC425.js → src-2FK3JHGW.js}

@@ -1,7 +1,9 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
-  reconstructSnapshots
-} from "./chunk-KCHKFYVX.js";
+  parseTraceActions,
+  reconstructSnapshots,
+  toMutationIndex
+} from "./chunk-PXFDH6YL.js";
 import {
   buildLocatorString
 } from "./chunk-5GD47G2D.js";
@@ -9,14 +11,14 @@ import {
   applyCustomAugmentors,
   captureSubstrateV2,
   parseSnapshot
-} from "./chunk-VGYN2KU2.js";
+} from "./chunk-5R4HMSNX.js";
 import "./chunk-JWHYXEA2.js";
 import {
   MACRO_PATTERN,
   isVolatileIdentifier,
   stableAttrSelector,
   stableIdentifierPrefix
-} from "./chunk-JYGNMKZ5.js";
+} from "./chunk-IWKJQZJQ.js";
 import "./chunk-6LEZCKKV.js";
 import {
   consoleLogger
@@ -5211,22 +5213,35 @@ var SubstrateMaterializer = class {
   cache = /* @__PURE__ */ new Map();
   session;
   ownsSession;
+  /** Parsed trace actions in `actions.jsonl` order — lazy, parsed once. */
+  allActions = null;
   /**
    * Reconstruct one action's snapshot and capture substrate-v2 over it.
    * `phase: 'before'` is the page state the action targeted (locator input);
    * `'after'` is its result (the next action's context).
+   *
+   * `actionIndex` is the action's position in `parseTraceActions` order — the
+   * SAME index space as the workspace's `browser/actions.jsonl` and
+   * `optimizer/segments.json` actionIndices. The mutation-filtered index the
+   * snapshot reconstructor uses internally is remapped here; observation
+   * actions (screenshots) are rejected with a self-correcting error.
    */
   async materialize(actionIndex, phase = "before") {
     const key2 = `${actionIndex}:${phase}`;
     const hit = this.cache.get(key2);
     if (hit) return hit;
+    this.allActions ??= parseTraceActions(this.opts.traceZipPath);
+    const resolved = toMutationIndex(this.allActions, actionIndex);
+    if (!resolved.ok) {
+      throw new Error(resolved.reason);
+    }
     const results = await reconstructSnapshots({
       traceZipPath: this.opts.traceZipPath,
       includeScreenshots: false,
       includeHtml: true,
       filter: phase,
       raw: false,
-      actionIndex
+      actionIndex: resolved.mutationIndex
     });
     const snapshot = results.find((r) => r.phase === phase && r.html);
     if (!snapshot?.html) {
@@ -5618,6 +5633,9 @@ function buildCacheRecipe(opts) {
       if (a.variableKey) bindingKeys.add(`$var.${a.variableKey}`);
       for (const key2 of Object.values(a.variableBindings ?? {})) bindingKeys.add(`$var.${key2}`);
       for (const expr of Object.values(a.macroBindings ?? {})) bindingKeys.add(expr);
+      if (a.actionType === "capture" && typeof a.args?.saveAs === "string" && a.args.saveAs) {
+        bindingKeys.add(`$var.${a.args.saveAs}`);
+      }
     }
     const missing = opts.requiredTokens.filter((t) => !present.has(t) && !bindingKeys.has(t));
     if (missing.length > 0) {
@@ -5938,4 +5956,4 @@ export {
   verifySelectorAgainstRef,
   waitForTraceDomHydration
 };
-//# sourceMappingURL=src-UEOOC425.js.map
+//# sourceMappingURL=src-2FK3JHGW.js.map