@reticlehq/server 2.1.0 → 2.2.1

package/dist/capsule/causal-summary.js

@@ -0,0 +1,111 @@
+import { EventType, PerfMetric } from '@reticlehq/core';
+function pushUnique(list, value) {
+    if (typeof value === 'string' && value.length > 0 && !list.includes(value))
+        list.push(value);
+}
+/** Keep a diff value bounded so the per-act summary never bloats: primitives capped to a short string. */
+const MAX_DIFF_LEN = 140;
+/** Truncate to at most MAX_DIFF_LEN chars total, including the ellipsis marker. */
+function truncate(text) {
+    return text.length > MAX_DIFF_LEN ? `${text.slice(0, MAX_DIFF_LEN - 1)}…` : text;
+}
+function capValue(value) {
+    if (value === undefined || value === null)
+        return value;
+    if (typeof value === 'string')
+        return truncate(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    // Objects/arrays: a shallow, length-capped JSON repr (never a deep dump on the hot path).
+    try {
+        return truncate(JSON.stringify(value));
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+export function causalSummary(events) {
+    let netTotal = 0;
+    let netErrors = 0;
+    let headline;
+    let consoleErrors = 0;
+    const statePathsChanged = [];
+    const storageKeysChanged = [];
+    const stateDiffs = [];
+    const storageDiffs = [];
+    let route;
+    const signals = [];
+    let layoutShift;
+    let longTasks = 0;
+    for (const event of events) {
+        const data = event.data;
+        switch (event.type) {
+            case EventType.NET_REQUEST: {
+                netTotal += 1;
+                const status = data['status'];
+                const failed = data['ok'] === false || (typeof status === 'number' && status >= 400);
+                if (failed) {
+                    netErrors += 1;
+                    // Headline is the first failing request — the thing most worth the agent's eye.
+                    headline ??= `${String(data['method'])} ${String(data['url'])} ${String(status)}`;
+                }
+                break;
+            }
+            case EventType.CONSOLE_ERROR:
+            case EventType.ERROR_UNCAUGHT:
+                consoleErrors += 1;
+                break;
+            case EventType.STATE_CHANGE: {
+                pushUnique(statePathsChanged, data['name']);
+                // The subscribed-store observer emits { name, path, value, old } — `value` is the AFTER side
+                // (`new` is accepted too for any producer that uses it). Presence of either makes it a real
+                // before→after diff rather than a bare reading.
+                const path = typeof data['path'] === 'string' ? data['path'] : data['name'];
+                const hasAfter = 'value' in data || 'new' in data;
+                if (typeof path === 'string' && path.length > 0 && ('old' in data || hasAfter)) {
+                    const after = 'value' in data ? data['value'] : data['new'];
+                    stateDiffs.push({ path, from: capValue(data['old']), to: capValue(after) });
+                }
+                break;
+            }
+            case EventType.STORAGE_CHANGE: {
+                pushUnique(storageKeysChanged, data['key']);
+                const key = data['key'];
+                if (typeof key === 'string' && key.length > 0) {
+                    storageDiffs.push({ key, from: capValue(data['old']), to: capValue(data['new']) });
+                }
+                break;
+            }
+            case EventType.ROUTE_CHANGE:
+                if (typeof data['pathname'] === 'string')
+                    route = data['pathname'];
+                break;
+            case EventType.SIGNAL:
+                pushUnique(signals, data['name']);
+                break;
+            case EventType.PERF:
+                if (data['metric'] === PerfMetric.CLS && typeof data['value'] === 'number') {
+                    layoutShift = Math.max(layoutShift ?? 0, data['value']);
+                }
+                else if (data['metric'] === PerfMetric.LONGTASK) {
+                    longTasks += 1;
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    return {
+        net: { total: netTotal, errors: netErrors, ...(headline === undefined ? {} : { headline }) },
+        consoleErrors,
+        statePathsChanged,
+        storageKeysChanged,
+        stateDiffs,
+        storageDiffs,
+        ...(route === undefined ? {} : { route }),
+        signals,
+        ...(layoutShift === undefined ? {} : { layoutShift }),
+        longTasks,
+    };
+}
+//# sourceMappingURL=causal-summary.js.map

package/dist/capsule/causal-summary.js.map

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

package/dist/capsule/divergence.d.ts

@@ -0,0 +1,31 @@
+import { type ReticleEvent } from '@reticlehq/core';
+/**
+ * First-divergence — the brain of the divergence capsule (Tier 2). Given the chain the flow DECLARED
+ * should happen (its mustHold, as ordered expected links) and what was OBSERVED, walk the declaration and
+ * report the FIRST link where expected ≠ observed, values side by side. That single link is where the
+ * fault lives — the agent fixes it without re-exploring. Pure; the acceptance bar is that for every
+ * hidden-500 / hung-request fixture it names the correct link.
+ */
+export type ExpectedLink = {
+    kind: 'signal';
+    name: string;
+} | {
+    kind: 'net';
+    urlContains: string;
+    status?: number;
+} | {
+    kind: 'state';
+    name: string;
+};
+export interface Divergence {
+    /** The declared link that did not hold. */
+    expected: ExpectedLink;
+    /** Human description of what was observed instead (the closest attempt, or "nothing"). */
+    observed: string;
+}
+/**
+ * Walk the declared chain in order; return the first link not satisfied by the observed events (with a
+ * side-by-side of what happened instead), or null when the whole chain held.
+ */
+export declare function firstDivergence(expected: readonly ExpectedLink[], observed: readonly ReticleEvent[]): Divergence | null;
+//# sourceMappingURL=divergence.d.ts.map

package/dist/capsule/divergence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"divergence.d.ts","sourceRoot":"","sources":["../../src/capsule/divergence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,YAAY,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmCD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,UAAU,GAAG,IAAI,CAOnB"}

package/dist/capsule/divergence.js

@@ -0,0 +1,41 @@
+import { EventType } from '@reticlehq/core';
+function net(events) {
+    return events.filter((e) => e.type === EventType.NET_REQUEST);
+}
+function satisfies(link, events) {
+    switch (link.kind) {
+        case 'signal':
+            return events.some((e) => e.type === EventType.SIGNAL && e.data['name'] === link.name);
+        case 'state':
+            return events.some((e) => e.type === EventType.STATE_CHANGE && e.data['name'] === link.name);
+        case 'net':
+            return net(events).some((e) => typeof e.data['url'] === 'string' &&
+                e.data['url'].includes(link.urlContains) &&
+                (link.status === undefined || e.data['status'] === link.status));
+    }
+}
+/** Describe what WAS observed for a link that failed — the closest attempt, for a side-by-side. */
+function observedFor(link, events) {
+    if (link.kind === 'net') {
+        const match = net(events).find((e) => typeof e.data['url'] === 'string' && e.data['url'].includes(link.urlContains));
+        if (match === undefined)
+            return `no request to ${link.urlContains}`;
+        return `${link.urlContains} responded ${String(match.data['status'])} (expected ${String(link.status)})`;
+    }
+    if (link.kind === 'signal')
+        return `signal "${link.name}" never fired`;
+    return `state "${link.name}" never changed`;
+}
+/**
+ * Walk the declared chain in order; return the first link not satisfied by the observed events (with a
+ * side-by-side of what happened instead), or null when the whole chain held.
+ */
+export function firstDivergence(expected, observed) {
+    for (const link of expected) {
+        if (!satisfies(link, observed)) {
+            return { expected: link, observed: observedFor(link, observed) };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=divergence.js.map

package/dist/capsule/divergence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"divergence.js","sourceRoot":"","sources":["../../src/capsule/divergence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AAsB/D,SAAS,GAAG,CAAC,MAA+B;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,WAAW,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,IAAkB,EAAE,MAA+B;IACpE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/F,KAAK,KAAK;YACR,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ;gBACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;gBACxC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAClE,CAAC;IACN,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,SAAS,WAAW,CAAC,IAAkB,EAAE,MAA+B;IACtE,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CACrF,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC;QACpE,OAAO,GAAG,IAAI,CAAC,WAAW,cAAc,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IAC3G,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,WAAW,IAAI,CAAC,IAAI,eAAe,CAAC;IACvE,OAAO,UAAU,IAAI,CAAC,IAAI,iBAAiB,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAiC,EACjC,QAAiC;IAEjC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/capsule/minimize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bug-capsule minimization — first cut: prefix-trim. A recorded flow that fails is often mostly setup;
+ * the capsule should be the SMALLEST flow that still reproduces the failure, so a regression flow stays
+ * fast and legible. Prefix-trim drops leading steps while the failure persists — the cheap, deterministic
+ * v1 (delta-debugging over arbitrary subsets is a later refinement). The `stillFails` predicate is
+ * injected (a real replay), so this stays pure and unit-testable.
+ */
+/**
+ * Return the shortest trailing sub-flow that still fails, by removing leading steps one at a time while
+ * `stillFails` holds. Never trims below one step. Deterministic given a deterministic predicate.
+ */
+export declare function prefixTrim<T>(steps: readonly T[], stillFails: (candidate: readonly T[]) => Promise<boolean>): Promise<T[]>;
+//# sourceMappingURL=minimize.d.ts.map

package/dist/capsule/minimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimize.d.ts","sourceRoot":"","sources":["../../src/capsule/minimize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GACxD,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd"}

package/dist/capsule/minimize.js

@@ -0,0 +1,23 @@
+/**
+ * Bug-capsule minimization — first cut: prefix-trim. A recorded flow that fails is often mostly setup;
+ * the capsule should be the SMALLEST flow that still reproduces the failure, so a regression flow stays
+ * fast and legible. Prefix-trim drops leading steps while the failure persists — the cheap, deterministic
+ * v1 (delta-debugging over arbitrary subsets is a later refinement). The `stillFails` predicate is
+ * injected (a real replay), so this stays pure and unit-testable.
+ */
+/**
+ * Return the shortest trailing sub-flow that still fails, by removing leading steps one at a time while
+ * `stillFails` holds. Never trims below one step. Deterministic given a deterministic predicate.
+ */
+export async function prefixTrim(steps, stillFails) {
+    let kept = [...steps];
+    while (kept.length > 1) {
+        const trimmed = kept.slice(1);
+        if (await stillFails(trimmed))
+            kept = trimmed;
+        else
+            break;
+    }
+    return kept;
+}
+//# sourceMappingURL=minimize.js.map

package/dist/capsule/minimize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimize.js","sourceRoot":"","sources":["../../src/capsule/minimize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAmB,EACnB,UAAyD;IAEzD,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC;YAAE,IAAI,GAAG,OAAO,CAAC;;YACzC,MAAM;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/capsule/predicate-to-links.d.ts

@@ -0,0 +1,9 @@
+import type { Predicate } from '../events/predicate.js';
+import type { ExpectedLink } from './divergence.js';
+/**
+ * Convert a mustHold predicate into the ordered ExpectedLinks the divergence capsule walks. Only the
+ * consequence kinds (signal/net/state) become links — a presence check (element/text) can't diverge in a
+ * dataflow sense. allOf/anyOf flatten in order; other kinds are skipped. Pure; feeds the capsule on red.
+ */
+export declare function predicateToExpectedLinks(predicate: Predicate): ExpectedLink[];
+//# sourceMappingURL=predicate-to-links.d.ts.map

package/dist/capsule/predicate-to-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-to-links.d.ts","sourceRoot":"","sources":["../../src/capsule/predicate-to-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,EAAE,CAwB7E"}

package/dist/capsule/predicate-to-links.js

@@ -0,0 +1,31 @@
+/**
+ * Convert a mustHold predicate into the ordered ExpectedLinks the divergence capsule walks. Only the
+ * consequence kinds (signal/net/state) become links — a presence check (element/text) can't diverge in a
+ * dataflow sense. allOf/anyOf flatten in order; other kinds are skipped. Pure; feeds the capsule on red.
+ */
+export function predicateToExpectedLinks(predicate) {
+    switch (predicate.kind) {
+        case 'signal':
+            return predicate.name === undefined ? [] : [{ kind: 'signal', name: predicate.name }];
+        case 'net':
+            return predicate.urlContains === undefined
+                ? []
+                : [
+                    {
+                        kind: 'net',
+                        urlContains: predicate.urlContains,
+                        ...(predicate.status === undefined ? {} : { status: predicate.status }),
+                    },
+                ];
+        case 'state': {
+            const name = predicate.store ?? predicate.path;
+            return [{ kind: 'state', name }];
+        }
+        case 'allOf':
+        case 'anyOf':
+            return predicate.predicates.flatMap(predicateToExpectedLinks);
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=predicate-to-links.js.map

package/dist/capsule/predicate-to-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-to-links.js","sourceRoot":"","sources":["../../src/capsule/predicate-to-links.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAoB;IAC3D,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,WAAW,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE;wBACE,IAAI,EAAE,KAAK;wBACX,WAAW,EAAE,SAAS,CAAC,WAAW;wBAClC,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;qBACxE;iBACF,CAAC;QACR,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC;YAC/C,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAChE;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli-flow-commands.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI commands that operate on SAVED FLOWS: watch, capsules, and the gate.
+ *
+ * Split out of cli.ts, which was 653 lines — over the project's own cap, and the file a contributor
+ * opens first. These five functions form one cohesive group: they all read the flow store and report on
+ * verification state, and none of them touch daemon lifecycle, which is what the rest of cli.ts does.
+ */
+import { type FileSystemPort } from './project/fs-port.js';
+import { type NamedFlow } from './flows/flow-sources.js';
+/** Load the {name, steps} of every saved flow for the active project. */
+/** Explicit files plus, when --since is given, the git-changed files since that ref. */
+export declare function resolveChangedFiles(files: string[], since: string | undefined): Promise<string[]>;
+export declare function loadNamedFlows(fs: FileSystemPort, reticleRoot: string): Promise<NamedFlow[]>;
+/**
+ * `reticle watch [url]` — on every save, report which saved flows must re-verify (the affected set).
+ * Environment-side (costs the agent nothing per turn); the buddy loop. This v1 detects + reports on
+ * change; auto-replaying the affected flows against the app is the next increment. Long-running.
+ */
+export declare function handleWatch(): void;
+/**
+ * `reticle capsules` — list saved fail-to-pass bug capsules (.reticle/capsules). Each is a minimal
+ * failing reproduction plus the consequence that should have held; replay one with reticle_flow_replay.
+ */
+export declare function handleCapsules(): Promise<void>;
+/**
+ * `reticle gate <file...>` — exit non-zero unless passing artifacts cover the flows affected by the
+ * changed files. Flaky flows are quarantined (surfaced, not blocking). The environment-side enforcement
+ * that makes verification unavoidable. Never throws; a fault fails closed (exit 1).
+ */
+export declare function handleGate(files: string[], since: string | undefined): Promise<void>;
+//# sourceMappingURL=cli-flow-commands.d.ts.map

package/dist/cli-flow-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flow-commands.d.ts","sourceRoot":"","sources":["../src/cli-flow-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAW7E,yEAAyE;AACzE,wFAAwF;AACxF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,EAAE,CAAC,CAStB;AA0CD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAiClC;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBpD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D1F"}

package/dist/cli-flow-commands.js

@@ -0,0 +1,207 @@
+/**
+ * CLI commands that operate on SAVED FLOWS: watch, capsules, and the gate.
+ *
+ * Split out of cli.ts, which was 653 lines — over the project's own cap, and the file a contributor
+ * opens first. These five functions form one cohesive group: they all read the flow store and report on
+ * verification state, and none of them touch daemon lifecycle, which is what the rest of cli.ts does.
+ */
+import { readProjectId } from './cli-port.js';
+import { changedFilesSince } from './flows/git-changed.js';
+import { join } from 'node:path';
+import { ReticleDir, RunFlowStatus } from '@reticlehq/core';
+import { FlowStore } from './flows/flows.js';
+import { RunStore } from './runs/run-store.js';
+import { createNodeFileSystem } from './project/fs-port.js';
+import { affectedSavedFlows } from './flows/flow-sources.js';
+import { gateDecision } from './flows/gate.js';
+import { FlakeStore } from './flows/flake-store.js';
+import { formatBuddyStatus } from './flows/buddy-status.js';
+import { CapsuleStore } from './capsule/capsule-store.js';
+import { AssertionTiersStore } from './flows/assertion-tiers-store.js';
+import { detectDowngrades } from './flows/assertion-integrity.js';
+import { computeCoverage } from './flows/coverage.js';
+import { createWatchBatcher } from './flows/watch-batcher.js';
+import { watch } from 'node:fs';
+import { log } from './log.js';
+/** Load the {name, steps} of every saved flow for the active project. */
+/** Explicit files plus, when --since is given, the git-changed files since that ref. */
+export async function resolveChangedFiles(files, since) {
+    if (since === undefined)
+        return files;
+    return [...new Set([...files, ...(await changedFilesSince(since, process.cwd()))])];
+}
+export async function loadNamedFlows(fs, reticleRoot) {
+    const projectId = readProjectId(process.cwd());
+    const store = new FlowStore(fs, reticleRoot, { now: () => Date.now() });
+    const flows = [];
+    for (const name of await store.list(projectId)) {
+        const loaded = await store.load(name, projectId);
+        if (loaded.ok)
+            flows.push({ name: loaded.value.name, steps: loaded.value.steps });
+    }
+    return flows;
+}
+/** File-change extensions worth reacting to (skip node_modules churn, dotfiles, build output). */
+/**
+ * The buddy channel: one ambient line a human can park in a statusline. Deliberately best-effort
+ * and silent on failure — a status line that throws is worse than no status line, and it must never
+ * interfere with the watch loop it rides on.
+ */
+async function emitBuddyStatus(fs, reticleRoot, flows, affected) {
+    try {
+        const latest = await new RunStore(fs, reticleRoot).latest();
+        const passingNames = new Set((latest?.flows ?? [])
+            .filter((f) => f.status === RunFlowStatus.PASS || f.status === RunFlowStatus.HEALED)
+            .map((f) => f.name));
+        const quarantined = await new FlakeStore(fs, reticleRoot).flakyFlows();
+        const flaky = new Set(quarantined);
+        // A deviation is an at-risk flow with no passing artifact — and a quarantined flake is not a deviation.
+        const deviations = affected.filter((n) => !passingNames.has(n) && !flaky.has(n));
+        log('reticle_buddy', {
+            status: formatBuddyStatus({
+                total: flows.length,
+                passing: passingNames.size,
+                deviations,
+                quarantined,
+            }),
+        });
+    }
+    catch {
+        // never let the ambient line break the watcher
+    }
+}
+const WATCHED_EXTENSIONS = /\.(ts|tsx|js|jsx|mjs|cjs|vue|svelte)$/;
+const WATCH_DEBOUNCE_MS = 200;
+/**
+ * `reticle watch [url]` — on every save, report which saved flows must re-verify (the affected set).
+ * Environment-side (costs the agent nothing per turn); the buddy loop. This v1 detects + reports on
+ * change; auto-replaying the affected flows against the app is the next increment. Long-running.
+ */
+export function handleWatch() {
+    const fs = createNodeFileSystem();
+    const reticleRoot = join(process.cwd(), ReticleDir.ROOT);
+    const batcher = createWatchBatcher({
+        debounceMs: WATCH_DEBOUNCE_MS,
+        schedule: (fn, ms) => {
+            setTimeout(fn, ms).unref();
+        },
+        onFlush: (files) => {
+            void loadNamedFlows(fs, reticleRoot)
+                .then(async (flows) => {
+                const result = affectedSavedFlows(flows, files);
+                if (result.affected.length > 0) {
+                    log('reticle_watch_affected', { changed: files, affected: result.affected });
+                }
+                await emitBuddyStatus(fs, reticleRoot, flows, result.affected);
+            })
+                .catch((error) => {
+                log('reticle_watch_failed', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            });
+        },
+    });
+    log('reticle_watch_started', { cwd: process.cwd() });
+    // Print the ambient line once at startup so the human sees where they stand before touching anything.
+    void loadNamedFlows(fs, reticleRoot)
+        .then((flows) => emitBuddyStatus(fs, reticleRoot, flows, []))
+        .catch(() => undefined);
+    watch(process.cwd(), { recursive: true }, (_event, filename) => {
+        if (typeof filename === 'string' && WATCHED_EXTENSIONS.test(filename))
+            batcher.onChange(filename);
+    });
+}
+/**
+ * `reticle capsules` — list saved fail-to-pass bug capsules (.reticle/capsules). Each is a minimal
+ * failing reproduction plus the consequence that should have held; replay one with reticle_flow_replay.
+ */
+export async function handleCapsules() {
+    try {
+        const fs = createNodeFileSystem();
+        const capsules = await new CapsuleStore(fs, join(process.cwd(), ReticleDir.ROOT)).all();
+        log('reticle_capsules', {
+            count: capsules.length,
+            capsules: capsules.map((c) => ({
+                id: c.id,
+                ...(c.flow === undefined ? {} : { flow: c.flow }),
+                origin: c.origin,
+                expected: c.expected,
+                observed: c.observed,
+                steps: c.steps.length,
+            })),
+        });
+    }
+    catch (error) {
+        log('reticle_capsules_failed', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exitCode = 1;
+    }
+}
+/**
+ * `reticle gate <file...>` — exit non-zero unless passing artifacts cover the flows affected by the
+ * changed files. Flaky flows are quarantined (surfaced, not blocking). The environment-side enforcement
+ * that makes verification unavoidable. Never throws; a fault fails closed (exit 1).
+ */
+export async function handleGate(files, since) {
+    try {
+        const fs = createNodeFileSystem();
+        const reticleRoot = join(process.cwd(), ReticleDir.ROOT);
+        const changed = await resolveChangedFiles(files, since);
+        const allFlows = await loadNamedFlows(fs, reticleRoot);
+        const affected = affectedSavedFlows(allFlows, changed).affected;
+        const latest = await new RunStore(fs, reticleRoot).latest();
+        const passing = (latest?.flows ?? [])
+            .filter((f) => f.status === RunFlowStatus.PASS || f.status === RunFlowStatus.HEALED)
+            .map((f) => f.name);
+        const flaky = await new FlakeStore(fs, reticleRoot).flakyFlows();
+        // Anti-reward-hacking: diff each flow's CURRENT assertions against what it asserted the last
+        // time it passed. A mustHold that dropped from a real consequence to a fakeable presence check is a
+        // green bought by weakening the test — and a flow that covered a changed file but no longer exists
+        // is coverage deleted rather than satisfied. Both block.
+        const baseline = await new AssertionTiersStore(fs, reticleRoot).load();
+        const byName = new Map(allFlows.map((f) => [f.name, f]));
+        const downgraded = Object.entries(baseline)
+            .filter(([name]) => affected.includes(name) && byName.has(name))
+            .map(([name, before]) => {
+            const current = byName.get(name);
+            const after = (current?.steps ?? []).map((s, i) => ({
+                step: i,
+                ...(s.expect === undefined ? {} : { expect: s.expect }),
+            }));
+            return { flow: name, steps: detectDowngrades(before.steps, after).map((d) => d.step) };
+        })
+            .filter((d) => d.steps.length > 0);
+        // A flow with a recorded passing baseline that has since vanished, while its files changed.
+        // A flow that PASSED covering these files and has since vanished is coverage DELETED, not satisfied —
+        // and it can never appear in `affected` (that is derived from flows that still exist), so it must be
+        // matched against the baseline's own recorded sources. Missing this made deleting a flow turn the
+        // gate green, which is precisely the gaming move exists to stop.
+        const changedSet = new Set(changed);
+        const deleted = Object.entries(baseline)
+            .filter(([name, entry]) => !byName.has(name) && entry.sources.some((f) => changedSet.has(f)))
+            .map(([name]) => name);
+        const result = gateDecision({ affected, passing, flaky, downgraded, deleted });
+        // Verified-surface coverage over flows: how much of the saved suite this run actually exercised.
+        const coverage = computeCoverage({ testids: [], signals: [], flows: allFlows.map((f) => f.name) }, { testids: [], signals: [], flows: passing });
+        log('reticle_gate', {
+            pass: result.pass,
+            uncovered: result.uncovered,
+            quarantined: result.quarantined,
+            ...(result.downgraded.length > 0 ? { downgraded: result.downgraded } : {}),
+            ...(result.deleted.length > 0 ? { deletedCoverage: result.deleted } : {}),
+            coverage: {
+                pct: coverage.flows.pct,
+                covered: coverage.flows.covered,
+                total: coverage.flows.total,
+            },
+        });
+        if (!result.pass)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        log('reticle_gate_failed', { error: error instanceof Error ? error.message : String(error) });
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=cli-flow-commands.js.map

package/dist/cli-flow-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flow-commands.js","sourceRoot":"","sources":["../src/cli-flow-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAkB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,yEAAyE;AACzE,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAe,EACf,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,WAAmB;IAEnB,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kGAAkG;AAElG;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAC5B,EAA2C,EAC3C,WAAmB,EACnB,KAA2B,EAC3B,QAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC;aACnF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACnC,wGAAwG;QACxG,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,GAAG,CAAC,eAAe,EAAE;YACnB,MAAM,EAAE,iBAAiB,CAAC;gBACxB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,YAAY,CAAC,IAAI;gBAC1B,UAAU;gBACV,WAAW;aACZ,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AACnE,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,kBAAkB,CAAC;QACjC,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YACnB,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,KAAK,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC;iBACjC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACpB,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,GAAG,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBACD,MAAM,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjE,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,GAAG,CAAC,sBAAsB,EAAE;oBAC1B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrD,sGAAsG;IACtG,KAAK,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC;SACjC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;SAC5D,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC7D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;YACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACxF,GAAG,CAAC,kBAAkB,EAAE;YACtB,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACjD,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;aACtB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,yBAAyB,EAAE;YAC7B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe,EAAE,KAAyB;IACzE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC;aACnF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC;QACjE,6FAA6F;QAC7F,oGAAoG;QACpG,mGAAmG;QACnG,yDAAyD;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,mBAAmB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aAC/D,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;YACtB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClD,IAAI,EAAE,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;aACxD,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACzF,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,4FAA4F;QAC5F,sGAAsG;QACtG,qGAAqG;QACrG,kGAAkG;QAClG,iEAAiE;QACjE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;aACrC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC5F,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,iGAAiG;QACjG,MAAM,QAAQ,GAAG,eAAe,CAC9B,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAChE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAC7C,CAAC;QACF,GAAG,CAAC,cAAc,EAAE;YAClB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,QAAQ,EAAE;gBACR,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG;gBACvB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;gBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;aAC5B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli-parse.d.ts

@@ -4,7 +4,14 @@
  * file-size cap and keep the parser pure + unit-testable. Re-exported from cli.ts so existing
  * imports are unchanged.
  */
-export declare const CLI_USAGE = "usage:\n  reticle init  [--yes] [--dry-run] [--port N] [--no-mcp] [--no-install]  (wire Reticle into the project in this directory)\n  reticle serve [--port N] [--drive <url>] [--headed] [--http] [--http-port N] [--http-token T]\n  reticle stop  [--port N] [--quiet]\n  reticle status [--port N]\n  reticle open  [url] [--port N]                        (show the app: reuse the connected tab, else open one)\n  reticle verify <url> [--headed] [--timeout N] [--storage-state <file>]  (one-shot: drive the URL, verify saved flows, exit 0=pass)\n  reticle drive <url> [--headed]                       (foreground mode \u2014 for debugging)\n  reticle mcp   [--port N] [--drive <url>] [--headed]  (MCP stdio proxy \u2014 auto-starts daemon if needed)\n  reticle license                                      (show enterprise license status: active | eval | missing)";
+export declare const CLI_USAGE = "usage:\n  reticle init  [--dry-run] [--port N] [--no-mcp] [--no-install]  (wire Reticle into the project in this directory)\n  reticle serve [--port N] [--drive <url>] [--headed] [--http] [--http-port N] [--http-token T]\n  reticle stop  [--port N] [--quiet]\n  reticle status [--port N]\n  reticle doctor [--port N]                            (diagnose setup: Chromium, daemon, port \u2014 one command)\n  reticle open  [url] [--port N]                        (show the app: reuse the connected tab, else open one)\n  reticle verify <url> [--headed] [--timeout N] [--storage-state <file>]  (one-shot: drive the URL, verify saved flows, exit 0=pass)\n  reticle affected [--since <ref>] [file...]           (which saved flows must re-verify for the changed files)\n  reticle gate [--since <ref>] [file...]               (exit non-zero unless passing artifacts cover the affected flows)\n  reticle watch [url]                                  (on save, report which saved flows must re-verify)\n  reticle drive <url> [--headed]                       (foreground mode \u2014 for debugging)\n  reticle mcp   [--port N] [--drive <url>] [--headed]  (MCP stdio proxy \u2014 auto-starts daemon if needed)\n  reticle update                                       (install the latest server version and restart)\n  reticle rollback                                     (restore the previous server version and restart)\n  reticle license                                      (show enterprise license status: active | eval | missing)\n  reticle telemetry [status|enable|disable]            (anonymous usage metrics \u2014 status shows what's sent + the policy)\n\nCloud (link this project to Reticle Cloud \u2014 runs/flows recorded on the dashboard):\n  reticle login --email <e> [--code <c>] [--org <n>]   (sign in: mails a code, then exchanges it)\n  reticle link  [--project <name|id>]                  (bind this repo: mints a scoped key, writes .reticle/cloud.json)\n  reticle whoami                                        (who am I signed in as, and is this repo attached?)\n  reticle project <ls|create <name>>                   (list or create cloud projects)\n  reticle config [--runs on|off] [--memory on|off] [--flows on|off] [--verify local|server]\n  reticle push                                          (send local run artifacts to the dashboard)\n  reticle runs | regression | share <runId>            (read cloud state; regression exits 3 if any flow broke)";
+/** The `reticle telemetry` sub-actions. Bare `reticle telemetry` means `status`. */
+export declare const TelemetryAction: {
+    readonly STATUS: "status";
+    readonly ENABLE: "enable";
+    readonly DISABLE: "disable";
+};
+export type TelemetryAction = (typeof TelemetryAction)[keyof typeof TelemetryAction];
 export declare const DAEMON_INNER_COMMAND = "_daemon";
 export declare const HEADED_FLAG = "--headed";
 export declare const PORT_FLAG = "--port";
@@ -35,8 +42,16 @@ export type CliResult = {
     port: number;
 } | {
     kind: 'license';
+} | {
+    kind: 'telemetry';
+    action: TelemetryAction;
 } | {
     kind: 'version';
+} | {
+    kind: 'help';
+} | {
+    kind: 'doctor';
+    port: number;
 } | {
     kind: 'open';
     port: number;
@@ -60,15 +75,34 @@ export type CliResult = {
     headless: boolean;
     timeoutMs?: number;
     storageState?: string;
+} | {
+    kind: 'affected';
+    files: string[];
+    since?: string;
+} | {
+    kind: 'capsules';
+} | {
+    kind: 'gate';
+    files: string[];
+    since?: string;
+} | {
+    kind: 'watch';
+    url?: string;
+} | {
+    kind: 'update';
+} | {
+    kind: 'rollback';
 } | {
     kind: 'mcp';
     port: number;
     driveUrl?: string;
     headless: boolean;
+    http: boolean;
+    httpPort?: number;
+    httpToken?: string;
 } | {
     kind: 'error';
     message: string;
 };
-/** Pure CLI arg parser — exported for unit tests. argv = process.argv.slice(2). */
 export declare function parseCliArgs(argv: string[], defaultPort: number): CliResult;
 //# sourceMappingURL=cli-parse.d.ts.map