@aaac/observability 0.1.14 → 0.1.15

package/dist/cli/index.js

@@ -1,21 +1,27 @@
 #!/usr/bin/env node
+import {
+  handleRecordHook
+} from "../chunk-EKFRH7PX.js";
 import {
   DEFAULT_DB_PATH,
+  OUTCOME_CHAIN_STAGES,
   OtelEmitter,
   SqliteQueryAdapter,
+  SqliteSink,
+  VENDOR_OTEL_SOURCE,
+  analyzeOutcomeChain,
   createPipeline,
-  emitHumanInstruction,
-  emitPromotionPr,
-  emitQualityGateResult,
-  evaluateMapping,
+  generateDiagnosticReport,
   generateId,
   isoToUnixNano,
-  loadEventMappingConfig
-} from "../chunk-J2F5GEMO.js";
+  mapVendorOtelExport,
+  renderReportJson,
+  renderReportMarkdown
+} from "../chunk-3DXZNA3E.js";
 
 // src/cli/index.ts
 import { readFileSync } from "fs";
-import { dirname as dirname2, resolve } from "path";
+import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 
 // src/generated/program.ts
@@ -154,6 +160,9 @@ command_sets:
           - name: dry-run
             schema: { type: boolean }
             description: Print span count without emitting to OTLP backend
+          - name: flush-timeout-ms
+            schema: { type: integer }
+            description: "Maximum ms to wait for OTLP flush before exit (default: 2000; use \u226530000 for >5k spans)"
         exits:
           '0':
             description: Backfill completed
@@ -173,6 +182,56 @@ command_sets:
             stderr:
               format: text
 
+      ingest-vendor-otel:
+        summary: Project a vendor OTLP/JSON trace export (e.g. Claude Code token/cost/trace) into the SQLite Ledger
+        description: |
+          Canonical Projection batch (observability-integration.md \xA79.2 / T-D2).
+
+          Reads a vendor OTLP/JSON trace export from --input (file) or stdin, projects
+          each span into a Canonical Event, and backfills it into the SQLite Ledger.
+
+          Idempotent: every event carries a deterministic dedup_key
+          (vendor-otel:{traceId}:{spanId}) enforced by UNIQUE + INSERT OR IGNORE, so
+          re-running on the same export inserts nothing new (reported as
+          skippedDuplicate). Hook/runtime records remain the primary source; vendor
+          OTEL is auxiliary evidence.
+        options:
+          - name: db
+            schema: { type: string }
+            description: Path to observability SQLite database (overrides default)
+          - name: input
+            aliases: [i]
+            schema: { type: string }
+            description: "Path to the OTLP/JSON trace export (reads stdin when omitted)"
+          - name: source
+            schema: { type: string }
+            description: "Source tag for projected events (default: claude-code-otel)"
+          - name: dry-run
+            schema: { type: boolean }
+            description: Parse and project without writing to the Ledger
+        exits:
+          '0':
+            description: Ingestion completed
+            stdout:
+              format: json
+              schema:
+                type: object
+                properties:
+                  found:
+                    type: integer
+                  inserted:
+                    type: integer
+                  skippedDuplicate:
+                    type: integer
+                  skippedInvalid:
+                    type: integer
+                  dryRun:
+                    type: boolean
+          '1':
+            description: Ingestion failed (unreadable input, invalid JSON, DB error)
+            stderr:
+              format: text
+
       query:
         summary: Query the observability store via QueryAdapter
         options:
@@ -180,8 +239,11 @@ command_sets:
             aliases: [k]
             schema:
               type: string
-              enum: [trace, span, search, links]
-            description: "Query kind: trace | span | search | links"
+              enum: [trace, span, search, links, issue]
+            description: "Query kind: trace | span | search | links | issue"
+          - name: issue
+            schema: { type: string }
+            description: "Issue ID for issue queries (--kind issue)"
           - name: trace-id
             schema: { type: string }
             description: Trace ID for trace queries (--kind trace)
@@ -221,8 +283,56 @@ command_sets:
             description: Query failed
             stderr:
               format: text
+
+      report:
+        summary: Generate an Observability diagnostic report (Layer 1-3 + link completion + Person Tier) from the SQLite Ledger
+        description: |
+          Customer-facing Observability diagnostic (#179 WS-F T-F1). Computes the
+          same Layer 1-3 / link-completion / Person-Tier metrics rendered by the
+          \`aaac-diagnostic\` Grafana dashboard, over the local SQLite Ledger.
+
+          Output is Markdown (default) or JSON. Use --project-id to scope to a
+          single project (internal or a cooperating customer project). Supply
+          --baseline-from / --baseline-to to add a Before/After comparison
+          section against a baseline window; --from / --to bound the current
+          (after) window.
+        options:
+          - name: project-id
+            aliases: [p]
+            schema: { type: string }
+            description: Restrict the report to a single project_id (project.id attr / service.name)
+          - name: from
+            schema: { type: string }
+            description: Start time (ISO 8601) for the current/after window
+          - name: to
+            schema: { type: string }
+            description: End time (ISO 8601) for the current/after window
+          - name: baseline-from
+            schema: { type: string }
+            description: Start time (ISO 8601) of the baseline/before window (enables Before/After comparison)
+          - name: baseline-to
+            schema: { type: string }
+            description: End time (ISO 8601) of the baseline/before window (enables Before/After comparison)
+          - name: format
+            aliases: [f]
+            schema:
+              type: string
+              enum: [markdown, json]
+            description: "Output format: markdown (default) | json"
+          - name: db
+            schema: { type: string }
+            description: Path to observability SQLite database (overrides default)
+        exits:
+          '0':
+            description: Report generated \u2014 Markdown or JSON on stdout
+            stdout:
+              format: text
+          '1':
+            description: Report generation failed
+            stderr:
+              format: text
 `;
-var CONTRACT_JSON_STR = '{\n  "cli_contracts": "0.1.0",\n  "info": {\n    "title": "AaaC Observability CLI",\n    "version": "0.1.0",\n    "description": "aaac-observ \u2014 external event registration and query for @aaac/observability"\n  },\n  "command_sets": {\n    "aaac-observ": {\n      "summary": "aaac-observ \u2014 register external events and query the observability store",\n      "executable": "aaac-observ",\n      "commands": {\n        "record": {\n          "summary": "Register an external event into the observability pipeline (thin entrypoint for EventCollector.registerExternalEvent)",\n          "options": [\n            {\n              "name": "event-type",\n              "aliases": [\n                "t"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event type (e.g. promotion.commit, process.edit, agent.session)"\n            },\n            {\n              "name": "lifecycle",\n              "aliases": [\n                "l"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "open",\n                  "close",\n                  "event",\n                  "instant"\n                ]\n              },\n              "description": "Event lifecycle phase: open | close | event | instant"\n            },\n            {\n              "name": "span-id",\n              "aliases": [\n                "s"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Span ID (auto-generated if omitted)"\n            },\n            {\n              "name": "parent-span-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Parent span ID for hierarchy"\n            },\n            {\n              "name": "session-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Session ID to associate with the event"\n            },\n            {\n              "name": "trace-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Trace ID for distributed tracing"\n            },\n            {\n              "name": "source",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event source identifier (default: external)"\n            },\n            {\n              "name": "attr",\n              "schema": {\n                "type": "array",\n                "items": {\n                  "type": "string"\n                }\n              },\n              "description": "Attribute as key=value (repeatable, e.g. --attr git.commit=abc123)"\n            },\n            {\n              "name": "link",\n              "schema": {\n                "type": "array",\n                "items": {\n                  "type": "string"\n                }\n              },\n              "description": "Cross-axis link as targetSpanId:linkType[:targetTraceId] (repeatable)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Event registered successfully",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "eventId": {\n                      "type": "string"\n                    },\n                    "spanId": {\n                      "type": "string"\n                    }\n                  }\n                }\n              }\n            },\n            "1": {\n              "description": "Registration failed (validation error or write error)",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "record-hook": {\n          "summary": "Record a Cursor/git hook event \u2014 parses stdin JSON, resolves event_mapping into 3-axis spans/links, injects session_id, and emits human-events (fail-open)",\n          "arguments": [\n            {\n              "name": "hook-name",\n              "index": 0,\n              "required": true,\n              "schema": {\n                "type": "string"\n              },\n              "description": "Cursor/git hook name (e.g. afterFileEdit, subagentStart, beforeShellExecution)"\n            }\n          ],\n          "options": [\n            {\n              "name": "mapping-config",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to event-mapping.json (default: .agent-logs/config/event-mapping.json)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Hook recorded (or no-op when stdin/mapping unavailable) \u2014 always fail-open",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "recorded": {\n                      "type": "integer"\n                    },\n                    "fallback": {\n                      "type": "boolean"\n                    }\n                  }\n                }\n              }\n            }\n          }\n        },\n        "backfill": {\n          "summary": "Re-emit historical spans from SQLite to an OTLP backend",\n          "description": "Reads closed/instant spans from the local SQLite database and emits them\\nvia OtelEmitter to an OTLP-compatible backend.\\n\\nIMPORTANT \u2014 idempotency: The OTel SDK does not support specifying custom\\nspanIds, so each backfill invocation creates NEW spans in the backend.\\nRepeated invocations will produce DUPLICATE data. Use --from/--to to\\ncontrol scope. See #125 \xA77 for full idempotency guidance.\\n",\n          "options": [\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            },\n            {\n              "name": "endpoint",\n              "schema": {\n                "type": "string"\n              },\n              "description": "OTLP HTTP endpoint URL (fallback: OTEL_EXPORTER_OTLP_ENDPOINT)"\n            },\n            {\n              "name": "service-name",\n              "schema": {\n                "type": "string"\n              },\n              "description": "OTEL service name reported to backend (default: @aaac/observability)"\n            },\n            {\n              "name": "from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Backfill spans starting at or after this ISO 8601 time"\n            },\n            {\n              "name": "to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Backfill spans starting at or before this ISO 8601 time"\n            },\n            {\n              "name": "event-type",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Filter by event type (e.g. agent.session)"\n            },\n            {\n              "name": "dry-run",\n              "schema": {\n                "type": "boolean"\n              },\n              "description": "Print span count without emitting to OTLP backend"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Backfill completed",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "spansFound": {\n                      "type": "integer"\n                    },\n                    "spansEmitted": {\n                      "type": "integer"\n                    },\n                    "dryRun": {\n                      "type": "boolean"\n                    }\n                  }\n                }\n              }\n            },\n            "1": {\n              "description": "Backfill failed (missing endpoint, DB error, etc.)",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "query": {\n          "summary": "Query the observability store via QueryAdapter",\n          "options": [\n            {\n              "name": "kind",\n              "aliases": [\n                "k"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "trace",\n                  "span",\n                  "search",\n                  "links"\n                ]\n              },\n              "description": "Query kind: trace | span | search | links"\n            },\n            {\n              "name": "trace-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Trace ID for trace queries (--kind trace)"\n            },\n            {\n              "name": "span-id",\n              "aliases": [\n                "s"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Span ID for span/links queries (--kind span or --kind links)"\n            },\n            {\n              "name": "event-type",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event type filter for search queries (--kind search)"\n            },\n            {\n              "name": "task-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Task ID filter for search queries (--kind search)"\n            },\n            {\n              "name": "from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Start time in ISO 8601 format for search queries (--kind search)"\n            },\n            {\n              "name": "to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "End time in ISO 8601 format for search queries (--kind search)"\n            },\n            {\n              "name": "direction",\n              "aliases": [\n                "d"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "forward",\n                  "reverse",\n                  "both"\n                ]\n              },\n              "description": "Link traversal direction for links queries (default: both)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Query succeeded \u2014 results as JSON array",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object"\n                }\n              }\n            },\n            "1": {\n              "description": "Query failed",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}';
+var CONTRACT_JSON_STR = '{\n  "cli_contracts": "0.1.0",\n  "info": {\n    "title": "AaaC Observability CLI",\n    "version": "0.1.0",\n    "description": "aaac-observ \u2014 external event registration and query for @aaac/observability"\n  },\n  "command_sets": {\n    "aaac-observ": {\n      "summary": "aaac-observ \u2014 register external events and query the observability store",\n      "executable": "aaac-observ",\n      "commands": {\n        "record": {\n          "summary": "Register an external event into the observability pipeline (thin entrypoint for EventCollector.registerExternalEvent)",\n          "options": [\n            {\n              "name": "event-type",\n              "aliases": [\n                "t"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event type (e.g. promotion.commit, process.edit, agent.session)"\n            },\n            {\n              "name": "lifecycle",\n              "aliases": [\n                "l"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "open",\n                  "close",\n                  "event",\n                  "instant"\n                ]\n              },\n              "description": "Event lifecycle phase: open | close | event | instant"\n            },\n            {\n              "name": "span-id",\n              "aliases": [\n                "s"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Span ID (auto-generated if omitted)"\n            },\n            {\n              "name": "parent-span-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Parent span ID for hierarchy"\n            },\n            {\n              "name": "session-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Session ID to associate with the event"\n            },\n            {\n              "name": "trace-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Trace ID for distributed tracing"\n            },\n            {\n              "name": "source",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event source identifier (default: external)"\n            },\n            {\n              "name": "attr",\n              "schema": {\n                "type": "array",\n                "items": {\n                  "type": "string"\n                }\n              },\n              "description": "Attribute as key=value (repeatable, e.g. --attr git.commit=abc123)"\n            },\n            {\n              "name": "link",\n              "schema": {\n                "type": "array",\n                "items": {\n                  "type": "string"\n                }\n              },\n              "description": "Cross-axis link as targetSpanId:linkType[:targetTraceId] (repeatable)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Event registered successfully",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "eventId": {\n                      "type": "string"\n                    },\n                    "spanId": {\n                      "type": "string"\n                    }\n                  }\n                }\n              }\n            },\n            "1": {\n              "description": "Registration failed (validation error or write error)",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "record-hook": {\n          "summary": "Record a Cursor/git hook event \u2014 parses stdin JSON, resolves event_mapping into 3-axis spans/links, injects session_id, and emits human-events (fail-open)",\n          "arguments": [\n            {\n              "name": "hook-name",\n              "index": 0,\n              "required": true,\n              "schema": {\n                "type": "string"\n              },\n              "description": "Cursor/git hook name (e.g. afterFileEdit, subagentStart, beforeShellExecution)"\n            }\n          ],\n          "options": [\n            {\n              "name": "mapping-config",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to event-mapping.json (default: .agent-logs/config/event-mapping.json)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Hook recorded (or no-op when stdin/mapping unavailable) \u2014 always fail-open",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "recorded": {\n                      "type": "integer"\n                    },\n                    "fallback": {\n                      "type": "boolean"\n                    }\n                  }\n                }\n              }\n            }\n          }\n        },\n        "backfill": {\n          "summary": "Re-emit historical spans from SQLite to an OTLP backend",\n          "description": "Reads closed/instant spans from the local SQLite database and emits them\\nvia OtelEmitter to an OTLP-compatible backend.\\n\\nIMPORTANT \u2014 idempotency: The OTel SDK does not support specifying custom\\nspanIds, so each backfill invocation creates NEW spans in the backend.\\nRepeated invocations will produce DUPLICATE data. Use --from/--to to\\ncontrol scope. See #125 \xA77 for full idempotency guidance.\\n",\n          "options": [\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            },\n            {\n              "name": "endpoint",\n              "schema": {\n                "type": "string"\n              },\n              "description": "OTLP HTTP endpoint URL (fallback: OTEL_EXPORTER_OTLP_ENDPOINT)"\n            },\n            {\n              "name": "service-name",\n              "schema": {\n                "type": "string"\n              },\n              "description": "OTEL service name reported to backend (default: @aaac/observability)"\n            },\n            {\n              "name": "from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Backfill spans starting at or after this ISO 8601 time"\n            },\n            {\n              "name": "to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Backfill spans starting at or before this ISO 8601 time"\n            },\n            {\n              "name": "event-type",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Filter by event type (e.g. agent.session)"\n            },\n            {\n              "name": "dry-run",\n              "schema": {\n                "type": "boolean"\n              },\n              "description": "Print span count without emitting to OTLP backend"\n            },\n            {\n              "name": "flush-timeout-ms",\n              "schema": {\n                "type": "integer"\n              },\n              "description": "Maximum ms to wait for OTLP flush before exit (default: 2000; use \u226530000 for >5k spans)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Backfill completed",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "spansFound": {\n                      "type": "integer"\n                    },\n                    "spansEmitted": {\n                      "type": "integer"\n                    },\n                    "dryRun": {\n                      "type": "boolean"\n                    }\n                  }\n                }\n              }\n            },\n            "1": {\n              "description": "Backfill failed (missing endpoint, DB error, etc.)",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "ingest-vendor-otel": {\n          "summary": "Project a vendor OTLP/JSON trace export (e.g. Claude Code token/cost/trace) into the SQLite Ledger",\n          "description": "Canonical Projection batch (observability-integration.md \xA79.2 / T-D2).\\n\\nReads a vendor OTLP/JSON trace export from --input (file) or stdin, projects\\neach span into a Canonical Event, and backfills it into the SQLite Ledger.\\n\\nIdempotent: every event carries a deterministic dedup_key\\n(vendor-otel:{traceId}:{spanId}) enforced by UNIQUE + INSERT OR IGNORE, so\\nre-running on the same export inserts nothing new (reported as\\nskippedDuplicate). Hook/runtime records remain the primary source; vendor\\nOTEL is auxiliary evidence.\\n",\n          "options": [\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            },\n            {\n              "name": "input",\n              "aliases": [\n                "i"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to the OTLP/JSON trace export (reads stdin when omitted)"\n            },\n            {\n              "name": "source",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Source tag for projected events (default: claude-code-otel)"\n            },\n            {\n              "name": "dry-run",\n              "schema": {\n                "type": "boolean"\n              },\n              "description": "Parse and project without writing to the Ledger"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Ingestion completed",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object",\n                  "properties": {\n                    "found": {\n                      "type": "integer"\n                    },\n                    "inserted": {\n                      "type": "integer"\n                    },\n                    "skippedDuplicate": {\n                      "type": "integer"\n                    },\n                    "skippedInvalid": {\n                      "type": "integer"\n                    },\n                    "dryRun": {\n                      "type": "boolean"\n                    }\n                  }\n                }\n              }\n            },\n            "1": {\n              "description": "Ingestion failed (unreadable input, invalid JSON, DB error)",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "query": {\n          "summary": "Query the observability store via QueryAdapter",\n          "options": [\n            {\n              "name": "kind",\n              "aliases": [\n                "k"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "trace",\n                  "span",\n                  "search",\n                  "links",\n                  "issue"\n                ]\n              },\n              "description": "Query kind: trace | span | search | links | issue"\n            },\n            {\n              "name": "issue",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Issue ID for issue queries (--kind issue)"\n            },\n            {\n              "name": "trace-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Trace ID for trace queries (--kind trace)"\n            },\n            {\n              "name": "span-id",\n              "aliases": [\n                "s"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Span ID for span/links queries (--kind span or --kind links)"\n            },\n            {\n              "name": "event-type",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Event type filter for search queries (--kind search)"\n            },\n            {\n              "name": "task-id",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Task ID filter for search queries (--kind search)"\n            },\n            {\n              "name": "from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Start time in ISO 8601 format for search queries (--kind search)"\n            },\n            {\n              "name": "to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "End time in ISO 8601 format for search queries (--kind search)"\n            },\n            {\n              "name": "direction",\n              "aliases": [\n                "d"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "forward",\n                  "reverse",\n                  "both"\n                ]\n              },\n              "description": "Link traversal direction for links queries (default: both)"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Query succeeded \u2014 results as JSON array",\n              "stdout": {\n                "format": "json",\n                "schema": {\n                  "type": "object"\n                }\n              }\n            },\n            "1": {\n              "description": "Query failed",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        },\n        "report": {\n          "summary": "Generate an Observability diagnostic report (Layer 1-3 + link completion + Person Tier) from the SQLite Ledger",\n          "description": "Customer-facing Observability diagnostic (#179 WS-F T-F1). Computes the\\nsame Layer 1-3 / link-completion / Person-Tier metrics rendered by the\\n`aaac-diagnostic` Grafana dashboard, over the local SQLite Ledger.\\n\\nOutput is Markdown (default) or JSON. Use --project-id to scope to a\\nsingle project (internal or a cooperating customer project). Supply\\n--baseline-from / --baseline-to to add a Before/After comparison\\nsection against a baseline window; --from / --to bound the current\\n(after) window.\\n",\n          "options": [\n            {\n              "name": "project-id",\n              "aliases": [\n                "p"\n              ],\n              "schema": {\n                "type": "string"\n              },\n              "description": "Restrict the report to a single project_id (project.id attr / service.name)"\n            },\n            {\n              "name": "from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Start time (ISO 8601) for the current/after window"\n            },\n            {\n              "name": "to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "End time (ISO 8601) for the current/after window"\n            },\n            {\n              "name": "baseline-from",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Start time (ISO 8601) of the baseline/before window (enables Before/After comparison)"\n            },\n            {\n              "name": "baseline-to",\n              "schema": {\n                "type": "string"\n              },\n              "description": "End time (ISO 8601) of the baseline/before window (enables Before/After comparison)"\n            },\n            {\n              "name": "format",\n              "aliases": [\n                "f"\n              ],\n              "schema": {\n                "type": "string",\n                "enum": [\n                  "markdown",\n                  "json"\n                ]\n              },\n              "description": "Output format: markdown (default) | json"\n            },\n            {\n              "name": "db",\n              "schema": {\n                "type": "string"\n              },\n              "description": "Path to observability SQLite database (overrides default)"\n            }\n          ],\n          "exits": {\n            "0": {\n              "description": "Report generated \u2014 Markdown or JSON on stdout",\n              "stdout": {\n                "format": "text"\n              }\n            },\n            "1": {\n              "description": "Report generation failed",\n              "stderr": {\n                "format": "text"\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}';
 
 // src/generated/program.ts
 function createProgram(handlers2, version) {
@@ -234,12 +344,18 @@ function createProgram(handlers2, version) {
   program2.command("record-hook").description("Record a Cursor/git hook event \u2014 parses stdin JSON, resolves event_mapping into 3-axis spans/links, injects session_id, and emits human-events (fail-open)").argument("<hook-name>", "Cursor/git hook name (e.g. afterFileEdit, subagentStart, beforeShellExecution)").option("--mapping-config <value>", "Path to event-mapping.json (default: .agent-logs/config/event-mapping.json)").option("--db <value>", "Path to observability SQLite database (overrides default)").action(async (hookName, opts, cmd) => {
     await handlers2.recordHook(hookName, opts, cmd.optsWithGlobals());
   });
-  program2.command("backfill").description("Re-emit historical spans from SQLite to an OTLP backend").option("--db <value>", "Path to observability SQLite database (overrides default)").option("--endpoint <value>", "OTLP HTTP endpoint URL (fallback: OTEL_EXPORTER_OTLP_ENDPOINT)").option("--service-name <value>", "OTEL service name reported to backend (default: @aaac/observability)").option("--from <value>", "Backfill spans starting at or after this ISO 8601 time").option("--to <value>", "Backfill spans starting at or before this ISO 8601 time").option("--event-type <value>", "Filter by event type (e.g. agent.session)").option("--dry-run", "Print span count without emitting to OTLP backend").option("--flush-timeout-ms <ms>", "Maximum ms to wait for OTLP flush before exit (default: 2000; use \u226530000 for >5k spans)", (v) => parseInt(v, 10)).action(async (opts, cmd) => {
+  program2.command("backfill").description("Re-emit historical spans from SQLite to an OTLP backend").option("--db <value>", "Path to observability SQLite database (overrides default)").option("--endpoint <value>", "OTLP HTTP endpoint URL (fallback: OTEL_EXPORTER_OTLP_ENDPOINT)").option("--service-name <value>", "OTEL service name reported to backend (default: @aaac/observability)").option("--from <value>", "Backfill spans starting at or after this ISO 8601 time").option("--to <value>", "Backfill spans starting at or before this ISO 8601 time").option("--event-type <value>", "Filter by event type (e.g. agent.session)").option("--dry-run", "Print span count without emitting to OTLP backend").option("--flush-timeout-ms <value>", "Maximum ms to wait for OTLP flush before exit (default: 2000; use \u226530000 for >5k spans)").action(async (opts, cmd) => {
     await handlers2.backfill(opts, cmd.optsWithGlobals());
   });
-  program2.command("query").description("Query the observability store via QueryAdapter").option("-k, --kind <value>", "Query kind: trace | span | search | links").option("--trace-id <value>", "Trace ID for trace queries (--kind trace)").option("-s, --span-id <value>", "Span ID for span/links queries (--kind span or --kind links)").option("--event-type <value>", "Event type filter for search queries (--kind search)").option("--task-id <value>", "Task ID filter for search queries (--kind search)").option("--from <value>", "Start time in ISO 8601 format for search queries (--kind search)").option("--to <value>", "End time in ISO 8601 format for search queries (--kind search)").option("-d, --direction <value>", "Link traversal direction for links queries (default: both)").option("--db <value>", "Path to observability SQLite database (overrides default)").action(async (opts, cmd) => {
+  program2.command("ingest-vendor-otel").description("Project a vendor OTLP/JSON trace export (e.g. Claude Code token/cost/trace) into the SQLite Ledger").option("--db <value>", "Path to observability SQLite database (overrides default)").option("-i, --input <value>", "Path to the OTLP/JSON trace export (reads stdin when omitted)").option("--source <value>", "Source tag for projected events (default: claude-code-otel)").option("--dry-run", "Parse and project without writing to the Ledger").action(async (opts, cmd) => {
+    await handlers2.ingestVendorOtel(opts, cmd.optsWithGlobals());
+  });
+  program2.command("query").description("Query the observability store via QueryAdapter").option("-k, --kind <value>", "Query kind: trace | span | search | links | issue").option("--issue <value>", "Issue ID for issue queries (--kind issue)").option("--trace-id <value>", "Trace ID for trace queries (--kind trace)").option("-s, --span-id <value>", "Span ID for span/links queries (--kind span or --kind links)").option("--event-type <value>", "Event type filter for search queries (--kind search)").option("--task-id <value>", "Task ID filter for search queries (--kind search)").option("--from <value>", "Start time in ISO 8601 format for search queries (--kind search)").option("--to <value>", "End time in ISO 8601 format for search queries (--kind search)").option("-d, --direction <value>", "Link traversal direction for links queries (default: both)").option("--db <value>", "Path to observability SQLite database (overrides default)").action(async (opts, cmd) => {
     await handlers2.query(opts, cmd.optsWithGlobals());
   });
+  program2.command("report").description("Generate an Observability diagnostic report (Layer 1-3 + link completion + Person Tier) from the SQLite Ledger").option("-p, --project-id <value>", "Restrict the report to a single project_id (project.id attr / service.name)").option("--from <value>", "Start time (ISO 8601) for the current/after window").option("--to <value>", "End time (ISO 8601) for the current/after window").option("--baseline-from <value>", "Start time (ISO 8601) of the baseline/before window (enables Before/After comparison)").option("--baseline-to <value>", "End time (ISO 8601) of the baseline/before window (enables Before/After comparison)").option("-f, --format <value>", "Output format: markdown (default) | json").option("--db <value>", "Path to observability SQLite database (overrides default)").action(async (opts, cmd) => {
+    await handlers2.report(opts, cmd.optsWithGlobals());
+  });
   program2.command("extract").description("Extract contract specification for this CLI tool.").argument("[commands...]", "Command IDs to extract. Use dot notation.").option("-a, --all", "Extract all commands.", false).option("--include-meta", "Include extraction metadata.", true).option("-F, --format <format>", "Output format (yaml or json).", "yaml").action(async (commands, opts, cmd) => {
     if (commands.length === 0 && !opts.all) {
       process.stderr.write(JSON.stringify({ code: "INVALID_ARGS", message: "Specify command IDs or use --all" }) + "\n");
@@ -257,7 +373,7 @@ function createProgram(handlers2, version) {
             type: "cli-contracts/extract",
             extractedAt: (/* @__PURE__ */ new Date()).toISOString(),
             specVersion: doc.cli_contracts ?? "0.1.0",
-            commands: ["aaac-observ.record", "aaac-observ.record-hook", "aaac-observ.backfill", "aaac-observ.query"]
+            commands: ["aaac-observ.record", "aaac-observ.record-hook", "aaac-observ.backfill", "aaac-observ.ingest-vendor-otel", "aaac-observ.query", "aaac-observ.report"]
           };
         }
         Object.assign(out, doc);
@@ -274,7 +390,7 @@ function createProgram(handlers2, version) {
           yamlLines.push("extractedAt: " + (/* @__PURE__ */ new Date()).toISOString());
           yamlLines.push("spec_version: " + (doc.cli_contracts ?? "0.1.0"));
           yamlLines.push("commands:");
-          for (const id of ["aaac-observ.record", "aaac-observ.record-hook", "aaac-observ.backfill", "aaac-observ.query"]) {
+          for (const id of ["aaac-observ.record", "aaac-observ.record-hook", "aaac-observ.backfill", "aaac-observ.ingest-vendor-otel", "aaac-observ.query", "aaac-observ.report"]) {
             yamlLines.push("  - " + id);
           }
         }
@@ -419,203 +535,15 @@ async function handleRecord(options, _parentOpts) {
   process.stdout.write(JSON.stringify(result) + "\n");
 }
 
-// src/cli/record-hook.ts
-import { mkdir, rename, unlink, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-var GIT_CONTEXT_COMMAND_RE = /\bgit\s+(?:commit|push|merge)\b/;
-var GIT_HOOK_NAMES = /* @__PURE__ */ new Set([
-  "pre-commit",
-  "post-commit",
-  "pre-push",
-  "post-merge",
-  "post-checkout"
-]);
-function defaultMappingConfigPath(dbPath) {
-  return join(dirname(dbPath), "config", "event-mapping.json");
-}
-function contextFilePath(dbPath) {
-  return join(dirname(dbPath), ".observ-context.json");
-}
-async function readStdin() {
-  if (process.stdin.isTTY) return "";
-  return new Promise((resolve2) => {
-    let data = "";
-    let settled = false;
-    const finish = () => {
-      if (settled) return;
-      settled = true;
-      resolve2(data);
-    };
-    try {
-      process.stdin.setEncoding("utf8");
-      process.stdin.on("data", (chunk) => {
-        data += chunk;
-      });
-      process.stdin.on("end", finish);
-      process.stdin.on("error", finish);
-      process.stdin.on("close", finish);
-      const t = setTimeout(finish, 1e3);
-      if (typeof t.unref === "function") t.unref();
-    } catch {
-      finish();
-    }
-  });
-}
-function parseHookInput(raw) {
-  const trimmed = raw.trim();
-  if (!trimmed) return {};
-  try {
-    const parsed = JSON.parse(trimmed);
-    return parsed !== null && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-function asString(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function asNumber(value) {
-  if (typeof value === "number" && Number.isFinite(value)) return value;
-  if (typeof value === "string" && value.trim() !== "") {
-    const n = Number(value);
-    if (Number.isFinite(n)) return n;
-  }
-  return void 0;
-}
-function emitMappedSpans(collector, hook, rule, hookInput, sessionId) {
-  const { spans, links } = evaluateMapping(rule, hookInput);
-  const linksBySpan = /* @__PURE__ */ new Map();
-  for (const link of links) {
-    const arr = linksBySpan.get(link.fromSpanId) ?? [];
-    arr.push({ targetSpanId: link.toSpanId, linkType: link.linkType });
-    linksBySpan.set(link.fromSpanId, arr);
-  }
-  const parentConversationId = hook === "subagentStart" ? asString(hookInput.parent_conversation_id) : void 0;
-  for (const span of spans) {
-    const attributes = { ...span.attributes };
-    if (sessionId) attributes["session_id"] = sessionId;
-    if (parentConversationId) {
-      attributes["parent_conversation_id"] = parentConversationId;
-    }
-    collector.emit({
-      source: "cursor-hook",
-      eventType: span.eventType,
-      lifecycle: span.lifecycle,
-      spanId: span.spanId,
-      parentSpanId: span.parentSpanId,
-      attributes,
-      links: linksBySpan.get(span.spanId) ?? []
-    });
-  }
-  return spans.length;
-}
-function emitGenericFallback(collector, hook, sessionId) {
-  const eventType = (GIT_HOOK_NAMES.has(hook) ? "git." : "cursor.") + hook;
-  const attributes = { "hook.name": hook };
-  if (sessionId) attributes["session_id"] = sessionId;
-  collector.emit({
-    source: "cursor-hook",
-    eventType,
-    lifecycle: "instant",
-    attributes
-  });
-  return 1;
-}
-function emitHumanEvents(collector, hook, hookInput, sessionId) {
-  let count = 0;
-  if (hook === "beforeSubmitPrompt") {
-    const prompt = asString(hookInput.prompt);
-    if (prompt !== void 0) {
-      const attachments = Array.isArray(hookInput.attachments) ? hookInput.attachments : [];
-      emitHumanInstruction(collector, { sessionId, prompt, attachments });
-      count += 1;
-    }
-  } else if (hook === "afterShellExecution") {
-    const command = asString(hookInput.command);
-    if (command !== void 0) {
-      const exitCode = asNumber(hookInput.exit_code) ?? asNumber(hookInput.exitCode) ?? 0;
-      const durationMs = asNumber(hookInput.duration);
-      if (emitQualityGateResult(collector, { sessionId, command, exitCode, durationMs })) {
-        count += 1;
-      }
-      const output = asString(hookInput.output) ?? "";
-      if (emitPromotionPr(collector, { sessionId, command, output })) {
-        count += 1;
-      }
-    }
-  }
-  return count;
-}
-async function manageContextFile(hook, hookInput, sessionId, dbPath) {
-  const command = asString(hookInput.command) ?? "";
-  const isGitContextCommand = GIT_CONTEXT_COMMAND_RE.test(command);
-  const file = contextFilePath(dbPath);
-  if (hook === "beforeShellExecution" && isGitContextCommand) {
-    await mkdir(dirname(file), { recursive: true });
-    const payload = JSON.stringify({
-      session_id: sessionId || null,
-      nonce: generateId(),
-      created_at_ms: Date.now()
-    }) + "\n";
-    const tmp = `${file}.${process.pid}.${generateId()}.tmp`;
-    await writeFile(tmp, payload, "utf8");
-    await rename(tmp, file);
-  } else if (hook === "afterShellExecution" && isGitContextCommand) {
-    await unlink(file).catch(() => {
-    });
-  }
-}
-async function runRecordHook(args) {
-  const { hook, hookInput, dbPath, mappingConfigPath } = args;
-  const sessionId = asString(hookInput.conversation_id) ?? "";
-  await manageContextFile(hook, hookInput, sessionId, dbPath).catch(() => {
-  });
-  let config;
-  try {
-    config = await loadEventMappingConfig(mappingConfigPath);
-  } catch {
-    config = void 0;
-  }
-  const rule = config?.mappings?.[hook];
-  let recorded = 0;
-  let fallback = false;
-  const { collector, sink } = createPipeline({ dbPath });
-  try {
-    if (rule) {
-      recorded += emitMappedSpans(collector, hook, rule, hookInput, sessionId);
-    } else {
-      recorded += emitGenericFallback(collector, hook, sessionId);
-      fallback = true;
-    }
-    recorded += emitHumanEvents(collector, hook, hookInput, sessionId);
-  } finally {
-    sink.close();
-  }
-  return { recorded, fallback };
-}
-async function handleRecordHook(hookName, options, _parentOpts) {
-  const hook = hookName ?? "unknown";
-  const dbPath = options.db ?? DEFAULT_DB_PATH;
-  const mappingConfigPath = options.mappingConfig ?? defaultMappingConfigPath(dbPath);
-  let result = { recorded: 0, fallback: false };
-  try {
-    const hookInput = parseHookInput(await readStdin());
-    result = await runRecordHook({ hook, hookInput, dbPath, mappingConfigPath });
-  } catch (err) {
-    process.stderr.write(
-      `record-hook: ${err instanceof Error ? err.message : String(err)}
-`
-    );
-  }
-  process.stdout.write(JSON.stringify(result) + "\n");
-}
-
 // src/cli/query.ts
 function bigIntReplacer(_key, value) {
   return typeof value === "bigint" ? value.toString() : value;
 }
 async function handleQuery(options, _parentOpts) {
-  const validKinds = ["trace", "span", "search", "links"];
+  if (options.issue && !options.kind) {
+    options.kind = "issue";
+  }
+  const validKinds = ["trace", "span", "search", "links", "issue"];
   if (!options.kind) {
     process.stderr.write(
       `Error: --kind (-k) is required (${validKinds.join("|")})
@@ -643,6 +571,10 @@ async function handleQuery(options, _parentOpts) {
     process.stderr.write("Error: --span-id is required for --kind links\n");
     process.exit(1);
   }
+  if (kind === "issue" && !options.issue) {
+    process.stderr.write("Error: --issue is required for --kind issue\n");
+    process.exit(1);
+  }
   const dbPath = options.db ?? DEFAULT_DB_PATH;
   const adapter = new SqliteQueryAdapter(dbPath);
   try {
@@ -677,12 +609,34 @@ async function handleQuery(options, _parentOpts) {
         result = adapter.getLinks(options.spanId, dir);
         break;
       }
+      // ── issue: Outcome chain analysis for an Issue (#178 T-E2) ──────────
+      case "issue": {
+        result = analyzeOutcomeChain(adapter, options.issue);
+        break;
+      }
     }
     process.stdout.write(JSON.stringify(result, bigIntReplacer) + "\n");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.includes("no such table") || msg.includes("no such column")) {
-      const emptyResult = kind === "span" ? null : [];
+      let emptyResult;
+      if (kind === "span") {
+        emptyResult = null;
+      } else if (kind === "issue") {
+        emptyResult = {
+          issueId: options.issue ?? "",
+          stages: OUTCOME_CHAIN_STAGES.map((s) => ({
+            eventType: s,
+            status: "missing",
+            spanIds: []
+          })),
+          complete: false,
+          gaps: [...OUTCOME_CHAIN_STAGES],
+          provisional: []
+        };
+      } else {
+        emptyResult = [];
+      }
       process.stdout.write(JSON.stringify(emptyResult, bigIntReplacer) + "\n");
       adapter.close();
       return;
@@ -787,7 +741,7 @@ async function handleBackfill(options, _parentOpts) {
     mappedSpans.push(spanRecordToMappedSpan(span, links));
   }
   adapter.close();
-  const effectiveFlushMs = options.flushTimeoutMs ?? 2e3;
+  const effectiveFlushMs = options.flushTimeoutMs != null ? Number(options.flushTimeoutMs) : 2e3;
   if (spansFound > 1e3 && effectiveFlushMs < 1e4) {
     process.stderr.write(
       `Warning: ${spansFound} spans queued but --flush-timeout-ms is ${effectiveFlushMs} ms (< 10 000 ms). Large batches may not fully flush before the deadline. Recommended: --flush-timeout-ms 30000
@@ -814,16 +768,182 @@ async function handleBackfill(options, _parentOpts) {
   process.stdout.write(JSON.stringify(result) + "\n");
 }
 
+// src/cli/ingest-vendor-otel.ts
+import { readFile } from "fs/promises";
+async function readStdin() {
+  if (process.stdin.isTTY) return "";
+  return new Promise((resolve2) => {
+    let data = "";
+    let settled = false;
+    const finish = () => {
+      if (settled) return;
+      settled = true;
+      resolve2(data);
+    };
+    try {
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", (chunk) => {
+        data += chunk;
+      });
+      process.stdin.on("end", finish);
+      process.stdin.on("error", finish);
+      process.stdin.on("close", finish);
+    } catch {
+      finish();
+    }
+  });
+}
+async function handleIngestVendorOtel(options, _parentOpts) {
+  const dbPath = options.db ?? DEFAULT_DB_PATH;
+  const dryRun = options.dryRun ?? false;
+  const source = options.source ?? VENDOR_OTEL_SOURCE;
+  let raw;
+  try {
+    raw = options.input ? await readFile(options.input, "utf8") : await readStdin();
+  } catch (err) {
+    process.stderr.write(
+      `Error: failed to read input \u2014 ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    process.exit(1);
+    return;
+  }
+  if (raw.trim() === "") {
+    process.stderr.write(
+      "Error: no input \u2014 provide --input <file> or pipe an OTLP/JSON trace export via stdin\n"
+    );
+    process.exit(1);
+    return;
+  }
+  let doc;
+  try {
+    doc = JSON.parse(raw);
+  } catch (err) {
+    process.stderr.write(
+      `Error: invalid JSON input \u2014 ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    process.exit(1);
+    return;
+  }
+  const { events, skipped: skippedInvalid } = mapVendorOtelExport(doc, { source });
+  const found = events.length;
+  if (dryRun) {
+    const result2 = {
+      found,
+      inserted: 0,
+      skippedDuplicate: 0,
+      skippedInvalid,
+      dryRun: true
+    };
+    process.stdout.write(JSON.stringify(result2) + "\n");
+    return;
+  }
+  const sink = new SqliteSink(dbPath);
+  let inserted = 0;
+  let skippedDuplicate = 0;
+  try {
+    for (const event of events) {
+      if (sink.write(event)) {
+        inserted += 1;
+      } else {
+        skippedDuplicate += 1;
+      }
+    }
+  } catch (err) {
+    sink.close();
+    process.stderr.write(
+      `Error: failed to write to Ledger \u2014 ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    process.exit(1);
+    return;
+  }
+  sink.close();
+  const result = {
+    found,
+    inserted,
+    skippedDuplicate,
+    skippedInvalid,
+    dryRun: false
+  };
+  process.stdout.write(JSON.stringify(result) + "\n");
+}
+
+// src/cli/report.ts
+function emptyReport(options) {
+  const report = {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    projectId: options.projectId ?? null,
+    period: { from: options.from ?? null, to: options.to ?? null },
+    metrics: {
+      layer1: [],
+      layer2: [],
+      layer3: [],
+      linkCompletion: { sessionLinkRate: [], stageArrival: [], provisional: [] },
+      tierRatio: [],
+      summary: {
+        issueCount: 0,
+        sessionCount: 0,
+        totalCostUsd: 0,
+        avgLeverage: 0,
+        avgCommitRate: 0,
+        avgCiPassRate: 0,
+        avgChainCompleteness: 0,
+        sessionLinkRate: 0,
+        tierCounts: { high: 0, mid: 0, low: 0 }
+      }
+    }
+  };
+  return report;
+}
+async function handleReport(options, _parentOpts) {
+  const validFormats = ["markdown", "json"];
+  if (options.format !== void 0 && !validFormats.includes(options.format)) {
+    process.stderr.write(`Error: --format must be one of: ${validFormats.join("|")}
+`);
+    process.exit(1);
+  }
+  const format = options.format ?? "markdown";
+  const render = (report) => format === "json" ? renderReportJson(report) : renderReportMarkdown(report);
+  const dbPath = options.db ?? DEFAULT_DB_PATH;
+  const adapter = new SqliteQueryAdapter(dbPath);
+  try {
+    const reportOptions = {};
+    if (options.projectId !== void 0) reportOptions.projectId = options.projectId;
+    if (options.from !== void 0) reportOptions.from = options.from;
+    if (options.to !== void 0) reportOptions.to = options.to;
+    if (options.baselineFrom !== void 0) reportOptions.baselineFrom = options.baselineFrom;
+    if (options.baselineTo !== void 0) reportOptions.baselineTo = options.baselineTo;
+    const report = generateDiagnosticReport(adapter, reportOptions);
+    process.stdout.write(render(report) + "\n");
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("no such table") || msg.includes("no such column")) {
+      process.stdout.write(render(emptyReport(options)) + "\n");
+      adapter.close();
+      return;
+    }
+    process.stderr.write(`Error: ${msg}
+`);
+    adapter.close();
+    process.exit(1);
+  }
+  adapter.close();
+}
+
 // src/cli/handlers.ts
 var handlers = {
   record: handleRecord,
   recordHook: handleRecordHook,
   query: handleQuery,
-  backfill: handleBackfill
+  backfill: handleBackfill,
+  ingestVendorOtel: handleIngestVendorOtel,
+  report: handleReport
 };
 
 // src/cli/index.ts
-var __dirname = dirname2(fileURLToPath(import.meta.url));
+var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(
   readFileSync(resolve(__dirname, "../../package.json"), "utf8")
 );