wicked-crew 0.7.46 → 0.7.48

package/dist/watch/lanes.js

@@ -0,0 +1,73 @@
+/**
+ * The check lanes (DES-TRIGGER-REGISTRY-001 §4.6).
+ *
+ * DETERMINISTIC. In-process and sequential (the registry drains one input at a time, so a run's
+ * inputs are evaluated in order). Each check has a 5 ms budget: a breach is counted, not cut. A
+ * check that throws or does not settle within its timeout yields NO output (a failed check never
+ * emits "fine") and is reported to the registry, which raises `registry-check-failed` past its
+ * threshold.
+ *
+ * LLM. Not in this slice: the `llm:*` lane, its seat port and `Core.checkOnce` land with TR-W9a/W9.
+ * No shipped check is `lane: "llm"`, and the registry refuses to run one (health `llm.enabled:false`).
+ */
+const TIMED_OUT = Symbol('timed-out');
+export class DeterministicLane {
+    opts;
+    /** The failure report, guarded: a throwing reporter never makes `run` reject. */
+    report(entryId, reason, err) {
+        try {
+            this.opts.onFailure?.(entryId, reason, err);
+        }
+        catch {
+            /* counted above; the report itself is best-effort */
+        }
+    }
+    stats = { runs: 0, budgetBreaches: 0, failures: 0, timeouts: 0 };
+    budgetMs;
+    timeoutMs;
+    clock;
+    constructor(opts = {}) {
+        this.opts = opts;
+        this.budgetMs = opts.budgetMs ?? 5;
+        this.timeoutMs = opts.timeoutMs ?? 1_000;
+        this.clock = opts.clock ?? (() => performance.now());
+    }
+    /** Never throws. */
+    async run(check, entry, input, state, ctx) {
+        if (check.lane !== 'deterministic')
+            return [];
+        this.stats.runs++;
+        const t0 = this.clock();
+        let timer;
+        try {
+            const result = check.evaluate(input, state, entry.params, entry.threshold, ctx);
+            const settled = Array.isArray(result)
+                ? result
+                : await Promise.race([
+                    result,
+                    new Promise((resolve) => {
+                        timer = setTimeout(() => resolve(TIMED_OUT), this.timeoutMs);
+                        timer.unref();
+                    }),
+                ]);
+            if (settled === TIMED_OUT) {
+                this.stats.timeouts++;
+                this.report(entry.id, 'timeout', null);
+                return [];
+            }
+            return Array.isArray(settled) ? settled : [];
+        }
+        catch (err) {
+            this.stats.failures++;
+            this.report(entry.id, 'threw', err);
+            return [];
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            if (this.clock() - t0 > this.budgetMs)
+                this.stats.budgetBreaches++;
+        }
+    }
+}
+//# sourceMappingURL=lanes.js.map

package/dist/watch/lanes.js.map

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

package/dist/watch/loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The entry loader (DES-TRIGGER-REGISTRY-001 §4.2).
+ *
+ * One file per entry, `packages/crew/watch/entries/<id>.json`, versioned with crew. A violating
+ * entry is REFUSED with a reason (listed in `GET /watch/health`) and every other entry still loads:
+ * one bad file cannot turn watching off. Refused when:
+ *   - the JSON does not parse, or its id is not `[a-z0-9-]{3,48}` or differs from the file name;
+ *   - it names a check the check map does not have, or its params / threshold fail the check's schema;
+ *   - `emit.as` is anything but finding | flag | proposal (no allow-like value exists in the schema);
+ *   - a bus source names a type that is not a 4-segment `wicked.<domain>.<noun>.<verb>`.
+ *
+ * The operator may change only `enabled` and `threshold` of a shipped entry (settings `watch.entries`),
+ * applied by {@link applyOverrides}; an override whose threshold fails the check's schema is ignored
+ * and reported, never half-applied.
+ */
+import type { WatchSettings } from 'wicked-crew-api-types';
+import type { LoadedEntry, WatchCheck } from './types.js';
+/** The shipped entries directory: `packages/crew/watch/entries` (same depth from `src/` and `dist/`). */
+export declare const SHIPPED_ENTRIES_DIR: string;
+export interface Refusal {
+    id: string;
+    reason: string;
+}
+export interface LoadResult {
+    entries: LoadedEntry[];
+    refused: Refusal[];
+}
+/** Validate one parsed entry against the schema and the check map. */
+export declare function validateEntry(raw: unknown, fileId: string, checks: ReadonlyMap<string, WatchCheck>): LoadedEntry | Refusal;
+/** Load every `<id>.json` in `dir`. A missing directory loads nothing and says so. */
+export declare function loadEntries(dir: string, checks: ReadonlyMap<string, WatchCheck>): LoadResult;
+/** Why a settings override was not applied (reported in health, never half-applied). */
+export interface OverrideProblem {
+    id: string;
+    reason: string;
+}
+/** The effective entries: the operator's `enabled` / `threshold` overrides on the shipped ones. */
+export declare function applyOverrides(entries: readonly LoadedEntry[], settings: WatchSettings | undefined, checks: ReadonlyMap<string, WatchCheck>): {
+    entries: LoadedEntry[];
+    problems: OverrideProblem[];
+};
+/**
+ * Validate a `PUT /settings` `watch` patch against the loaded entries. Returns the error text for a
+ * 400, or `null`. Only `enabled` and `threshold` of a KNOWN entry, and the boolean `llm`.
+ */
+export declare function validateWatchPatch(patch: unknown, entries: readonly LoadedEntry[], checks: ReadonlyMap<string, WatchCheck>): string | null;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/watch/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,yGAAyG;AACzG,eAAO,MAAM,mBAAmB,QAAiE,CAAC;AAgClG,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAMD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,WAAW,GAAG,OAAO,CAuB1H;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,UAAU,CAuB5F;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GACtC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,CAmBzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GACtC,MAAM,GAAG,IAAI,CA6Bf"}

package/dist/watch/loader.js

@@ -0,0 +1,178 @@
+/**
+ * The entry loader (DES-TRIGGER-REGISTRY-001 §4.2).
+ *
+ * One file per entry, `packages/crew/watch/entries/<id>.json`, versioned with crew. A violating
+ * entry is REFUSED with a reason (listed in `GET /watch/health`) and every other entry still loads:
+ * one bad file cannot turn watching off. Refused when:
+ *   - the JSON does not parse, or its id is not `[a-z0-9-]{3,48}` or differs from the file name;
+ *   - it names a check the check map does not have, or its params / threshold fail the check's schema;
+ *   - `emit.as` is anything but finding | flag | proposal (no allow-like value exists in the schema);
+ *   - a bus source names a type that is not a 4-segment `wicked.<domain>.<noun>.<verb>`.
+ *
+ * The operator may change only `enabled` and `threshold` of a shipped entry (settings `watch.entries`),
+ * applied by {@link applyOverrides}; an override whose threshold fails the check's schema is ignored
+ * and reported, never half-applied.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+/** The shipped entries directory: `packages/crew/watch/entries` (same depth from `src/` and `dist/`). */
+export const SHIPPED_ENTRIES_DIR = fileURLToPath(new URL('../../watch/entries', import.meta.url));
+const ID = /^[a-z0-9-]{3,48}$/;
+const BUS_TYPE = /^wicked\.[a-z0-9_]+\.[a-z0-9_]+\.[a-z0-9_]+$/;
+const EntrySchema = z
+    .object({
+    id: z.string().regex(ID, 'id must be [a-z0-9-]{3,48}'),
+    version: z.number().int().min(1),
+    on: z.object({ source: z.enum(['core', 'bus', 'watchdog', 'internal']), type: z.string().min(1).max(128) }).strict(),
+    join: z
+        .array(z.object({ source: z.enum(['core', 'bus', 'watchdog']), type: z.string().min(1).max(128) }).strict())
+        .max(4)
+        .optional(),
+    filter: z.record(z.unknown()).default({}),
+    check: z.string().min(1),
+    params: z.record(z.unknown()).default({}),
+    threshold: z.record(z.unknown()).default({}),
+    emit: z
+        .object({
+        as: z.enum(['finding', 'flag', 'proposal']),
+        severity: z.enum(['high', 'medium', 'info']),
+        watch_kind: z.enum(['problem', 'decision', 'done', 'quiet', 'delivery']),
+        attach: z.enum(['gate']).nullable().default(null),
+        rate: z.object({ per_run: z.number().int().min(1).max(1_000) }).strict(),
+    })
+        .strict(),
+    priority: z.enum(['p0', 'p1', 'p2']),
+    enabled: z.boolean(),
+})
+    .strict();
+function zodReason(err) {
+    return err.issues.map((i) => `${i.path.join('.') || '(entry)'}: ${i.message}`).join('; ');
+}
+/** Validate one parsed entry against the schema and the check map. */
+export function validateEntry(raw, fileId, checks) {
+    const parsed = EntrySchema.safeParse(raw);
+    if (!parsed.success)
+        return { id: fileId, reason: zodReason(parsed.error) };
+    const e = parsed.data;
+    if (e.id !== fileId)
+        return { id: fileId, reason: `id "${e.id}" differs from the file name "${fileId}.json"` };
+    for (const point of [e.on, ...(e.join ?? [])]) {
+        if (point.source === 'bus' && !BUS_TYPE.test(point.type)) {
+            return { id: e.id, reason: `bus type "${point.type}" is not a 4-segment wicked.<domain>.<noun>.<verb> type` };
+        }
+    }
+    const check = checks.get(e.check);
+    if (check === undefined)
+        return { id: e.id, reason: `unknown check "${e.check}"` };
+    const params = check.paramsSchema.safeParse(e.params);
+    if (!params.success)
+        return { id: e.id, reason: `params: ${zodReason(params.error)}` };
+    const threshold = check.thresholdSchema.safeParse(e.threshold);
+    if (!threshold.success)
+        return { id: e.id, reason: `threshold: ${zodReason(threshold.error)}` };
+    const { join, ...rest } = e;
+    return {
+        ...rest,
+        ...(join !== undefined && join.length > 0 ? { join } : {}),
+        params: params.data,
+        threshold: threshold.data,
+    };
+}
+/** Load every `<id>.json` in `dir`. A missing directory loads nothing and says so. */
+export function loadEntries(dir, checks) {
+    const entries = [];
+    const refused = [];
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => n.endsWith('.json')).sort();
+    }
+    catch (err) {
+        return { entries, refused: [{ id: '(entries)', reason: `cannot read ${basename(dir)}: ${err.message}` }] };
+    }
+    for (const name of names) {
+        const fileId = name.slice(0, -'.json'.length);
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(join(dir, name), 'utf8'));
+        }
+        catch (err) {
+            refused.push({ id: fileId, reason: `not JSON: ${err.message}` });
+            continue;
+        }
+        const out = validateEntry(raw, fileId, checks);
+        if ('reason' in out)
+            refused.push(out);
+        else
+            entries.push(out);
+    }
+    return { entries, refused };
+}
+/** The effective entries: the operator's `enabled` / `threshold` overrides on the shipped ones. */
+export function applyOverrides(entries, settings, checks) {
+    const problems = [];
+    const out = entries.map((e) => {
+        const o = settings?.entries?.[e.id];
+        if (o === undefined)
+            return e;
+        let next = e;
+        // Validated FIRST: a bad threshold leaves the whole override unapplied (enabled included).
+        if (o.threshold !== undefined) {
+            const parsed = checks.get(e.check)?.thresholdSchema.safeParse({ ...e.threshold, ...o.threshold });
+            if (parsed?.success !== true) {
+                problems.push({ id: e.id, reason: `threshold override ignored: ${parsed ? zodReason(parsed.error) : 'no check'}` });
+                return e;
+            }
+            next = { ...next, threshold: parsed.data };
+        }
+        if (typeof o.enabled === 'boolean')
+            next = { ...next, enabled: o.enabled };
+        return next;
+    });
+    return { entries: out, problems };
+}
+/**
+ * Validate a `PUT /settings` `watch` patch against the loaded entries. Returns the error text for a
+ * 400, or `null`. Only `enabled` and `threshold` of a KNOWN entry, and the boolean `llm`.
+ */
+export function validateWatchPatch(patch, entries, checks) {
+    if (typeof patch !== 'object' || patch === null || Array.isArray(patch))
+        return 'watch must be an object';
+    for (const key of Object.keys(patch)) {
+        if (key !== 'entries' && key !== 'llm')
+            return `watch.${key} is not a setting (only watch.entries and watch.llm)`;
+    }
+    const p = patch;
+    if (p.llm !== undefined && typeof p.llm !== 'boolean')
+        return 'watch.llm must be a boolean';
+    if (p.entries === undefined)
+        return null;
+    if (typeof p.entries !== 'object' || p.entries === null || Array.isArray(p.entries))
+        return 'watch.entries must be an object keyed by entry id';
+    for (const [id, raw] of Object.entries(p.entries)) {
+        const entry = entries.find((e) => e.id === id);
+        if (entry === undefined)
+            return `watch.entries.${id}: no such entry`;
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            return `watch.entries.${id} must be an object`;
+        for (const k of Object.keys(raw)) {
+            if (k !== 'enabled' && k !== 'threshold')
+                return `watch.entries.${id}.${k} cannot be changed (only enabled and threshold)`;
+        }
+        const o = raw;
+        if (o.enabled !== undefined && typeof o.enabled !== 'boolean')
+            return `watch.entries.${id}.enabled must be a boolean`;
+        if (o.threshold !== undefined) {
+            if (typeof o.threshold !== 'object' || o.threshold === null || Array.isArray(o.threshold)) {
+                return `watch.entries.${id}.threshold must be an object`;
+            }
+            const parsed = checks.get(entry.check)?.thresholdSchema.safeParse({ ...entry.threshold, ...o.threshold });
+            if (parsed === undefined || !parsed.success) {
+                return `watch.entries.${id}.threshold: ${parsed ? zodReason(parsed.error) : 'no check'}`;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/watch/loader.js.map

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

package/dist/watch/registry.d.ts

@@ -0,0 +1,166 @@
+/**
+ * The key-point trigger registry (DES-TRIGGER-REGISTRY-001, TR-W5a): the runtime.
+ *
+ * ```
+ *  daemon fan-in ──offer() O(1)──▶ ring[512] ─┐
+ *  watchdog onFrame ──offerWatchdog() O(1)──▶ ├─▶ router ─▶ deterministic lane ─▶ emitter ─▶ bus ─▶ relay ─▶ /ws
+ *  bus (pulled, only types an entry wants) ───┘
+ * ```
+ *
+ * - OFF THE HOT PATH (G3). `offer` is synchronous, allocation-light, never awaited and never throws;
+ *   an input no enabled entry listens for is dropped by one `Set.has`.
+ * - ADVISORY BY CONSTRUCTION (G6). The registry is built with no gate, reassign or policy
+ *   dependency (`tests/watch-no-authority.test.ts` fails the build if `src/watch/**` names one). It
+ *   emits findings, flags and proposals; it never adds a needs-you row.
+ * - ONE RECORD (§4.8). The bus. The feed is hydrated from it once at arm; each live run's persisted
+ *   events (and its wanted bus rows) are replayed through the entries at boot; every key is built
+ *   from producer-assigned identity, so a replay resolves to the rows already there.
+ * - NO BUS, NO WATCHING (§6). Without an engine bus the registry does not arm, and health says why.
+ */
+import type { RecordedEvent, WatchCoverage, WatchEntry, WatchEntrySource, WatchFeedResponse, WatchFinding, WatchHealth, WatchKind, WatchSettings } from 'wicked-crew-api-types';
+import type { CoreEvent } from '../core/types.js';
+import type { WatchCheck } from './types.js';
+export interface WatchRegistryOptions {
+    /**
+     * TR-W6: the daemon's steering rules, read for `warned_rule` and cached for {@link RULES_SNAPSHOT_TTL_MS}.
+     * Absent = checks see no `ctx.rules` (coverage says the store is not readable once a rule fires).
+     */
+    rules?: () => Promise<ReadonlyArray<{
+        id: string;
+        effect?: string | undefined;
+        severity: string;
+        retired?: boolean | undefined;
+    }>>;
+    /** Test seam: the per-ask deadline on that read (default {@link RULES_READ_DEADLINE_MS}). */
+    rulesDeadlineMs?: number;
+    /** The bus the daemon handed its engine; `undefined` = no bus, no watching. */
+    dbPath: string | undefined;
+    entriesDir?: string;
+    checks?: ReadonlyMap<string, WatchCheck>;
+    /** The `watch` key of crew's settings (the operator's on/off and thresholds). */
+    settings: () => Promise<WatchSettings | undefined>;
+    projectOf: (runId: string) => string | undefined;
+    /** Runs live at boot (their persisted events are replayed, §4.8 step 2). */
+    liveRuns?: () => Promise<string[]>;
+    /** A run's persisted events (`Core.runEvents`); `null` = this engine cannot say. */
+    runEvents?: (runId: string) => Promise<RecordedEvent[] | null>;
+    /** Where `watchEvent` frames go (the relay); omitted = no relay. */
+    broadcast?: (frame: CoreEvent) => void;
+    auditEmitFailed?: (detail: Record<string, unknown>) => void;
+    submitProposal?: (finding: WatchFinding) => Promise<void>;
+    log?: (msg: string) => void;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    /** Emitter flush cadence (ms); 0 = flush only on demand (tests). */
+    flushMs?: number;
+    /** Internal tick cadence (ms) for `registry-lagging`; 0 = no timer (tests tick by hand). */
+    tickMs?: number;
+    /** Bus poll cadence for the relay and the pull (ms). */
+    pollIntervalMs?: number;
+    ringCapacity?: number;
+    /** Per-check budget and timeout (ms). */
+    checkBudgetMs?: number;
+    checkTimeoutMs?: number;
+}
+export type DismissResult = 'dismissed' | 'not_found' | 'already_cleared' | 'emit_failed';
+/** TR-W6: how long one `listConformanceRules` read serves the warned-rule check. */
+export declare const RULES_SNAPSHOT_TTL_MS = 30000;
+/** TR-W6: how long a check waits on that read — well below the deterministic lane's 1 s timeout. */
+export declare const RULES_READ_DEADLINE_MS = 400;
+export declare class WatchRegistry {
+    private readonly opts;
+    private armedFlag;
+    private reasonText;
+    private accepting;
+    private live;
+    private readonly checks;
+    private shipped;
+    private refused;
+    private overrideProblems;
+    private effective;
+    private settingsNow;
+    private router;
+    private readonly ring;
+    private readonly lane;
+    private emitter;
+    private relay;
+    private pull;
+    private tickTimer;
+    private draining;
+    private drainScheduled;
+    private shedTickQueued;
+    private dbPath;
+    private readonly runStates;
+    /** Live runs whose persisted events could not be read at boot (their coverage says so). */
+    private readonly gapRuns;
+    /** The live runs could not even be listed at boot: every unseen run's coverage says so. */
+    private listGap;
+    /** While the boot replay runs, live bus rows wait here (the pull is armed BEFORE the replay). */
+    private busHold;
+    private readonly now;
+    private readonly sourceState;
+    constructor(opts: WatchRegistryOptions);
+    get armed(): boolean;
+    /** Arm: load entries, hydrate the feed from the bus, replay live runs, then go live. Never throws. */
+    arm(): Promise<void>;
+    private armBusPull;
+    /** §4.8 step 2: every run live at boot is re-read from its own record and evaluated. */
+    private replay;
+    /** THE HOT PATH (daemon fan-in): synchronous, O(1), never throws, never awaited. */
+    offer(event: CoreEvent): void;
+    /** The watchdog's frames (the `onFrame` tee): same contract as {@link offer}. */
+    offerWatchdog(frame: {
+        type: string;
+        session?: string;
+    } & Record<string, unknown>): void;
+    private offerInternal;
+    private schedule;
+    private drain;
+    private stateOf;
+    private rulesSnapshot;
+    private rulesInFlight;
+    /**
+     * TR-W6: one store read per TTL, shared by every check that asks in the window.
+     *
+     * The ask has a DEADLINE below the deterministic lane's timeout (codex r1): a slow read must not
+     * get the evaluation abandoned mid-way (its dedupe state would move while its output is dropped).
+     * Past the deadline the ask is refused — the check keeps the frame and classifies it on a later
+     * one — while the read itself goes on and fills the snapshot when it lands. A read that has not
+     * settled within one TTL is abandoned: the next ask starts a new one (a hung store never pins the
+     * slot), and a late answer from an abandoned read never overwrites a newer snapshot.
+     */
+    private readRules;
+    private ctx;
+    /** Route one input through every matching entry and hand the outputs to the emitter. */
+    private process;
+    /** Drain the ring and flush the emitter (tests, and shutdown). */
+    flush(): Promise<void>;
+    /** Stop taking inputs, finish what was accepted, then close the emitter and the taps. */
+    stop(): Promise<void>;
+    /** Tick the internal clock by hand (tests; the timer does this every 30 s). */
+    tick(): void;
+    /** Apply the operator's `watch` settings: the effective entries and the router are rebuilt. */
+    applySettings(watch: WatchSettings | undefined): void;
+    /** The 400 text for a bad `watch` patch, or `null`. */
+    validateSettingsPatch(patch: unknown): string | null;
+    /** Merge a validated patch into the current `watch` settings, stamping who changed what and when. */
+    mergeSettings(current: WatchSettings | undefined, patch: WatchSettings, actorId: string, at: number): WatchSettings;
+    health(): WatchHealth;
+    /** `GET /watch/entries`: the effective entries, each threshold in plain words. */
+    entries(): WatchEntry[];
+    /** `GET /watch`: the feed, newest first; with `run`, the run's coverage too. */
+    feed(q: {
+        project?: string;
+        kind?: WatchKind;
+        run?: string;
+        since?: number;
+        limit?: number;
+    }): WatchFeedResponse;
+    /** G7: per run, which entries checked and which did not (and why). Run-less entries have none. */
+    coverage(runId: string): WatchCoverage[];
+    /** "Seen, not a problem": publishes `cleared{reason:"dismissed"}` for the row. */
+    dismiss(watchId: string, actorId: string): Promise<DismissResult>;
+    /** The sources an entry can name (for the routes' validation and the docs). */
+    static readonly SOURCES: readonly WatchEntrySource[];
+}
+//# sourceMappingURL=registry.d.ts.map

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

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