opencode-swarm 7.165.0 → 7.166.1

package/dist/cli/{scope-persistence-6c55akfz.js → scope-persistence-q792yfxh.js}

@@ -23,32 +23,32 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-3xyjvx24.js";
-import"./index-y1zhpfk8.js";
-import"./index-xwbn7c8m.js";
-import"./index-556ja8an.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
+} from "./index-xwkn5hse.js";
+import"./index-2y4kargd.js";
+import"./index-2v17wb75.js";
+import"./index-79sr3fd1.js";
+import"./index-jx9f4ke1.js";
+import"./index-aftapk6j.js";
 import"./index-ry16d01s.js";
 import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
+import"./index-axf65x87.js";
+import"./index-bkd3450m.js";
 import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
+import"./index-a7rw4g4s.js";
 import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
+import"./index-edm41q4j.js";
 import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
+import"./index-hwj25q9r.js";
 import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
+import"./index-52xdezsh.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
+import"./index-wf12wckd.js";
+import"./index-0tc0pcmh.js";
+import"./index-zpsr8rpc.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
+import"./index-yzjaj53h.js";
 import"./index-zgwm4ryv.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{skill-generator-mv5jxzsh.js → skill-generator-g8wbjw6v.js}

@@ -33,33 +33,33 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-6be5caj8.js";
+} from "./index-066xxa4q.js";
 import"./index-q7sjgr1y.js";
-import"./index-gn6ybsc4.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
+import"./index-zha9bdj9.js";
+import"./index-bfr392e7.js";
+import"./index-ee6ydtfe.js";
 import"./index-p612v1mv.js";
-import"./index-2k53pfnc.js";
-import"./index-ajknebrc.js";
+import"./index-6rff2h8x.js";
+import"./index-c20gf089.js";
 import"./index-rtry5xyf.js";
-import"./index-58be2gtd.js";
+import"./index-nph5g4em.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
+import"./index-axf65x87.js";
+import"./index-bkd3450m.js";
 import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
+import"./index-a7rw4g4s.js";
 import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
+import"./index-edm41q4j.js";
 import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
+import"./index-hwj25q9r.js";
 import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
+import"./index-52xdezsh.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
+import"./index-wf12wckd.js";
+import"./index-0tc0pcmh.js";
+import"./index-zpsr8rpc.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{snapshot-coordination-init-n556wa18.js → snapshot-coordination-init-y6spakwm.js}

@@ -8,68 +8,68 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-hwz46jj7.js";
-import"./index-8d90gzaz.js";
-import"./index-f36hy1x4.js";
-import"./index-hdakb4n9.js";
-import"./index-k1ntjzmf.js";
-import"./index-5ythtd9t.js";
-import"./index-tqw8w2n5.js";
+} from "./index-399nq780.js";
+import"./index-2sqgbmtq.js";
+import"./index-hvk3zs62.js";
+import"./index-gr8ppbq3.js";
+import"./index-8fr2wn18.js";
+import"./index-0g5v4s0x.js";
+import"./index-17yszqs5.js";
 import"./index-txdagbh7.js";
 import"./index-cw912re7.js";
-import"./index-6be5caj8.js";
-import"./index-n3pjcks8.js";
-import"./index-g8wdekzz.js";
+import"./index-066xxa4q.js";
+import"./index-13egyjgv.js";
+import"./index-ybcxvv17.js";
 import"./index-70ha9e09.js";
-import"./index-dh5th4jn.js";
+import"./index-8hqkrd2j.js";
 import"./index-9ss2m4rs.js";
-import"./index-ptsqnxwd.js";
+import"./index-xezfx7ge.js";
 import"./index-zsrtt42s.js";
-import"./index-7h94rfem.js";
+import"./index-k5w284js.js";
 import"./index-6chhqq2n.js";
-import"./index-8bdk7124.js";
+import"./index-1zqf2pny.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-e6n7cemz.js";
-import"./index-p7hdp3rp.js";
-import"./index-afpkqsdb.js";
-import"./index-gn6ybsc4.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
+import"./index-yt25kpvz.js";
+import"./index-fc1dqzjp.js";
+import"./index-w11whwn3.js";
+import"./index-zha9bdj9.js";
+import"./index-bfr392e7.js";
+import"./index-ee6ydtfe.js";
 import"./index-p612v1mv.js";
-import"./index-2k53pfnc.js";
-import"./index-ajknebrc.js";
+import"./index-6rff2h8x.js";
+import"./index-c20gf089.js";
 import"./index-rtry5xyf.js";
-import"./index-58be2gtd.js";
+import"./index-nph5g4em.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-3xyjvx24.js";
-import"./index-y1zhpfk8.js";
-import"./index-xwbn7c8m.js";
-import"./index-556ja8an.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
+import"./index-xwkn5hse.js";
+import"./index-2y4kargd.js";
+import"./index-2v17wb75.js";
+import"./index-79sr3fd1.js";
+import"./index-jx9f4ke1.js";
+import"./index-aftapk6j.js";
 import"./index-ry16d01s.js";
 import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
+import"./index-axf65x87.js";
+import"./index-bkd3450m.js";
 import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
+import"./index-a7rw4g4s.js";
 import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
+import"./index-edm41q4j.js";
 import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
+import"./index-hwj25q9r.js";
 import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
+import"./index-52xdezsh.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
+import"./index-wf12wckd.js";
+import"./index-0tc0pcmh.js";
+import"./index-zpsr8rpc.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
-import"./index-4fwbbad3.js";
+import"./index-q1r1cfww.js";
+import"./index-yzjaj53h.js";
 import"./index-zgwm4ryv.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{telemetry-a1yvjerj.js → telemetry-9h1z2w9d.js}

@@ -14,7 +14,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-5ebgzb5a.js";
+} from "./index-hwj25q9r.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{worktree-collision-ownership-pp4z4z8p.js → worktree-collision-ownership-pmpnftkd.js}

@@ -6,38 +6,38 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-8bdk7124.js";
+} from "./index-1zqf2pny.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-afpkqsdb.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
+} from "./index-w11whwn3.js";
+import"./index-bfr392e7.js";
+import"./index-ee6ydtfe.js";
 import {
   bunSpawn
 } from "./index-p612v1mv.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
+import"./index-79sr3fd1.js";
+import"./index-jx9f4ke1.js";
+import"./index-aftapk6j.js";
 import"./index-ry16d01s.js";
 import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
+import"./index-axf65x87.js";
+import"./index-bkd3450m.js";
 import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
+import"./index-a7rw4g4s.js";
 import {
   canonicalRootKeyFresh
 } from "./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
+import"./index-edm41q4j.js";
 import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
+import"./index-hwj25q9r.js";
 import"./index-7g4c7s5r.js";
 import {
   init_git_executable,
   resolveGitExecutable
 } from "./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-zjygnfay.js";
+import"./index-zpsr8rpc.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{worktree-isolation-69hz9dgg.js → worktree-isolation-4053n0px.js}

@@ -21,70 +21,70 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-hwz46jj7.js";
-import"./index-8d90gzaz.js";
-import"./index-f36hy1x4.js";
-import"./index-hdakb4n9.js";
-import"./index-k1ntjzmf.js";
-import"./index-5ythtd9t.js";
-import"./index-tqw8w2n5.js";
+} from "./index-399nq780.js";
+import"./index-2sqgbmtq.js";
+import"./index-hvk3zs62.js";
+import"./index-gr8ppbq3.js";
+import"./index-8fr2wn18.js";
+import"./index-0g5v4s0x.js";
+import"./index-17yszqs5.js";
 import"./index-txdagbh7.js";
 import"./index-cw912re7.js";
-import"./index-6be5caj8.js";
-import"./index-n3pjcks8.js";
-import"./index-g8wdekzz.js";
+import"./index-066xxa4q.js";
+import"./index-13egyjgv.js";
+import"./index-ybcxvv17.js";
 import"./index-70ha9e09.js";
-import"./index-dh5th4jn.js";
+import"./index-8hqkrd2j.js";
 import"./index-9ss2m4rs.js";
-import"./index-ptsqnxwd.js";
+import"./index-xezfx7ge.js";
 import"./index-zsrtt42s.js";
-import"./index-7h94rfem.js";
+import"./index-k5w284js.js";
 import"./index-6chhqq2n.js";
-import"./index-8bdk7124.js";
+import"./index-1zqf2pny.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-e6n7cemz.js";
-import"./index-p7hdp3rp.js";
-import"./index-afpkqsdb.js";
-import"./index-gn6ybsc4.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
+import"./index-yt25kpvz.js";
+import"./index-fc1dqzjp.js";
+import"./index-w11whwn3.js";
+import"./index-zha9bdj9.js";
+import"./index-bfr392e7.js";
+import"./index-ee6ydtfe.js";
 import"./index-p612v1mv.js";
-import"./index-2k53pfnc.js";
-import"./index-ajknebrc.js";
+import"./index-6rff2h8x.js";
+import"./index-c20gf089.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-58be2gtd.js";
+} from "./index-nph5g4em.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-3xyjvx24.js";
-import"./index-y1zhpfk8.js";
-import"./index-xwbn7c8m.js";
-import"./index-556ja8an.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
+import"./index-xwkn5hse.js";
+import"./index-2y4kargd.js";
+import"./index-2v17wb75.js";
+import"./index-79sr3fd1.js";
+import"./index-jx9f4ke1.js";
+import"./index-aftapk6j.js";
 import"./index-ry16d01s.js";
 import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
+import"./index-axf65x87.js";
+import"./index-bkd3450m.js";
 import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
+import"./index-a7rw4g4s.js";
 import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
+import"./index-edm41q4j.js";
 import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
+import"./index-hwj25q9r.js";
 import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
+import"./index-52xdezsh.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
+import"./index-wf12wckd.js";
+import"./index-0tc0pcmh.js";
+import"./index-zpsr8rpc.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
-import"./index-4fwbbad3.js";
+import"./index-q1r1cfww.js";
+import"./index-yzjaj53h.js";
 import"./index-zgwm4ryv.js";
 import"./index-a76rekgs.js";
 export {

package/dist/commands/pr-monitor-status.d.ts

@@ -9,6 +9,7 @@
  * Input contract (no args):
  *   /swarm pr status                              → show session subscriptions
  */
+import { getPrMonitorWorkerHealth } from '../background/pr-monitor-worker.js';
 import { getPrSubscriptionHealth, listActive, type PrSubscriptionHealth } from '../background/pr-subscriptions.js';
 type MergeGroupRun = {
     databaseId: number;
@@ -54,6 +55,7 @@ export declare const _internals: {
     listMergeGroupRuns: typeof listMergeGroupRuns;
     parseMergeGroupRuns: typeof parseMergeGroupRuns;
     getPrSubscriptionHealth: typeof getPrSubscriptionHealth;
+    getPrMonitorWorkerHealth: typeof getPrMonitorWorkerHealth;
 };
 /**
  * Show PR monitor subscription status for the current session.

package/dist/commands/registry.d.ts

@@ -489,6 +489,14 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "diagnostics";
         readonly toolPolicy: "agent";
     };
+    readonly report: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Report swarm observability events from the SQLite query authority [--task <id>] [--session <id>] [--trace <id>] [--run <batchId>] [--since <ISO-8601>] [--json]";
+        readonly args: "--task <id>, --session <id>, --trace <id>, --run <batchId>, --since <ISO-8601>, --json";
+        readonly details: "Bounded, deterministic query over the observability events store in .swarm/swarm.db (the first run performs a bounded, idempotent legacy-import into the local sink). --run filters the lane/dispatch batch axis (workflow.batchId). Unmatched delegation begins are disclosed, never fabricated into ends. --json emits a schemaVersion-tagged block.";
+        readonly category: "diagnostics";
+        readonly toolPolicy: "agent";
+    };
     readonly learning: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Show learning metrics and violation trends";

package/dist/commands/report.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `/swarm report` — bounded, deterministic observability report over the
+ * SQLite-native query authority (issue #2482 / D3, absorbing #2048).
+ *
+ * - Read-only. Queries `.swarm/swarm.db` `observability_event` via the
+ *   bounded store queries (`src/db/observability-event-store.ts`); lazily
+ *   syncs the rebuildable legacy import (`syncObservabilityImport`) FIRST so
+ *   the report covers the bounded `telemetry.jsonl(.1)` window too.
+ * - Filters: `--task <id>` (workflow.taskId), `--session <id>`
+ *   (hostSessionId), `--trace <id>` (traceId), `--run <id>` (workflow.batchId
+ *   — the lane/dispatch batch axis; `prRunId`/`backgroundInvocationId` have
+ *   no producers today), `--since <ISO-8601>` (inclusive lower bound).
+ *   `--json` emits a versioned JSON block. Each value flag may appear at
+ *   most once with a non-empty value; any subset is valid.
+ * - Bounded: row cap + truncated flag (`MAX_REPORT_ROWS`), ordering is
+ *   `occurred_at, rowid` (code-unit string compare — no locale collation),
+ *   so the same query window yields byte-identical output (proven by test).
+ * - Honest coverage: live vs imported row counts, quarantined rows (excluded
+ *   from the timeline), the sink's own health counters, and the delegation
+ *   begin/end pairing delta — unmatched begins are DISCLOSED, never
+ *   fabricated into ends.
+ * - Fail-open: a missing/unopenable store yields an explicit empty report
+ *   with `coverage.unavailable`, never an error.
+ */
+import { type ObservabilityEventFilter } from '../db/observability-event-store.js';
+export declare const REPORT_JSON_SCHEMA_VERSION = 1;
+interface ParsedReportArgs {
+    filter: ObservabilityEventFilter;
+    json: boolean;
+}
+export declare function parseReportArgs(args: string[]): {
+    parsed?: ParsedReportArgs;
+    error?: string;
+};
+export declare function handleReportCommand(directory: string, args: string[]): Promise<string>;
+export {};

package/dist/db/observability-event-store.d.ts

@@ -0,0 +1,162 @@
+/**
+ * swarm.db store for the canonical observability event envelope (issue #2482,
+ * Workstream D PR 3).
+ *
+ * The durable local query authority for observability events:
+ *
+ * - Table `observability_event` — one row per emitted canonical
+ *   `ObservabilityEvent`, appended through the group-commit writer (queue ->
+ *   one txn per flush). Durability class `normal` (rebuildable telemetry
+ *   sink; the bounded `.swarm/telemetry.jsonl` stream remains the
+ *   operational legacy record — this store does NOT replace it).
+ * - The sink registers as a TELEMETRY LISTENER (`registerObservabilityEventSink`),
+ *   not as an `emit()` call site: the retention-registry writer-coverage
+ *   ratchet requires every writer module to appear in exactly one registry
+ *   row, and `src/telemetry.ts` is already owned by the `telemetry-jsonl`
+ *   row. The listener receives the canonical envelope as its third
+ *   parameter.
+ * - Zero top-level executable side effects; no DB work at plugin init. The
+ *   DB handle opens lazily on the first sink append (`getProjectDb` /
+ *   `getGroupCommitWriter` are invoked inside the listener closure, matching
+ *   the `insight-candidate-store.ts` precedent). Processes that never
+ *   register the sink (direct CLI / test scripts) simply get no SQLite sink —
+ *   fail-open, never an error.
+ * - Fail-open everywhere: sink failures are counted (bounded in-memory
+ *   counters persisted opportunistically into `observability_sink_health`)
+ *   and never propagate. The sink is non-authoritative for every decision;
+ *   observability health is surfaced through `/swarm report`.
+ * - Malformed events are QUARANTINED, not dropped: rows that cannot carry a
+ *   faithful envelope (fallback observations, oversize payloads, unparseable
+ *   legacy import lines) are stored with `quarantined = 1` plus a reason and
+ *   excluded from report timelines while remaining countable.
+ * - Rebuildable: `syncObservabilityImport` (report path only — never per
+ *   emit, never at init) incrementally imports the bounded legacy
+ *   `telemetry.jsonl(.1)` stream using deterministic per-line synthetic ids,
+ *   so deleting the imported rows and re-syncing reproduces byte-identical
+ *   content (proven by test).
+ */
+import type { ObservabilityEvent } from '../observability/envelope.js';
+import { extractWorkflowIds } from '../observability/legacy.js';
+import { getGroupCommitWriter } from './group-commit-writer.js';
+import { getProjectDb } from './project-db.js';
+/** Hard cap on retained observability rows (DELETE-based retention). */
+export declare const MAX_OBSERVABILITY_EVENT_ROWS = 50000;
+/** Rows past this many accepted events get a retention check appended. */
+export declare const RETENTION_CHECK_INTERVAL = 512;
+/** Health-counter deltas are persisted at most this often (events). */
+export declare const HEALTH_UPSERT_INTERVAL = 256;
+/** Hard cap on a single serialized payload (oversize → quarantined stub). */
+export declare const MAX_EVENT_PAYLOAD_BYTES: number;
+export type IngestedVia = 'live' | 'import';
+export interface ObservabilityEventRow {
+    rowid: number;
+    event_id: string;
+    kind: string;
+    category: string | null;
+    severity: string | null;
+    occurred_at: string;
+    writer_sequence: number | null;
+    trace_id: string | null;
+    span_id: string | null;
+    host_session_id: string | null;
+    task_id: string | null;
+    lane_id: string | null;
+    batch_id: string | null;
+    phase_id: string | null;
+    council_round_id: string | null;
+    project_ref: string | null;
+    outcome_status: string | null;
+    retry_index: number | null;
+    privacy_class: string | null;
+    sampled: number | null;
+    payload_json: string;
+    relationship_violations: string | null;
+    quarantined: number;
+    quarantine_reason: string | null;
+    ingested_via: string;
+}
+export interface ObservabilitySinkHealth {
+    accepted: number;
+    quarantined: number;
+    dropped: number;
+    last_error_category: string | null;
+    last_error_at: string | null;
+    last_flush_at: string | null;
+    updated_at: string | null;
+}
+/** Filter set for bounded report queries. Every field optional. */
+export interface ObservabilityEventFilter {
+    taskId?: string;
+    sessionId?: string;
+    traceId?: string;
+    batchId?: string;
+    /** Inclusive lower bound on `occurred_at` (ISO-8601 string compare). */
+    since?: string;
+}
+/**
+ * Register the SQLite observability sink as a telemetry listener for this
+ * project root. O(1), idempotent, never opens the DB, never throws — safe to
+ * call immediately before `initTelemetry` on the plugin init path. Registering
+ * with a DIFFERENT directory evicts the previous listener first, so exactly
+ * one sink listener is ever on the telemetry bus (per-directory counters live
+ * in their own maps and simply resume under the new binding).
+ */
+export declare function registerObservabilityEventSink(directory: string): void;
+/** Test/reset hook: drops the listener and forgets the binding. */
+export declare function resetObservabilityEventSinkForTesting(): void;
+/**
+ * Append one canonical event to the SQLite query authority via the
+ * group-commit writer (durability `normal`). Fail-open contract: throws are
+ * the CALLER's to swallow (the sink listener does). In-memory health counters
+ * track accepted/quarantined; retention + health persistence are appended to
+ * the same batch on their throttle intervals so they can never race a live
+ * append.
+ */
+export declare function appendObservabilityEventDb(directory: string, canonical: ObservabilityEvent): void;
+export interface ObservabilityImportResult {
+    imported: number;
+    quarantined: number;
+    skippedUnchanged: boolean;
+}
+/**
+ * Incrementally import the bounded legacy `telemetry.jsonl(.1)` stream into
+ * the query authority. Deterministic and idempotent: per-file markers record
+ * (size, mtime, lines_seen); append-only growth imports just the delta;
+ * rotation/shrink (or a deleted/recreated file) triggers a full rescan whose
+ * content-derived synthetic ids make every re-insert a no-op (`INSERT OR
+ * IGNORE`). Runs only from the report path — never per emit, never at init.
+ * Files are read oldest-generation first so rowid order tracks event order.
+ */
+export declare function syncObservabilityImport(directory: string): ObservabilityImportResult;
+/** Row cap for a single report query (#2048 bounded output budget). */
+export declare const MAX_REPORT_ROWS = 5000;
+export interface ObservabilityQueryResult {
+    rows: ObservabilityEventRow[];
+    truncated: boolean;
+    totalMatching: number;
+}
+/**
+ * Bounded, deterministic query over the query authority. Filters are exact
+ * bound parameters (node:sqlite strictness — counts are exact per branch);
+ * ordering is code-unit string compare on ISO timestamps plus rowid — no
+ * locale-dependent collation. Quarantined rows are excluded from timelines.
+ */
+export declare function queryObservabilityEvents(directory: string, filter: ObservabilityEventFilter): ObservabilityQueryResult;
+/** Cumulative persisted sink health (never opens a DB when absent). */
+export declare function readObservabilitySinkHealth(directory: string): ObservabilitySinkHealth | null;
+/** Coverage snapshot for report disclosure (live/imported/quarantined). */
+export interface ObservabilityCoverage {
+    liveRows: number;
+    importedRows: number;
+    quarantinedRows: number;
+    totalRows: number;
+    earliestOccurredAt: string | null;
+    latestOccurredAt: string | null;
+}
+export declare function readObservabilityCoverage(directory: string): ObservabilityCoverage | null;
+/** DI seam (repo `_internals` convention). */
+export declare const _internals: {
+    getProjectDb: typeof getProjectDb;
+    getGroupCommitWriter: typeof getGroupCommitWriter;
+    extractWorkflowIds: typeof extractWorkflowIds;
+};