@senpi/runtime 3.0.9-dev.feat-strategy-compos.20260716013009 → 3.0.9-dev.feat-strategy-compos.20260716233548

package/dist/cli/composer-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer-commands.d.ts","sourceRoot":"","sources":["../../src/cli/composer-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CACJ,EAAE,EACE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzD,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzE,gBAAgB,CAAC;CACrB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AA6FD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAoKjE"}
+{"version":3,"file":"composer-commands.d.ts","sourceRoot":"","sources":["../../src/cli/composer-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CACJ,EAAE,EACE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzD,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzE,gBAAgB,CAAC;CACrB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAmGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CA8QjE"}

package/dist/cli/composer-commands.js

@@ -55,6 +55,12 @@ function detectEnvError(pythonBin, root, result) {
         if (mod === "composer" || mod.startsWith("composer.")) {
             return `composer: the 'composer' package was not found under ${root} — on a claw run \`npm run build\` (copy:composer) or set COMPOSER_ROOT to your checkout root.`;
         }
+        if (mod === "scaffold" || mod.startsWith("scaffold.")) {
+            // The scaffold harness ships WITH the runtime (copy:external-scanners), never from PyPI.
+            // Do NOT route this to the "pip install deps" hint — and warn off `pip install scaffold`
+            // (an unrelated PyPI package), the exact dead end the original dev-box run hit.
+            return `composer: the 'scaffold' harness package was not found — on a claw run \`npm run build\` (copy:external-scanners stages it into dist/scanners/external) or set COMPOSER_SCAFFOLD_DIR to the dir that CONTAINS scaffold/ (…/src/scanners/external). Do NOT \`pip install scaffold\` — that is an unrelated PyPI package.`;
+        }
         return `composer: Python dependency '${mod}' is missing — install the composer deps: ${requirementsHint(root)}`;
     }
     return null;
@@ -117,7 +123,7 @@ function printErrors(errors) {
 }
 export function registerComposerCli(senpi) {
     const composer = senpi.command("composer");
-    composer.description("Strategy Composer: new / validate / compile / check / deploy / status a strategy graph; catalog / describe nodes");
+    composer.description("Strategy Composer: new / validate / compile / check / deploy / fund / install / close / status a strategy graph; catalog / describe nodes");
     // new / validate / compile stream Python's own (rich) human render through — teaching
     // errors, gap reports, emitted scan.py — forwarding only the relevant flags. Thin: no
     // TS-side interpretation; the exit code is Python's (0 ok, 2 gap report, 3 clobber-refused).
@@ -239,20 +245,123 @@ export function registerComposerCli(senpi) {
             printErrors(check.errors ?? []);
         }
         else {
+            // Always surface the ABSOLUTE staged dir Python resolved (a relative `-o` against an
+            // unexpected cwd was "deploy exited 0 but there are no files where I looked"). UNCHANGED
+            // says plainly that nothing was rewritten so an idempotent no-op never reads as a failure.
             const staged = (json.staged ?? {});
-            console.log(`${verdict}: ${graph} — staged to ${staged.dir}. (live tick: slice 8)`);
+            const dir = staged.dir ?? "(no staged dir reported)";
+            if (verdict === "UNCHANGED") {
+                console.log(`UNCHANGED: ${graph} — already staged at ${dir}, nothing rewritten (idempotent no-op).`);
+            }
+            else {
+                console.log(`${verdict}: ${graph} — staged to ${dir}.`);
+            }
+        }
+        process.exitCode = status;
+    });
+    composer
+        .command("fund <target>")
+        .description("Create + fund the strategy's wallet (MCP strategy_create_custom_strategy): preflights the balance, waits for ACTIVE, safe to re-run while funding settles")
+        .option("--budget <usd>", "Explicit USD to fund this strategy's wallet with (>= $100; never derived/split)")
+        .option("-o, --out <dir>", "Staging dir (when target is a graph file, not a staged dir)")
+        .option("--state-dir <dir>", "Base senpi-state dir (default: $SENPI_STATE_DIR or ~/.openclaw/senpi-state)")
+        .option("--json", "Print the raw Python fund verdict JSON")
+        .action(async (target, opts) => {
+        const args = ["fund", target];
+        if (opts.budget !== undefined)
+            args.push("--budget", String(opts.budget));
+        if (opts.out)
+            args.push("--out", opts.out);
+        if (opts.stateDir)
+            args.push("--state-dir", opts.stateDir);
+        // The rim owns the wall-clock: created_at is injected as an ISO string (like install's bound-at).
+        args.push("--created-at", new Date().toISOString());
+        if (opts.json)
+            args.push("--json");
+        const { status, stdout, stderr, envError } = runComposer(args);
+        if (envError) {
+            process.exitCode = 1;
+            return;
+        }
+        if (stdout)
+            process.stdout.write(stdout);
+        if (stderr)
+            process.stderr.write(stderr);
+        process.exitCode = status;
+    });
+    composer
+        .command("install <target>")
+        .description("Bind a staged unit onto THIS box: copy to a canonical hash dir, bind --wallet (or auto-bind a funded wallet.json), run `openclaw senpi runtime create`")
+        .option("--wallet <address>", "The strategy's ACTIVE 0x… wallet to bind (omit to auto-bind a funded wallet.json)")
+        .option("-o, --out <dir>", "Staging dir (when target is a graph file, not a staged dir)")
+        .option("--state-dir <dir>", "Base senpi-state dir (default: $SENPI_STATE_DIR or ~/.openclaw/senpi-state)")
+        .option("--runtime-id <id>", "Override the derived runtime id (default: <strategy>-<hash8>)")
+        .option("--json", "Print the raw Python install verdict JSON")
+        .action(async (target, opts) => {
+        const args = ["install", target];
+        if (opts.wallet)
+            args.push("--wallet", opts.wallet);
+        if (opts.out)
+            args.push("--out", opts.out);
+        if (opts.stateDir)
+            args.push("--state-dir", opts.stateDir);
+        if (opts.runtimeId)
+            args.push("--runtime-id", opts.runtimeId);
+        // Inject the wall-clock here (the rim owns the clock; the Python core stays deterministic).
+        args.push("--bound-at", new Date().toISOString());
+        if (opts.json)
+            args.push("--json");
+        const { status, stdout, stderr, envError } = runComposer(args);
+        if (envError) {
+            process.exitCode = 1;
+            return;
         }
+        if (stdout)
+            process.stdout.write(stdout);
+        if (stderr)
+            process.stderr.write(stderr);
+        process.exitCode = status;
+    });
+    composer
+        .command("close <target>")
+        .description("Safe teardown: stop the runtime, confirm gone, then trigger MCP strategy_close (flattens positions + returns funds). Idempotent — re-run to poll")
+        .option("--wallet <address>", "Close the strategy on this 0x… wallet directly")
+        .option("--strategy-id <id>", "Close this strategyId directly (legacy/ops-deployed strategies)")
+        .option("--state-dir <dir>", "Base senpi-state dir (default: $SENPI_STATE_DIR or ~/.openclaw/senpi-state)")
+        .option("--json", "Print the raw Python close verdict JSON")
+        .action(async (target, opts) => {
+        const args = ["close", target];
+        if (opts.wallet)
+            args.push("--wallet", opts.wallet);
+        if (opts.strategyId)
+            args.push("--strategy-id", opts.strategyId);
+        if (opts.stateDir)
+            args.push("--state-dir", opts.stateDir);
+        if (opts.json)
+            args.push("--json");
+        const { status, stdout, stderr, envError } = runComposer(args);
+        if (envError) {
+            process.exitCode = 1;
+            return;
+        }
+        if (stdout)
+            process.stdout.write(stdout);
+        if (stderr)
+            process.stderr.write(stderr);
         process.exitCode = status;
     });
     composer
         .command("status <target>")
         .description("Derived lifecycle position + the next verb to run (graph file or staging dir)")
         .option("-o, --out <dir>", "Staging directory to check for a deployed artifact")
+        .option("--state-dir <dir>", "Base senpi-state dir — extend status down the on-box install chain")
         .option("--json", "Print the raw Python status JSON")
         .action(async (target, opts) => {
         const args = ["status", target, "--json"];
         if (opts.out)
             args.push("--out", opts.out);
+        if (opts.stateDir)
+            args.push("--state-dir", opts.stateDir);
         const { status, stdout, json } = runComposer(args);
         if (opts.json || !json) {
             process.stdout.write(stdout);

package/dist/cli/composer-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"composer-commands.js","sourceRoot":"","sources":["../../src/cli/composer-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAwB1E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,uEAAuE;AACvE,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,kBAAkB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,kBAAkB,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,SAAiB,EACjB,IAAY,EACZ,MAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,KAA0C,CAAC;IAC9D,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,cAAc,SAAS,oFAAoF,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7I,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,OAAO,wDAAwD,IAAI,gGAAgG,CAAC;QACtK,CAAC;QACD,OAAO,gCAAgC,GAAG,6CAA6C,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IAClH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS,CAAC;IAC3D,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU;QACvC,CAAC,CAAC,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;QAC7D,CAAC,CAAC,YAAY,CAAC;IACjB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,EAAE;QACnE,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;QAClC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE;KAChD,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACtF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,IAAI,IAAI,GAAmC,IAAI,CAAC;IAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC9E,CAAC;AASD,SAAS,cAAc,CAAC,GAA8B;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,UAAU,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,MAAuB;IAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAqB,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAClB,kHAAkH,CACnH,CAAC;IAEF,sFAAsF;IACtF,sFAAsF;IACtF,6FAA6F;IAC7F,QAAQ;SACL,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,oBAAoB,EAAE,gEAAgE,CAAC;SAC9F,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,8DAA8D,CAAC;SACjF,MAAM,CAAC,QAAQ,EAAE,wDAAwD,CAAC;SAC1E,MAAM,CACL,KAAK,EACH,EAAU,EACV,IAA6F,EAC7F,EAAE;QACF,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CACF,CAAC;IAEJ,QAAQ;SACL,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,wEAAwE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,oFAAoF,CAAC;SACjG,MAAM,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;SAC9E,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAsB,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,QAAQ,EAAE,mCAAmC,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QACxD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAI,IAAI,CAAC,MAA0B,IAAI,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,qBAAqB,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,MAAM,CAAC,MAAM,2CAA2C,CAAC,CAAC;YACzF,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,QAAQ,EAAE,mCAAmC,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAsC,EAAE,EAAE;QACtE,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAmD,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,eAAe,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;YAC1F,WAAW,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAqB,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,gBAAgB,MAAM,CAAC,GAAG,wBAAwB,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,+EAA+E,CAAC;SAC5F,MAAM,CAAC,iBAAiB,EAAE,oDAAoD,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAsC,EAAE,EAAE;QACvE,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC5B,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"composer-commands.js","sourceRoot":"","sources":["../../src/cli/composer-commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/validate-runtime-config.mjs

@@ -46,10 +46,24 @@ async function main() {
 
   const imp = (rel) => import(pathToFileURL(pathJoin(distDir, rel)).href);
   let runtimeConfigSchema, parseDslPluginConfig, mapRuntimeExitToDslConfig, DslConfigValidationError;
+  // A3 (install-time parity): checks the runtime runs only when it actually boots — a
+  // runtime.yaml can pass the Zod schema + DSL preset parse yet still fail at install. Imported
+  // from dist alongside the existing three oracle objects so the same single source of truth
+  // (the runtime's own code) judges them. `validateDslPositionTracking` is Runtime.start()'s DSL
+  // wiring gate; `assertUnique*Names` + `assertActionPromptPlaceholdersResolvable` are
+  // loadRuntimeConfig's post-Zod asserts the rim otherwise skips (it avoids loadRuntimeConfig to
+  // keep structured errors). All throw plain Errors — caught below and mapped to distinct codes.
+  let validateDslPositionTracking,
+    assertActionPromptPlaceholdersResolvable,
+    assertUniqueScannerNames,
+    assertUniqueActionNames;
   try {
     ({ runtimeConfigSchema } = await imp("runtime/runtime-schema.js"));
     ({ parseDslPluginConfig, DslConfigValidationError } = await imp("dsl/config/index.js"));
     ({ mapRuntimeExitToDslConfig } = await imp("runtime/map-exit-config.js"));
+    ({ validateDslPositionTracking } = await imp("runtime/validate-dsl-position-tracking.js"));
+    ({ assertActionPromptPlaceholdersResolvable } = await imp("runtime/validate-action-prompts.js"));
+    ({ assertUniqueScannerNames, assertUniqueActionNames } = await imp("runtime/load-runtime-config.js"));
   } catch (err) {
     // Signal an ENV-absent condition distinctly so Python can skip (not RED) when dist is unbuilt.
     process.stdout.write(
@@ -117,6 +131,58 @@ async function main() {
     }
   }
 
+  // Third oracle layer (A3): install-time parity. The above proves the config PARSES; these
+  // reproduce the checks that only fire when the runtime BOOTS, so GREEN means "will install".
+  // Each new failure class carries a distinct machine `code` the Python CMP1xx mapper keys on.
+  // Collected together (not first-throw) so the author sees every install blocker at once.
+  const installErrors = [];
+
+  // load-time asserts loadRuntimeConfig runs post-Zod (the rim skips loadRuntimeConfig to keep
+  // structured errors, so it must re-run them here). Order matches load-runtime-config.ts.
+  try {
+    assertUniqueScannerNames(cfg);
+  } catch (err) {
+    installErrors.push({ path: "scanners", message: err?.message ?? String(err), code: "DUP_SCANNER_NAME" });
+  }
+  try {
+    assertUniqueActionNames(cfg);
+  } catch (err) {
+    installErrors.push({ path: "actions", message: err?.message ?? String(err), code: "DUP_ACTION_NAME" });
+  }
+  try {
+    assertActionPromptPlaceholdersResolvable(cfg);
+  } catch (err) {
+    installErrors.push({ path: "actions", message: err?.message ?? String(err), code: "UNRESOLVED_PROMPT_PLACEHOLDER" });
+  }
+
+  // DSL position-tracking wiring — the Runtime.start() gate (runtime.ts:452-457). hasDsl is
+  // derived exactly as the call site does: mapRuntimeExitToDslConfig(config.exit).dsl_preset
+  // present. The map call already succeeded in the DSL layer above whenever a dsl_preset exists;
+  // if it throws for a preset-less exit block, hasDsl is false (the gate is a no-op) — that class
+  // of error is surfaced by the schema/DSL layers, not misreported here.
+  try {
+    let hasDsl = false;
+    try {
+      const exitConfig = mapRuntimeExitToDslConfig(cfg.exit);
+      const dp = exitConfig?.dsl_preset;
+      hasDsl = dp != null && typeof dp === "object" && !Array.isArray(dp);
+    } catch {
+      hasDsl = false;
+    }
+    validateDslPositionTracking(cfg, hasDsl);
+  } catch (err) {
+    const message = err?.message ?? String(err);
+    // The single function throws one of three messages; the action-wiring ones point at actions.
+    const path = /action/i.test(message) ? "actions" : "scanners";
+    installErrors.push({ path, message, code: "DSL_POSITION_TRACKING" });
+  }
+
+  if (installErrors.length > 0) {
+    process.stdout.write(JSON.stringify({ ok: false, errors: installErrors }) + "\n");
+    process.exit(0);
+    return;
+  }
+
   process.stdout.write(JSON.stringify({ ok: true }) + "\n");
   process.exit(0);
 }

package/dist/composer/AUTHORING.md

@@ -48,6 +48,16 @@ fixtures) or `composer/generated/` (registry-derived, do-not-edit).
 mkdir -p drafts
 ```
 
+**`scaffold` resolves itself — never set a manual `PYTHONPATH` for it.** `check`/`deploy` run
+the emitted `scan.py` under the runtime's `scaffold` harness. The composer finds `scaffold`
+automatically in BOTH layouts — a dev checkout (`src/scanners/external`) and a claw dist install
+(`dist/scanners/external`, no `src/` segment) — so you do not export any path. If it genuinely
+cannot be found, the `smoke` stage fails RED with a teaching error naming the fix: on a claw run
+`npm run build` (its `copy:external-scanners` step stages the harness), or set
+`COMPOSER_SCAFFOLD_DIR` to the dir that CONTAINS `scaffold/`. Do **not** `pip install scaffold` —
+that is an unrelated PyPI package and will not satisfy the import (the harness ships with the
+runtime, never from PyPI).
+
 ## 3. Verb reference
 
 Every verb takes `--json` for machine-readable output; omit it for a human-readable
@@ -59,8 +69,11 @@ report.
 | `validate` | Schema + graph-semantic teaching-error report (exit 0 iff clean). | `... python -m composer.cli validate drafts/my_strat.graph.yaml` |
 | `check` | ONE verdict: validate + pure_fn inline tests + compile + one-tick smoke, staged so a failing stage skips the rest. | `... python -m composer.cli check drafts/my_strat.graph.yaml` |
 | `compile` | Materialize the graph into `scan.py` on the `external_scanner` contract. | `... python -m composer.cli compile drafts/my_strat.graph.yaml -o drafts/scan.py` |
-| `deploy` | Stage the COMPLETE standalone unit as a package tree (`strategy.yaml`, `main/runtime.yaml`, `main/scanners/scan.py`, `main/<id>.graph.yaml`, `manifest.json`, `deploy.json`); HARD-gated on a GREEN `check`. Does not install. | `... python -m composer.cli deploy drafts/my_strat.graph.yaml -o drafts/dist` |
-| `status` | Derives your lifecycle position (`absent` / `invalid` / `valid_undeployed` / `deployed_stale` / `deployed_current`) from the file + check + staged manifest, and names the next verb. No journal — the file is the state. | `... python -m composer.cli status drafts/my_strat.graph.yaml -o drafts/dist` |
+| `deploy` | Stage the COMPLETE standalone unit as a package tree (`strategy.yaml`, `main/runtime.yaml`, `main/scanners/scan.py`, `main/scanners/strategy_primitives/` — the vendored primitives snapshot — `main/<id>.graph.yaml`, `manifest.json`, `deploy.json`); HARD-gated on a GREEN `check`. Does not install. The verdict always reports the ABSOLUTE staged dir (a relative `-o` resolves under your current working dir), and a re-deploy of unchanged bytes is `UNCHANGED` — "already staged at `<abs>`, nothing rewritten". | `... python -m composer.cli deploy drafts/my_strat.graph.yaml -o drafts/dist` |
+| `fund` | Create + fund the strategy's ONE wallet via MCP `strategy_create_custom_strategy`. `--budget <usd>` is REQUIRED and EXPLICIT (≥ $100) — agree it with the user; it is NEVER derived or split. Preflights the visible balance (free Hyperliquid + EVM USDC), creates, records `wallet.json` BEFORE polling, then polls briefly to ACTIVE. Idempotent + safe to re-run while funds settle (re-run IS the poll): existing ACTIVE wallet → `FUNDED` no-op; still initializing → `PENDING`; stale → CMP231. Short balance → CMP232 (states the shortfall + the bridged-funds visibility lag). Teaching errors CMP230-233 (+ CMP223 for missing creds). | `... python -m composer.cli fund drafts/dist/my_strat --budget 250` |
+| `install` | Bind a staged unit onto THIS box: preflight (manifest verify + GREEN oracle verdict) → copy to a content-addressed immutable dir `<senpi-state>/strategies/<id>/<hash8>/` (temp+verify+atomic-rename) → bind the wallet into the COPIED `runtime.yaml` (staged source stays pristine) → invoke the frozen `openclaw senpi runtime create -p …` consumer. Pass `--wallet 0x…` explicitly, OR omit it to AUTO-BIND the funded `wallet.json` from `composer fund` (only if MCP confirms the strategy is ACTIVE; explicit `--wallet` always wins). Failures map to teaching errors (CMP200-219, + CMP206 when there is no ACTIVE wallet to auto-bind). Resumable-by-artifact. | `... python -m composer.cli fund drafts/dist/my_strat --budget 250` then `... install drafts/dist/my_strat` |
+| `close` | SAFE TEARDOWN of a running strategy: STOP the runtime first (`openclaw senpi runtime delete`), CONFIRM it is gone, and only THEN trigger MCP `strategy_close` (flattens all positions, returns funds). Idempotent — re-running IS the poll to `CLOSED`. Target is a strategy name / canonical hash dir / runtime id / `0x…` wallet / strategyId; on-box artifacts resolve first, else legacy `strategy_list` attribution (skillName / strategyId). Failures map to teaching errors (CMP220-225). | `... python -m composer.cli close my_strat --state-dir ~/.openclaw/senpi-state` |
+| `status` | Derives your lifecycle position (`absent` / `invalid` / `valid_undeployed` / `deployed_stale` / `deployed_current`) from the file + check + staged manifest, and names the next verb. Pass `--state-dir` to EXTEND the chain onto a box: `installable` → `installed_unregistered` → `installed_stopped` → `installed_running`, distinguishing which hash is installed/running vs merely a prior landed version. Functional liveness (scan() has actually ticked) is reported honestly as NOT-checked — `runtime list` only proves the process is up. No journal — the file is the state. | `... python -m composer.cli status drafts/my_strat.graph.yaml -o drafts/dist --state-dir ~/.openclaw/senpi-state` |
 | `catalog` | The progressive-disclosure node index (names + one-liners + param summary) — level 1. Reference it; don't inline the whole thing into a prompt. | `... python -m composer.cli catalog` |
 | `describe` | Full ports/params/example/cost for ONE node — level 2, on-demand deep-dive. | `... python -m composer.cli describe candles_fetch` |
 
@@ -76,17 +89,17 @@ interprets it) — plus any `requires:` capabilities. Full field definitions liv
 `composer/authoring/answers.py`; the shape:
 
 ```yaml
-archetype: trend_momentum      # trend_momentum | thesis_fund | classifier
+archetype: trend_momentum      # trend_momentum | breakout | thesis_fund | classifier
 strategy: my_strat             # short id -> <id>.graph.yaml
 universe:
-  whitelist: ["BTC", "ETH", "SOL"]   # fixed asset list (trend_momentum)
+  whitelist: ["BTC", "ETH", "SOL"]   # fixed asset list (trend_momentum / breakout)
   long_basket: []                    # thesis_fund LONG leg (use instead of whitelist)
   short_basket: []                   # thesis_fund SHORT leg
-  discover: false                    # classifier: derive the universe from the live board
-  dex: ""                            # classifier discovery: venue filter
-  name_prefix: ""                    # classifier discovery: instrument name prefix
-  max_leverage_cap: 5.0              # classifier discovery: leverage ceiling
-  min_day_volume: 0.0                # classifier discovery: daily-volume floor
+  discover: false                    # classifier / breakout: derive the universe from the live board
+  dex: ""                            # discovery: venue filter
+  name_prefix: ""                    # discovery: instrument name prefix
+  max_leverage_cap: 5.0              # discovery: leverage ceiling
+  min_day_volume: 0.0                # discovery: daily-volume floor
 intervals: ["4h"]               # candle intervals, e.g. ["1h", "4h"]
 max_positions: 1                # 1 = single best; >1 = rank a pool, cap to open slots
 ttl_seconds: 240                # signal-dedup memory window
@@ -106,17 +119,62 @@ edge: >
   This is carried verbatim into the graph; nothing parses it, so be as specific as you want.
 requires: []                    # [{name, kind, need}] — a capability that may not exist yet;
                                   # a name the registry lacks becomes a gap report, nothing written
+# --- OPTIONAL expressiveness (omit both for the archetype's working defaults) ---
+indicators:                     # ADD registry indicator nodes and wire them into the scorer,
+                                #   so they become addressable by id from `scoring` below.
+  - id: fresh_raw               #   the node's graph id (a feature key = SOURCE NODE ID)
+    node: recent_high_bars_ago  #   any registry indicator (see `composer catalog`)
+    with: { window: 24, interval: "1h" }   # the node's params
+    # port: bars_ago            #   optional: which output feeds the scorer (default: the node's sole output)
+  - id: fresh                   #   a THRESHOLDED gate over the raw feature above (C1b)
+    node: threshold_gate        #   compare a per-asset feature vs a threshold -> 1.0/0.0
+    with: { op: lte, value: 5 } #   op is lt|lte|gt|gte; here: bars_ago <= 5 means "fresh"
+    source: fresh_raw           #   CHAIN the input off fresh_raw's output (not candles)
+scoring:                        # RE-SELECT the scorer's hard-vs-weighted split over the feature
+                                #   nodes (built-in + any `indicators` above). Each field omitted
+                                #   -> keep the archetype default; set -> override it.
+  required_gates: ["brk", "fresh", "vol", "lean"]   # feature ids that must ALL pass (hard gates)
+  weights: { mom: 2.0, vol: 1.0, lean: 0.05 }       # feature id -> weighted-sum weight
+  min_score: 0                  # minimum score to emit
 ```
 
 **Universe modes**: `whitelist` is a fixed list you already know (trend_momentum,
-trend_conviction shapes). `long_basket`/`short_basket` are the two legs of a fixed macro
-basket (thesis_fund — a relative-value long/short). `discover: true` (+ `dex`,
+breakout, trend_conviction shapes). `long_basket`/`short_basket` are the two legs of a
+fixed macro basket (thesis_fund — a relative-value long/short). `discover: true` (+ `dex`,
 `name_prefix`, `max_leverage_cap`, `min_day_volume`) derives the tradeable set each tick
-from the live instrument board by a signature instead of a fixed list (classifier).
-
-An `archetype` the composer doesn't recognize (i.e. not `trend_momentum` /
-`thesis_fund` / `classifier`) falls back to the **off-map skeleton** — still a valid,
-generated starting graph, just minimal; expect to do more hand-editing from there.
+from the live instrument board by a signature instead of a fixed list (classifier and
+breakout). `trend_momentum` is fixed-universe only — a `discover: true` answer is rejected
+with a teaching error pointing at `breakout` / `classifier` (it never silently emits an
+empty universe).
+
+**Archetypes**: `trend_momentum` (fixed universe → indicators → hard-gates + weighted-sum
+scorer), `breakout` (a directional range-break as the hard gate, fixed basket OR discovered
+universe — the hawk shape), `classifier` (a pure_fn direction classifier on a discovered or
+fixed universe), `thesis_fund` (fixed long/short basket, direction fixed per leg). An
+`archetype` the composer doesn't recognize falls back to the **off-map skeleton** — still a
+valid, generated starting graph, just minimal; expect to do more hand-editing from there.
+
+**Expressiveness (`scoring` / `indicators`)**: both are OPTIONAL and default to the
+archetype's built-in scorer. `scoring` re-selects which feature nodes are HARD gates
+(`required_gates`) versus weighted contributors (`weights`) and the score floor
+(`min_score`), addressing feature nodes by their SOURCE NODE ID. `indicators` adds
+registry indicator nodes (e.g. `breakout_detect` with a `window`) and wires them into the
+scorer so they become addressable from `scoring`. A `scoring` name that matches no feature
+node, or an `indicators` node the registry lacks, is a loud generation error — never a
+silent drop. This is how, e.g., the `breakout` archetype expresses a four-hard-gate
+discovery variant without any hand editing.
+
+**Thresholded gates (`threshold_gate` + `source`)**: a hard gate must be TRUTHY, so a raw
+numeric feature (e.g. `recent_high_bars_ago`, whose output is bars-since-the-high) can't be
+gated directly — 0 (a high set this bar) reads falsy, a stale 40 reads truthy, exactly
+inverted. Add a `threshold_gate` indicator (`op` one of `lt|lte|gt|gte`, `value` the
+threshold) and CHAIN it off the raw feature with `source:` — its input then reads that node's
+output instead of candles, emitting a real `1.0`/`0.0` gate. So a "fresh entry within 5 bars"
+gate is `fresh = threshold_gate(op: lte, value: 5, source: fresh_raw)` over `fresh_raw =
+recent_high_bars_ago(...)`; a "don't chase a runaway" filter is `threshold_gate(op: lt, value:
+15, source: own_ret)` over an `own_return_24h` feature. `source` names an EARLIER `indicators`
+entry or a built-in feature node of the archetype; an unknown source, or one whose output
+type doesn't match the consumer's input, is a loud generation error.
 
 Get a blank skeleton for any archetype with `composer describe`-adjacent tooling, or just
 copy the block above and strip fields you don't need — every field has a sane default via
@@ -133,9 +191,29 @@ edit rights over the whole graph: add/remove nodes, rewire edges, retune any par
 Two ways to express bespoke logic:
 
 - **Registry nodes** (`node: <name>`, see `catalog`) — parameterized, pre-built pipeline
-  steps: sources, indicators, filters, scorers, rankers, the emitter, and the
-  `ttl_dedup_state` stateful node. Wire per-asset features into a scorer's `features`
-  input to MERGE them (keyed by producing node id).
+  steps: sources, indicators, filters, scorers, rankers, the emitter, and three stateful
+  nodes (`ttl_dedup_state` for signal dedup; `snapshot_diff_state` for a bounded rolling
+  per-key growth ledger; `cohort_cache_state` to pin an expensive fetch across ticks). Wire
+  per-asset features into a scorer's `features` input to MERGE them (keyed by producing node
+  id). The cohort/cross-trader vocabulary (the whalehunter thesis) is now expressible end to
+  end: `top_traders_fetch` → `cohort_cache_state` → `trader_states_fetch` → `aggregate_bias`
+  (the one sanctioned fn→primitive promotion: cross-trader net/gross bias per coin) +
+  `snapshot_diff_state` → a bespoke cohort-scoring `pure_fn` → emit. The **world-coverage sources** span the
+  whole scanner-usable Senpi MCP read surface (proven fully-mapped by the closure check, see
+  below): market signals (funding regime/history, cross-asset flows, prices, momentum events),
+  trader intelligence (top-traders + batch trader-state, the fast 4h smart-money leaderboard
+  `leaderboard_top_fetch` and its single-trader companion `leaderboard_trader_fetch`, leaderboard
+  trader positions, copy-strategy ranking `top_strategies_fetch`, the Arena leaderboard), and
+  own-account reads (order/PnL/clearinghouse/history, banked realized-PnL on open positions).
+  They emit `record_list` outputs — ordered lists of typed dict records — and, for
+  `funding_regime_fetch`, a `label` output (a market-wide categorical string like `LONG_CROWDED`).
+  Neither type is asset-keyed: their intended consumer is a `kind: pure_fn` node that declares a
+  `record_list`/`label` input and reads the fields itself (e.g. project addresses out of
+  `top_traders_fetch.traders` and wire that record_list straight into `trader_states_fetch.traders`
+  to pull the cohort's live books; or project `{wallet_address, coin}` pairs into
+  `open_positions_realized_pnl_fetch.positions`). Prefer `leaderboard_top_fetch` for CURRENT-
+  momentum cohorts (transient 4h delta-PnL) and `top_traders_fetch` for CONSISTENT-performer
+  cohorts (multi-window track record) — the two are deliberately different reads.
 - **`kind: pure_fn` nodes** — how you write bespoke scoring/classification math the
   registry vocabulary can't express (e.g. the cross-feature conviction waterfall in
   `composer/examples/conviction_scorer.graph.yaml`, corpus_origin: bison). Rules, statically
@@ -150,6 +228,20 @@ Two ways to express bespoke logic:
   - it must `return` exactly its declared outputs;
   - include `tests:` (inline fixture cases: `inputs:` → `expect:`) — these run as part of
     `composer check`'s `pure_fn_tests` stage.
+- **The escape hatch (`mcp_read` + the `raw` port)** — the LAST RESORT for a read the curated
+  source vocabulary doesn't wrap (or doesn't expose the fields you need). `mcp_read` calls a
+  named MCP tool with `args` passed verbatim and emits the unwrapped payload as the `raw` type;
+  you MUST wire that payload into a `kind: pure_fn` node — the NORMALIZER — which reads it and
+  returns TYPED outputs (with inline tests). What it's for: closing a genuine gap without
+  waiting for a registry add. What it is NOT: a way to bypass typing (a `raw` wire may feed
+  nothing but a pure_fn — CMP039), a general-purpose tool caller (READ-ONLY: the `tool` must be
+  in the committed snapshot and must not be a mutation — CMP060/CMP061), or a substitute for a
+  first-class node. **Reach for the registry/answers path FIRST** (`composer catalog` /
+  `composer describe`); use the hatch only when nothing fits, and be explicit in the `edge:`
+  about WHAT you're fetching and WHY the curated path can't express it. Never invent a tool —
+  if the read doesn't exist, it can't be faked here. `composer check` ANNOTATES every hatch use
+  (and flags when the tool already has a first-class node) so the usage stays visible; recurring
+  hatch use of the same shape is the maintainer's signal to wrap it as a real source node.
 
 **Teaching errors are actionable, not decorative.** Every error from `validate`/`check`
 carries a stable code (`CMPxxx`), a location (node id / port / line), what's wrong in one
@@ -210,6 +302,20 @@ what you'd wire in. Re-run `check` after each edit until GREEN.
   nearest registry alternatives) and writes nothing. That's the correct outcome for
   something not yet buildable; the fix is adding the capability to the registry, not
   working around it in the graph.
+- **Stateful nodes carry PRIOR-tick data, and the cohort cache does NOT skip the fetch.**
+  Every stateful node is split READ (prologue) / WRITE (epilogue): its outputs are read
+  BEFORE the pipeline runs and reflect the LAST persisted tick, while its late input is
+  recorded AFTER. Two consequences to author around: (1) `snapshot_diff_state.growth` is the
+  delta between the latest STORED snapshot and the oldest in the window — one tick behind this
+  tick's fresh input, and empty until ≥2 buckets have accumulated (a short warmup, exactly like
+  whalehunter's `requireGrowing` blocking until ~day 2). (2) `cohort_cache_state` does NOT
+  rate-limit — sources fire every tick and the compiler emits the upstream fetch
+  unconditionally (there is no conditional-fetch machinery). What it buys is COHORT STABILITY:
+  the read half serves the last-known-good cohort (pinned for `ttl_hours`, smoothing a transient
+  fetch failure, surviving process restarts via `ctx.state`), and the write half refreshes only
+  when the TTL lapses, the `version` changes, or the cache was empty. Cold start serves an empty
+  cohort for one warmup tick. State is BOUNDED by design (dedup prune, `max_snapshots` cap, one
+  cached cohort) — an unbounded fleet-box state series is a real ops hazard.
 - **Ambiguous ideas need answers first, not invented specifics.** If a brief is missing
   information you can't responsibly guess (which assets, long/short/both, how much risk),
   ask the user rather than pick something plausible-sounding. Pin down the answers file,
@@ -226,8 +332,104 @@ what you'd wire in. Re-run `check` after each edit until GREEN.
   a GREEN `check` (which now includes the `runtime_validate` stage — the real Zod + DSL oracle)
   and stages a standalone strategy PACKAGE TREE, idempotent and side-effect-free:
   `strategy.yaml` (catalog + funding manifest), `main/runtime.yaml` (the complete runtime:
-  strategy/scanners/actions/**exit**/risk), `main/scanners/scan.py`, `main/<id>.graph.yaml`, and
-  `manifest.json` (hashing all three, with the runtime's Zod verdict). There is no host
-  `runtime.yaml` to borrow — the staged unit is complete on its own. Install is `senpi-strategy-ops`:
+  strategy/scanners/actions/**exit**/risk), `main/scanners/scan.py`,
+  `main/scanners/strategy_primitives/` (a vendored SNAPSHOT of `composer/primitives/`, a sibling
+  package of `scan.py`), `main/<id>.graph.yaml`, and `manifest.json` (hashing every artifact
+  including each vendored primitives file, with the runtime's Zod verdict). The emitted `scan.py`
+  imports `strategy_primitives`, NEVER `composer.*`, so the unit is self-contained: it runs on a
+  box that has none of the composer checkout — the scaffold puts the scanner dir on `sys.path` and
+  the vendored package resolves as a sibling of `scan.py`. The snapshot freezes the primitives at
+  deploy time (later `composer/primitives/` changes never mutate an already-staged strategy). There
+  is no host `runtime.yaml` to borrow — the staged unit is complete on its own. Install is `senpi-strategy-ops`:
   it reads `strategy.yaml.instances[]`, mints one funded wallet per instance, and renders each
   `runtime.yaml` onto its wallet. The composer never creates wallets, moves money, or installs.
+- **`install` puts ONE instance of a staged unit onto a box — without touching the frozen runtime.**
+  `composer install <staged-dir> --wallet 0x…` (or a graph file plus `-o <staging-dir>`) is the box-side
+  step deploy stops short of. It (a) PREFLIGHTS — resolves the staged tree, verifies every artifact's
+  bytes against `manifest.json` (CMP201, tamper/hand-edit detection), and requires the recorded oracle
+  verdict to be GREEN (`VALID`; a `SKIPPED` verdict on an oracle-less box is allowed, `INVALID` is CMP202);
+  (b) COPIES the unit to a CONTENT-ADDRESSED, IMMUTABLE dir `<senpi-state>/strategies/<strategy>/<hash8>/`
+  — written to a temp sibling, every file re-verified against the manifest (CMP203), then atomic-renamed
+  into place, and NEVER edited after (so the frozen inline-YAML in the registry can't drift from the
+  scan.py re-read off disk on a scaffold respawn). `hash8` = the first 8 hex of a sha256 over the manifest
+  `artifacts` map, so identical staged content always maps to the same dir and a re-install is an idempotent
+  no-op; (c) BINDS the real `--wallet` for the `${..._WALLET}` placeholder in the COPIED `runtime.yaml` only
+  (the staged source stays pristine), records the binding in `install.json`, and re-runs the placeholder
+  policy — any remaining bare `${VAR}` after binding is CMP115; (d) INVOKES the FROZEN consumer,
+  `openclaw senpi runtime create -p <hashdir>/main/runtime.yaml` (PATH mode — never `--content`), behind an
+  injectable seam; (e) maps the known installRuntime failure classes (duplicate id CMP210,
+  one-runtime-per-wallet CMP211, wallet not ACTIVE CMP212, invalid YAML CMP213, entrypoint missing CMP214)
+  to teaching errors that name the exact next command. The runtime id is `<strategy>-<hash8>` (content-keyed,
+  so a duplicate is meaningful). Every step's completion is derivable from disk (staged tree / hash dir +
+  `install.json` / the box registry entry) — the verb is resumable-by-artifact, with no hidden session state.
+  The wallet is supplied by `--wallet`, or auto-bound from the `composer fund` `wallet.json` when `--wallet`
+  is omitted (see `fund`, below); the update/reinstall (delete+create) flow is OUT of scope (the sanctioned
+  teardown path is `composer close`, below).
+- **`fund` creates + funds the wallet — inside the flow, with an EXPLICIT budget.** `composer fund
+  <staged-dir> --budget <usd>` is the funding step the composer used to hand off conversationally. `--budget`
+  is REQUIRED and EXPLICIT (≥ $100): agree it with the user and pass the exact amount. It is NEVER derived
+  from a `funding_share` nor split across wallets — that legacy ops derivation misfired on a real box
+  (it bridged in pieces and told a user with sufficient balance to top up), so this verb funds ONE wallet
+  with the ONE number you pass. Steps, resumable-by-artifact: (a) if `<senpi-state>/strategies/<strategy>/wallet.json`
+  exists (STRATEGY-level, ABOVE the `<hash8>` dirs — the wallet is the strategy's instance identity across
+  content versions), verify it via MCP `strategy_list` — ACTIVE → `FUNDED` no-op, still initializing →
+  `PENDING`, closed/gone → CMP231 (stale); (b) otherwise PREFLIGHT the visible balance via
+  `account_get_portfolio` (free Hyperliquid + free EVM USDC, summed as the backend funds a create) — short
+  of budget → CMP232 stating the current visible total, the exact shortfall, the bridged-funds VISIBILITY
+  LAG (funds moved HL→EVM can lag ~a minute; wait + re-run), and the top-up options (the composer NEVER
+  bridges); (c) sufficient → call MCP `strategy_create_custom_strategy` (`skillName` = the strategy name,
+  matching what `composer close`'s legacy discovery reads), record `wallet.json` BEFORE polling, then poll
+  briefly to ACTIVE. `strategy_create_custom_strategy` is a MONEY MUTATION: there is no `--yes` (the CLI is
+  agent-driven — the user's confirmation is conversational per the skill), but the verb prints an
+  unmistakable pre-action line (creating wallet, budget, funding source) in its result. Missing MCP creds
+  is a loud CMP223. Then `composer install` (omit `--wallet`) auto-binds the funded wallet.
+- **`close` is the ONLY sanctioned teardown — never a raw `strategy_close`.** The invariant is
+  non-negotiable: STOP the runtime first (`openclaw senpi runtime delete <id>`), CONFIRM it is gone,
+  and ONLY THEN submit MCP `strategy_close(<strategyId>)` (which flattens ALL positions and returns
+  funds). A raw `strategy_close` with a live runtime STRANDS the runtime — it keeps trading a wallet the
+  server is tearing down. `composer close <target>` enforces this behind injectable seams: if the runtime
+  delete fails (CMP220) or the runtime is still present afterward (CMP221), `strategy_close` is WITHHELD
+  and the verb fails loud rather than strand or double-fire. It is IDEMPOTENT and SUBMIT-ONLY (no poll):
+  `strategy_close` is async, so the verb reports `CLOSING` and re-running it IS the poll — a re-run skips
+  the delete (runtime already gone) and skips the re-submit (strategy left the ACTIVE set), reporting
+  `CLOSED` once the strategy is terminal. It resolves the target from the composer's own on-box artifacts
+  first (a canonical hash dir's `install.json`, or a strategy name / runtime id under `--state-dir`), and
+  falls back to `strategy_list` attribution (skillName / strategyId + the wallet read from the strategy
+  record) so it also closes legacy ops-deployed strategies and orphan runtimes. Missing MCP creds
+  (`SENPI_API_KEY`) is a loud CMP223, not a silent skip.
+- **`status --state-dir` is the resumable-by-artifact install chain.** With a box named, `status` walks
+  the current staged content DOWN onto the box entirely from artifacts + one read-only `runtime list`:
+  landed (canonical hash dir + `install.json`) → registered (`installed_runtimes.json`) → running. Multiple
+  hash dirs for one strategy are distinguished — which hash is installed/running vs a merely-landed prior
+  version. Liveness is reported HONESTLY: `runtime list` proves only that the process is up, so a running
+  install is annotated that functional liveness (scan() `runCount>0`, a fresh `lastRunFinishedAt`,
+  `consecutiveErrorCount==0` — see `senpi-strategy-ops/references/liveness-verification.md`) is NOT checked
+  here; run `openclaw senpi state -r <id> --json` for that. "running" ≠ "operating".
+
+## 8. Debugging generation deterministically
+
+Generation (`new`/`check`/`deploy`) is fully offline-reproducible: no creds, no network, no
+wall-clock — the same answers always produce the same bytes. So any "the composer generated the
+wrong thing" report replays exactly. The procedure (proven on the first real dev-test incident):
+
+1. Reconstruct the user's answers file from the conversation (the graph's `metadata` block IS the
+   answers when you have the generated graph — spec-is-state).
+2. Drive the CLI into a scratch dir: `python -m composer.cli new --archetype <a> --answers <f> -o /tmp/repro`
+   (deps: pyyaml, pydantic, jinja2, jsonschema — a throwaway venv or `uvx` is enough).
+3. Diff the emitted graph against what the user agreed to — the delta names the lost intent.
+4. Read the archetype's `build()` in `composer/authoring/archetypes/` for where that intent was
+   dropped (a hardcoded literal, an unread answer field, a missing archetype route).
+
+Classify before fixing: COVERAGE (no archetype+params expresses it) · EXPRESSIVENESS (the answers
+surface can't say it) · ROUTING (wrong archetype chosen) · INSTRUCTION (the skill never told the
+agent to pass it). Each has a different smallest fix — and only genuinely-missing SOURCE
+capability (no data feed in the world) is a registry gap; everything else is composer-side.
+
+**Maintainer note (source coverage).** The source vocabulary is kept EXHAUSTIVE over the scanner-
+usable Senpi MCP read surface, and that claim is enforced continuously by the CI closure check
+(`composer/registry/mcp_closure.py`, offline by default). If a new server-side read tool appears,
+CI goes red until it is either mapped by a new source node (declaring `mcp_tool="..."`) or added to
+the allowlist with a reason. To pick up a catalog change, run
+`MCP_SNAPSHOT_REFRESH=1 pytest python-tests/composer/test_mcp_closure.py` (fetches the live
+unauthenticated `tools/list`, rewrites `mcp-tools-snapshot.json`, and surfaces input-schema drift),
+then commit the refreshed snapshot. Full design in `docs/composer/design-models.md` §9.