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

package/dist/ta/backtest/volsq.d.ts

@@ -0,0 +1,34 @@
+/**
+ * volsq-1 — volatility compression → expansion backtest (Phase 1c).
+ *
+ * Frozen by docs/phase1c-precommit.md (refuter-amended: LEVEL metrics only,
+ * the FwdRV/TrailingRV ratio is descriptive because its denominator is the
+ * conditioning variable; expectation registered as likely-null given GARCH
+ * persistence). Two squeeze variants: BBW(20,2) on daily closes and RV from
+ * trailing 120 4h returns.
+ */
+import type { Candle } from "../types.js";
+/** Population std (Pine ta.stdev convention) of the last `n` closes at t. */
+export declare function popStdCloses(candles: Candle[], t: number, n: number): number | null;
+/** BBW(t) = 4·σ20(t)/SMA20(t); null during warm-up. */
+export declare function bbwSeries(candles: Candle[]): (number | null)[];
+/**
+ * RV variant: per DAILY bar t, sample std of the trailing 120 4h log
+ * close-returns among 4h bars with closeTime ≤ closeTime(t), × √(365·6).
+ */
+export declare function rv4hDaily(daily: Candle[], fourH: Candle[]): (number | null)[];
+/** Trailing-252 percentile (linear interp) of series[t] history; ≥200 needed. */
+export declare function trailing252Pctile(series: (number | null)[], t: number, pctile: number): number | null;
+/** Percentile RANK (0-1) of series[c] within its own trailing 252 history. */
+export declare function trailingRank(series: (number | null)[], c: number): number | null;
+/** Squeeze events: measure[t] < trailing P10, 20-bar non-overlap. */
+export declare function detectSqueezes(measure: (number | null)[]): number[];
+/** Forward 20-bar realized vol (sample std of daily log returns) × √365. */
+export declare function fwdRV(daily: Candle[], t: number): number | null;
+/** |20-bar forward log return|. */
+export declare function absRet20(daily: Candle[], t: number): number | null;
+/**
+ * Direction sub-claim (exploratory, expected null): sign of the first daily
+ * close outside the walk-forward SMA20±2σ bands within 20 bars, else 0.
+ */
+export declare function firstBreakoutDir(daily: Candle[], t: number): 1 | -1 | 0;

package/dist/ta/backtest/volsq.js

@@ -0,0 +1,154 @@
+/**
+ * volsq-1 — volatility compression → expansion backtest (Phase 1c).
+ *
+ * Frozen by docs/phase1c-precommit.md (refuter-amended: LEVEL metrics only,
+ * the FwdRV/TrailingRV ratio is descriptive because its denominator is the
+ * conditioning variable; expectation registered as likely-null given GARCH
+ * persistence). Two squeeze variants: BBW(20,2) on daily closes and RV from
+ * trailing 120 4h returns.
+ */
+import { mean, stdDev } from "./tsmom.js";
+/** Population std (Pine ta.stdev convention) of the last `n` closes at t. */
+export function popStdCloses(candles, t, n) {
+    if (t < n - 1)
+        return null;
+    const xs = [];
+    for (let i = t - n + 1; i <= t; i++)
+        xs.push(candles[i].close);
+    const m = mean(xs);
+    return Math.sqrt(xs.reduce((a, b) => a + (b - m) * (b - m), 0) / xs.length);
+}
+/** BBW(t) = 4·σ20(t)/SMA20(t); null during warm-up. */
+export function bbwSeries(candles) {
+    return candles.map((_, t) => {
+        const sd = popStdCloses(candles, t, 20);
+        if (sd === null)
+            return null;
+        let s = 0;
+        for (let i = t - 19; i <= t; i++)
+            s += candles[i].close;
+        const sma = s / 20;
+        return sma !== 0 ? (4 * sd) / sma : null;
+    });
+}
+/**
+ * RV variant: per DAILY bar t, sample std of the trailing 120 4h log
+ * close-returns among 4h bars with closeTime ≤ closeTime(t), × √(365·6).
+ */
+export function rv4hDaily(daily, fourH) {
+    const logr = [];
+    const closeTimes = [];
+    for (let i = 1; i < fourH.length; i++) {
+        logr.push(Math.log(fourH[i].close / fourH[i - 1].close));
+        closeTimes.push(fourH[i].closeTime);
+    }
+    const out = [];
+    let ptr = 0;
+    for (const d of daily) {
+        while (ptr < closeTimes.length && closeTimes[ptr] <= d.closeTime)
+            ptr++;
+        // returns [ptr-120, ptr-1] are the trailing 120 ending at/before d.close
+        if (ptr < 120) {
+            out.push(null);
+            continue;
+        }
+        const window = logr.slice(ptr - 120, ptr);
+        out.push(stdDev(window) * Math.sqrt(365 * 6));
+    }
+    return out;
+}
+/** Trailing-252 percentile (linear interp) of series[t] history; ≥200 needed. */
+export function trailing252Pctile(series, t, pctile) {
+    const from = Math.max(0, t - 252);
+    const vals = [];
+    for (let i = from; i < t; i++) {
+        const v = series[i];
+        if (v !== null && v !== undefined && Number.isFinite(v))
+            vals.push(v);
+    }
+    if (vals.length < 200)
+        return null;
+    vals.sort((a, b) => a - b);
+    const idx = (vals.length - 1) * pctile;
+    const lo = Math.floor(idx);
+    const hi = Math.ceil(idx);
+    return vals[lo] + (vals[hi] - vals[lo]) * (idx - lo);
+}
+/** Percentile RANK (0-1) of series[c] within its own trailing 252 history. */
+export function trailingRank(series, c) {
+    const v = series[c];
+    if (v === null || v === undefined)
+        return null;
+    const from = Math.max(0, c - 252);
+    let cnt = 0;
+    let below = 0;
+    for (let i = from; i < c; i++) {
+        const x = series[i];
+        if (x === null || x === undefined || !Number.isFinite(x))
+            continue;
+        cnt++;
+        if (x < v)
+            below++;
+    }
+    if (cnt < 200)
+        return null;
+    return below / cnt;
+}
+/** Squeeze events: measure[t] < trailing P10, 20-bar non-overlap. */
+export function detectSqueezes(measure) {
+    const out = [];
+    let nextEligible = 0;
+    for (let t = 0; t < measure.length; t++) {
+        if (t < nextEligible)
+            continue;
+        const v = measure[t];
+        if (v === null || v === undefined)
+            continue;
+        const p10 = trailing252Pctile(measure, t, 0.1);
+        if (p10 === null)
+            continue;
+        if (v < p10) {
+            out.push(t);
+            nextEligible = t + 20;
+        }
+    }
+    return out;
+}
+/** Forward 20-bar realized vol (sample std of daily log returns) × √365. */
+export function fwdRV(daily, t) {
+    if (t + 20 >= daily.length)
+        return null;
+    const rs = [];
+    for (let i = t + 1; i <= t + 20; i++) {
+        rs.push(Math.log(daily[i].close / daily[i - 1].close));
+    }
+    return stdDev(rs) * Math.sqrt(365);
+}
+/** |20-bar forward log return|. */
+export function absRet20(daily, t) {
+    if (t + 20 >= daily.length)
+        return null;
+    return Math.abs(Math.log(daily[t + 20].close / daily[t].close));
+}
+/**
+ * Direction sub-claim (exploratory, expected null): sign of the first daily
+ * close outside the walk-forward SMA20±2σ bands within 20 bars, else 0.
+ */
+export function firstBreakoutDir(daily, t) {
+    const end = Math.min(daily.length - 1, t + 20);
+    for (let i = t + 1; i <= end; i++) {
+        const sd = popStdCloses(daily, i, 20);
+        if (sd === null)
+            continue;
+        let s = 0;
+        for (let k = i - 19; k <= i; k++)
+            s += daily[k].close;
+        const sma = s / 20;
+        if (daily[i].close > sma + 2 * sd)
+            return 1;
+        if (daily[i].close < sma - 2 * sd)
+            return -1;
+    }
+    return 0;
+}
+//# sourceMappingURL=volsq.js.map

package/dist/ta/backtest/volsq.js.map

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

package/dist/ta/backtest/walkForward.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Walk-forward backtest loop.
+ *
+ * At each cursor t, only swings confirmed by t (index ≤ t − N) are visible and
+ * outcomes are scored strictly on bars after t — the no-lookahead guarantee.
+ * Detecting all swings once and filtering by index is provably identical to
+ * re-running detection on candles[0..t] (a fractal at i needs only bars i±N,
+ * all ≤ t when i ≤ t − N) and is far cheaper.
+ *
+ * Each distinct setup (a swing range, or a swing+cycle) is emitted ONCE, at the
+ * first cursor it appears, so correlated repeats don't inflate N.
+ */
+import { type Candle, type Timeframe } from "../types.js";
+export type ClaimType = "price-third" | "price-fifty" | "fourth-level-top" | "time-cycle";
+export interface Prediction {
+    asset: string;
+    timeframe: Timeframe;
+    type: ClaimType;
+    n?: number;
+    cursorIndex: number;
+    hit: boolean;
+    baselineHit: boolean;
+}
+export interface WalkForwardOptions {
+    asset: string;
+    timeframe: Timeframe;
+    fractalN?: number;
+    /** Bars to skip at the start (need swing history). */
+    warmup?: number;
+    /** PRNG seed for reproducible random baselines. */
+    seed?: number;
+    /**
+     * Cycle bar-counts projected from reversals (default PIVOT_SEQUENCE — the
+     * ta-cycles-1 set). fibtime-1 passes the Fibonacci set; the paired-baseline
+     * scoring is otherwise identical.
+     */
+    cycleSequence?: readonly number[];
+}
+export declare function runWalkForward(candles: Candle[], opts: WalkForwardOptions): Prediction[];
+/** Unconditional context stats — the "dumb" reference rates. */
+export declare function contextStats(candles: Candle[], fractalN?: number): {
+    reversalBaseRate: number;
+    upRate: number;
+    bars: number;
+};

package/dist/ta/backtest/walkForward.js

@@ -0,0 +1,136 @@
+/**
+ * Walk-forward backtest loop.
+ *
+ * At each cursor t, only swings confirmed by t (index ≤ t − N) are visible and
+ * outcomes are scored strictly on bars after t — the no-lookahead guarantee.
+ * Detecting all swings once and filtering by index is provably identical to
+ * re-running detection on candles[0..t] (a fractal at i needs only bars i±N,
+ * all ≤ t when i ≤ t − N) and is far cheaper.
+ *
+ * Each distinct setup (a swing range, or a swing+cycle) is emitted ONCE, at the
+ * first cursor it appears, so correlated repeats don't inflate N.
+ */
+import { computeLevels } from "../levels.js";
+import { detectSwings, latestReversal, latestSwing } from "../swings.js";
+import { PIVOT_SEQUENCE } from "../types.js";
+import { CYCLE_WINDOW, firstTouchIndex, mulberry32, OUTCOME_WINDOW, priceLevelHit, reversalNear, } from "./scoring.js";
+export function runWalkForward(candles, opts) {
+    const fractalN = opts.fractalN ?? 2;
+    const warmup = opts.warmup ?? 60;
+    const cycleSequence = opts.cycleSequence ?? PIVOT_SEQUENCE;
+    const rng = mulberry32(opts.seed ?? 0x5eed);
+    const preds = [];
+    const emitted = new Set();
+    const allSwings = detectSwings(candles, fractalN);
+    const lastCursor = candles.length - 1 - OUTCOME_WINDOW;
+    for (let t = warmup; t <= lastCursor; t++) {
+        const avail = allSwings.filter((s) => s.index <= t - fractalN);
+        if (avail.length === 0)
+            continue;
+        const hi = latestSwing(avail, "high");
+        const lo = latestSwing(avail, "low");
+        const rev = latestReversal(avail);
+        const from = t + 1;
+        const to = t + OUTCOME_WINDOW;
+        const future = candles.slice(from, to + 1);
+        // ── Price levels (S/R retracements + fourth-level top) ──────────────────
+        if (hi && lo) {
+            const levels = computeLevels(lo.price, hi.price);
+            if (levels) {
+                const rangeKey = `${lo.time}:${hi.time}`;
+                const randLevel = () => lo.price + rng() * levels.range;
+                // R/3 and 2R/3 retracements → price-third
+                for (const k of [1, 2]) {
+                    const key = `third${k}:${rangeKey}`;
+                    if (!emitted.has(key)) {
+                        emitted.add(key);
+                        const level = levels.ladder[k].price;
+                        preds.push({
+                            asset: opts.asset,
+                            timeframe: opts.timeframe,
+                            type: "price-third",
+                            cursorIndex: t,
+                            hit: priceLevelHit(level, future),
+                            baselineHit: priceLevelHit(randLevel(), future),
+                        });
+                    }
+                }
+                // 50% retracement → price-fifty
+                const fiftyKey = `fifty:${rangeKey}`;
+                if (!emitted.has(fiftyKey)) {
+                    emitted.add(fiftyKey);
+                    preds.push({
+                        asset: opts.asset,
+                        timeframe: opts.timeframe,
+                        type: "price-fifty",
+                        cursorIndex: t,
+                        hit: priceLevelHit(levels.fifty, future),
+                        baselineHit: priceLevelHit(randLevel(), future),
+                    });
+                }
+                // Fourth level (high + R/3): a top claim — only resolves if price
+                // reaches it within the window; hit = reversal at the touch.
+                const topKey = `top:${rangeKey}`;
+                if (levels.fourthLevel !== null && !emitted.has(topKey)) {
+                    const touch = firstTouchIndex(levels.fourthLevel, candles, from, to);
+                    if (touch !== -1) {
+                        emitted.add(topKey);
+                        const randIdx = from + Math.floor(rng() * (to - from + 1));
+                        preds.push({
+                            asset: opts.asset,
+                            timeframe: opts.timeframe,
+                            type: "fourth-level-top",
+                            cursorIndex: t,
+                            hit: reversalNear(candles, touch, fractalN),
+                            baselineHit: reversalNear(candles, randIdx, fractalN),
+                        });
+                    }
+                }
+            }
+        }
+        // ── Time cycles from the latest reversal ────────────────────────────────
+        if (rev) {
+            for (const n of cycleSequence) {
+                const target = rev.index + n;
+                if (target <= t || target > to)
+                    continue; // must land in the future window
+                if (target + CYCLE_WINDOW >= candles.length)
+                    continue;
+                const key = `cycle:${rev.time}:${n}`;
+                if (emitted.has(key))
+                    continue;
+                emitted.add(key);
+                const randIdx = from + Math.floor(rng() * (to - from + 1));
+                preds.push({
+                    asset: opts.asset,
+                    timeframe: opts.timeframe,
+                    type: "time-cycle",
+                    n,
+                    cursorIndex: t,
+                    hit: reversalNear(candles, target, fractalN),
+                    baselineHit: reversalNear(candles, randIdx, fractalN),
+                });
+            }
+        }
+    }
+    return preds;
+}
+/** Unconditional context stats — the "dumb" reference rates. */
+export function contextStats(candles, fractalN = 2) {
+    let reversals = 0;
+    let ups = 0;
+    let denom = 0;
+    for (let i = fractalN; i < candles.length - OUTCOME_WINDOW; i++) {
+        if (reversalNear(candles, i, fractalN))
+            reversals++;
+        if (candles[i + OUTCOME_WINDOW].close > candles[i].close)
+            ups++;
+        denom++;
+    }
+    return {
+        reversalBaseRate: denom ? reversals / denom : 0,
+        upRate: denom ? ups / denom : 0,
+        bars: denom,
+    };
+}
+//# sourceMappingURL=walkForward.js.map

package/dist/ta/backtest/walkForward.js.map

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

package/dist/ta/cycles.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Time-cycle pivots — candle-count projection.
+ *
+ * From a confirmed swing extreme (the reversal bar, count 0), pivots project
+ * forward at n ∈ PIVOT_SEQUENCE closed bars: `projectedTime = swing.time +
+ * n · barInterval`. The method claims higher timeframes are more reliable, so
+ * 1d pivots are flagged `moreReliable`.
+ */
+import { type Swing, type Timeframe, type TimePivot } from "./types.js";
+/**
+ * Project all PIVOT_SEQUENCE pivots from a swing on the given timeframe.
+ * Returns every pivot (caller filters for "upcoming" when needed; the backtest
+ * scores all of them).
+ */
+export declare function projectTimePivots(swing: Swing, timeframe: Timeframe): TimePivot[];

package/dist/ta/cycles.js

@@ -0,0 +1,31 @@
+/**
+ * Time-cycle pivots — candle-count projection.
+ *
+ * From a confirmed swing extreme (the reversal bar, count 0), pivots project
+ * forward at n ∈ PIVOT_SEQUENCE closed bars: `projectedTime = swing.time +
+ * n · barInterval`. The method claims higher timeframes are more reliable, so
+ * 1d pivots are flagged `moreReliable`.
+ */
+import { BAR_INTERVAL_MS, PIVOT_SEQUENCE, } from "./types.js";
+/**
+ * Project all PIVOT_SEQUENCE pivots from a swing on the given timeframe.
+ * Returns every pivot (caller filters for "upcoming" when needed; the backtest
+ * scores all of them).
+ */
+export function projectTimePivots(swing, timeframe) {
+    const interval = BAR_INTERVAL_MS[timeframe];
+    const moreReliable = timeframe === "1d";
+    return PIVOT_SEQUENCE.map((n) => {
+        const projectedTime = swing.time + n * interval;
+        return {
+            n,
+            projectedTime,
+            projectedDate: new Date(projectedTime).toISOString(),
+            fromSwingIndex: swing.index,
+            fromSwingKind: swing.kind,
+            fromSwingTime: swing.time,
+            moreReliable,
+        };
+    });
+}
+//# sourceMappingURL=cycles.js.map

package/dist/ta/cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.js","sourceRoot":"","sources":["../../src/ta/cycles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,GAIf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAY,EACZ,SAAoB;IAEpB,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,SAAS,KAAK,IAAI,CAAC;IACxC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;QAChD,OAAO;YACL,CAAC;YACD,aAAa;YACb,aAAa,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE;YACpD,cAAc,EAAE,KAAK,CAAC,KAAK;YAC3B,aAAa,EAAE,KAAK,CAAC,IAAI;YACzB,aAAa,EAAE,KAAK,CAAC,IAAI;YACzB,YAAY;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * accrualEmitter.ts — Phase 0(b) accrual emitter for the QUMO desk.
+ *
+ * Writes dated card/level rows to ~/.patchwork/qumo-ledger.jsonl (NEVER the shared
+ * ta-ledger.jsonl). Called once per daily engine run after feeds are collected.
+ *
+ * Design:
+ *   - A `CellDetector` registry maps cellType → detector function + geometry.
+ *   - On each daily run: for each registered detector, for each asset in its universe,
+ *     run the detector on the latest closed candle. If it fires, append a row.
+ *   - Deduplication: one row per {cellType, asset, candleDay}. Duplicate writes
+ *     for the same day are silently dropped (idempotent).
+ *   - Startup check: if qumo-ledger.jsonl EXISTS (not first run) and a registered
+ *     cell has 0 rows AND the file has at least MIN_EMITTER_RUNS rows from other
+ *     cells, throw — the emitter is wired but not writing for that cell.
+ *
+ * Phase 0 ships with an empty registry (no detectors wired yet). Phase 1 wires
+ * wp-volume-climax. The infrastructure — writer, dedup, startup check — is the
+ * deliverable.
+ */
+import type { Candle } from "../types.js";
+export type DetectResult = false | {
+    direction: "long" | "short";
+    lastClose: number;
+    invalidation: number;
+    rRef: number;
+};
+/**
+ * A cell the emitter tracks.
+ *   detector: given candles[0..n] where candles[n] is the latest CLOSED candle,
+ *             return false or the card geometry.
+ *   outcomeWindowBars: the window in bars for the card's outcome race.
+ *   assets: universe the cell applies to (always-listed subset only).
+ *   timeframe: "1d" etc.
+ */
+export interface CellDetector {
+    cellType: string;
+    timeframe: "1d" | "4h";
+    assets: readonly string[];
+    outcomeWindowBars: number;
+    /** Run at bar-close. candles are chronological; last element is the just-closed bar. */
+    detect: (candles: Candle[]) => DetectResult;
+}
+export declare function registerDetector(d: CellDetector): void;
+/**
+ * Startup self-check. If the ledger is large enough (MIN_EMITTER_RUNS rows) and a
+ * registered detector has zero rows, the emitter is broken — throw.
+ * Call this BEFORE emitting new rows.
+ */
+export declare function startupCheck(): void;
+/**
+ * Emit card rows for today's closed candles.
+ * Called once per daily engine run. Idempotent — duplicate rows for the same day are dropped.
+ *
+ * @param candlesByAsset  Map from symbol → candles (chronological, latest closed).
+ * @param nowMs           Current timestamp (Date.now()).
+ * @returns count of new rows written.
+ */
+export declare function emitTodayCards(candlesByAsset: Map<string, Candle[]>, nowMs: number): number;

package/dist/ta/desk/accrualEmitter.js

@@ -0,0 +1,136 @@
+/**
+ * accrualEmitter.ts — Phase 0(b) accrual emitter for the QUMO desk.
+ *
+ * Writes dated card/level rows to ~/.patchwork/qumo-ledger.jsonl (NEVER the shared
+ * ta-ledger.jsonl). Called once per daily engine run after feeds are collected.
+ *
+ * Design:
+ *   - A `CellDetector` registry maps cellType → detector function + geometry.
+ *   - On each daily run: for each registered detector, for each asset in its universe,
+ *     run the detector on the latest closed candle. If it fires, append a row.
+ *   - Deduplication: one row per {cellType, asset, candleDay}. Duplicate writes
+ *     for the same day are silently dropped (idempotent).
+ *   - Startup check: if qumo-ledger.jsonl EXISTS (not first run) and a registered
+ *     cell has 0 rows AND the file has at least MIN_EMITTER_RUNS rows from other
+ *     cells, throw — the emitter is wired but not writing for that cell.
+ *
+ * Phase 0 ships with an empty registry (no detectors wired yet). Phase 1 wires
+ * wp-volume-climax. The infrastructure — writer, dedup, startup check — is the
+ * deliverable.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { QUMO_LEDGER } from "./deskLedger.js";
+const PATCHWORK = path.join(homedir(), ".patchwork");
+/** Minimum total row count in the ledger before we enforce per-cell emitter checks. */
+const MIN_EMITTER_RUNS = 10;
+/** The registry of registered detectors. Add via registerDetector(). */
+const REGISTRY = [];
+export function registerDetector(d) {
+    if (REGISTRY.some((r) => r.cellType === d.cellType)) {
+        throw new Error(`accrualEmitter: duplicate registration for cellType "${d.cellType}"`);
+    }
+    REGISTRY.push(d);
+}
+function isoDay(ms) {
+    return new Date(ms).toISOString().slice(0, 10);
+}
+/** Read all existing rows from qumo-ledger.jsonl. Returns empty array on missing/corrupt file. */
+function readRows() {
+    if (!existsSync(QUMO_LEDGER))
+        return [];
+    try {
+        return readFileSync(QUMO_LEDGER, "utf-8")
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/** Append a single JSON row to qumo-ledger.jsonl (O_APPEND). */
+function appendRow(row) {
+    mkdirSync(PATCHWORK, { recursive: true });
+    appendFileSync(QUMO_LEDGER, JSON.stringify(row) + "\n", {
+        encoding: "utf-8",
+    });
+}
+/**
+ * Startup self-check. If the ledger is large enough (MIN_EMITTER_RUNS rows) and a
+ * registered detector has zero rows, the emitter is broken — throw.
+ * Call this BEFORE emitting new rows.
+ */
+export function startupCheck() {
+    if (REGISTRY.length === 0)
+        return; // nothing registered — no check needed
+    const rows = readRows();
+    if (rows.length < MIN_EMITTER_RUNS)
+        return; // too early to enforce
+    for (const det of REGISTRY) {
+        const typeRows = rows.filter((r) => r["type"] === det.cellType);
+        if (typeRows.length === 0) {
+            throw new Error(`accrualEmitter startup check FAILED: registered cell "${det.cellType}" has 0 rows ` +
+                `in ${QUMO_LEDGER} but the ledger has ${rows.length} rows (emitter not writing for this cell).`);
+        }
+    }
+}
+/**
+ * Emit card rows for today's closed candles.
+ * Called once per daily engine run. Idempotent — duplicate rows for the same day are dropped.
+ *
+ * @param candlesByAsset  Map from symbol → candles (chronological, latest closed).
+ * @param nowMs           Current timestamp (Date.now()).
+ * @returns count of new rows written.
+ */
+export function emitTodayCards(candlesByAsset, nowMs) {
+    if (REGISTRY.length === 0)
+        return 0;
+    const existingRows = readRows();
+    // Build dedup key set: "cellType:asset:candleDay"
+    const seen = new Set(existingRows
+        .filter((r) => r["type"] && r["asset"] && r["madeAt"])
+        .map((r) => `${r["type"]}:${r["asset"]}:${String(r["madeAt"]).slice(0, 10)}`));
+    let written = 0;
+    for (const det of REGISTRY) {
+        for (const asset of det.assets) {
+            const candles = candlesByAsset.get(asset);
+            if (!candles || candles.length === 0)
+                continue;
+            const result = det.detect(candles);
+            if (!result)
+                continue;
+            const lastCandle = candles[candles.length - 1];
+            const candleDay = isoDay(lastCandle.openTime);
+            const dedupKey = `${det.cellType}:${asset}:${candleDay}`;
+            if (seen.has(dedupKey))
+                continue;
+            // Outcome window ends W bars from the fire candle's close time.
+            // Use closeTime + (W-1)*86400000 for daily bars (rough; exact window is
+            // evaluated by the backtest using candles, not wall-clock).
+            const barMs = det.timeframe === "1d" ? 86_400_000 : 14_400_000;
+            const outcomeWindowEndsAt = new Date(lastCandle.closeTime + (det.outcomeWindowBars - 1) * barMs).toISOString();
+            const row = {
+                id: `${det.cellType}-${asset}-${candleDay}`,
+                kind: "card",
+                type: det.cellType,
+                timeframe: det.timeframe,
+                asset,
+                direction: result.direction,
+                lastClose: result.lastClose,
+                invalidation: result.invalidation,
+                rRef: result.rRef,
+                madeAt: new Date(nowMs).toISOString(),
+                outcomeWindowEndsAt,
+                candleDay,
+                // methodVersion is set at registration time in the CellSpec (Phase 1+)
+            };
+            appendRow(row);
+            seen.add(dedupKey);
+            written++;
+        }
+    }
+    return written;
+}
+//# sourceMappingURL=accrualEmitter.js.map

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

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