wicked-crew 0.7.46 → 0.7.48

package/dist/watch/ring.js

@@ -0,0 +1,90 @@
+/**
+ * The push ring (DES-TRIGGER-REGISTRY-001 §4.6): where the daemon fan-in and the watchdog tee drop
+ * their key points. A push is O(1) and never blocks the producer.
+ *
+ * Capacity is shared by three priority classes. On overflow the oldest `p2` item goes first, then
+ * the oldest `p1`. A `p0` item is NEVER shed: when only `p0` items remain the ring grows past its
+ * capacity rather than lose one (`claim-vs-evidence` and `deliver-audit` are `p0`).
+ */
+/** A growable FIFO with an O(1) shift (a head index, compacted now and then). */
+class Fifo {
+    items = [];
+    head = 0;
+    get length() {
+        return this.items.length - this.head;
+    }
+    push(item) {
+        this.items.push(item);
+    }
+    peek() {
+        return this.head < this.items.length ? this.items[this.head] : undefined;
+    }
+    shift() {
+        if (this.head >= this.items.length)
+            return undefined;
+        const item = this.items[this.head];
+        this.items[this.head] = undefined;
+        this.head++;
+        // Compact once the dead prefix is half the array: amortised O(1), bounded memory.
+        if (this.head > 64 && this.head * 2 >= this.items.length) {
+            this.items = this.items.slice(this.head);
+            this.head = 0;
+        }
+        return item;
+    }
+}
+export class PushRing {
+    capacity;
+    classes = {
+        p0: new Fifo(),
+        p1: new Fifo(),
+        p2: new Fifo(),
+    };
+    seq = 0;
+    hwm = 0;
+    shed = { p0: 0, p1: 0, p2: 0 };
+    /** Called once per shed item (the registry raises one `registry-lagging` flag per episode). */
+    onShed;
+    constructor(capacity = 512) {
+        this.capacity = capacity;
+    }
+    get depth() {
+        return this.classes.p0.length + this.classes.p1.length + this.classes.p2.length;
+    }
+    /** O(1); never throws, never blocks. */
+    push(item, priority) {
+        this.classes[priority].push({ seq: this.seq++, item });
+        while (this.depth > this.capacity) {
+            const victim = this.classes.p2.length > 0 ? 'p2' : this.classes.p1.length > 0 ? 'p1' : null;
+            if (victim === null)
+                break; // only p0 left: never shed, grow instead
+            this.classes[victim].shift();
+            this.shed[victim]++;
+            try {
+                this.onShed?.(victim);
+            }
+            catch {
+                /* a reporting hook never breaks the producer's push */
+            }
+        }
+        if (this.depth > this.hwm)
+            this.hwm = this.depth;
+    }
+    /** The oldest item across classes, in arrival order. */
+    shift() {
+        let best = null;
+        let bestSeq = Infinity;
+        for (const p of ['p0', 'p1', 'p2']) {
+            const head = this.classes[p].peek();
+            if (head !== undefined && head.seq < bestSeq) {
+                best = p;
+                bestSeq = head.seq;
+            }
+        }
+        return best === null ? undefined : this.classes[best].shift()?.item;
+    }
+    stats() {
+        return { depth: this.depth, hwm: this.hwm, shed_by_priority: { ...this.shed } };
+    }
+}
+//# sourceMappingURL=ring.js.map

package/dist/watch/ring.js.map

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

package/dist/watch/router.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The router (DES-TRIGGER-REGISTRY-001 §4.6): which enabled entries a key point reaches.
+ *
+ * The type set is precomputed per source, so the 68% of CoreEvents that are `unitOutputDelta` are
+ * rejected by one `Set.has` on the hot path (`wants`). The filter is JSON-path equality, an AND of
+ * keys; an array value means "any of".
+ */
+import type { WatchEntrySource, WatchPriority } from 'wicked-crew-api-types';
+import type { KeyPointInput, LoadedEntry } from './types.js';
+/** True when `event` satisfies every key of `filter` (an array value: any of its members). */
+export declare function matchesFilter(filter: Record<string, unknown>, event: unknown): boolean;
+export declare class Router {
+    private readonly byKey;
+    private readonly priorityByKey;
+    constructor(entries: readonly LoadedEntry[]);
+    /** O(1): the input's priority when some enabled entry listens for it, else `null` (drop it). */
+    wants(source: WatchEntrySource, type: string): WatchPriority | null;
+    /** The enabled entries whose `on` and `filter` the input satisfies. */
+    route(input: KeyPointInput): LoadedEntry[];
+    /** Every bus type an enabled entry listens for (the bus pull reads only these). */
+    busTypes(): string[];
+    /** Enabled entries of one source (coverage, internal ticks). */
+    entriesOf(source: WatchEntrySource): LoadedEntry[];
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/watch/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/watch/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4B7D,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAMtF;AAQD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;gBAEtD,OAAO,EAAE,SAAS,WAAW,EAAE;IAgB3C,gGAAgG;IAChG,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAInE,uEAAuE;IACvE,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,EAAE;IAM1C,mFAAmF;IACnF,QAAQ,IAAI,MAAM,EAAE;IAIpB,gEAAgE;IAChE,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,EAAE;CAKnD"}

package/dist/watch/router.js

@@ -0,0 +1,87 @@
+/**
+ * The router (DES-TRIGGER-REGISTRY-001 §4.6): which enabled entries a key point reaches.
+ *
+ * The type set is precomputed per source, so the 68% of CoreEvents that are `unitOutputDelta` are
+ * rejected by one `Set.has` on the hot path (`wants`). The filter is JSON-path equality, an AND of
+ * keys; an array value means "any of".
+ */
+const RANK = { p0: 0, p1: 1, p2: 2 };
+/** The value at a dotted path (`"a.b"`), or `undefined`. */
+function at(obj, path) {
+    let cur = obj;
+    for (const seg of path.split('.')) {
+        if (cur === null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+/** JSON-value equality: key order does not matter, array order does. */
+function same(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a)) {
+        const bb = b;
+        return a.length === bb.length && a.every((v, i) => same(v, bb[i]));
+    }
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    return ka.length === kb.length && ka.every((k) => Object.hasOwn(b, k) && same(a[k], b[k]));
+}
+/** True when `event` satisfies every key of `filter` (an array value: any of its members). */
+export function matchesFilter(filter, event) {
+    for (const [path, want] of Object.entries(filter)) {
+        const got = at(event, path);
+        if (Array.isArray(want) ? !want.some((w) => same(got, w)) : !same(got, want))
+            return false;
+    }
+    return true;
+}
+export class Router {
+    byKey = new Map();
+    priorityByKey = new Map();
+    constructor(entries) {
+        for (const e of entries) {
+            if (!e.enabled)
+                continue;
+            const points = [{ point: e.on, joined: false }, ...(e.join ?? []).map((point) => ({ point, joined: true }))];
+            for (const { point, joined } of points) {
+                const key = `${point.source}\u0000${point.type}`;
+                const list = this.byKey.get(key) ?? [];
+                if (list.some((r) => r.entry.id === e.id))
+                    continue; // a join naming the trigger's own type
+                list.push({ entry: e, joined });
+                this.byKey.set(key, list);
+                const prev = this.priorityByKey.get(key);
+                if (prev === undefined || RANK[e.priority] < RANK[prev])
+                    this.priorityByKey.set(key, e.priority);
+            }
+        }
+    }
+    /** O(1): the input's priority when some enabled entry listens for it, else `null` (drop it). */
+    wants(source, type) {
+        return this.priorityByKey.get(`${source}\u0000${type}`) ?? null;
+    }
+    /** The enabled entries whose `on` and `filter` the input satisfies. */
+    route(input) {
+        const list = this.byKey.get(`${input.source}\u0000${input.type}`);
+        if (list === undefined)
+            return [];
+        return list.filter((r) => r.joined || matchesFilter(r.entry.filter, input.event)).map((r) => r.entry);
+    }
+    /** Every bus type an enabled entry listens for (the bus pull reads only these). */
+    busTypes() {
+        return [...this.byKey.keys()].filter((k) => k.startsWith('bus\u0000')).map((k) => k.slice(4));
+    }
+    /** Enabled entries of one source (coverage, internal ticks). */
+    entriesOf(source) {
+        return [...this.byKey.entries()]
+            .filter(([k]) => k.startsWith(`${source}\u0000`))
+            .flatMap(([, v]) => v.filter((r) => !r.joined).map((r) => r.entry));
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/watch/router.js.map

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

package/dist/watch/sources.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The registry's pulled sources and its `/ws` relay (DES-TRIGGER-REGISTRY-001 §4.5, §4.6).
+ *
+ * BUS PULL. Bus key points are PULLED through the engine (`tapBus` over `Core.busRead`), never
+ * pushed: the tap awaits each row's handler (route, check, emit) before it reads on, so its
+ * in-memory cursor advances only after the row's outputs were emitted or recorded as failed. When
+ * the lanes are slow the tap simply reads later; the bus is the buffer. Armed only while an enabled
+ * entry listens on the bus (none does in TR-W5a; `plan.accepted` arrives with TR-W7).
+ *
+ * RELAY. Watch rows reach `/ws` as `{type:"watchEvent", event:<bus row>, project_id?}` through a tap
+ * of `wicked.crew.watch_finding.**`, the team relay's pattern (`team/ws-relay.ts`). The registry
+ * never broadcasts directly, so the socket and the record cannot disagree.
+ */
+import type { CoreEvent } from '../core/types.js';
+import type { KeyPointInput } from './types.js';
+export interface BusPull {
+    /** ms between the newest handled row's emit and its handling (0 when caught up). */
+    tailLagMs(): number;
+    stop(): Promise<void>;
+}
+/** Arm the bus pull. `wants(type)` is the router's O(1) type check; `handle` is awaited per row. */
+export declare function startBusPull(opts: {
+    dbPath: string;
+    wants: (type: string) => boolean;
+    handle: (input: KeyPointInput) => Promise<void>;
+    pollIntervalMs?: number;
+    log?: (msg: string) => void;
+}): Promise<BusPull>;
+/** The boot replay's bus half (§4.8 step 2): the wanted rows of the live runs, oldest first. */
+export declare function replayBusRows(dbPath: string, types: readonly string[], liveRuns: ReadonlySet<string>): Promise<KeyPointInput[]>;
+export interface WatchRelay {
+    stop(): Promise<void>;
+}
+/** Arm the `watchEvent` relay; `null` (logged) when no engine holds the bus. */
+export declare function startWatchWsRelay(opts: {
+    dbPath: string;
+    projectOf: (runId: string) => string | undefined;
+    broadcast: (frame: CoreEvent) => void;
+    pollIntervalMs?: number;
+    log?: (msg: string) => void;
+}): Promise<WatchRelay | null>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/watch/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/watch/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,MAAM,WAAW,OAAO;IACtB,oFAAoF;IACpF,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAgBD,oGAAoG;AACpG,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnB;AAED,gGAAgG;AAChG,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAUrI;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,gFAAgF;AAChF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgC7B"}

package/dist/watch/sources.js

@@ -0,0 +1,104 @@
+/**
+ * The registry's pulled sources and its `/ws` relay (DES-TRIGGER-REGISTRY-001 §4.5, §4.6).
+ *
+ * BUS PULL. Bus key points are PULLED through the engine (`tapBus` over `Core.busRead`), never
+ * pushed: the tap awaits each row's handler (route, check, emit) before it reads on, so its
+ * in-memory cursor advances only after the row's outputs were emitted or recorded as failed. When
+ * the lanes are slow the tap simply reads later; the bus is the buffer. Armed only while an enabled
+ * entry listens on the bus (none does in TR-W5a; `plan.accepted` arrives with TR-W7).
+ *
+ * RELAY. Watch rows reach `/ws` as `{type:"watchEvent", event:<bus row>, project_id?}` through a tap
+ * of `wicked.crew.watch_finding.**`, the team relay's pattern (`team/ws-relay.ts`). The registry
+ * never broadcasts directly, so the socket and the record cannot disagree.
+ */
+import { readBus, tapBus } from '../core/bus.js';
+import { WATCH_EVENT_FRAME, WATCH_FINDING_PREFIX } from './events.js';
+/** Every bus row the registry may pull starts with this; the router keeps only the wanted types. */
+const BUS_PULL_FILTER = 'wicked.**';
+function inputOf(row, replay) {
+    const payload = (row.payload ?? {});
+    const runId = typeof payload['run_id'] === 'string' ? payload['run_id'] : null;
+    return {
+        source: 'bus',
+        type: row.event_type,
+        event: row,
+        runId,
+        at: typeof row.emitted_at === 'number' ? row.emitted_at : Date.now(),
+        busKey: row.idempotency_key,
+        ...(replay ? { replay: true } : {}),
+    };
+}
+/** Arm the bus pull. `wants(type)` is the router's O(1) type check; `handle` is awaited per row. */
+export async function startBusPull(opts) {
+    let lag = 0;
+    let lastHandled = Date.now();
+    const tap = await tapBus({
+        dbPath: opts.dbPath,
+        filter: BUS_PULL_FILTER,
+        pollIntervalMs: opts.pollIntervalMs ?? 2_000,
+        handler: async (row) => {
+            if (!opts.wants(row.event_type))
+                return;
+            const now = Date.now();
+            lag = typeof row.emitted_at === 'number' ? Math.max(0, now - row.emitted_at) : 0;
+            lastHandled = now;
+            await opts.handle(inputOf(row, false));
+        },
+        onError: (err) => opts.log?.(`[watch] bus pull read failed (retrying): ${err.message}`),
+    });
+    return {
+        // A pull that has handled nothing for a poll or two is caught up, not "behind".
+        tailLagMs: () => (Date.now() - lastHandled > 5_000 ? 0 : lag),
+        stop: () => tap.stop(),
+    };
+}
+/** The boot replay's bus half (§4.8 step 2): the wanted rows of the live runs, oldest first. */
+export async function replayBusRows(dbPath, types, liveRuns) {
+    const out = [];
+    for (const type of types) {
+        for (const row of await readBus(dbPath, type, { history: true })) {
+            if (row.event_type !== type)
+                continue;
+            const input = inputOf(row, true);
+            if (input.runId !== null && liveRuns.has(input.runId))
+                out.push(input);
+        }
+    }
+    return out.sort((a, b) => a.at - b.at);
+}
+/** Arm the `watchEvent` relay; `null` (logged) when no engine holds the bus. */
+export async function startWatchWsRelay(opts) {
+    let lastError = null;
+    try {
+        return await tapBus({
+            dbPath: opts.dbPath,
+            filter: `${WATCH_FINDING_PREFIX}**`,
+            pollIntervalMs: opts.pollIntervalMs ?? 2_000,
+            handler: (event) => {
+                lastError = null;
+                const payload = event.payload;
+                const runId = payload?.run_id;
+                const projectId = typeof payload?.project_id === 'string'
+                    ? payload.project_id
+                    : typeof runId === 'string'
+                        ? opts.projectOf(runId)
+                        : undefined;
+                opts.broadcast({
+                    type: WATCH_EVENT_FRAME,
+                    event,
+                    ...(projectId !== undefined ? { project_id: projectId } : {}),
+                });
+            },
+            onError: (err) => {
+                if (err.message !== lastError)
+                    opts.log?.(`[watch-relay] bus read failed (retrying): ${err.message}`);
+                lastError = err.message;
+            },
+        });
+    }
+    catch (err) {
+        opts.log?.(`[watch-relay] cannot read the bus — /ws carries no watchEvent frames: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=sources.js.map

package/dist/watch/sources.js.map

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

package/dist/watch/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The watch registry's internal shapes (DES-TRIGGER-REGISTRY-001 §4.2, §4.4). The wire shapes are
+ * api-types' (`WatchFinding`, `WatchEntry`, …); these are what the runtime passes between its parts.
+ */
+import type { ZodType } from 'zod';
+import type { WatchCoverage, WatchEmitAs, WatchEntrySource, WatchEvidenceRef, WatchKind, WatchPriority, WatchSeverity } from 'wicked-crew-api-types';
+/** One registry entry as loaded from `watch/entries/<id>.json` (before the operator's overrides). */
+export interface LoadedEntry {
+    id: string;
+    version: number;
+    on: {
+        source: WatchEntrySource;
+        type: string;
+    };
+    /**
+     * TR-W5b: the key points the check JOINS to its trigger (DES §4.3 rows 1, 3, 5 — "joined to the
+     * same unit's …"). Routed to the check unfiltered so it can fold them; only `on` triggers a row.
+     * Absent = none.
+     */
+    join?: Array<{
+        source: Exclude<WatchEntrySource, 'internal'>;
+        type: string;
+    }>;
+    filter: Record<string, unknown>;
+    check: string;
+    params: Record<string, unknown>;
+    threshold: Record<string, unknown>;
+    emit: {
+        as: WatchEmitAs;
+        severity: WatchSeverity;
+        watch_kind: WatchKind;
+        attach: 'gate' | null;
+        rate: {
+            per_run: number;
+        };
+    };
+    priority: WatchPriority;
+    enabled: boolean;
+}
+/** One key point, as a source hands it to the router. */
+export interface KeyPointInput {
+    source: WatchEntrySource;
+    /** The CoreEvent `type`, the bus `event_type`, the watchdog frame `type`, or the internal tick name. */
+    type: string;
+    /** The event itself (a CoreEvent, a bus row, a watchdog frame, an internal tick). */
+    event: Record<string, unknown>;
+    /** The run it belongs to, `null` for run-less inputs. */
+    runId: string | null;
+    /** Unix millis of the source event (the anchor's `at`). */
+    at: number;
+    /** For a bus input: the source row's idempotency key (its `subject`). */
+    busKey?: string;
+    /** Set while the boot replay re-reads a live run's persisted events. */
+    replay?: boolean;
+}
+/** Per-run state a check may fold into and read back. One bag per (run, entry). */
+export interface RunWatchState {
+    runId: string | null;
+    /** Event types this run has shown the registry, for coverage ("the engine is too old" and the like). */
+    seen: Set<string>;
+    bag: Map<string, unknown>;
+}
+/** The registry's own numbers, for the internal checks (`registry-lagging`). */
+export interface RegistryStats {
+    queueDepth: number;
+    queueHwm: number;
+    shedTotal: number;
+    tailLagMs: number;
+}
+/** What a check may know about a steering rule (TR-W6 `warned_rule`): never the whole store. */
+export interface WatchRuleBrief {
+    effect?: string | undefined;
+    severity: string;
+}
+export interface CheckCtx {
+    now(): number;
+    stats(): RegistryStats;
+    /**
+     * TR-W6: the registry's bounded snapshot of the daemon's steering rules by id (refreshed on a
+     * cadence, never per frame). Absent on a registry without a rule source; rejects when the store
+     * cannot be read — a check treats both as "not classifiable", never as "no rule fired".
+     */
+    rules?: () => Promise<ReadonlyMap<string, WatchRuleBrief>>;
+}
+/** What a check returns: a row to raise, or a raised row (by subject) that has resolved. */
+export type CheckOutput = {
+    op: 'raise';
+    /** Producer-assigned identity only (§4.5): `ord:attempt:<type>`, a bus key, a path, a rule id. */
+    subject: string;
+    sentence: string;
+    facts?: Record<string, unknown>;
+    ord?: number | null;
+    attempt?: number | null;
+    /** Overrides the entry's severity (a warned rule carries the rule's own). */
+    severity?: WatchSeverity;
+    /**
+     * TR-W5b: overrides the entry's `emit.as` between `finding` and `flag` (one entry, several
+     * arms: deliver-audit's unverified lift is a finding, its skipped lift a flag). Never a
+     * proposal, never anything allow-like.
+     */
+    kind?: 'finding' | 'flag';
+    re: string;
+    evidence?: WatchEvidenceRef[];
+    /**
+     * TR-W6: set only when the row is for an EARLIER key point than the one being evaluated (a
+     * frame a check kept and classified later): that key point's own time and replay provenance,
+     * so the anchor is the source event's and a replayed row over the rate is still dropped.
+     * Absent = the evaluated input's.
+     */
+    at?: number;
+    replay?: boolean;
+} | {
+    op: 'clear';
+    subject: string;
+};
+export interface WatchCheck<P = Record<string, unknown>, T = Record<string, unknown>> {
+    /** `"deterministic:<name>"` (`"llm:<prompt-ref>@<n>"` lands with TR-W9). */
+    name: string;
+    lane: 'deterministic' | 'llm';
+    paramsSchema: ZodType<P>;
+    thresholdSchema: ZodType<T>;
+    /** Pure over (input, the run's folded state); 0..n outputs. A throw is counted by the lane, never escapes. */
+    evaluate(input: KeyPointInput, state: RunWatchState, params: P, threshold: T, ctx: CheckCtx): Promise<CheckOutput[]> | CheckOutput[];
+    /** What this check can see on this run (G7). `null`: the check is run-less and has no run coverage. */
+    coverage(state: RunWatchState): Omit<WatchCoverage, 'entry_id'> | null;
+    /** The threshold in plain words, for "When Studio speaks up". */
+    describe(threshold: T): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/watch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/watch/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,EAAE;QACJ,EAAE,EAAE,WAAW,CAAC;QAChB,QAAQ,EAAE,aAAa,CAAC;QACxB,UAAU,EAAE,SAAS,CAAC;QACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,wGAAwG;IACxG,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,yDAAyD;IACzD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wGAAwG;IACxG,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,IAAI,aAAa,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC5D;AAED,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GACnB;IACE,EAAE,EAAE,OAAO,CAAC;IACZ,kGAAkG;IAClG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACD;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClF,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,GAAG,KAAK,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC;IACrI,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IACvE,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC;CAChC"}

package/dist/watch/types.js

@@ -0,0 +1,6 @@
+/**
+ * The watch registry's internal shapes (DES-TRIGGER-REGISTRY-001 §4.2, §4.4). The wire shapes are
+ * api-types' (`WatchFinding`, `WatchEntry`, …); these are what the runtime passes between its parts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/watch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/watch/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}