feat(telemetry): anonymous posthog usage telemetry across node cli and python daemon (#205)

* feat: add telemetry phase 1

* feat: add node telemetry event catalog

* feat: add telemetry event helpers

* feat: emit setup and connection telemetry

* feat: emit connection and stack telemetry

* feat: emit ingest and scan telemetry

* feat: emit query telemetry

* feat: emit sampled mcp telemetry

* docs: expand telemetry event catalog

* feat: add telemetry schema sync artifact

* feat: pass telemetry project id to semantic daemon

* feat: add daemon telemetry foundation

* feat: emit semantic daemon telemetry

* feat: emit daemon lifecycle telemetry

* docs: document full telemetry event catalog

* feat(telemetry): dim first-run notice

* feat(telemetry): show first-run notice before command output

* feat(telemetry): wire ktx PostHog project for live ingestion

* docs(telemetry): drop posthog project name and host from storage section

* docs(telemetry): trim to general overview and disclaimer

* docs(agents): add short telemetry guidelines

* feat(telemetry): enable posthog geoip enrichment

* docs(telemetry): drop ip-geoip note from public overview

* refactor(telemetry): drop no-op groupIdentify, rely on capture groups field

* fix(telemetry): respect CI kill switch in python daemon identity

* fix(sql): route table-count analysis to existing analyze-batch endpoint

* fix(telemetry): emit install_first_run from notice path and derive flagsPresent from commander

* fix(telemetry): read package info via getKtxCliPackageInfo to satisfy boundary check

* fix(telemetry): make python identity env={} bypass os.environ and unset CI in tests

* fix(telemetry): unset CI kill switch in cli-program-telemetry tests

packages/cli/src/scan.ts

@@ -8,6 +8,8 @@ import { createKtxCliLocalIngestAdapters } from './local-adapters.js';
 import { createKtxCliScanConnector } from './local-scan-connectors.js';
 import type { KtxManagedPythonInstallPolicy } from './managed-python-command.js';
 import { profileMark } from './startup-profile.js';
+import { emitTelemetryEvent } from './telemetry/index.js';
+import { scrubErrorClass } from './telemetry/scrubber.js';
 
 profileMark('module:scan');
 
@@ -62,6 +64,14 @@ function totalTableCount(report: KtxScanReport): number {
   return tableChangeCount(report) + report.diffSummary.tablesUnchanged;
 }
 
+function scanColumnCount(report: KtxScanReport): number {
+  return report.structuralSyncStats.columnsCreated + report.structuralSyncStats.columnsUpdated;
+}
+
+function inferredFkCount(report: KtxScanReport): number {
+  return report.relationships.accepted + report.relationships.review + report.relationships.rejected;
+}
+
 function writeScanIdentity(report: KtxScanReport, io: KtxCliIo): void {
   io.stdout.write(`Run: ${report.runId}\n`);
   io.stdout.write(`Connection: ${report.connectionId}\n`);
@@ -311,6 +321,7 @@ export function createCliScanProgress(
 }
 
 export async function runKtxScan(args: KtxScanArgs, io: KtxCliIo = process, deps: KtxScanDeps = {}): Promise<number> {
+  const startedAt = performance.now();
   try {
     const project = await loadKtxProject({ projectDir: args.projectDir });
     const resolveEmbeddingProvider = deps.resolveEmbeddingProvider ?? resolveProjectEmbeddingProvider;
@@ -347,12 +358,42 @@ export async function runKtxScan(args: KtxScanArgs, io: KtxCliIo = process, deps
         ...(progress ? { progress } : {}),
       });
       cliProgress?.flush();
+      await emitTelemetryEvent({
+        name: 'scan_completed',
+        projectDir: args.projectDir,
+        io,
+        fields: {
+          driver: result.report.driver,
+          tableCount: totalTableCount(result.report),
+          columnCount: scanColumnCount(result.report),
+          inferredFkCount: inferredFkCount(result.report),
+          declaredFkCount: 0,
+          durationMs: Math.max(0, performance.now() - startedAt),
+          outcome: 'ok',
+        },
+      });
       writeRunSummary(result.report, args.projectDir, io);
     } finally {
       cliProgress?.flush();
     }
     return 0;
   } catch (error) {
+    const errorClass = scrubErrorClass(error);
+    await emitTelemetryEvent({
+      name: 'scan_completed',
+      projectDir: args.projectDir,
+      io,
+      fields: {
+        driver: 'unknown',
+        tableCount: 0,
+        columnCount: 0,
+        inferredFkCount: 0,
+        declaredFkCount: 0,
+        durationMs: Math.max(0, performance.now() - startedAt),
+        outcome: 'error',
+        ...(errorClass ? { errorClass } : {}),
+      },
+    });
     io.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
     return 1;
   }