@senpi/runtime 3.0.58 → 3.0.62

package/dist/actions/skipped-signal-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipped-signal-results.js","sourceRoot":"","sources":["../../src/actions/skipped-signal-results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,MAAc,EACd,KAAa,EACb,SAAiD;IAEjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,iFAAiF;QACjF,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,6FAA6F;QAC7F,yFAAyF;QACzF,8FAA8F;QAC9F,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9F,IAAI,CAAC,IAAI,CAAC;YACR,KAAK;YACL,GAAG,CAAC,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,EAAE,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM;YACvE,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,IAAI;YACnC,MAAM;YACN,GAAG,CAAC,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/deploy-render.d.ts

@@ -0,0 +1,91 @@
+export interface DeployStepLike {
+    status: string;
+    detail: string;
+    evidence?: Record<string, unknown>;
+}
+export interface DeployInstanceLike {
+    instance: string;
+    wallet?: string;
+    strategyId?: string;
+    funded?: number;
+    runtimeId?: string;
+    /** D-6: this job created the wallet, its install failed, and the close+refund completed. */
+    rolledBack?: boolean;
+    steps: Record<string, DeployStepLike>;
+}
+export interface DeployReportLike {
+    packageId: string;
+    version: string;
+    overall: string;
+    instances: DeployInstanceLike[];
+    next?: string;
+    /** The SOFT calculated-minimum tier — advisory, and never part of `overall`. */
+    minBudget?: number;
+    minWalletCount?: number;
+    belowMin?: boolean;
+    minBudgetNote?: string;
+    minBudgetUnresolved?: string[];
+    /** The OUTCOME tier — the backend funded a wallet short of the ask. Advisory, like the above. */
+    partialFundNote?: string;
+    /** The OUTCOME tier's other half — the backend reported no readable funded amount. Advisory. */
+    fundedUnreadableNote?: string;
+}
+export interface DeployEventLike {
+    seq: number;
+    ts: string;
+    type: string;
+    phase?: string;
+    instance?: string;
+    step?: string;
+    status?: string;
+    detail: string;
+}
+export interface DeployLiveLayerLike {
+    strategies: Array<{
+        strategyName: string;
+        status: string;
+        strategyWalletAddress: string;
+        totalFunded?: number;
+    }>;
+    runtimes: Array<{
+        id: string;
+        wallet?: string;
+    }>;
+    unavailable?: string;
+}
+export interface DeploySnapshotLike {
+    meta: {
+        deployId: string;
+        packageId: string;
+        version: string;
+        packageDir: string;
+        budget?: number;
+        startedAt: string;
+    };
+    state: {
+        status: "running";
+        phase: string;
+        stopRequested: boolean;
+    } | {
+        status: "done";
+        overall: string;
+    } | {
+        status: "interrupted";
+    };
+    events?: DeployEventLike[];
+    report?: DeployReportLike;
+    live?: DeployLiveLayerLike;
+    next?: string;
+}
+export declare function renderHeader(snap: DeploySnapshotLike, now: number): string;
+export declare function renderStepTable(report: DeployReportLike): string[];
+export declare function renderEventsTail(events: DeployEventLike[]): string[];
+export declare function renderReportFooter(report: DeployReportLike): string[];
+/** Fresh-read layer, printed beside (never instead of) the journal narration. */
+export declare function renderLiveLayer(live: DeployLiveLayerLike): string[];
+export declare function renderDeploySnapshotLines(snap: DeploySnapshotLike, now?: number): string[];
+/** The ONE place the D-12 map lives; the status action calls it. */
+export declare function exitCodeForDeploy(snap: DeploySnapshotLike): number;
+/** CLI entry point: print the snapshot rendering. */
+export declare function renderDeploySnapshot(snap: DeploySnapshotLike, now?: number): void;
+//# sourceMappingURL=deploy-render.d.ts.map

package/dist/cli/deploy-render.d.ts.map

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

package/dist/cli/deploy-render.js

@@ -0,0 +1,216 @@
+/**
+ * Pure renderer for `senpi deploy status`.
+ *
+ * Every number and lifecycle claim printed here is quoted from the surface that
+ * proves it — the report's `funded` (backend `totalFunded`), the scanner row's
+ * fields, the install payload — never re-derived in prose and never reformatted.
+ * A running phase renders as an in-progress fact, never as an achievement, and
+ * an unobserved tick renders as `unobserved` with the check-later command.
+ *
+ * Kept free of I/O so it unit-tests without the gateway spawn mock. It borrows exactly one thing
+ * from the deploy module — `usd()`, so money reads the same here as in the notes this prints beside
+ * — and nothing else: the report types below are structural mirrors, deliberately not imports, so
+ * the renderer stays decoupled from the orchestrator's shapes.
+ */
+import { usd } from "../deploy/funding.js";
+const STEP_ORDER = ["reconcile", "preflight", "create", "install", "observe"];
+const EVENT_TAIL = 6;
+/** Human phrase for a job state — running phases stay in-progress, never triumphant. */
+function renderState(state) {
+    switch (state.status) {
+        case "running":
+            return state.stopRequested
+                ? `running (phase: ${state.phase}; deploy deadline reached — stopping at the next step boundary)`
+                : `running (phase: ${state.phase})`;
+        case "done":
+            return `done — ${state.overall}`;
+        case "interrupted":
+            return "interrupted by a gateway restart (no deploy is running now)";
+    }
+}
+function elapsedSeconds(startedAt, now) {
+    const started = Date.parse(startedAt);
+    if (Number.isNaN(started))
+        return null;
+    return Math.max(0, Math.round((now - started) / 1000));
+}
+export function renderHeader(snap, now) {
+    const elapsed = elapsedSeconds(snap.meta.startedAt, now);
+    const elapsedPart = elapsed === null ? "" : `, elapsed ${elapsed}s`;
+    return (`deploy ${snap.meta.deployId} — ${renderState(snap.state)} — package ` +
+        `${snap.meta.packageId} v${snap.meta.version}${elapsedPart}`);
+}
+/** `k=v` pairs straight from the evidence object — no rounding, no currency formatting. */
+function renderEvidence(evidence) {
+    return Object.entries(evidence)
+        .map(([key, value]) => `${key}=${typeof value === "string" ? value : JSON.stringify(value)}`)
+        .join(" ");
+}
+export function renderStepTable(report) {
+    const lines = [];
+    for (const instance of report.instances) {
+        // A rolled-back wallet is closed and its funds are back with the owner — rendering it as
+        // `funded N` here would be the same fail-open as calling an unobserved tick `live`. An
+        // INCOMPLETE rollback deliberately keeps the funded figure: there the money really is stranded.
+        const facts = [
+            instance.wallet ? `wallet ${instance.wallet}` : null,
+            instance.strategyId ? `strategyId ${instance.strategyId}` : null,
+            instance.rolledBack
+                ? "ROLLED BACK — strategy closed, funds returned"
+                : instance.funded !== undefined
+                    ? `funded ${instance.funded}`
+                    : null,
+            // A runtime id survives a FAILED install (a blind runtime records its id as a fact), and the
+            // facts line is the skim line agents quote. Bare, it relays as "the runtime is installed" —
+            // the exact opposite of what the install step two lines below says.
+            instance.runtimeId
+                ? instance.steps.install?.status === "failed"
+                    ? `runtime ${instance.runtimeId} (install FAILED — not watching this wallet)`
+                    : `runtime ${instance.runtimeId}`
+                : null,
+        ].filter((fact) => fact !== null);
+        lines.push(`  instance ${instance.instance}${facts.length > 0 ? ` — ${facts.join(", ")}` : ""}`);
+        for (const step of STEP_ORDER) {
+            const outcome = instance.steps[step];
+            if (!outcome)
+                continue;
+            lines.push(`    ${step.padEnd(9)} ${outcome.status.padEnd(11)} ${outcome.detail}`);
+            if (outcome.evidence && Object.keys(outcome.evidence).length > 0) {
+                lines.push(`      evidence: ${renderEvidence(outcome.evidence)}`);
+            }
+        }
+    }
+    return lines;
+}
+export function renderEventsTail(events) {
+    if (events.length === 0)
+        return [];
+    return ["  recent events:", ...events.slice(-EVENT_TAIL).map((event) => `    ${event.ts}  ${event.detail}`)];
+}
+/**
+ * The SOFT calculated-minimum tier, rendered beside the overall — never folded INTO it.
+ *
+ * A deploy that ran below the package's calculated minimum is still `live`: the minimum is a local
+ * estimate over the package's own YAML, not a platform rule, and the deploy proceeded. So the
+ * figure prints as its own fact and the note prints under an explicit `warn:` label, which is what
+ * keeps a reader (agent or human) from reading its `[E_…]` code as a refusal.
+ *
+ * The figure renders through the same `usd()` every note in the deploy module uses. It is NOT in
+ * the "quote it exactly as carried" class that `funded` and the scanner fields are in: those are
+ * backend-quoted facts that must never be re-derived, whereas this one is computed locally two
+ * modules away. `SKILL.md` tells the agent to quote the report's numbers verbatim, so a bare `125`
+ * is what would reach the user.
+ *
+ * The two qualifiers COMPOSE rather than compete. `belowMin` and an unresolved sleeve can hold at
+ * once, and this line is what a skimming reader takes away, so dropping either half would
+ * understate the situation.
+ *
+ * `belowMin` renders as a statement about a WALLET, never about the budget versus this total. The
+ * two are different claims — a partially-adopted deploy splits the budget among fewer wallets — and
+ * "the requested budget is BELOW it" is not merely weaker but false where they diverge: a declared
+ * `funding_share: 0` sleeve is floored at MIN_WALLET at every budget, so `belowMin` holds while the
+ * budget may be far above the total.
+ */
+function renderSoftBudgetTier(report) {
+    const lines = [];
+    if (report.minBudget !== undefined) {
+        const unresolved = report.minBudgetUnresolved ?? [];
+        const parts = [];
+        if (unresolved.length > 0)
+            parts.push(`UNRESOLVED for ${unresolved.join(", ")}`);
+        if (report.belowMin) {
+            parts.push(`${unresolved.length > 0 ? "and " : ""}a wallet in this deploy is sized below its own minimum`);
+        }
+        const qualifier = parts.length > 0 ? ` — ${parts.join(", ")}` : "";
+        lines.push(`  calculated minimum: ${usd(report.minBudget)} across ${report.minWalletCount} wallet(s)${qualifier}`);
+    }
+    if (report.minBudgetNote)
+        lines.push(`  warn: ${report.minBudgetNote}`);
+    return lines;
+}
+export function renderReportFooter(report) {
+    const lines = [`  overall: ${report.overall}`, ...renderSoftBudgetTier(report)];
+    // A SECOND warn line, never merged with the soft tier's: that one is a claim about the funding
+    // plan against the package's own sizing, this one is a claim about what the backend actually
+    // landed, and a report can truthfully carry both. Same `warn:` label for the same reason — it is
+    // what stops a reader taking a bracketed code on a `live` deploy for a refusal.
+    if (report.partialFundNote)
+        lines.push(`  warn: ${report.partialFundNote}`);
+    // Mutually exclusive with the line above per wallet, but not per report: a two-sleeve package
+    // can land one short wallet and one unreadable read, and each wallet gets the note that fits it.
+    if (report.fundedUnreadableNote)
+        lines.push(`  warn: ${report.fundedUnreadableNote}`);
+    if (report.next)
+        lines.push(`  next: ${report.next}`);
+    return lines;
+}
+/** Fresh-read layer, printed beside (never instead of) the journal narration. */
+export function renderLiveLayer(live) {
+    if (live.unavailable)
+        return [`  live (fresh read): unavailable — ${live.unavailable}`];
+    const lines = ["  live (fresh read):"];
+    if (live.strategies.length === 0)
+        lines.push("    strategies: none matching this package");
+    for (const strategy of live.strategies) {
+        lines.push(`    strategy ${strategy.strategyName}: status ${strategy.status}, ` +
+            `wallet ${strategy.strategyWalletAddress}, totalFunded ${strategy.totalFunded ?? "unreadable"}`);
+    }
+    if (live.runtimes.length === 0)
+        lines.push("    runtimes: none registered for this package");
+    for (const runtime of live.runtimes) {
+        lines.push(`    runtime ${runtime.id}: wallet ${runtime.wallet ?? "(none)"}`);
+    }
+    return lines;
+}
+export function renderDeploySnapshotLines(snap, now = Date.now()) {
+    const lines = [renderHeader(snap, now)];
+    const interrupted = snap.state.status === "interrupted";
+    if (snap.report)
+        lines.push(...renderStepTable(snap.report));
+    const events = snap.events ?? [];
+    if (events.length > 0) {
+        lines.push(...(interrupted ? ["  history (journal):"] : []), ...renderEventsTail(events));
+    }
+    if (snap.live)
+        lines.push(...renderLiveLayer(snap.live));
+    if (snap.report)
+        lines.push(...renderReportFooter(snap.report));
+    if (snap.next)
+        lines.push(`  next: ${snap.next}`);
+    return lines;
+}
+/**
+ * D-12 exit-code contract for `senpi deploy status`. 1 is reserved for transport/internal
+ * errors (node/commander default) and is also the unknown-status fallback so a future status
+ * can never silently read as success. Anything richer than the overall status: use --json.
+ */
+const DEPLOY_EXIT_CODES = {
+    live: 0,
+    refused: 2,
+    failed: 3,
+    "installed-unobserved": 4,
+    interrupted: 5,
+    // A report whose overall is `pending` (a wallet was still funding when the poll budget ran out)
+    // is the same answer as a job still in flight: not finished, re-run to resume. It shares code 6
+    // rather than falling to 1, which would call a normal resumable outcome an internal error.
+    pending: 6,
+};
+/** The ONE place the D-12 map lives; the status action calls it. */
+export function exitCodeForDeploy(snap) {
+    // A snapshot with no state is a broken gateway contract, not a running job — 1, not 6.
+    if (!snap?.state?.status)
+        return 1;
+    // `interrupted` is a terminal STATE, not an overall — a gateway restart killed the job. It is
+    // not pending: nothing is running, so it must never exit 6.
+    if (snap.state.status === "interrupted")
+        return DEPLOY_EXIT_CODES.interrupted;
+    if (snap.state.status !== "done")
+        return 6; // pending — job still running
+    return DEPLOY_EXIT_CODES[snap.state.overall ?? ""] ?? 1;
+}
+/** CLI entry point: print the snapshot rendering. */
+export function renderDeploySnapshot(snap, now = Date.now()) {
+    for (const line of renderDeploySnapshotLines(snap, now))
+        console.log(line);
+}
+//# sourceMappingURL=deploy-render.js.map

package/dist/cli/deploy-render.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8cH,eAAO,MAAM,eAAe,QAqNpB,CAAC;AAIT,kFAAkF;AAClF,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,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}
+{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+cH,eAAO,MAAM,eAAe,QA4RpB,CAAC;AAIT,kFAAkF;AAClF,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,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}

package/dist/cli/guide-commands.js

@@ -24,6 +24,7 @@ Quick commands:
   senpi guide actions     Action types and decision modes
   senpi guide dsl         DSL exit: phases, lock modes, tiers, time-based cuts
   senpi validate <pkg>    Prove a strategy runs before funding it (static → import → live)
+  senpi deploy -p <pkg>   Take a proven package live: create+fund → install → verified tick
   senpi scanner           Per-scanner health: runs, errors, liveness, "(no signals yet)" flag
   senpi events            Local domain-event log — the trade narrative
   senpi explain <asset>   Stitch one asset's position lifecycle from the event log
@@ -478,11 +479,75 @@ senpi config — Manage CLI preferences (~/.openclaw/senpi-cli.json)
   config unset <key>                   Remove a key
   config reset                         Clear all preferences
 
+senpi deploy — Take a strategy package live, end to end (the strategy lifecycle)
+  openclaw senpi deploy -p <package-dir> --budget <usd>   # start (detached): preflight → create+fund → install → verified tick
+  openclaw senpi deploy status                            # watch until terminal; quotes the verified report
+    -p, --path <dir>                     Strategy package directory (contains strategy.yaml)
+    --budget <usd>                       Total budget across the package's wallets (min $10/wallet)
+    --decision-model <model>             Required if the package uses decision_mode: llm
+    --tick-wait <seconds>                Wait for one verified scanner tick (default 120, 0 skips)
+    --max-wait <seconds>                 Wait for wallets to reach ACTIVE (default 150)
+    --json                               Raw JSON output
+                                       deploy returns in ~1s; the job runs detached. Poll
+                                       'deploy status' until it is terminal. Exit codes:
+                                       0 live · 2 refused · 3 failed · 4 installed-unobserved ·
+                                       5 interrupted · 6 pending/running · 1 error. An
+                                       unobserved tick reports as "unobserved", never as success.
+                                       'deploy' itself uses the same classes at START: 0 job
+                                       started · 2 refused (the message leads with its code, e.g.
+                                       [INVALID_REQUEST]) · 1 internal/transport. So 2 always
+                                       means obey the message; 1 always means the deploy's state
+                                       is unknown — never retry a 2.
+                                       A package no 'senpi validate' has ever proven — or one whose
+                                       files have changed since, or whose proof predates this
+                                       runtime — is refused BEFORE any money moves. The refusal
+                                       leads with [E_VALIDATE_NO_PROOF] /
+                                       [E_VALIDATE_CONTENT_CHANGED] /
+                                       [E_VALIDATE_RUNTIME_VERSION_CHANGED] and names the exact
+                                       validate command for the instance that failed. Two instances
+                                       sharing one runtime directory are refused outright
+                                       ([INVALID_REQUEST]): a proof lives beside its recipe, one
+                                       file per directory, so it cannot speak for both.
+                                       Budget is two-tier: BELOW the $10/wallet floor it refuses
+                                       [E_FUNDS_BELOW_FLOOR]; and when the split leaves a wallet
+                                       under its OWN sizing it DEPLOYS and warns
+                                       [W_BUDGET_BELOW_STRATEGY_MIN] (that sleeve runs degraded —
+                                       fewer slots than authored). [W_BUDGET_UNRESOLVED] = the
+                                       minimum could not be computed and may be understated.
+                                       Neither warn stops a deploy; both judge each wallet against
+                                       its OWN allocation, not the budget against the package
+                                       total (those differ once a sleeve is adopted). To run the
+                                       authored design you must close and redeploy — a re-run at
+                                       a bigger --budget only adopts the wallet it already made.
+                                       Follow the warn's own close command verbatim; it is scoped
+                                       to the short sleeves so adopted wallets are left alone.
+                                       Some reports deliberately carry NO close command (a funded
+                                       wallet with no runtime installed; a funding_share: 0
+                                       sleeve; or when [E_ROLLBACK_INCOMPLETE] owns the cleanup)
+                                       — that is the correct answer there, not a gap to fill:
+                                       never substitute a package-wide close.
+                                       Both of those judge the PLAN. After the wallets exist the
+                                       report also checks the OUTCOME: when the backend lands under
+                                       90% of what a wallet was asked to be funded, it warns
+                                       [W_BUDGET_PARTIAL_FUND] with both numbers ("funded $60.00 of
+                                       requested $500.00 (12%, short $440.00)"). The strategy is
+                                       still live and the exit code does not move — do NOT close it
+                                       over the shortfall. Quote the FUNDED figure, never the
+                                       requested one. Those figures are AT DEPLOY TIME and the note
+                                       re-renders on every later status read, so re-read the
+                                       current funding (status.py) before moving money, then top up
+                                       via the senpi-deposit-withdraw-transfer skill;
+                                       close-and-redeploy is the destructive fallback. The warn is
+                                       silent wherever a D-6 rollback was attempted — if the create
+                                       step carries [E_ROLLBACK_INCOMPLETE], THAT line owns the
+                                       remediation (reclaim), and it is the one to follow.
+                                       When the backend reports no readable funded amount at all,
+                                       you get [W_BUDGET_FUNDED_UNREADABLE] instead: no percentage,
+                                       no shortfall, no top-up. The funded amount is UNKNOWN, never
+                                       $0.00 — ask the USER to verify what actually landed before
+                                       any money action
+
 senpi runtime — Manage runtimes
-  runtime create                       Add a runtime from a YAML file
-    -p, --path <path>                    Path to strategy YAML file
-    -c, --content <yaml>                 Inline YAML content
-    --runtime-id <id>                    Override auto-derived ID
   runtime delete [id]                  Remove a runtime
     --id <runtime_id>                    Delete by runtime ID
     --address <wallet>                   Delete by wallet address
@@ -510,6 +575,12 @@ senpi validate — Prove a strategy can execute BEFORE it is funded
                  command, not the code
   A full unscoped PASS at live depth writes .senpi-proof.json beside the recipe
   (content-addressed, no expiry); the deploy gate verifies it via verifyProof().
+  That gate REFUSES, before any money moves: [E_VALIDATE_NO_PROOF] nothing here
+  was ever observed to run · [E_VALIDATE_CONTENT_CHANGED] the files moved since
+  the proof, and it names which · [E_VALIDATE_RUNTIME_VERSION_CHANGED] the proof
+  predates the running runtime (the package needs no edit — just re-prove it).
+  A proof attests that this content RAN and passed, not that every check at that
+  depth produced a verdict — deploy re-checks the live instrument universe itself.
 
 senpi status — Lightweight runtime health digest
   status                               Overall health + scanners (with degraded count),
@@ -623,8 +694,9 @@ senpi.installRuntime
   Success: { id, name, wallet }
   Errors:  INVALID_REQUEST (missing YAML, duplicate ID/wallet, or the install gate: a recipe that
            cannot trade — no margin source, no risk guardrails, missing scanner entrypoint, or an
-           unresolvable scanner path — is refused with what/why/fix per problem),
-           UNAVAILABLE (bad YAML, start failure)
+           unresolvable scanner path — is refused with what/why/fix per problem, the message
+           leading with the bracketed code of the first blocking finding, e.g.
+           [E_VALIDATE_UNGATED]), UNAVAILABLE (bad YAML, start failure)
 
 senpi.listRuntimes
   Params:  (none)

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

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

package/dist/cli/senpi-commands.d.ts

@@ -24,7 +24,12 @@ export declare function renderEventsDigest(entries: StoredEvent[]): string;
 export declare function renderExplain(asset: string, entries: StoredEvent[]): string;
 /** Minimal Commander command type for subcommands and options. */
 interface CommanderCommand {
-    command(name: string, desc?: string): CommanderCommand;
+    /** Commander 14 accepts either a description string or an options object (e.g. `{ hidden: true }`). */
+    command(name: string, descOrOpts?: string | {
+        hidden?: boolean;
+    }, opts?: {
+        hidden?: boolean;
+    }): CommanderCommand;
     description(desc: string): CommanderCommand;
     argument(name: string, description?: string): CommanderCommand;
     option(flags: string, description?: string): CommanderCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"senpi-commands.d.ts","sourceRoot":"","sources":["../../src/cli/senpi-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAA;CAAE,GAChF,IAAI,CA4vCN;AAgKD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAWvE;AAmDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CASjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAW3E;AA8HD,kEAAkE;AAClE,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,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtE,MAAM,CACJ,EAAE,EACE,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"}
+{"version":3,"file":"senpi-commands.d.ts","sourceRoot":"","sources":["../../src/cli/senpi-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAA;CAAE,GAChF,IAAI,CAgxCN;AAyVD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAWvE;AAmDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CASjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAW3E;AA8HD,kEAAkE;AAClE,UAAU,gBAAgB;IACxB,uGAAuG;IACvG,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAC1C,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,gBAAgB,CAAC;IACpB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtE,MAAM,CACJ,EAAE,EACE,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"}