@cat-factory/local-server 0.92.1 → 0.93.1

package/dist/telemetryIngest.d.ts

@@ -0,0 +1,49 @@
+import type { Clock, Logger } from '@cat-factory/kernel';
+import { type MachineTelemetryClient } from '@cat-factory/server';
+import type { LocalTelemetryIngestReader } from './sqlite/telemetryIngestReader.js';
+/** A row no batch can ever carry, named so the sweep can REPORT the drop rather than hide it. */
+export interface OversizedRow {
+    id: string;
+    chars: number;
+}
+/** What one sweep moved, for logging. */
+export interface TelemetryIngestSweepResult {
+    runs: number;
+    metrics: number;
+    snapshots: number;
+    searchQueries: number;
+    /** Runs left un-marked because their upload failed — retried on the next pass. */
+    failed: number;
+    /**
+     * Rows skipped because one row alone exceeds the mothership's whole-body cap. Reported, never
+     * silent: the alternative is a run that can never finish draining, and a cap that drops
+     * something has to say so.
+     */
+    skipped: number;
+}
+export interface TelemetryIngestDeps {
+    reader: LocalTelemetryIngestReader;
+    client: MachineTelemetryClient;
+    clock: Clock;
+    log: Logger;
+}
+/**
+ * Upload every quiesced run's telemetry once. Pure over its dependencies (no timer), so it is
+ * unit-testable directly — the same shape as `sweepLocalTelemetryRetention`.
+ *
+ * A run whose upload fails is left UNMARKED and counted in `failed`: the next pass retries it from
+ * the beginning, which is safe precisely because the mothership's append is idempotent by row id.
+ * One run's failure never stops the pass — a single unreachable moment must not park the backlog.
+ */
+export declare function sweepTelemetryIngest(deps: TelemetryIngestDeps, now: number): Promise<TelemetryIngestSweepResult>;
+/**
+ * Start the periodic telemetry ingest sweep. Best-effort throughout — losing observability must
+ * never take the node down, and an unreachable mothership only means the rows stay local until it
+ * comes back.
+ *
+ * Like the retention sweep, the returned stop function is ASYNC and must be AWAITED before the
+ * telemetry store is closed: a pass in flight when shutdown closes the SQLite handle would die on
+ * "database is not open" and put a spurious error line on every clean exit.
+ */
+export declare function startTelemetryIngest(deps: TelemetryIngestDeps): () => Promise<void>;
+//# sourceMappingURL=telemetryIngest.d.ts.map

package/dist/telemetryIngest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryIngest.d.ts","sourceRoot":"","sources":["../src/telemetryIngest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAgB,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAyDjG,iGAAiG;AACjG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,yCAAyC;AACzC,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,0BAA0B,CAAA;IAClC,MAAM,EAAE,sBAAsB,CAAA;IAC9B,KAAK,EAAE,KAAK,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAoFD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,0BAA0B,CAAC,CAqErC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CA6BnF"}

package/dist/telemetryIngest.js

@@ -0,0 +1,226 @@
+import { startSweeper } from '@cat-factory/node-server';
+import { MAX_TELEMETRY_INGEST_CHARS, MachineTokenUnavailableError, TELEMETRY_INGEST_LIMITS, } from '@cat-factory/server';
+// The UPSTREAM half of the mothership-mode telemetry bucket (docs/initiatives/mothership-mode.md,
+// PR 5). The capture half writes every LLM call, dispatch context and performed search to the
+// laptop's `node:sqlite` store, because putting a network round trip on the hot path of every
+// model call is exactly what the local-first bucket exists to avoid. This is the background sweep
+// that carries a FINISHED run's rows up to the mothership afterwards, so hosted teammates can read
+// the observability of a run a developer drove, and so those rows outlive the node's short local
+// retention window.
+//
+// Two design points worth keeping:
+//
+//   - "Finished" is QUIESCENCE, not a run-status read. The node holds no execution index of its
+//     own (runs live on the mothership), so asking "which runs ended" would mean a remote query
+//     per candidate — the N+1 this bucket was created to avoid. A run that has produced no
+//     telemetry for the grace period is done as far as its telemetry is concerned, and a RESUMED
+//     run simply becomes a candidate again on its next quiet period.
+//   - Progress is a per-run high-water mark, advanced only after the whole run drained. A node
+//     that dies mid-drain re-offers the rows it already sent, which costs bandwidth and nothing
+//     else: the mothership's append is idempotent by row id.
+/** How often the sweep runs. Telemetry is read after the fact, so a slow cadence is right. */
+const INGEST_SWEEP_INTERVAL_MS = 5 * 60 * 1000;
+/**
+ * How long a run must produce no telemetry before it is uploaded. Long enough that an agent step
+ * thinking between model calls is not mistaken for a finished run (which would upload the run
+ * repeatedly as it continued), short enough that a developer's teammates see a run's telemetry
+ * while it is still the thing being discussed.
+ */
+const QUIESCENCE_MS = 10 * 60 * 1000;
+/** Runs uploaded per pass — a bound on how much a single sweep can spend on a backlog. */
+const RUNS_PER_SWEEP = 20;
+/**
+ * Rows read per page, per sink. Deliberately the mothership's own per-request ROW caps: a page the
+ * node built larger would be refused whole, and the drain would never advance.
+ */
+const PAGE_SIZES = TELEMETRY_INGEST_LIMITS;
+/**
+ * Headroom left under {@link MAX_TELEMETRY_INGEST_CHARS} for everything in the request body that
+ * is not the rows themselves — the envelope's two ids, the sink key, the brackets and separators.
+ * Generous, because being a few hundred bytes over the mothership's cap costs a whole refused
+ * batch.
+ */
+const ENVELOPE_OVERHEAD_CHARS = 4_096;
+/**
+ * The byte budget one posted batch may fill. The mothership enforces TWO caps — a row count AND
+ * {@link MAX_TELEMETRY_INGEST_CHARS} — and mirroring only the first is what let a page of 20
+ * snapshot rows (routinely megabytes each) exceed the byte cap, be refused 413 whole, and leave
+ * the run retrying the same doomed page every sweep until the local prune deleted it.
+ */
+const BATCH_BUDGET_CHARS = MAX_TELEMETRY_INGEST_CHARS - ENVELOPE_OVERHEAD_CHARS;
+/** The last row of a page, as the cursor the next page resumes from. */
+function cursorOf(rows) {
+    const last = rows[rows.length - 1];
+    return last ? { createdAt: last.createdAt, id: last.id } : undefined;
+}
+/**
+ * Split one page into batches that each fit {@link BATCH_BUDGET_CHARS}, separating out any row
+ * that cannot fit ALONE.
+ *
+ * The row caps bound COUNT; this bounds BYTES, which is the axis a snapshot row moves — the whole
+ * composed prompt plus every injected context file's body. Sizing is by the row's own serialized
+ * length, the same measure the mothership applies to the body it receives.
+ *
+ * A row too big even by itself is returned in `oversized` rather than posted: sending it means a
+ * guaranteed 413, which fails the run's whole drain and re-offers the identical page on the next
+ * sweep, forever. Skipping it lets the rest of the run through, and the caller reports the drop.
+ */
+function budgetBatches(rows) {
+    const batches = [];
+    const oversized = [];
+    let batch = [];
+    let used = 0;
+    for (const row of rows) {
+        const chars = JSON.stringify(row).length;
+        if (chars > BATCH_BUDGET_CHARS) {
+            oversized.push({ id: row.id, chars });
+            continue;
+        }
+        if (batch.length > 0 && used + chars > BATCH_BUDGET_CHARS) {
+            batches.push(batch);
+            batch = [];
+            used = 0;
+        }
+        batch.push(row);
+        used += chars;
+    }
+    if (batch.length > 0)
+        batches.push(batch);
+    return { batches, oversized };
+}
+/**
+ * Drain ONE sink of one run, posting each page as one or more byte-budgeted batches. Pages are
+ * read forwards on the `(createdAt, id)` keyset, so a run's telemetry lands on the mothership in
+ * the order it was captured — which is what keeps a metric's prompt-delta chain readable there.
+ *
+ * The cursor advances past a skipped oversized row deliberately: it can never be uploaded, so
+ * holding the drain on it would strand every row behind it too. The caller names what was dropped.
+ */
+async function drainSink(read, limit, post) {
+    let cursor;
+    const drain = { uploaded: 0, oversized: [] };
+    for (;;) {
+        const rows = read(cursor, limit);
+        if (rows.length === 0)
+            return drain;
+        const budgeted = budgetBatches(rows);
+        for (const batch of budgeted.batches) {
+            await post(batch);
+            drain.uploaded += batch.length;
+        }
+        drain.oversized.push(...budgeted.oversized);
+        cursor = cursorOf(rows);
+        // A short page is the last one; asking again would cost a query to learn nothing.
+        if (rows.length < limit)
+            return drain;
+    }
+}
+/**
+ * Upload every quiesced run's telemetry once. Pure over its dependencies (no timer), so it is
+ * unit-testable directly — the same shape as `sweepLocalTelemetryRetention`.
+ *
+ * A run whose upload fails is left UNMARKED and counted in `failed`: the next pass retries it from
+ * the beginning, which is safe precisely because the mothership's append is idempotent by row id.
+ * One run's failure never stops the pass — a single unreachable moment must not park the backlog.
+ */
+export async function sweepTelemetryIngest(deps, now) {
+    const pending = deps.reader.listPendingRuns(now - QUIESCENCE_MS, RUNS_PER_SWEEP);
+    const result = {
+        runs: 0,
+        metrics: 0,
+        snapshots: 0,
+        searchQueries: 0,
+        failed: 0,
+        skipped: 0,
+    };
+    for (const run of pending) {
+        const { workspaceId, executionId } = run;
+        const send = (batch) => deps.client.ingest({ workspaceId, executionId, ...batch }).then(() => undefined);
+        try {
+            const metrics = await drainSink((cursor, limit) => deps.reader.listMetrics(workspaceId, executionId, cursor, limit), PAGE_SIZES.metrics, (rows) => send({ metrics: rows }));
+            const snapshots = await drainSink((cursor, limit) => deps.reader.listSnapshots(workspaceId, executionId, cursor, limit), PAGE_SIZES.snapshots, (rows) => send({ snapshots: rows }));
+            const searchQueries = await drainSink((cursor, limit) => deps.reader.listSearchQueries(workspaceId, executionId, cursor, limit), PAGE_SIZES.searchQueries, (rows) => send({ searchQueries: rows }));
+            result.metrics += metrics.uploaded;
+            result.snapshots += snapshots.uploaded;
+            result.searchQueries += searchQueries.uploaded;
+            // A row too large to ever post is dropped rather than retried forever — but a cap that drops
+            // something says what it dropped, naming the rows so the gap in the mothership's view of
+            // this run is explicable rather than an unexplained hole.
+            const oversized = [...metrics.oversized, ...snapshots.oversized, ...searchQueries.oversized];
+            if (oversized.length > 0) {
+                result.skipped += oversized.length;
+                deps.log.warn('mothership telemetry ingest skipped rows over the body cap', {
+                    workspaceId,
+                    executionId,
+                    skipped: oversized.length,
+                    capChars: BATCH_BUDGET_CHARS,
+                    rows: oversized.map((row) => `${row.id}:${row.chars}`).join(','),
+                });
+            }
+            // Marked only once every sink drained — the mark is what stops the run being re-offered, so
+            // writing it after a partial upload would strand whatever had not been sent yet.
+            deps.reader.markIngested(workspaceId, executionId, run.lastWriteAt, now);
+            result.runs += 1;
+        }
+        catch (error) {
+            result.failed += 1;
+            // No token yet: EVERY remaining run would fail the same way, so the pass stops here with one
+            // line instead of twenty identical ones. The runs stay candidates — nothing was marked.
+            if (error instanceof MachineTokenUnavailableError) {
+                deps.log.info('mothership telemetry ingest deferred: node has not logged in yet', {
+                    pending: pending.length,
+                });
+                return result;
+            }
+            deps.log.warn('mothership telemetry ingest failed for a run', {
+                workspaceId,
+                executionId,
+                err: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Start the periodic telemetry ingest sweep. Best-effort throughout — losing observability must
+ * never take the node down, and an unreachable mothership only means the rows stay local until it
+ * comes back.
+ *
+ * Like the retention sweep, the returned stop function is ASYNC and must be AWAITED before the
+ * telemetry store is closed: a pass in flight when shutdown closes the SQLite handle would die on
+ * "database is not open" and put a spurious error line on every clean exit.
+ */
+export function startTelemetryIngest(deps) {
+    let stopped = false;
+    let inFlight;
+    const stopSweeper = startSweeper({
+        name: 'mothership-telemetry-ingest',
+        intervalMs: INGEST_SWEEP_INTERVAL_MS,
+        log: deps.log,
+        failureMessage: 'mothership telemetry ingest sweep failed',
+        tick: async () => {
+            if (stopped)
+                return;
+            const pass = sweepTelemetryIngest(deps, deps.clock.now());
+            inFlight = pass;
+            try {
+                const moved = await pass;
+                if (moved.runs > 0 || moved.failed > 0 || moved.skipped > 0) {
+                    deps.log.info('mothership telemetry ingest uploaded runs', { ...moved });
+                }
+            }
+            finally {
+                if (inFlight === pass)
+                    inFlight = undefined;
+            }
+        },
+    });
+    return async () => {
+        stopped = true;
+        stopSweeper();
+        // silent-catch-ok: the sweeper's own error handler already logged this pass's failure; here we
+        // only need it to have FINISHED touching the store before the caller closes it.
+        await inFlight?.catch(() => undefined);
+    };
+}
+//# sourceMappingURL=telemetryIngest.js.map

package/dist/telemetryIngest.js.map

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

package/dist/telemetryRetention.d.ts

@@ -8,6 +8,8 @@ export interface LocalTelemetryRetentionResult {
     agentSearchQueries: number;
     provisioningLog: number;
     subscriptionQuotaCycles: number;
+    /** Upstream-ingest high-water marks (PR 5's sync UP) whose runs' rows are long gone. */
+    ingestState: number;
 }
 /**
  * Prune each local telemetry table to its retention window. Pure over the store, so it is

package/dist/telemetryRetention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetryRetention.d.ts","sourceRoot":"","sources":["../src/telemetryRetention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AA4BrE,mEAAmE;AACnE,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAYD;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,6BAA6B,CAAC,CAkBxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,OAAO,CAAC,IAAI,CAAC,CA8BrB"}
+{"version":3,"file":"telemetryRetention.d.ts","sourceRoot":"","sources":["../src/telemetryRetention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AA4BrE,mEAAmE;AACnE,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAA;CACpB;AAYD;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,6BAA6B,CAAC,CAyBxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,MAAM,OAAO,CAAC,IAAI,CAAC,CA8BrB"}

package/dist/telemetryRetention.js

@@ -41,6 +41,11 @@ export async function sweepLocalTelemetryRetention(store, retention, now) {
         agentSearchQueries: await prune(retention.llmCallMetricsMs, now, (c) => store.agentSearchQueryRepository.deleteOlderThan(c)),
         provisioningLog: await prune(retention.provisioningLogMs, now, (c) => store.provisioningLogRepository.deleteOlderThan(c)),
         subscriptionQuotaCycles: await prune(SUBSCRIPTION_QUOTA_CYCLE_RETENTION_MS, now, (c) => store.subscriptionQuotaCycleRepository.deleteOlderThan(c)),
+        // The ingest bookkeeping rides the LLM-call window too, and the ordering is what makes that
+        // safe: a mark is stamped at ingest time, which is always at or after the newest row it covers,
+        // so the mark outlives the rows it describes and can never be dropped while a still-stored run
+        // would be re-uploaded because of it.
+        ingestState: await prune(retention.llmCallMetricsMs, now, async (c) => store.ingestReader.deleteIngestStateOlderThan(c)),
     };
 }
 /**

package/dist/telemetryRetention.js.map

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

package/dist/telemetrySweeps.d.ts

@@ -0,0 +1,28 @@
+import type { Clock, Logger } from '@cat-factory/kernel';
+import type { MachineTelemetryClient, RetentionConfig } from '@cat-factory/server';
+import type { LocalTelemetryStore } from './sqlite/telemetryStore.js';
+export interface MothershipTelemetrySweepDeps {
+    store: LocalTelemetryStore;
+    client: MachineTelemetryClient;
+    retention: RetentionConfig;
+    clock: Clock;
+    log: Logger;
+}
+/**
+ * Start the local telemetry PRUNE and the UPSTREAM ingest, returning one stop function that awaits
+ * both.
+ *
+ * - The prune is the only thing bounding the store: the mothership's cron owns ITS tables, and the
+ *   Node facade's retention sweeper runs from `start()`, which a mothership-mode boot never calls.
+ *   Left unpruned, `llm_call_metrics` — full per-call prompt + response bodies — grows without
+ *   bound on the developer's disk.
+ * - The ingest is what stops the prune being a DATA LOSS: it carries a quiesced run's rows up to
+ *   the mothership, so a run this laptop drove stays readable (by hosted teammates, and by anyone
+ *   at all) after the local window passes.
+ *
+ * The returned stop is ASYNC and must be AWAITED before the store closes — each sweep's first pass
+ * is asynchronous, so an un-awaited one dies on "database is not open" and puts a spurious error
+ * line on every clean exit.
+ */
+export declare function startMothershipTelemetrySweeps(deps: MothershipTelemetrySweepDeps): () => Promise<void>;
+//# sourceMappingURL=telemetrySweeps.d.ts.map

package/dist/telemetrySweeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetrySweeps.d.ts","sourceRoot":"","sources":["../src/telemetrySweeps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAWrE,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,mBAAmB,CAAA;IAC1B,MAAM,EAAE,sBAAsB,CAAA;IAC9B,SAAS,EAAE,eAAe,CAAA;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,4BAA4B,GACjC,MAAM,OAAO,CAAC,IAAI,CAAC,CAiBrB"}

package/dist/telemetrySweeps.js

@@ -0,0 +1,32 @@
+import { startTelemetryIngest } from './telemetryIngest.js';
+import { startLocalTelemetryRetention } from './telemetryRetention.js';
+/**
+ * Start the local telemetry PRUNE and the UPSTREAM ingest, returning one stop function that awaits
+ * both.
+ *
+ * - The prune is the only thing bounding the store: the mothership's cron owns ITS tables, and the
+ *   Node facade's retention sweeper runs from `start()`, which a mothership-mode boot never calls.
+ *   Left unpruned, `llm_call_metrics` — full per-call prompt + response bodies — grows without
+ *   bound on the developer's disk.
+ * - The ingest is what stops the prune being a DATA LOSS: it carries a quiesced run's rows up to
+ *   the mothership, so a run this laptop drove stays readable (by hosted teammates, and by anyone
+ *   at all) after the local window passes.
+ *
+ * The returned stop is ASYNC and must be AWAITED before the store closes — each sweep's first pass
+ * is asynchronous, so an un-awaited one dies on "database is not open" and puts a spurious error
+ * line on every clean exit.
+ */
+export function startMothershipTelemetrySweeps(deps) {
+    const stopRetention = startLocalTelemetryRetention(deps.store, deps.retention, deps.clock, deps.log);
+    const stopIngest = startTelemetryIngest({
+        reader: deps.store.ingestReader,
+        client: deps.client,
+        clock: deps.clock,
+        log: deps.log,
+    });
+    return async () => {
+        await stopRetention();
+        await stopIngest();
+    };
+}
+//# sourceMappingURL=telemetrySweeps.js.map

package/dist/telemetrySweeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetrySweeps.js","sourceRoot":"","sources":["../src/telemetrySweeps.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAiBtE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,8BAA8B,CAC5C,IAAkC;IAElC,MAAM,aAAa,GAAG,4BAA4B,CAChD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,GAAG,CACT,CAAA;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAA;IACF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,aAAa,EAAE,CAAA;QACrB,MAAM,UAAU,EAAE,CAAA;IACpB,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/local-server",
-  "version": "0.92.1",
+  "version": "0.93.1",
   "description": "Local-mode runtime facade for the Agent Architecture Board: the @cat-factory/node-server stack with agent jobs run as local Docker/Podman containers and GitHub accessed via a personal access token — a developer can run the whole product on their own machine.",
   "repository": {
     "type": "git",
@@ -27,23 +27,23 @@
     "@hono/node-server": "^2.0.12",
     "drizzle-orm": "1.0.0-rc.4",
     "ws": "^8.21.1",
-    "@cat-factory/agents": "0.94.0",
-    "@cat-factory/contracts": "0.202.0",
-    "@cat-factory/executor-harness": "1.82.0",
-    "@cat-factory/gitlab": "0.14.13",
-    "@cat-factory/integrations": "0.113.5",
-    "@cat-factory/kernel": "0.201.0",
-    "@cat-factory/node-server": "0.144.1",
-    "@cat-factory/orchestration": "0.177.1",
-    "@cat-factory/server": "0.185.2"
+    "@cat-factory/agents": "0.95.1",
+    "@cat-factory/contracts": "0.203.0",
+    "@cat-factory/executor-harness": "1.84.0",
+    "@cat-factory/gitlab": "0.14.15",
+    "@cat-factory/integrations": "0.113.7",
+    "@cat-factory/kernel": "0.202.0",
+    "@cat-factory/node-server": "0.145.0",
+    "@cat-factory/orchestration": "0.178.1",
+    "@cat-factory/server": "0.187.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
     "@types/ws": "^8.18.1",
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/conformance": "0.16.11",
-    "@cat-factory/gates": "0.8.30"
+    "@cat-factory/conformance": "0.16.13",
+    "@cat-factory/gates": "0.8.32"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",