patchwork-os 0.2.0-beta.9.canary.92 → 1.1.0-beta.1

package/dist/ta/desk/contract.js

@@ -0,0 +1,261 @@
+/**
+ * contract.ts — assemble the FLAT payload + THREE asserts that ABORT loudly.
+ *
+ *   (a) JSON.stringify(payload).length < 7000
+ *   (b) every numbersIndex token is provenance-backed
+ *   (c) no banned field/token name present
+ *
+ * The code guarantee is the real moat boundary: a faithful LLM narrating a
+ * dishonest JSON would pass a byte-present judge, so the JSON must be honest by
+ * construction. On total feed failure this still produces a fully-degraded
+ * payload (surfaces become 'feed offline' lines; posture forced 'Standing
+ * aside').
+ */
+import { renderAtlas, renderBtcDna, renderDepth, renderFeedHealth, renderLedger, renderLiqGeometry, renderLiqTape, renderMaxPain, renderNav, renderRektShield, renderTodaysRead, } from "./render.js";
+import { computeAtlas, computeBtcDna, computeIchimokuLocation, computeRektShield, computeTodaysRead, depthSurface, liqGeometrySurface, maxPainSurface, stopVsBand, } from "./surfaces.js";
+import { ALLOWED_POSTURES, BANNED_CLAIM_VOCAB, BANNED_TOKENS, narratedNumbers, PAYLOAD_BYTE_BUDGET, SCHEMA_VERSION, } from "./types.js";
+export class ContractError extends Error {
+}
+/** Build the flat payload and run the three asserts before returning it. */
+export function assemblePayload(input) {
+    const { feeds, trade, ledger, tri, nowMs, cachedLedger, verdicts, liqTape } = input;
+    const todaysRead = computeTodaysRead(feeds, tri);
+    const rekt = computeRektShield(trade, nowMs);
+    const dna = computeBtcDna(feeds);
+    const ichi = computeIchimokuLocation(feeds.btc1d.value);
+    const atlas = computeAtlas(feeds.atlas.value);
+    const depth = depthSurface(feeds.depth.value);
+    const maxPain = maxPainSurface(feeds.options.value, nowMs);
+    // Modeled liq geometry — NO new fetch. mid = order-book depth mid; fall back to
+    // the latest BTC 1d close when depth is offline. OI $ = latest perp-OI notional
+    // (reused from the openInterestHist fetch). Pure leverage-bucket arithmetic.
+    const btcCandles = feeds.btc1d.value;
+    const lastClose = btcCandles && btcCandles.length > 0
+        ? btcCandles[btcCandles.length - 1]?.close
+        : null;
+    const geoMid = typeof depth.mid === "number" ? depth.mid : (lastClose ?? null);
+    const liqGeo = liqGeometrySurface(geoMid, feeds.oiNotional.value);
+    const stopBand = stopVsBand(trade, liqGeo);
+    const todaysReadFrag = renderTodaysRead(todaysRead);
+    const rektFrag = renderRektShield(rekt, stopBand);
+    const dnaFrag = renderBtcDna(dna, ichi);
+    const atlasFrag = renderAtlas(atlas);
+    const depthFrag = renderDepth(depth);
+    const maxPainFrag = renderMaxPain(maxPain);
+    const liqGeoFrag = renderLiqGeometry(liqGeo);
+    const ledgerFrag = renderLedger(ledger, cachedLedger ? ledger.asOf : null, verdicts);
+    const liqTapeFrag = liqTape ? renderLiqTape(liqTape) : null;
+    const engineHealthy = feeds.btc1d.state === "live";
+    const navFrag = renderNav(engineHealthy);
+    // asOfData = newest live datum across collectors.
+    const asOfs = [
+        feeds.btc1d.asOf,
+        feeds.btc24hPct.asOf,
+        feeds.funding.asOf,
+        feeds.atlas.asOf,
+        feeds.feargreed.asOf,
+    ].filter((x) => typeof x === "string");
+    const asOfData = asOfs.length > 0
+        ? asOfs.sort().slice(-1)[0]
+        : new Date(nowMs).toISOString();
+    const frags = [
+        todaysReadFrag,
+        rektFrag,
+        dnaFrag,
+        atlasFrag,
+        depthFrag,
+        maxPainFrag,
+        liqGeoFrag,
+        ledgerFrag,
+        navFrag,
+    ];
+    if (liqTapeFrag)
+        frags.push(liqTapeFrag);
+    // numbersIndex — dedup, preserve order, newline-joined. Dates/schemaVersion
+    // are NOT fragment numbers so they never enter here.
+    const seen = new Set();
+    const indexLines = [];
+    for (const frag of frags) {
+        for (const nt of frag.numbers) {
+            if (seen.has(nt.token))
+                continue;
+            seen.add(nt.token);
+            indexLines.push(nt.token);
+        }
+    }
+    const numbersIndex = indexLines.join("\n");
+    const payload = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedAt: new Date(nowMs).toISOString(),
+        asOfData,
+        feedHealthMd: renderFeedHealth(feeds),
+        allowedPostures: ALLOWED_POSTURES.join(" | "),
+        todaysReadMd: todaysReadFrag.md,
+        rektShieldMd: rektFrag.md,
+        btcDnaMd: dnaFrag.md,
+        atlasMd: atlasFrag.md,
+        depthMd: depthFrag.md,
+        maxPainMd: maxPainFrag.md,
+        liqGeoMd: liqGeoFrag.md,
+        ...(liqTapeFrag ? { liqTapeMd: liqTapeFrag.md } : {}),
+        ledgerMd: ledgerFrag.md,
+        navMd: navFrag.md,
+        numbersIndex,
+    };
+    assertContract(payload, frags);
+    return payload;
+}
+/**
+ * The THREE asserts. Throws ContractError (loud abort) on any failure.
+ * Exported so the build-failing unit test can call it directly.
+ */
+export function assertContract(payload, frags) {
+    // (a) byte budget
+    const bytes = Buffer.byteLength(JSON.stringify(payload), "utf-8");
+    if (bytes >= PAYLOAD_BYTE_BUDGET) {
+        throw new ContractError(`payload ${bytes} bytes >= ${PAYLOAD_BYTE_BUDGET} budget — aborting POST`);
+    }
+    // The user-facing markdown surfaces — every banned claim word in these must
+    // co-locate a closed/location label (check c).
+    const surfaceFields = [
+        payload.feedHealthMd,
+        payload.allowedPostures,
+        payload.todaysReadMd,
+        payload.rektShieldMd,
+        payload.btcDnaMd,
+        payload.atlasMd,
+        payload.depthMd,
+        payload.maxPainMd,
+        payload.liqGeoMd,
+        payload.ledgerMd,
+        payload.navMd,
+    ];
+    // The NARRATIVE FACT surfaces — the subset whose printed numbers are claims of
+    // fact the engine fully controls, so each MUST trace to numbersIndex (b2).
+    // EXCLUDED:
+    //   - feedHealthMd / allowedPostures: digits are structural identifiers
+    //     (feed names like "binance24h", posture vocab like "Watching X").
+    //   - atlasMd: its only numeric CLAIMS are the per-sector change24hPct values,
+    //     already provenance-backed by check (b); its sector NAMES come verbatim
+    //     from the live CoinGecko feed ("Layer 1", "Web3") and carry unpredictable
+    //     identifier digits the engine cannot pre-register. narratedNumbers()
+    //     strips glued identifiers (L1/Web3) but a SPACE-separated name ("Layer 1")
+    //     still yields a bare digit — not a claim, so atlas is guard-exempt.
+    const factSurfaces = [
+        payload.todaysReadMd,
+        payload.rektShieldMd,
+        payload.btcDnaMd,
+        payload.depthMd,
+        payload.maxPainMd,
+        payload.liqGeoMd,
+        payload.ledgerMd,
+        payload.navMd,
+        ...(payload.liqTapeMd ? [payload.liqTapeMd] : []),
+    ];
+    // (b) every numbersIndex token is provenance-backed (index → provenance)
+    const backed = new Set();
+    for (const frag of frags) {
+        for (const nt of frag.numbers) {
+            if (!nt.provenance) {
+                throw new ContractError(`numbersIndex token "${nt.token}" has no provenance`);
+            }
+            backed.add(nt.token);
+        }
+    }
+    for (const token of payload.numbersIndex.split("\n").filter(Boolean)) {
+        if (!backed.has(token)) {
+            throw new ContractError(`numbersIndex token "${token}" is not provenance-backed`);
+        }
+    }
+    // (c) no banned field/token NAME present anywhere in the payload.
+    // Match as a whole identifier token, NOT a substring — otherwise the English
+    // word "graded" (a legitimate ledger state) trips the "grade" ban, and
+    // "upgrade" would too. Banned names are field identifiers; bound them by
+    // non-alphanumeric edges so prose words are not false-positives.
+    const haystack = JSON.stringify(payload);
+    for (const banned of BANNED_TOKENS) {
+        const re = new RegExp(`(^|[^a-zA-Z])${banned}([^a-zA-Z]|$)`, "i");
+        if (re.test(haystack)) {
+            throw new ContractError(`banned token name "${banned}" present in payload`);
+        }
+    }
+    // Falsified claim vocab is allowed ONLY in the audit-view rendering of the
+    // ledger ("ichimoku family ... closed"); banned as a positive lean elsewhere.
+    // We assert the family name never appears OUTSIDE the explicit closed-label
+    // context. Simplest honest rule: the only legal occurrences carry the word
+    // "closed" alongside. Enforce by requiring every occurrence to co-locate.
+    // (surfaceFields declared above — reused here.)
+    for (const vocab of BANNED_CLAIM_VOCAB) {
+        const v = vocab.toLowerCase();
+        if (!haystack.toLowerCase().includes(v))
+            continue;
+        // every surface field mentioning the banned vocab must co-locate an
+        // explicit "closed" or "location" audit label — else it is a live claim.
+        const mentioning = surfaceFields.filter((md) => md.toLowerCase().includes(v));
+        for (const md of mentioning) {
+            const lower = md.toLowerCase();
+            if (!lower.includes("closed") && !lower.includes("location")) {
+                throw new ContractError(`banned claim vocab "${vocab}" present without closed/location label`);
+            }
+        }
+    }
+    // (d) BIDIRECTIONAL number trace — every PRINTED number in the fact surfaces
+    // is in numbersIndex (the complement of check (b), which only verifies the
+    // other direction). Closes the leak class where a surface narrates a number
+    // — e.g. the Deribit DDMMMYY expiry's embedded 27/26 — that was never
+    // registered. narratedNumbers() strips the date/time + identifier exempt
+    // classes first. Runs LAST so the categorical banned-NAME/vocab violations
+    // (b,c) surface ahead of this finer-grained trace check.
+    const indexed = new Set(payload.numbersIndex.split("\n").filter(Boolean));
+    for (const md of factSurfaces) {
+        for (const token of narratedNumbers(md)) {
+            if (!indexed.has(token)) {
+                throw new ContractError(`narrated number "${token}" is not in numbersIndex (printed but un-indexed) — surface: ${md.slice(0, 60)}…`);
+            }
+        }
+    }
+}
+/**
+ * A fully-degraded payload for total feed failure (still POSTed). Routed
+ * through assertContract so the static prose can never silently drift to
+ * narrate a number outside its index or a banned name — the provenance
+ * round-trip holds on the exact path (total feed failure) where it matters most.
+ */
+export function degradedPayload(nowMs) {
+    const payload = buildDegradedPayload(nowMs);
+    // The degraded numbersIndex tokens, each provenance-backed by construction.
+    const frags = [
+        {
+            md: "degraded",
+            numbers: payload.numbersIndex
+                .split("\n")
+                .filter(Boolean)
+                .map((token) => ({
+                token,
+                provenance: token === "-0.53" ? "matured-ledger" : "det",
+            })),
+        },
+    ];
+    assertContract(payload, frags);
+    return payload;
+}
+function buildDegradedPayload(nowMs) {
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        generatedAt: new Date(nowMs).toISOString(),
+        asOfData: new Date(nowMs).toISOString(),
+        feedHealthMd: "binanceSpot: offline · binance24h: offline · binanceFutures: offline · coingecko: offline · feargreed: offline · orderbookDepth: offline · deribitOptions: offline · liqMap: offline-paid · etfFlows: offline-paid · whale: offline-paid · bybitCrossVenue: offline-deferred",
+        allowedPostures: ALLOWED_POSTURES.join(" | "),
+        todaysReadMd: "**Desk posture: Standing aside.** Reason: all market feeds offline — no read. Tri-count — risk 0 / watch 0 / confirm 0 (no live ledger files reachable). Breadth — feed offline.",
+        rektShieldMd: "No hypothetical trade supplied — Rekt Shield idle. (Risk math is feed-independent; it activates only on a supplied trade.)",
+        btcDnaMd: "Trend: feed offline. Funding-stress: feed offline. Spot-confirm: feed offline. Leverage: feed offline. Whale: pending — feed offline. Liquidity-trap: pending — liq-map paid. ETF: pending — paid. Location (no edge): Ichimoku location unavailable. Ichimoku family closed 2026-06-11 — location context, not a signal. Coverage: 0 of 7 strands live, 7 pending/offline.",
+        atlasMd: "Atlas offline — sector feed unavailable.",
+        depthMd: "Order book: feed offline.",
+        maxPainMd: "Deribit options: feed offline.",
+        liqGeoMd: "Liq geometry: feed offline — mid or OI unavailable.",
+        ledgerMd: "LEDGER (history, not a forward probability). No fresh ledger summary reachable. FALSIFIED/BANNED (audit): wp-level-fifty @4h edge -0.53 — falsified. ichimoku-family @1d — closed 2026-06-11. Live signal audit: 0 open claims, 0 graded.",
+        navMd: "Read Market → Find Setups → Confirm → Assess/Protect Risk → Review proof. Terminal: Stand Aside. Engine: waiting — awaiting cron data.",
+        numbersIndex: ["0", "7", "-0.53"].join("\n"),
+    };
+}
+//# sourceMappingURL=contract.js.map

package/dist/ta/desk/contract.js.map

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

package/dist/ta/desk/deskLedger.d.ts

@@ -0,0 +1,36 @@
+/**
+ * deskLedger.ts — the moat-native ledger spine, on a SEPARATE file.
+ *
+ *   ~/.patchwork/qumo-ledger.jsonl   (NEVER the shared ta-ledger.jsonl —
+ *   ta.score parses ALL rows asset-filtered-only, so QUMO types there would
+ *   pollute the local scorer.)
+ *
+ * Daily reads the matured summary (cheap). Nightly --backtest reruns cells +
+ * dartboard + kill-gate and rewrites the summary. Emits ONLY the genuine
+ * ScoreSummary {matured,scorable,holds,holdRate,baselineRate,edge} + altsetup
+ * kill-gate state (N/40 + permutation p). Only-positive cells are PAIRED with a
+ * falsified/banned audit view (price-fifty −0.53, ichimoku) shown by name.
+ * NO totalR / avgR / grade.
+ */
+import { LEDGER_BASELINE } from "../ledger.js";
+import type { Candle } from "../types.js";
+import type { LedgerCell } from "./types.js";
+export declare const QUMO_LEDGER: string;
+export declare const QUMO_SUMMARY: string;
+/** The static falsified/banned audit rows — visible by name, never hidden. */
+export declare const FALSIFIED_AUDIT: LedgerCell[];
+export interface LedgerSummary {
+    asOf: string;
+    cells: LedgerCell[];
+    openClaims: number;
+    gradedClaims: number;
+}
+/** Read the cached daily summary. Returns a degraded shell if missing. */
+export declare function readLedgerSummary(): LedgerSummary;
+/**
+ * Run the nightly backtest: score level-cells via scoreLedger, setup arms via
+ * the paired-dartboard kill-gate, write the summary. `candlesByAsset` supplies
+ * the OHLCV the rows need; an empty map → cells stay WATCH/empty (honest).
+ */
+export declare function runBacktest(candlesByAsset: Map<string, Candle[]>, nowMs: number): LedgerSummary;
+export { LEDGER_BASELINE };

package/dist/ta/desk/deskLedger.js

@@ -0,0 +1,239 @@
+/**
+ * deskLedger.ts — the moat-native ledger spine, on a SEPARATE file.
+ *
+ *   ~/.patchwork/qumo-ledger.jsonl   (NEVER the shared ta-ledger.jsonl —
+ *   ta.score parses ALL rows asset-filtered-only, so QUMO types there would
+ *   pollute the local scorer.)
+ *
+ * Daily reads the matured summary (cheap). Nightly --backtest reruns cells +
+ * dartboard + kill-gate and rewrites the summary. Emits ONLY the genuine
+ * ScoreSummary {matured,scorable,holds,holdRate,baselineRate,edge} + altsetup
+ * kill-gate state (N/40 + permutation p). Only-positive cells are PAIRED with a
+ * falsified/banned audit view (price-fifty −0.53, ichimoku) shown by name.
+ * NO totalR / avgR / grade.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { mulberry32 } from "../backtest/scoring.js";
+import { LEDGER_BASELINE, parseLedger, scoreLedger } from "../ledger.js";
+const PATCHWORK = path.join(homedir(), ".patchwork");
+export const QUMO_LEDGER = path.join(PATCHWORK, "qumo-ledger.jsonl");
+export const QUMO_SUMMARY = path.join(PATCHWORK, "qumo-ledger-summary.json");
+/** Setup-cell arms we track (paired against a dartboard arm). */
+const SETUP_ARMS = ["kodama"];
+const GATE = 40;
+/** The static falsified/banned audit rows — visible by name, never hidden. */
+export const FALSIFIED_AUDIT = [
+    {
+        type: "wp-level-fifty",
+        timeframe: "4h",
+        status: "FALSIFIED",
+        edge: -0.53,
+        note: "falsified — banned even as reference (mirrors closed price-fifty @4h)",
+    },
+    {
+        type: "ichimoku-family",
+        timeframe: "1d",
+        status: "BANNED",
+        note: "closed 2026-06-11 — banned even as reference",
+    },
+];
+/** Read the cached daily summary. Returns a degraded shell if missing. */
+export function readLedgerSummary() {
+    try {
+        if (existsSync(QUMO_SUMMARY)) {
+            const j = JSON.parse(readFileSync(QUMO_SUMMARY, "utf-8"));
+            if (j && Array.isArray(j.cells))
+                return j;
+        }
+    }
+    catch {
+        // fall through to degraded shell
+    }
+    return {
+        asOf: new Date().toISOString(),
+        cells: [...FALSIFIED_AUDIT],
+        openClaims: 0,
+        gradedClaims: 0,
+    };
+}
+/** Race a setup card to win/loss/push/unscorable (altsetup-killgate pattern). */
+function raceCard(r, candles) {
+    if (!(r.rRef && r.rRef > 0) ||
+        !(r.lastClose && r.lastClose > 0) ||
+        r.invalidation === undefined) {
+        return "unscorable";
+    }
+    const start = Date.parse(r.madeAt);
+    const end = Date.parse(r.outcomeWindowEndsAt);
+    const window = candles.filter((c) => c.openTime > start && c.openTime <= end);
+    if (window.length === 0)
+        return "unscorable";
+    const long = r.direction !== "short";
+    for (const c of window) {
+        const loss = long ? c.low <= r.invalidation : c.high >= r.invalidation;
+        const win = long ? c.high >= r.rRef : c.low <= r.rRef;
+        if (loss)
+            return "loss";
+        if (win)
+            return "win";
+    }
+    return "push";
+}
+/**
+ * Run the nightly backtest: score level-cells via scoreLedger, setup arms via
+ * the paired-dartboard kill-gate, write the summary. `candlesByAsset` supplies
+ * the OHLCV the rows need; an empty map → cells stay WATCH/empty (honest).
+ */
+export function runBacktest(candlesByAsset, nowMs) {
+    const cells = [];
+    let openClaims = 0;
+    let gradedClaims = 0;
+    let rows = [];
+    if (existsSync(QUMO_LEDGER)) {
+        try {
+            rows = parseLedger(readFileSync(QUMO_LEDGER, "utf-8"));
+        }
+        catch {
+            rows = [];
+        }
+    }
+    // 1) Level-cells via scoreLedger (price-only, backtestable immediately).
+    const btc = candlesByAsset.get("BTCUSDT") ?? [];
+    if (btc.length > 0 && rows.length > 0) {
+        const levelRows = rows.filter((r) => r.kind !== "card");
+        const summaries = scoreLedger(levelRows, btc, nowMs);
+        for (const s of summaries) {
+            if (s.scorable < 30 || s.matured < 10) {
+                cells.push({
+                    type: s.type,
+                    timeframe: s.timeframe,
+                    status: "WATCH",
+                    matured: s.matured,
+                    scorable: s.scorable,
+                    decided: s.scorable,
+                    gate: GATE,
+                });
+            }
+            else {
+                // No statistical test on this path — positive edge alone cannot earn GRADED.
+                // FALSIFIED is valid (enough data, edge ≤ 0); GRADED requires the kill-gate in section 2.
+                const status = s.edge > 0 ? "WATCH" : "FALSIFIED";
+                cells.push({
+                    type: s.type,
+                    timeframe: s.timeframe,
+                    status,
+                    matured: s.matured,
+                    scorable: s.scorable,
+                    holds: s.holds,
+                    holdRate: Number(s.holdRate.toFixed(2)),
+                    baselineRate: s.baselineRate,
+                    edge: Number(s.edge.toFixed(2)),
+                });
+                if (status === "GRADED")
+                    gradedClaims++;
+            }
+        }
+    }
+    // 2) Setup arms via paired-dartboard kill-gate (altsetup-killgate pattern).
+    for (const arm of SETUP_ARMS) {
+        const byDate = new Map();
+        const totals = {
+            [arm]: { wins: 0, decided: 0 },
+            dartboard: { wins: 0, decided: 0 },
+        };
+        const cards = rows.filter((r) => r.kind === "card" &&
+            (r.type === arm || r.type === "dartboard") &&
+            nowMs >= Date.parse(r.outcomeWindowEndsAt));
+        for (const r of cards) {
+            const t = totals[r.type];
+            if (!t)
+                continue;
+            const candles = candlesByAsset.get(r.asset) ?? [];
+            const res = raceCard(r, candles);
+            if (res !== "win" && res !== "loss")
+                continue;
+            t.decided++;
+            if (res === "win")
+                t.wins++;
+            const dk = r.madeAt.slice(0, 10);
+            const d = byDate.get(dk) ?? {};
+            const slot = d[r.type] ?? { wins: 0, decided: 0 };
+            slot.decided++;
+            if (res === "win")
+                slot.wins++;
+            d[r.type] = slot;
+            byDate.set(dk, d);
+        }
+        const decided = Math.min(totals[arm]?.decided ?? 0, totals.dartboard?.decided ?? 0);
+        if (decided < GATE) {
+            cells.push({
+                type: arm,
+                timeframe: "1d",
+                status: "WATCH",
+                decided,
+                gate: GATE,
+                note: "accumulating — no test run",
+            });
+        }
+        else {
+            const deltas = [];
+            for (const [, d] of byDate) {
+                const a = d[arm];
+                const b = d.dartboard;
+                if (!a?.decided || !b?.decided)
+                    continue;
+                deltas.push(a.wins / a.decided - b.wins / b.decided);
+            }
+            const meanD = deltas.reduce((x, y) => x + y, 0) / Math.max(1, deltas.length);
+            const rng = mulberry32(777);
+            let ge = 0;
+            for (let i = 0; i < 1000; i++) {
+                let s = 0;
+                for (const dd of deltas)
+                    s += rng() < 0.5 ? -dd : dd;
+                if (s / Math.max(1, deltas.length) >= meanD)
+                    ge++;
+            }
+            const p = (1 + ge) / 1001;
+            const holdRate = (totals[arm]?.wins ?? 0) / (totals[arm]?.decided ?? 1);
+            const baseRate = (totals.dartboard?.wins ?? 0) /
+                Math.max(1, totals.dartboard?.decided ?? 0);
+            const edge = holdRate - baseRate;
+            cells.push({
+                type: arm,
+                timeframe: "1d",
+                status: meanD > 0 && p < 0.05 ? "GRADED" : "FALSIFIED",
+                decided,
+                gate: GATE,
+                holdRate: Number(holdRate.toFixed(2)),
+                baselineRate: Number(baseRate.toFixed(2)),
+                edge: Number(edge.toFixed(2)),
+                permutationP: Number(p.toFixed(3)),
+            });
+            if (meanD > 0 && p < 0.05)
+                gradedClaims++;
+        }
+    }
+    // 3) Live signal audit — count open forward claims.
+    openClaims = rows.filter((r) => nowMs < Date.parse(r.outcomeWindowEndsAt)).length;
+    // 4) ALWAYS append the falsified/banned audit view (survivorship guard).
+    cells.push(...FALSIFIED_AUDIT);
+    const summary = {
+        asOf: new Date(nowMs).toISOString(),
+        cells,
+        openClaims,
+        gradedClaims,
+    };
+    try {
+        mkdirSync(PATCHWORK, { recursive: true });
+        writeFileSync(QUMO_SUMMARY, JSON.stringify(summary, null, 2));
+    }
+    catch {
+        // summary write failure is non-fatal for a --backtest invocation
+    }
+    return summary;
+}
+export { LEDGER_BASELINE };
+//# sourceMappingURL=deskLedger.js.map

package/dist/ta/desk/deskLedger.js.map

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

package/dist/ta/desk/liqTape.d.ts

@@ -0,0 +1,37 @@
+/**
+ * liqTape.ts — read the local liquidation tape JSONL files and produce
+ * a per-asset 24h summary for the desk's liquidations surface.
+ *
+ * Data source: qumo-liq-collector.ts (resident VPS process, writes daily files).
+ * File format: one JSON row per line:
+ *   { ts: number, sym: string, side: "long"|"short", qty: number, price: number, usd: number }
+ *
+ * Called from collectors.ts when QUMO_LIQ_DIR is set and tape files exist.
+ * NEVER throws — returns empty tape on any error.
+ */
+export interface LiqRow {
+    ts: number;
+    sym: string;
+    side: "long" | "short";
+    qty: number;
+    price: number;
+    usd: number;
+}
+export interface LiqTapeSummary {
+    windowHours: number;
+    asOf: number;
+    totalLongUsd: number;
+    totalShortUsd: number;
+    longCount: number;
+    shortCount: number;
+    topSymbols: Array<{
+        sym: string;
+        longUsd: number;
+        shortUsd: number;
+    }>;
+}
+/**
+ * Produce a 24h liquidation summary from the local tape.
+ * Returns null if no tape files exist (collector not yet running).
+ */
+export declare function readLiqTape(nowMs: number, windowHours?: number): LiqTapeSummary | null;