@descryy/runtime-database-observation 0.3.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/collector-version.d.ts

@@ -1,10 +1,8 @@
 /**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
+ * `Evidence.collectorVersion` for every collector here: read from this
+ * package's own `package.json` "version" rather than hand-duplicated into
+ * a second string that can drift. Same idea as `nodeVersion`
+ * (`process.version`) applied to a package instead of the runtime.
  */
 export declare const COLLECTOR_VERSION: string;
 //# sourceMappingURL=collector-version.d.ts.map

package/dist/collector-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}
+{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}

package/dist/collector-version.js

@@ -1,10 +1,8 @@
 /**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
+ * `Evidence.collectorVersion` for every collector here: read from this
+ * package's own `package.json` "version" rather than hand-duplicated into
+ * a second string that can drift. Same idea as `nodeVersion`
+ * (`process.version`) applied to a package instead of the runtime.
  */
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);

package/dist/collector-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}
+{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}

package/dist/graph-mapping.d.ts

@@ -1,17 +1,14 @@
 /**
- * §10/§18's "graph correlation" row (RT-141's own disclosed gap, closed
- * here): resolving an observed `DATABASE_QUERY`'s captured table name to
- * the real `DATABASE_TABLE` graph node `resolveDatabaseTableNode`
- * (`@descryy/runtime-graph-correlator`) already knows how to find.
+ * §10/§18's graph correlation row (RT-141's disclosed gap, closed here):
+ * resolving an observed `DATABASE_QUERY`'s captured table name to the real
+ * `DATABASE_TABLE` graph node via `resolveDatabaseTableNode`
+ * (`@descryy/runtime-graph-correlator`).
  *
- * Same shape as `test-runner`'s own `resolveObservedTestCase`
- * (`graph-mapping.ts`), deliberately: a thin per-package translation, not a
- * new abstraction, and it does not call `EvidenceStore.attribute()` itself
- * — that needs the evidence's real `evidenceId`, which only exists after
- * `store.write()` has returned it, outside this collector's own reach, same
- * as every other collector's `graphNodeId: null`. The caller that already
- * holds both the store and the graph `driver` attributes; this only
- * resolves.
+ * Same shape as `test-runner`'s `resolveObservedTestCase`, deliberately: a
+ * thin per-package translation, not a new abstraction. Doesn't call
+ * `EvidenceStore.attribute()` itself — that needs the real `evidenceId`,
+ * which only exists after `store.write()` returns it. Caller attributes;
+ * this only resolves.
  */
 import type { SqlDriver } from "@descryy/core";
 import { type DatabaseTableResolution } from "@descryy/runtime-graph-correlator";

package/dist/graph-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-mapping.d.ts","sourceRoot":"","sources":["../src/graph-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC3G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,MAAM,+BAA+B,GACvC,uBAAuB,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC,EACjD,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,+BAA+B,CAkBjC"}
+{"version":3,"file":"graph-mapping.d.ts","sourceRoot":"","sources":["../src/graph-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC3G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,MAAM,+BAA+B,GACvC,uBAAuB,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC,EACjD,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,+BAA+B,CAkBjC"}

package/dist/graph-mapping.js

@@ -1,17 +1,14 @@
 /**
- * §10/§18's "graph correlation" row (RT-141's own disclosed gap, closed
- * here): resolving an observed `DATABASE_QUERY`'s captured table name to
- * the real `DATABASE_TABLE` graph node `resolveDatabaseTableNode`
- * (`@descryy/runtime-graph-correlator`) already knows how to find.
+ * §10/§18's graph correlation row (RT-141's disclosed gap, closed here):
+ * resolving an observed `DATABASE_QUERY`'s captured table name to the real
+ * `DATABASE_TABLE` graph node via `resolveDatabaseTableNode`
+ * (`@descryy/runtime-graph-correlator`).
  *
- * Same shape as `test-runner`'s own `resolveObservedTestCase`
- * (`graph-mapping.ts`), deliberately: a thin per-package translation, not a
- * new abstraction, and it does not call `EvidenceStore.attribute()` itself
- * — that needs the evidence's real `evidenceId`, which only exists after
- * `store.write()` has returned it, outside this collector's own reach, same
- * as every other collector's `graphNodeId: null`. The caller that already
- * holds both the store and the graph `driver` attributes; this only
- * resolves.
+ * Same shape as `test-runner`'s `resolveObservedTestCase`, deliberately: a
+ * thin per-package translation, not a new abstraction. Doesn't call
+ * `EvidenceStore.attribute()` itself — that needs the real `evidenceId`,
+ * which only exists after `store.write()` returns it. Caller attributes;
+ * this only resolves.
  */
 import { resolveDatabaseTableNode } from "@descryy/runtime-graph-correlator";
 /**

package/dist/graph-mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-mapping.js","sourceRoot":"","sources":["../src/graph-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,wBAAwB,EAAgC,MAAM,mCAAmC,CAAC;AAO3G;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAiB,EACjB,QAAiD,EACjD,UAAuC,EAAE;IAEzC,IAAI,QAAQ,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,0BAA0B,QAAQ,CAAC,SAAS,gHAAgH;SACrK,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAuC,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EACJ,wGAAwG;gBACxG,qEAAqE;SACxE,CAAC;IACJ,CAAC;IACD,OAAO,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"graph-mapping.js","sourceRoot":"","sources":["../src/graph-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,wBAAwB,EAAgC,MAAM,mCAAmC,CAAC;AAO3G;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAiB,EACjB,QAAiD,EACjD,UAAuC,EAAE;IAEzC,IAAI,QAAQ,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,0BAA0B,QAAQ,CAAC,SAAS,gHAAgH;SACrK,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAuC,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,MAAM,EACJ,wGAAwG;gBACxG,qEAAqE;SACxE,CAAC;IACJ,CAAC;IACD,OAAO,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/query-collector.d.ts

@@ -1,23 +1,19 @@
 /**
  * `DatabaseQueryCollector` (plan §18 / checklist §14): translates
  * `sqlite-instrumentation.ts`'s captured queries into `DATABASE_QUERY`
- * Evidence. Same shape as `LogCollector` (`@descryy/runtime-backend-observation`)
- * deliberately — a `ProcessOutputSource` in, `Evidence` out, streaming-first,
- * a collector failure reported as evidence rather than swallowed — but for
- * a different marker on the same stream.
+ * Evidence. Same shape as `LogCollector` deliberately — `ProcessOutputSource`
+ * in, `Evidence` out, streaming-first, a collector failure reported as
+ * evidence rather than swallowed — for a different marker on the same stream.
  *
- * **What this collector does not do, named rather than silently absent:**
- * no transaction-boundary tracking (BEGIN/COMMIT/ROLLBACK are captured as
- * ordinary queries, not grouped) — a real, still-open §14/§18 row.
+ * Does not do transaction-boundary tracking — BEGIN/COMMIT/ROLLBACK are
+ * captured as ordinary queries, not grouped (open §14/§18 row).
  *
- * **`graphNodeId` on emitted evidence is still always null here, same as
- * every other collector** (RT-076's own precedent, `test-runner-collector.ts`)
- * — `graph-mapping.ts`'s `resolveObservedDatabaseQuery` is what a caller
- * holding both the store and the graph driver uses to resolve a captured
- * table name to the real `DATABASE_TABLE` node and attribute it, after
- * `write()`, the same way `vertical-slice` already does for every other
- * evidence type. The resolver itself (RT-146) is real; this collector
- * simply isn't the one that calls it.
+ * `graphNodeId` on emitted evidence is always null here, same as every
+ * other collector (RT-076 precedent) — `graph-mapping.ts`'s
+ * `resolveObservedDatabaseQuery` is what a caller holding the store and
+ * driver uses to resolve the table and attribute it after `write()`, the
+ * way `vertical-slice` does for every evidence type. The resolver (RT-146)
+ * is real; this collector just isn't the one that calls it.
  */
 import type { Collector } from "@descryy/runtime-contracts";
 import { type ProcessOutputSource } from "@descryy/runtime-backend-observation";

package/dist/query-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-collector.d.ts","sourceRoot":"","sources":["../src/query-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAMvG,iNAAiN;AACjN,eAAO,MAAM,0BAA0B,QAAyE,CAAC;AAEjH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2BD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CAkG9F"}
+{"version":3,"file":"query-collector.d.ts","sourceRoot":"","sources":["../src/query-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAMvG,iNAAiN;AACjN,eAAO,MAAM,0BAA0B,QAAyE,CAAC;AAEjH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyBD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CAgG9F"}

package/dist/query-collector.js

@@ -1,23 +1,19 @@
 /**
  * `DatabaseQueryCollector` (plan §18 / checklist §14): translates
  * `sqlite-instrumentation.ts`'s captured queries into `DATABASE_QUERY`
- * Evidence. Same shape as `LogCollector` (`@descryy/runtime-backend-observation`)
- * deliberately — a `ProcessOutputSource` in, `Evidence` out, streaming-first,
- * a collector failure reported as evidence rather than swallowed — but for
- * a different marker on the same stream.
+ * Evidence. Same shape as `LogCollector` deliberately — `ProcessOutputSource`
+ * in, `Evidence` out, streaming-first, a collector failure reported as
+ * evidence rather than swallowed — for a different marker on the same stream.
  *
- * **What this collector does not do, named rather than silently absent:**
- * no transaction-boundary tracking (BEGIN/COMMIT/ROLLBACK are captured as
- * ordinary queries, not grouped) — a real, still-open §14/§18 row.
+ * Does not do transaction-boundary tracking — BEGIN/COMMIT/ROLLBACK are
+ * captured as ordinary queries, not grouped (open §14/§18 row).
  *
- * **`graphNodeId` on emitted evidence is still always null here, same as
- * every other collector** (RT-076's own precedent, `test-runner-collector.ts`)
- * — `graph-mapping.ts`'s `resolveObservedDatabaseQuery` is what a caller
- * holding both the store and the graph driver uses to resolve a captured
- * table name to the real `DATABASE_TABLE` node and attribute it, after
- * `write()`, the same way `vertical-slice` already does for every other
- * evidence type. The resolver itself (RT-146) is real; this collector
- * simply isn't the one that calls it.
+ * `graphNodeId` on emitted evidence is always null here, same as every
+ * other collector (RT-076 precedent) — `graph-mapping.ts`'s
+ * `resolveObservedDatabaseQuery` is what a caller holding the store and
+ * driver uses to resolve the table and attribute it after `write()`, the
+ * way `vertical-slice` does for every evidence type. The resolver (RT-146)
+ * is real; this collector just isn't the one that calls it.
  */
 import { fileURLToPath } from "node:url";
 import { extractCorrelationIds } from "@descryy/runtime-backend-observation";
@@ -42,9 +38,7 @@ function computeCapabilities() {
         sourceMapping: status,
         stackCapture: status,
         processLifecycle: status,
-        // The field this collector's own RT-141 entry named as missing and
-        // deferred (RT-142) -- closed here (RT-146), alongside the field's
-        // own addition to the contract.
+        // RT-141 named this missing, deferred as RT-142 -- closed here (RT-146).
         databaseObservation: { availability: "available", reason: null },
         externalServiceObservation: { availability: "unavailable", reason: "DatabaseQueryCollector instruments node:sqlite only; outbound requests are ExternalRequestCollector's to observe (RT-146)." },
     };
@@ -72,14 +66,12 @@ export function createDatabaseQueryCollector(options) {
             traceId,
             requestId,
             correlationId: null,
-            // Resolved later, by a caller holding the store and driver --
-            // resolveObservedDatabaseQuery (graph-mapping.ts), not here. Same
-            // split every other collector's graphNodeId already takes.
+            // Resolved later by a caller holding store+driver --
+            // resolveObservedDatabaseQuery (graph-mapping.ts), not here.
             graphNodeId: null,
             sourceLocation: null,
             stackTrace: null,
-            // The observation itself (a real captured call, real timing, real
-            // success/failure) is not probabilistic.
+            // Real captured call, real timing, real outcome -- not probabilistic.
             confidence: 1,
             redactionStatus: "pending-redaction",
             collectorVersion: COLLECTOR_VERSION,

package/dist/query-collector.js.map

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

package/dist/query-line-parser.d.ts

@@ -6,11 +6,9 @@
  */
 import { QUERY_MARKER, type CapturedMethod, type CapturedQuery } from "./query-marker.ts";
 /**
- * `null` for a non-matching line (ordinary application output) AND for a
- * line that starts with the marker but fails to parse as one of this
- * package's own captured queries — a malformed marker line is refused,
- * never guessed at, the same "wrong shape, not a wrong value" distinction
- * `test-runner`'s own `isNodeTestEvent` makes.
+ * `null` for a non-matching line AND for a line that starts with the
+ * marker but fails to parse -- a malformed marker line is refused, never
+ * guessed at (same distinction `test-runner`'s `isNodeTestEvent` makes).
  */
 export declare function parseQueryLine(line: string): CapturedQuery | null;
 export type { CapturedMethod, CapturedQuery };

package/dist/query-line-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-line-parser.d.ts","sourceRoot":"","sources":["../src/query-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAc1F;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAUjE;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"query-line-parser.d.ts","sourceRoot":"","sources":["../src/query-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAc1F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAUjE;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/query-line-parser.js

@@ -4,10 +4,9 @@
  * stdout/stderr — is not this parser's concern and is left alone; a
  * database collector does not also try to be a log collector.
  */
-// From `query-marker.ts`, never from `sqlite-instrumentation.ts`. That import
-// used to read as free — one string constant — and was not: it loaded a module
-// that patches `DatabaseSync.prototype` and writes to stdout at module scope,
-// into every consumer of this package's index.
+// From query-marker.ts, never sqlite-instrumentation.ts: that module patches
+// DatabaseSync.prototype and writes to stdout at module scope -- importing
+// it here would leak into every consumer of this package's index.
 import { QUERY_MARKER } from "./query-marker.js";
 function isCapturedQuery(value) {
     if (typeof value !== "object" || value === null)
@@ -20,11 +19,9 @@ function isCapturedQuery(value) {
         (v.error === null || typeof v.error === "string"));
 }
 /**
- * `null` for a non-matching line (ordinary application output) AND for a
- * line that starts with the marker but fails to parse as one of this
- * package's own captured queries — a malformed marker line is refused,
- * never guessed at, the same "wrong shape, not a wrong value" distinction
- * `test-runner`'s own `isNodeTestEvent` makes.
+ * `null` for a non-matching line AND for a line that starts with the
+ * marker but fails to parse -- a malformed marker line is refused, never
+ * guessed at (same distinction `test-runner`'s `isNodeTestEvent` makes).
  */
 export function parseQueryLine(line) {
     if (!line.startsWith(`${QUERY_MARKER} `))

package/dist/query-line-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-line-parser.js","sourceRoot":"","sources":["../src/query-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAA2C,MAAM,mBAAmB,CAAC;AAE1F,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS;QAC9B,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAGD,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"query-line-parser.js","sourceRoot":"","sources":["../src/query-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6EAA6E;AAC7E,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,EAAE,YAAY,EAA2C,MAAM,mBAAmB,CAAC;AAE1F,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS;QAC9B,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAGD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/query-marker.d.ts

@@ -2,25 +2,21 @@
  * The wire vocabulary shared by the two halves of database observation: the
  * marker prefix and the shape that follows it.
  *
- * This module exists to be **free of side effects**, and that is its entire
- * job. `sqlite-instrumentation.ts` — the other holder of these names until
- * now — patches `DatabaseSync.prototype` at module scope and writes to
- * stdout, which is right for a `--import` preload inside an observed process
- * and wrong everywhere else. `query-line-parser.ts` needed nothing from it
- * but the string `"DESCRY_DB_QUERY"`, and importing a string is still
- * importing a module: the patch and the stdout writer came along, through the
- * package index, into every consumer. Downstream that reached `@descryy/mcp`,
- * whose stdout is a JSON-RPC transport — one `analyze` call put 14,906
- * `DESCRY_DB_QUERY` lines into the protocol stream.
+ * Exists to be free of side effects -- that's its entire job.
+ * `sqlite-instrumentation.ts` patches `DatabaseSync.prototype` at module
+ * scope and writes to stdout, right for a `--import` preload in an
+ * observed process, wrong everywhere else. Importing just the string
+ * `"DESCRY_DB_QUERY"` from it still imports the module -- the patch and
+ * stdout writer came along through the package index into every consumer,
+ * reaching `@descryy/mcp`, whose stdout is a JSON-RPC transport: one
+ * `analyze` call put 14,906 `DESCRY_DB_QUERY` lines into the protocol stream.
  *
- * So: the emitter imports the vocabulary, the parser imports the vocabulary,
- * and neither imports the other. Anything added here must stay a constant or
- * a type. A function with a module-scope effect would rebuild the same trap
- * one file over.
+ * So: emitter and parser both import the vocabulary, neither imports the
+ * other. Anything added here must stay a constant or type -- a
+ * module-scope-effect function would rebuild the same trap.
  *
- * The prefix convention itself is the benchmark harness's `BENCH_RESULT
- * {json}` (RT-072): one line of structured JSON, never prose, because
- * scraping prose measures the prose.
+ * Prefix convention: the benchmark harness's `BENCH_RESULT {json}` (RT-072)
+ * -- one line of structured JSON, never prose.
  */
 export declare const QUERY_MARKER = "DESCRY_DB_QUERY";
 export type CapturedMethod = "exec" | "prepare" | "run" | "get" | "all";

package/dist/query-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-marker.d.ts","sourceRoot":"","sources":["../src/query-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,eAAO,MAAM,YAAY,oBAAsC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}
+{"version":3,"file":"query-marker.d.ts","sourceRoot":"","sources":["../src/query-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,eAAO,MAAM,YAAY,oBAAsC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/query-marker.js

@@ -2,29 +2,24 @@
  * The wire vocabulary shared by the two halves of database observation: the
  * marker prefix and the shape that follows it.
  *
- * This module exists to be **free of side effects**, and that is its entire
- * job. `sqlite-instrumentation.ts` — the other holder of these names until
- * now — patches `DatabaseSync.prototype` at module scope and writes to
- * stdout, which is right for a `--import` preload inside an observed process
- * and wrong everywhere else. `query-line-parser.ts` needed nothing from it
- * but the string `"DESCRY_DB_QUERY"`, and importing a string is still
- * importing a module: the patch and the stdout writer came along, through the
- * package index, into every consumer. Downstream that reached `@descryy/mcp`,
- * whose stdout is a JSON-RPC transport — one `analyze` call put 14,906
- * `DESCRY_DB_QUERY` lines into the protocol stream.
+ * Exists to be free of side effects -- that's its entire job.
+ * `sqlite-instrumentation.ts` patches `DatabaseSync.prototype` at module
+ * scope and writes to stdout, right for a `--import` preload in an
+ * observed process, wrong everywhere else. Importing just the string
+ * `"DESCRY_DB_QUERY"` from it still imports the module -- the patch and
+ * stdout writer came along through the package index into every consumer,
+ * reaching `@descryy/mcp`, whose stdout is a JSON-RPC transport: one
+ * `analyze` call put 14,906 `DESCRY_DB_QUERY` lines into the protocol stream.
  *
- * So: the emitter imports the vocabulary, the parser imports the vocabulary,
- * and neither imports the other. Anything added here must stay a constant or
- * a type. A function with a module-scope effect would rebuild the same trap
- * one file over.
+ * So: emitter and parser both import the vocabulary, neither imports the
+ * other. Anything added here must stay a constant or type -- a
+ * module-scope-effect function would rebuild the same trap.
  *
- * The prefix convention itself is the benchmark harness's `BENCH_RESULT
- * {json}` (RT-072): one line of structured JSON, never prose, because
- * scraping prose measures the prose.
+ * Prefix convention: the benchmark harness's `BENCH_RESULT {json}` (RT-072)
+ * -- one line of structured JSON, never prose.
  */
 import { RESERVED_MARKER_PREFIX } from "@descryy/runtime-contracts";
-// Derived, not spelled again: `RESERVED_MARKER_PREFIX` is what the
-// backend log collector skips on, so a marker that did not use it would
-// come back as the application's own log output.
+// Derived, not spelled again -- RESERVED_MARKER_PREFIX is what the backend
+// log collector skips on; a marker without it reads as application output.
 export const QUERY_MARKER = `${RESERVED_MARKER_PREFIX}DB_QUERY`;
 //# sourceMappingURL=query-marker.js.map

package/dist/query-marker.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-marker.js","sourceRoot":"","sources":["../src/query-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,mEAAmE;AACnE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,sBAAsB,UAAU,CAAC"}
+{"version":3,"file":"query-marker.js","sourceRoot":"","sources":["../src/query-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,2EAA2E;AAC3E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,sBAAsB,UAAU,CAAC"}

package/dist/sqlite-instrumentation.d.ts

@@ -1,23 +1,18 @@
 /**
  * `--import`-loaded preload: patches `node:sqlite`'s `DatabaseSync`
- * prototype before the target application's own code runs, so every real
- * query the application issues through its own `import { DatabaseSync }
- * from "node:sqlite"` is observed — proven directly (a probe script, not
- * assumed): Node's built-in modules are a process-wide singleton, so a
- * `--import` preload patching `DatabaseSync.prototype` here and an
- * application's completely separate `import` of the same built-in later
- * see the same prototype object.
+ * prototype before the target application's code runs, so every real query
+ * through the app's own `import { DatabaseSync } from "node:sqlite"` is
+ * observed -- verified directly (probe script): Node's built-in modules
+ * are a process-wide singleton, so a `--import` preload and the app's own
+ * later import see the same prototype object.
  *
- * Deliberately minimal and import-free, like `test-runner`'s own
- * `reporter.ts` — this runs inside the OBSERVED process, not this
- * package's own, and is loaded by absolute path via `node --import`, never
- * through this package's normal dependency graph. Interpretation (target
- * table, correlation ids) happens on the collector side, in the observing
- * process, not here — this only captures.
+ * Deliberately minimal and import-free, like `test-runner`'s `reporter.ts`
+ * -- runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * One line of structured JSON per query, prefixed exactly like the
- * benchmark harness's own `BENCH_RESULT {json}` convention (RT-072):
- * scraping prose measures the prose, so nothing here is prose.
+ * One line of structured JSON per query, same convention as the benchmark
+ * harness's `BENCH_RESULT {json}` (RT-072).
  */
 export {};
 //# sourceMappingURL=sqlite-instrumentation.d.ts.map

package/dist/sqlite-instrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-instrumentation.d.ts","sourceRoot":"","sources":["../src/sqlite-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"sqlite-instrumentation.d.ts","sourceRoot":"","sources":["../src/sqlite-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/sqlite-instrumentation.js

@@ -1,30 +1,24 @@
 /**
  * `--import`-loaded preload: patches `node:sqlite`'s `DatabaseSync`
- * prototype before the target application's own code runs, so every real
- * query the application issues through its own `import { DatabaseSync }
- * from "node:sqlite"` is observed — proven directly (a probe script, not
- * assumed): Node's built-in modules are a process-wide singleton, so a
- * `--import` preload patching `DatabaseSync.prototype` here and an
- * application's completely separate `import` of the same built-in later
- * see the same prototype object.
+ * prototype before the target application's code runs, so every real query
+ * through the app's own `import { DatabaseSync } from "node:sqlite"` is
+ * observed -- verified directly (probe script): Node's built-in modules
+ * are a process-wide singleton, so a `--import` preload and the app's own
+ * later import see the same prototype object.
  *
- * Deliberately minimal and import-free, like `test-runner`'s own
- * `reporter.ts` — this runs inside the OBSERVED process, not this
- * package's own, and is loaded by absolute path via `node --import`, never
- * through this package's normal dependency graph. Interpretation (target
- * table, correlation ids) happens on the collector side, in the observing
- * process, not here — this only captures.
+ * Deliberately minimal and import-free, like `test-runner`'s `reporter.ts`
+ * -- runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * One line of structured JSON per query, prefixed exactly like the
- * benchmark harness's own `BENCH_RESULT {json}` convention (RT-072):
- * scraping prose measures the prose, so nothing here is prose.
+ * One line of structured JSON per query, same convention as the benchmark
+ * harness's `BENCH_RESULT {json}` (RT-072).
  */
 import { DatabaseSync } from "node:sqlite";
-// The vocabulary lives in a module with no side effects of its own, and the
-// direction matters: this file imports it, nothing imports this file. The
-// parser once reached in here for `QUERY_MARKER` alone and took the prototype
-// patch and the stdout writer with it, all the way into a JSON-RPC transport.
-// See `query-marker.ts` for the measurement.
+// query-marker.ts has no side effects; direction matters -- this file
+// imports it, nothing imports this file. Importing QUERY_MARKER alone from
+// here once dragged the prototype patch and stdout writer into a JSON-RPC
+// transport. See query-marker.ts for the measurement.
 import { QUERY_MARKER } from "./query-marker.js";
 function emit(query) {
     process.stdout.write(`${QUERY_MARKER} ${JSON.stringify(query)}\n`);
@@ -63,10 +57,9 @@ if (target[PATCHED] !== true) {
                 return timed(sql, method, () => original.apply(stmt, args));
             };
         }
-        // `iterate()` deliberately left unwrapped: it returns a lazy generator,
-        // so "duration" would mean the time to build the iterator, not the
-        // time to consume it -- a different, misleading number under the same
-        // name. Disclosed here rather than measured wrong.
+        // iterate() deliberately unwrapped: it returns a lazy generator, so
+        // "duration" would measure building the iterator, not consuming it --
+        // disclosed rather than measured wrong.
         return stmt;
     };
 }

package/dist/sqlite-instrumentation.js.map

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

package/dist/table-extraction.d.ts

@@ -1,22 +1,19 @@
 /**
  * Extracts the single target table a DML statement names — deliberately
- * not a SQL parser, same reasoning `adapter-sql`'s `parse.ts` gives for
- * its own DDL-only scope: a bounded reader that recognises a few shapes
- * and refuses (`null`) on everything else is honest; a reader that guesses
- * at a JOIN or a subquery is not.
+ * not a SQL parser, same reasoning `adapter-sql`'s `parse.ts` gives for its
+ * own DDL-only scope: a bounded reader that recognises a few shapes and
+ * refuses (`null`) on the rest is honest; guessing at a JOIN or subquery
+ * isn't.
  *
- * `adapter-sql` (descry-adapters) reads CREATE/ALTER — schema declaration.
- * This reads INSERT/UPDATE/DELETE/SELECT — a different problem (which
- * table did a query at RUNTIME actually touch), so its own small reader
- * rather than a false shared abstraction over two different questions.
+ * `adapter-sql` reads CREATE/ALTER (schema declaration); this reads
+ * INSERT/UPDATE/DELETE/SELECT (which table a query touched at RUNTIME) --
+ * a different question, its own small reader rather than a false shared
+ * abstraction.
  *
- * **Refused, not guessed, for:** a JOIN anywhere in the statement (which
- * table is "the" table is genuinely ambiguous), a comma-separated FROM
- * list (old-style implicit join, same ambiguity), a subquery in FROM, a
- * CTE (`WITH ... AS`), and anything this reader does not recognise the
- * shape of at all. The wrong-table negative control this package's tests
- * assert on is exactly this: a two-table JOIN must resolve to `null`, not
- * to either table picked arbitrarily.
+ * Refused, not guessed: a JOIN anywhere, a comma-separated FROM list
+ * (old-style implicit join), a subquery in FROM, a CTE, or an unrecognised
+ * shape. Tested negative control: a two-table JOIN must resolve to `null`,
+ * not either table picked arbitrarily.
  */
 /**
  * `null` for anything not recognised as exactly one of INSERT/UPDATE/

package/dist/table-extraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-extraction.d.ts","sourceRoot":"","sources":["../src/table-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA8BH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB7D"}
+{"version":3,"file":"table-extraction.d.ts","sourceRoot":"","sources":["../src/table-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8BH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB7D"}

package/dist/table-extraction.js

@@ -1,22 +1,19 @@
 /**
  * Extracts the single target table a DML statement names — deliberately
- * not a SQL parser, same reasoning `adapter-sql`'s `parse.ts` gives for
- * its own DDL-only scope: a bounded reader that recognises a few shapes
- * and refuses (`null`) on everything else is honest; a reader that guesses
- * at a JOIN or a subquery is not.
+ * not a SQL parser, same reasoning `adapter-sql`'s `parse.ts` gives for its
+ * own DDL-only scope: a bounded reader that recognises a few shapes and
+ * refuses (`null`) on the rest is honest; guessing at a JOIN or subquery
+ * isn't.
  *
- * `adapter-sql` (descry-adapters) reads CREATE/ALTER — schema declaration.
- * This reads INSERT/UPDATE/DELETE/SELECT — a different problem (which
- * table did a query at RUNTIME actually touch), so its own small reader
- * rather than a false shared abstraction over two different questions.
+ * `adapter-sql` reads CREATE/ALTER (schema declaration); this reads
+ * INSERT/UPDATE/DELETE/SELECT (which table a query touched at RUNTIME) --
+ * a different question, its own small reader rather than a false shared
+ * abstraction.
  *
- * **Refused, not guessed, for:** a JOIN anywhere in the statement (which
- * table is "the" table is genuinely ambiguous), a comma-separated FROM
- * list (old-style implicit join, same ambiguity), a subquery in FROM, a
- * CTE (`WITH ... AS`), and anything this reader does not recognise the
- * shape of at all. The wrong-table negative control this package's tests
- * assert on is exactly this: a two-table JOIN must resolve to `null`, not
- * to either table picked arbitrarily.
+ * Refused, not guessed: a JOIN anywhere, a comma-separated FROM list
+ * (old-style implicit join), a subquery in FROM, a CTE, or an unrecognised
+ * shape. Tested negative control: a two-table JOIN must resolve to `null`,
+ * not either table picked arbitrarily.
  */
 const IDENTIFIER = String.raw `(?:\[[^\]]+\]|"[^"]+"|` + "`[^`]+`" + String.raw `|[A-Za-z_][A-Za-z0-9_]*)`;
 const QUALIFIED = `${IDENTIFIER}(?:\\.${IDENTIFIER})?`;

package/dist/table-extraction.js.map

@@ -1 +1 @@
-{"version":3,"file":"table-extraction.js","sourceRoot":"","sources":["../src/table-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA,wBAAwB,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA,0BAA0B,CAAC;AACzG,MAAM,SAAS,GAAG,GAAG,UAAU,SAAS,UAAU,IAAI,CAAC;AAEvD,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAC7E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAChE,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAC7E,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,eAAe,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAEjE,qHAAqH;AACrH,MAAM,SAAS,GAAG,8BAA8B,CAAC;AAEjD,SAAS,OAAO,CAAC,UAAkB;IACjC,OAAO,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,qJAAqJ;AACrJ,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC7B,CAAC;AAED,2JAA2J;AAC3J,SAAS,iBAAiB,CAAC,GAAW,EAAE,QAAgB;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,WAAW,KAAK,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAElD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpF,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"table-extraction.js","sourceRoot":"","sources":["../src/table-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA,wBAAwB,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA,0BAA0B,CAAC;AACzG,MAAM,SAAS,GAAG,GAAG,UAAU,SAAS,UAAU,IAAI,CAAC;AAEvD,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAC7E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAChE,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,2BAA2B,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAC7E,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,eAAe,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;AAEjE,qHAAqH;AACrH,MAAM,SAAS,GAAG,8BAA8B,CAAC;AAEjD,SAAS,OAAO,CAAC,UAAkB;IACjC,OAAO,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,qJAAqJ;AACrJ,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC7B,CAAC;AAED,2JAA2J;AAC3J,SAAS,iBAAiB,CAAC,GAAW,EAAE,QAAgB;IACtD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,WAAW,KAAK,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAElD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpF,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@descryy/runtime-database-observation",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Database query observation (plan \u00a718, checklist \u00a714): real DATABASE_QUERY capture via driver instrumentation, never parsed application logs. Driver #1 is node:sqlite.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-runtime.git",
+    "directory": "packages/database-observation"
+  },
   "engines": {
     "node": ">=22.5"
   },
@@ -24,9 +29,9 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.2.0",
-    "@descryy/runtime-backend-observation": "0.2.0",
-    "@descryy/runtime-graph-correlator": "0.3.0"
+    "@descryy/runtime-contracts": "0.3.0",
+    "@descryy/runtime-backend-observation": "0.3.0",
+    "@descryy/runtime-graph-correlator": "0.4.0"
   },
   "devDependencies": {
     "@descryy/runtime-controller": "*",