@senpi/runtime 3.0.55 → 3.0.57

package/dist/validate/run.js

@@ -0,0 +1,444 @@
+/**
+ * Running a validation and deciding what it means.
+ *
+ * Deliberately free of any command-line concern: it takes resolved options and returns a result
+ * object. The command layer is a thin translation on either side, so the parts worth testing —
+ * ordering, verdict, exit code, the basis — are testable without spawning anything.
+ */
+import { existsSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { VALIDATE_CODE } from "./codes.js";
+import { checkScanner, resolveRoot } from "./import-stage.js";
+import { judgeTick, runTick } from "./live-stage.js";
+import { recordValidateRun } from "../telemetry/metrics.js";
+import { writeProof } from "./proof.js";
+import { resolveWallet, walletClaim } from "./wallet.js";
+import { collectRecipeFindings } from "./recipe.js";
+import { resolveTarget } from "./target.js";
+import { depthsUpTo, severityOfFindings } from "./types.js";
+/** Applied when a recipe declares no per-tick budget. Never derived from the cadence. */
+const DEFAULT_TICK_BUDGET_SECONDS = 120;
+/** Used only when a bare scanner directory is validated with no recipe to declare an entrypoint. */
+const CONVENTIONAL_ENTRYPOINT = "scan.py";
+/** An address as the chain writes them. Shape only — existence is not this layer's business. */
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+function invocationFailure(finding) {
+    return {
+        verdict: "FAIL",
+        exit_code: 3,
+        target: {},
+        stages_run: [],
+        verdict_basis: {
+            rule: "the request must name something that can be validated",
+            observed: { resolved: false },
+            why_not_pass: finding.what,
+            what_would_change_it: finding.fix,
+        },
+        findings: [finding],
+        proof_eligible: false,
+    };
+}
+/**
+ * What a passing run establishes at each depth, and what it does not.
+ *
+ * Carried on the result so a caller cannot over-claim on the user's behalf. A green result that
+ * silently implies more than it checked is the same failure as a health surface that reports fine
+ * while dead — the thing this whole feature exists to correct.
+ */
+const DEPTH_CLAIMS = {
+    static: {
+        proves: "the recipe is well formed and internally coherent",
+        doesNotProve: ["that the scanner code loads", "that anything executes"],
+    },
+    import: {
+        proves: "the recipe is coherent and every scanner file compiles and imports",
+        doesNotProve: ["that a tick executes", "that emitted signals would be accepted"],
+    },
+    live: {
+        proves: "runnable from cold start — imported, ticked, and emitted intake-valid signals",
+        doesNotProve: [
+            "position-dependent logic, since the account had no open positions",
+            "branches this tick did not take",
+        ],
+    },
+};
+/** The depths that have an implementation. Grows as each layer lands. */
+const IMPLEMENTED = ["static", "import", "live"];
+export function isImplemented(depth) {
+    return IMPLEMENTED.includes(depth);
+}
+/**
+ * Validate, and report what it means.
+ *
+ * Stages short-circuit: a depth that produced an error stops the ones after it, because they would
+ * be reading a shape that was never established.
+ */
+export async function runValidation(options) {
+    const startedAt = Date.now();
+    const result = await runValidationInner(options);
+    // Class and shape only — the attribute builders clamp everything to closed sets, so nothing
+    // from the package (paths, config, addresses, messages) can reach a label.
+    recordValidateRun(result, Date.now() - startedAt);
+    return result;
+}
+async function runValidationInner(options) {
+    if (options.wallet !== undefined && !ADDRESS.test(options.wallet)) {
+        return invocationFailure({
+            code: VALIDATE_CODE.badWallet,
+            severity: "error",
+            stage: "invocation",
+            actor: "agent",
+            fix_kind: "command",
+            what: `'${options.wallet}' is not a well-formed account address`,
+            why: "The address is passed to the exchange reads a scanner makes, which will not accept it.",
+            fix: "Pass a 42-character hex address beginning 0x, or omit --wallet to validate against an empty account.",
+            evidence: { supplied: options.wallet },
+        });
+    }
+    const resolution = options.content !== undefined
+        ? resolveTarget({ kind: "content", content: options.content, dir: options.dir, cwd: options.cwd }, options.depth)
+        : resolveTarget({ kind: "path", path: options.target, cwd: options.cwd }, options.depth);
+    if (!resolution.ok)
+        return invocationFailure(resolution.finding);
+    const target = resolution.target;
+    const requested = depthsUpTo(options.depth);
+    const stagesRun = [];
+    const findings = [];
+    // Carried between depths so the import stage knows which scanners the recipe declared, rather
+    // than reading and parsing it a second time.
+    let config;
+    let wallet;
+    let liveExecuted;
+    let observations = [];
+    for (const depth of requested) {
+        if (!isImplemented(depth))
+            break;
+        const produced = await runDepth(depth, target, options, config, findings);
+        if (produced.config !== undefined)
+            config = produced.config;
+        if (produced.wallet !== undefined)
+            wallet = produced.wallet;
+        if (produced.liveExecuted !== undefined)
+            liveExecuted = produced.liveExecuted;
+        if (produced.observations !== undefined)
+            observations = produced.observations;
+        stagesRun.push(depth);
+        findings.push(...produced.findings);
+        // A depth that failed invalidates everything after it: the next reads a shape this one could
+        // not establish.
+        if (produced.findings.some((f) => f.severity === "error"))
+            break;
+    }
+    const result = assemble(target, stagesRun, findings, options, wallet, liveExecuted);
+    // The record is the pass made durable — it is what the deploy gate reads. Written after the
+    // verdict so a write failure can never flip a pass: the package is no less runnable because a
+    // disk was full, but whoever operates the environment needs to hear about it.
+    if (result.proof_eligible && target.recipePath !== undefined) {
+        const scannerRoots = scannersToCheck(target, config, undefined).targets.map((t) => relative(dirname(target.recipePath), t.root));
+        const written = writeProof({
+            recipePath: target.recipePath,
+            scannerRoots,
+            wallet,
+            observations,
+        });
+        result.proof_recorded = written.recorded;
+        if (written.finding)
+            result.findings.push(written.finding);
+    }
+    return result;
+}
+/**
+ * The scanners the import depth should check.
+ *
+ * From the recipe when there is one, so the declared entrypoint is honoured; from the target itself
+ * when validating a bare directory or file, which is the mid-authoring case where the recipe does
+ * not exist yet.
+ */
+function scannersToCheck(target, config, only) {
+    if (config === undefined) {
+        if (target.scannerRoot === undefined)
+            return { targets: [], findings: [] };
+        // With no recipe there is no declared entrypoint, so fall back to the conventional name when
+        // it is there. This is the only place a filename is assumed, and it is a fallback rather than a
+        // rule: without it the contract checks simply do not run, and the compile and shape checks
+        // still do — which is worth having on its own while a recipe is being written.
+        const entrypoint = target.entrypoint ??
+            (existsSync(resolve(target.scannerRoot, CONVENTIONAL_ENTRYPOINT))
+                ? CONVENTIONAL_ENTRYPOINT
+                : undefined);
+        return {
+            targets: [{ name: "scanner", root: target.scannerRoot, entrypoint }],
+            findings: [],
+        };
+    }
+    const targets = [];
+    const findings = [];
+    for (const scanner of config.scanners ?? []) {
+        if (scanner.type !== "external_scanner")
+            continue;
+        if (only !== undefined && scanner.name !== only)
+            continue;
+        const declared = scanner.path;
+        const entrypoint = scanner.entrypoint;
+        if (declared === undefined || entrypoint === undefined)
+            continue;
+        const root = resolveRoot(declared, target.baseDir);
+        // An unresolvable path is already reported by the recipe checks; skipping here avoids saying
+        // the same thing twice in different words.
+        if (root === undefined)
+            continue;
+        targets.push({ name: scanner.name, root, entrypoint });
+    }
+    return { targets, findings };
+}
+async function runDepth(depth, target, options, config, 
+/** What the depths before this one found. Read, never appended to. */
+prior) {
+    if (depth === "import") {
+        const { targets, findings } = scannersToCheck(target, config, options.scanner);
+        // Sequentially: each check spawns an interpreter, and running them in order keeps output
+        // deterministic for a cost that is irrelevant at this scale.
+        for (const scanner of targets) {
+            findings.push(...(await checkScanner(scanner)));
+        }
+        return { findings };
+    }
+    if (depth === "live") {
+        const { targets } = scannersToCheck(target, config, options.scanner);
+        if (targets.length === 0) {
+            return {
+                findings: [
+                    {
+                        code: VALIDATE_CODE.noExternalScanners,
+                        severity: "warning",
+                        stage: "live",
+                        actor: "agent",
+                        fix_kind: "locate-only",
+                        what: "This recipe declares no author-written scanner",
+                        why: "Built-in scanners are part of the runtime and are covered by its own tests, so there is no author code here whose runnability is in question.",
+                        fix: "Nothing to do — a recipe using only built-in scanners has nothing for this depth to execute.",
+                    },
+                ],
+                liveExecuted: 0,
+            };
+        }
+        const wallet = resolveWallet({
+            explicit: options.wallet,
+            fromRecipe: config?.strategy?.wallet,
+            fromEnvironment: process.env.SENPI_VALIDATE_WALLET,
+        });
+        // Asked once, before anything is spawned. A package with thirty scanners would otherwise start
+        // thirty processes to learn the same thing thirty times and report it thirty times over.
+        const missing = missingCredentials();
+        if (missing.length > 0) {
+            return {
+                findings: [
+                    {
+                        code: VALIDATE_CODE.noCredentials,
+                        severity: "error",
+                        stage: "live",
+                        actor: "ops",
+                        fix_kind: "command",
+                        what: `This environment has no data-client credentials: ${missing.join(" and ")} ${missing.length === 1 ? "is" : "are"} not set`,
+                        why: "A live run reads real market data. Without credentials no scanner can be executed, so nothing about this strategy can be established.",
+                        fix: `Set ${missing.join(" and ")} in this environment, or run --stage import to check the code without executing it.`,
+                        evidence: { missing },
+                    },
+                ],
+                wallet,
+            };
+        }
+        // A warning from the import depth that changes how a zero-read tick should be read: the
+        // scanner may have fetched plenty, just not by a route anything here can see.
+        const nonMcpSources = prior
+            .filter((f) => f.code === VALIDATE_CODE.nonMcpSource && f.where !== undefined)
+            .map((f) => f.where);
+        const findings = [];
+        const observations = [];
+        for (const scanner of targets) {
+            const declared = (config?.scanners ?? []).find((s) => s.name === scanner.name);
+            const outcome = await runTick({
+                scanner,
+                wallet,
+                timeoutSeconds: tickBudgetSeconds(declared, options.timeoutSeconds),
+                intervalSeconds: declared?.interval_seconds ?? 60,
+                defaultSignalValiditySeconds: declared?.default_signal_validity_seconds ?? 600,
+                inputs: declared?.inputs,
+                signalDataSchema: declared?.signal_data_schema,
+                stateHistoryMaxCount: declared?.state_history_max_count,
+            });
+            findings.push(...judgeTick(scanner, outcome, { nonMcpSources }));
+            observations.push({
+                scanner: scanner.name,
+                reads_ok: outcome.reads_ok ?? 0,
+                reads_failed: outcome.reads_failed ?? 0,
+                signals_emitted: outcome.signals?.length ?? 0,
+            });
+        }
+        return { findings, wallet, liveExecuted: targets.length, observations };
+    }
+    if (depth !== "static")
+        return { findings: [] };
+    if (target.recipePath === undefined && target.recipeContent === undefined) {
+        // A code-only target has no recipe to check; the depth is a no-op rather than a failure.
+        return { findings: [] };
+    }
+    const result = await collectRecipeFindings({
+        path: target.recipePath,
+        content: target.recipeContent,
+        baseDir: target.baseDir,
+    });
+    const findings = [...result.findings];
+    // `--scanner` can only be checked once the recipe names its scanners.
+    if (options.scanner !== undefined && result.config !== undefined) {
+        const declared = (result.config.scanners ?? []).map((s) => s.name);
+        if (!declared.includes(options.scanner)) {
+            findings.push({
+                code: VALIDATE_CODE.unknownScanner,
+                severity: "error",
+                stage: "invocation",
+                actor: "agent",
+                fix_kind: "choice",
+                what: `This recipe declares no scanner named '${options.scanner}'`,
+                why: "Nothing would be checked, so the run would report a pass having examined nothing.",
+                fix: declared.length > 0
+                    ? `Pick one of the scanners it does declare:\n${declared.map((n) => `  --scanner ${n}`).join("\n")}`
+                    : "This recipe declares no scanners at all, so drop --scanner.",
+                evidence: { requested: options.scanner, declared },
+            });
+        }
+    }
+    return { findings, config: result.config };
+}
+/**
+ * The verdict, from the findings alone.
+ *
+ * Three outcomes rather than two. A run that executed cleanly and established nothing is neither a
+ * pass nor a failure: called a failure it sends someone hunting a defect that may not exist, called
+ * a pass it is precisely the hole this command exists to close. It gets its own verdict and its own
+ * exit code so a caller can tell the difference without parsing anything.
+ *
+ * Pure, and exported, because this is the rule the whole command reduces to.
+ */
+export function decideVerdict(findings, options = {}) {
+    const { errors, warnings } = severityOfFindings(findings);
+    const strict = options.strict === true;
+    const failing = errors > 0 || (strict && warnings > 0);
+    // A malformed request is not a failed package: a different exit code, because the remedy is a
+    // different command rather than an edit. Checked first — nothing downstream of it ran.
+    const invocationError = findings.some((f) => f.stage === "invocation" && f.severity === "error");
+    if (invocationError)
+        return { verdict: "FAIL", exit_code: 3, errors, warnings };
+    // Only the verdict when nothing else is wrong. A genuine error alongside it wins, because there
+    // is something concrete to fix first — and under --strict a warning is a genuine error.
+    const unprovenOnly = errors > 0 &&
+        !(strict && warnings > 0) &&
+        findings
+            .filter((f) => f.severity === "error")
+            .every((f) => f.code === VALIDATE_CODE.tickUnproven);
+    if (unprovenOnly)
+        return { verdict: "UNPROVEN", exit_code: 2, errors, warnings };
+    return failing
+        ? { verdict: "FAIL", exit_code: 1, errors, warnings }
+        : { verdict: "PASS", exit_code: 0, errors, warnings };
+}
+function assemble(target, stagesRun, findings, options, wallet, liveExecuted) {
+    const strict = options.strict === true;
+    const { verdict, exit_code, errors, warnings } = decideVerdict(findings, { strict });
+    const deepest = stagesRun[stagesRun.length - 1];
+    // At the live depth what a pass establishes depends on what actually ran. A recipe with no
+    // author-written scanner reaches this depth and executes nothing — claiming it "ticked and
+    // emitted" would be a green result asserting things it never checked, which is the precise
+    // failure this command exists to correct. The claim states the absence instead.
+    const claims = deepest === "live" && liveExecuted === 0
+        ? {
+            proves: "the recipe is well formed and every scanner it declares is runtime-provided — there is no author-written code in this package to execute",
+            doesNotProve: [
+                "anything about author code, since none exists here",
+                "runtime-provided scanners, which are covered by the runtime's own tests rather than by this run",
+            ],
+        }
+        : deepest === "live" && wallet !== undefined
+            ? walletClaim(wallet)
+            : deepest
+                ? DEPTH_CLAIMS[deepest]
+                : undefined;
+    const basis = {
+        rule: strict
+            ? "a pass requires no findings of any severity"
+            : "a pass requires no error-severity findings",
+        observed: {
+            errors,
+            warnings,
+            stages_run: stagesRun,
+            strict,
+            ...(wallet ? { wallet: wallet.address, wallet_source: wallet.source, book: wallet.book } : {}),
+        },
+        ...(verdict === "PASS" && claims
+            ? { proves: claims.proves, does_not_prove: claims.doesNotProve }
+            : {}),
+        ...(verdict === "UNPROVEN"
+            ? {
+                why_not_pass: "the tick completed but read no data, so nothing about the scanner was established",
+                what_would_change_it: "one successful read through ctx.senpi_mcp during the tick",
+            }
+            : verdict !== "PASS"
+                ? {
+                    why_not_pass: `${errors} error${errors === 1 ? "" : "s"}${strict && warnings > 0 ? ` and ${warnings} warning${warnings === 1 ? "" : "s"} under --strict` : ""}`,
+                    what_would_change_it: "Apply the fix on each finding below and run again.",
+                }
+                : {}),
+    };
+    // A run proves the whole package only when it went all the way, unscoped, and passed.
+    const proof_eligible = verdict === "PASS" &&
+        options.depth === "live" &&
+        options.scanner === undefined &&
+        options.noAttest !== true &&
+        stagesRun.includes("live") &&
+        // Content mode validates text with no durable home; a proof must live beside the package it
+        // is a claim about, so there is nothing coherent to record.
+        target.recipePath !== undefined;
+    return {
+        verdict,
+        exit_code,
+        target: {
+            kind: target.kind,
+            ...(target.recipePath ? { recipe: target.recipePath } : {}),
+            ...(target.scannerRoot ? { scanner_roots: [target.scannerRoot] } : {}),
+        },
+        stages_run: stagesRun,
+        verdict_basis: basis,
+        findings,
+        proof_eligible,
+    };
+}
+/**
+ * How long one tick may take.
+ *
+ * Never derived from the cadence. A strategy that ticks every six hours is not a strategy whose
+ * tick may take six hours — the cadence is how long the runtime waits between ticks, and inheriting
+ * it would make `senpi validate` hang for a working scanner while looking like it was doing
+ * something. What the recipe declares wins; failing that, a bound that keeps the command
+ * answerable.
+ */
+export function tickBudgetSeconds(declared, override) {
+    return override ?? declared?.timeout_seconds ?? DEFAULT_TICK_BUDGET_SECONDS;
+}
+/**
+ * What the environment is missing before a tick could run at all.
+ *
+ * Named rather than counted: "credentials are missing" leaves someone guessing which, and this is
+ * the one finding whose fix belongs to whoever set the environment up rather than to the author.
+ */
+export function missingCredentials(env = process.env) {
+    const missing = [];
+    // Named as a pair: either satisfies the check, and the agent box's normal credential is
+    // SENPI_AUTH_TOKEN — telling someone to set SENPI_API_KEY when they already have the other one
+    // sends them looking for a second credential that does not exist.
+    if (!env.SENPI_API_KEY && !env.SENPI_AUTH_TOKEN)
+        missing.push("SENPI_AUTH_TOKEN (or SENPI_API_KEY)");
+    if (!env.SENPI_MCP_URL)
+        missing.push("SENPI_MCP_URL");
+    return missing;
+}
+//# sourceMappingURL=run.js.map

package/dist/validate/run.js.map

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

package/dist/validate/signal-stage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Would the signals this tick produced actually be accepted?
+ *
+ * A tick can read successfully, compute correctly, and emit something intake rejects at the wire —
+ * and from the scanner's side that is indistinguishable from success. It returned its candidates
+ * and the loop reported a healthy tick; the 400 happens somewhere else, to someone else. That gap
+ * is the last place a strategy can look runnable while producing nothing.
+ *
+ * ## Judged against intake's own schema
+ *
+ * `SignalsBodySchema` is imported from the route rather than described here, and checked with the
+ * same `Value.Check` the route calls. A second description of the contract would be a second thing
+ * to keep in step, and the failure mode of getting it wrong is the one this feature exists to
+ * prevent: a green result that means less than it claims.
+ *
+ * The whole body is checked, not the signal alone, because the body is what intake receives —
+ * `additionalProperties: false` at that level is part of the contract too.
+ */
+import type { ScannerTarget } from "./import-stage.js";
+import type { Finding } from "./types.js";
+/** One candidate as the harness reports it, before and after the envelope was built. */
+export interface SignalRecord {
+    /** What scan() returned. */
+    emitted: unknown;
+    /** The envelope, or null when the scaffold refused to build one. */
+    wire: unknown;
+    /** Why the scaffold refused, when it did. */
+    rejected_by_scaffold: {
+        reason?: string;
+    }[];
+}
+/**
+ * Judge the signals one tick produced.
+ *
+ * Separate from judging the tick because these are separate claims — a tick can be perfectly
+ * healthy and emit nothing acceptable — and because this needs no harness at all, so the cases that
+ * matter are testable directly.
+ */
+export declare function judgeSignals(scanner: ScannerTarget, signals: SignalRecord[]): Finding[];
+//# sourceMappingURL=signal-stage.d.ts.map

package/dist/validate/signal-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-stage.d.ts","sourceRoot":"","sources":["../../src/validate/signal-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,oBAAoB,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAoDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAsDvF"}

package/dist/validate/signal-stage.js

@@ -0,0 +1,116 @@
+/**
+ * Would the signals this tick produced actually be accepted?
+ *
+ * A tick can read successfully, compute correctly, and emit something intake rejects at the wire —
+ * and from the scanner's side that is indistinguishable from success. It returned its candidates
+ * and the loop reported a healthy tick; the 400 happens somewhere else, to someone else. That gap
+ * is the last place a strategy can look runnable while producing nothing.
+ *
+ * ## Judged against intake's own schema
+ *
+ * `SignalsBodySchema` is imported from the route rather than described here, and checked with the
+ * same `Value.Check` the route calls. A second description of the contract would be a second thing
+ * to keep in step, and the failure mode of getting it wrong is the one this feature exists to
+ * prevent: a green result that means less than it claims.
+ *
+ * The whole body is checked, not the signal alone, because the body is what intake receives —
+ * `additionalProperties: false` at that level is part of the contract too.
+ */
+import { Value } from "@sinclair/typebox/value";
+import { SignalsBodySchema } from "../runtime-api/routes/signals.schema.js";
+import { VALIDATE_CODE } from "./codes.js";
+/**
+ * A percentage below one.
+ *
+ * `marginPct` is a percent of withdrawable, so `0.1` means a tenth of one percent — a position
+ * roughly a thousand times smaller than the `10` the author almost certainly meant. Intake accepts
+ * it, the exchange accepts it, and the strategy trades sizes too small to matter while looking
+ * entirely healthy.
+ */
+const SUSPICIOUS_MARGIN_PCT = 1;
+function signalFinding(code, severity, parts) {
+    return {
+        code,
+        severity,
+        stage: "live",
+        actor: "agent",
+        fix_kind: "edit",
+        ...parts,
+    };
+}
+/** Describe an emitted candidate briefly enough to recognise, without dumping it whole. */
+function identify(record, index) {
+    const emitted = record.emitted;
+    const asset = typeof emitted?.asset === "string" ? emitted.asset : undefined;
+    const direction = typeof emitted?.direction === "string" ? emitted.direction : undefined;
+    if (asset && direction)
+        return `${direction} ${asset}`;
+    if (asset)
+        return asset;
+    return `signal ${index + 1}`;
+}
+/**
+ * What intake would say about this body, in its own words.
+ *
+ * Reported per field: "the body was rejected" is not a fix, and the offending path plus the value
+ * that was there is the difference between an edit and an investigation.
+ */
+function schemaComplaints(body) {
+    return [...Value.Errors(SignalsBodySchema, body)]
+        .slice(0, 10)
+        .map((e) => {
+        const path = e.path === "" ? "the body" : e.path.replace(/^\/signals\/\d+\//, "");
+        return `${path}: ${e.message} (got ${JSON.stringify(e.value)?.slice(0, 80)})`;
+    });
+}
+/**
+ * Judge the signals one tick produced.
+ *
+ * Separate from judging the tick because these are separate claims — a tick can be perfectly
+ * healthy and emit nothing acceptable — and because this needs no harness at all, so the cases that
+ * matter are testable directly.
+ */
+export function judgeSignals(scanner, signals) {
+    const findings = [];
+    for (const [index, record] of signals.entries()) {
+        const label = identify(record, index);
+        // The scaffold refused to build an envelope, so this never reaches the wire at all. In
+        // production the loop logs it and carries on: the scanner reports a healthy tick, and the
+        // candidate simply evaporates.
+        if (record.wire === null || record.wire === undefined) {
+            const reasons = record.rejected_by_scaffold.map((r) => r.reason).filter(Boolean);
+            findings.push(signalFinding(VALIDATE_CODE.signalRejected, "error", {
+                what: `${label} was discarded before it reached the runtime: ${reasons.join("; ") || "the envelope could not be built"}`,
+                why: "The tick still reports success — a candidate the scaffold refuses is dropped quietly, so the scanner looks healthy while producing nothing that can be traded.",
+                fix: `Correct what scan() returns for ${label} so the envelope can be built.`,
+                evidence: { emitted: record.emitted, rejected_by_scaffold: record.rejected_by_scaffold },
+            }));
+            continue;
+        }
+        // The exact body intake receives, checked the way intake checks it.
+        const body = { scanner_id: scanner.name, signals: [record.wire] };
+        if (!Value.Check(SignalsBodySchema, body)) {
+            const complaints = schemaComplaints(body);
+            findings.push(signalFinding(VALIDATE_CODE.signalRejected, "error", {
+                what: `${label} would be rejected by intake: ${complaints[0] ?? "the body does not match the accepted shape"}`,
+                why: "Intake answers 400 and the signal is never processed. The scanner does not see that reply — it returned its candidates and its tick was recorded as healthy — so this is silent from the strategy's side.",
+                fix: complaints.length > 1
+                    ? `Correct each of: ${complaints.join(" · ")}`
+                    : `Correct ${complaints[0] ?? "the emitted shape"}.`,
+                evidence: { wire: record.wire, rejections: complaints },
+            }));
+            continue;
+        }
+        const marginPct = record.wire.marginPct;
+        if (typeof marginPct === "number" && marginPct > 0 && marginPct < SUSPICIOUS_MARGIN_PCT) {
+            findings.push(signalFinding(VALIDATE_CODE.marginPctSuspicious, "warning", {
+                what: `${label} sizes at marginPct ${marginPct}`,
+                why: `This field is a percent of withdrawable, so ${marginPct} means ${marginPct} percent — not ${marginPct * 100}. Nothing rejects it: the position is simply opened about a hundred times smaller than intended, and the strategy trades on happily.`,
+                fix: `If ${marginPct * 100} percent was intended, emit ${marginPct * 100}. If ${marginPct} percent really was, this warning is the only way to say so — it needs no change.`,
+                evidence: { marginPct },
+            }));
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=signal-stage.js.map

package/dist/validate/signal-stage.js.map

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