twining-mcp 1.4.3 → 1.5.1

package/README.md

@@ -182,17 +182,66 @@ No. It's a local MCP server — tool calls are local file reads/writes. Semantic
 Yes. Twining is a standard MCP server. Any MCP host can connect to it.
 
 **Where does my data go?**
-Nowhere. All state is local in `.twining/`. No telemetry, no cloud, no external calls.
+All coordination state is local in `.twining/`. Tool call metrics are stored locally in `.twining/metrics.jsonl` (gitignored). Optional anonymous telemetry can be enabled — see [Analytics](#analytics) below.
 
 **Is Twining an agent orchestrator?**
 No. It's a coordination state layer. It captures what agents decided and why, and makes that knowledge available to future agents. Use it alongside orchestrators, agent teams, or standalone sessions.
 
+## Analytics
+
+Twining includes a three-layer analytics system to help you understand the value it provides.
+
+### Insights Dashboard Tab
+
+The web dashboard includes an **Insights** tab showing:
+
+- **Value Metrics** — Blind decision prevention rate, warning acknowledgment, test coverage via `tested_by` graph relations, commit traceability, decision lifecycle, knowledge graph stats, and agent coordination metrics
+- **Tool Usage** — Call counts, error rates, average/P95 latency per tool
+- **Error Breakdown** — Errors grouped by tool and error code
+
+All value metrics are computed from existing `.twining/` data — no new data collection needed.
+
+### Tool Call Metrics
+
+Every MCP tool call is automatically instrumented with timing and success/error tracking. Metrics are stored locally in `.twining/metrics.jsonl` (gitignored — operational data, not architectural).
+
+To disable local metrics collection, set in `.twining/config.yml`:
+
+```yaml
+analytics:
+  metrics:
+    enabled: false
+```
+
+### Opt-in Telemetry
+
+Anonymous aggregate usage data can optionally be sent to PostHog to help improve Twining. **Disabled by default.** To enable, add to `.twining/config.yml`:
+
+```yaml
+analytics:
+  telemetry:
+    enabled: true
+```
+
+That's it — the PostHog project key is built into the source code. If you run your own PostHog instance, you can override with `posthog_api_key` and `posthog_host`.
+
+**What is sent:** tool names, call durations, success/failure booleans, server version, OS, architecture.
+
+**What is never sent:** file paths, decision content, agent names, error messages, tool arguments, environment variables.
+
+**Privacy safeguards:**
+- `DO_NOT_TRACK=1` environment variable always overrides config
+- `CI=true` auto-disables telemetry
+- Identity is a SHA-256 hash of hostname + project root (never raw paths)
+- Network failures are silent — no retries
+- `posthog-node` is an optional dependency — graceful no-op if not installed
+
 ## Development
 
 ```bash
 npm install       # Install dependencies
 npm run build     # Build
-npm test          # Run tests (444 tests)
+npm test          # Run tests (570+ tests)
 npm run test:watch
 ```
 

package/dist/analytics/analytics-engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Analytics engine — computes value stats from existing .twining/ data.
+ * No new data collection needed — reads existing stores.
+ */
+import type { BlackboardStore } from "../storage/blackboard-store.js";
+import type { DecisionStore } from "../storage/decision-store.js";
+import type { GraphStore } from "../storage/graph-store.js";
+import type { HandoffStore } from "../storage/handoff-store.js";
+import type { ValueStats } from "../utils/types.js";
+export declare class AnalyticsEngine {
+    private readonly blackboardStore;
+    private readonly decisionStore;
+    private readonly graphStore;
+    private readonly handoffStore;
+    constructor(blackboardStore: BlackboardStore, decisionStore: DecisionStore, graphStore: GraphStore, handoffStore: HandoffStore);
+    computeValueStats(): Promise<ValueStats>;
+}
+//# sourceMappingURL=analytics-engine.d.ts.map

package/dist/analytics/analytics-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-engine.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAHZ,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY;IAGvC,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC;CA6H/C"}

package/dist/analytics/analytics-engine.js

@@ -0,0 +1,114 @@
+export class AnalyticsEngine {
+    blackboardStore;
+    decisionStore;
+    graphStore;
+    handoffStore;
+    constructor(blackboardStore, decisionStore, graphStore, handoffStore) {
+        this.blackboardStore = blackboardStore;
+        this.decisionStore = decisionStore;
+        this.graphStore = graphStore;
+        this.handoffStore = handoffStore;
+    }
+    async computeValueStats() {
+        const [decisionIndex, bbResult, entities, relations, handoffs,] = await Promise.all([
+            this.decisionStore.getIndex(),
+            this.blackboardStore.read(),
+            this.graphStore.getEntities(),
+            this.graphStore.getRelations(),
+            this.handoffStore.list({}),
+        ]);
+        // Blind decisions prevented
+        const totalDecisions = decisionIndex.length;
+        let assembledBefore = 0;
+        for (const dec of decisionIndex) {
+            const full = await this.decisionStore.get(dec.id);
+            if (full?.assembled_before) {
+                assembledBefore++;
+            }
+        }
+        const preventionRate = totalDecisions > 0 ? assembledBefore / totalDecisions : 0;
+        // Warnings surfaced
+        const warnings = bbResult.entries.filter((e) => e.entry_type === "warning");
+        const warningTotal = warnings.length;
+        // Check for acknowledgment patterns: relates_to links or answer entries
+        const answerRelatesTo = new Set(bbResult.entries
+            .filter((e) => e.entry_type === "answer")
+            .flatMap((e) => e.relates_to || []));
+        const acknowledged = warnings.filter((w) => answerRelatesTo.has(w.id) || w.tags.includes("acknowledged")).length;
+        const resolved = warnings.filter((w) => w.tags.includes("resolved")).length;
+        const ignored = warningTotal - acknowledged - resolved;
+        // Test coverage via graph relations
+        const testedByRelations = relations.filter((r) => r.type === "tested_by");
+        const decisionsWithTests = new Set(testedByRelations.map((r) => r.source));
+        const withTestedBy = decisionIndex.filter((d) => decisionsWithTests.has(d.id)).length;
+        const coverageRate = totalDecisions > 0 ? withTestedBy / totalDecisions : 0;
+        // Decision lifecycle
+        const lifecycle = { active: 0, provisional: 0, superseded: 0, overridden: 0 };
+        for (const dec of decisionIndex) {
+            if (dec.status in lifecycle) {
+                lifecycle[dec.status]++;
+            }
+        }
+        // Commit traceability
+        const withCommits = decisionIndex.filter((d) => d.commit_hashes && d.commit_hashes.length > 0).length;
+        const traceabilityRate = totalDecisions > 0 ? withCommits / totalDecisions : 0;
+        // Knowledge graph
+        const entitiesByType = {};
+        for (const entity of entities) {
+            entitiesByType[entity.type] = (entitiesByType[entity.type] || 0) + 1;
+        }
+        const relationsByType = {};
+        for (const relation of relations) {
+            relationsByType[relation.type] = (relationsByType[relation.type] || 0) + 1;
+        }
+        // Agent coordination (handoffs are HandoffIndexEntry with result_status + acknowledged)
+        const byResultStatus = {};
+        let acknowledgedHandoffs = 0;
+        for (const handoff of handoffs) {
+            const status = handoff.result_status || "unknown";
+            byResultStatus[status] = (byResultStatus[status] || 0) + 1;
+            if (handoff.acknowledged) {
+                acknowledgedHandoffs++;
+            }
+        }
+        const acknowledgmentRate = handoffs.length > 0
+            ? acknowledgedHandoffs / handoffs.length
+            : 0;
+        return {
+            blind_decisions_prevented: {
+                total_decisions: totalDecisions,
+                assembled_before: assembledBefore,
+                prevention_rate: Math.round(preventionRate * 100) / 100,
+            },
+            warnings_surfaced: {
+                total: warningTotal,
+                acknowledged,
+                resolved,
+                ignored: Math.max(0, ignored),
+            },
+            test_coverage: {
+                total_decisions: totalDecisions,
+                with_tested_by: withTestedBy,
+                coverage_rate: Math.round(coverageRate * 100) / 100,
+            },
+            decision_lifecycle: lifecycle,
+            commit_traceability: {
+                total_decisions: totalDecisions,
+                with_commits: withCommits,
+                traceability_rate: Math.round(traceabilityRate * 100) / 100,
+            },
+            knowledge_graph: {
+                entities: entities.length,
+                relations: relations.length,
+                entities_by_type: entitiesByType,
+                relations_by_type: relationsByType,
+            },
+            agent_coordination: {
+                total_handoffs: handoffs.length,
+                by_result_status: byResultStatus,
+                acknowledgment_rate: Math.round(acknowledgmentRate * 100) / 100,
+            },
+        };
+    }
+}
+//# sourceMappingURL=analytics-engine.js.map

package/dist/analytics/analytics-engine.js.map

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

package/dist/analytics/instrumented-server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Instrumented MCP server — patches registerTool to wrap callbacks with timing.
+ * Zero changes to any tool file — instrumentation is invisible to them.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MetricsCollector } from "./metrics-collector.js";
+/**
+ * Patch the server's registerTool method to wrap all tool callbacks with
+ * timing instrumentation. Returns the same server instance (mutated).
+ */
+export declare function createInstrumentedServer(server: McpServer, collector: MetricsCollector): McpServer;
+//# sourceMappingURL=instrumented-server.d.ts.map

package/dist/analytics/instrumented-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumented-server.d.ts","sourceRoot":"","sources":["../../src/analytics/instrumented-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,gBAAgB,GAC1B,SAAS,CAuEX"}

package/dist/analytics/instrumented-server.js

@@ -0,0 +1,76 @@
+/**
+ * Patch the server's registerTool method to wrap all tool callbacks with
+ * timing instrumentation. Returns the same server instance (mutated).
+ */
+export function createInstrumentedServer(server, collector) {
+    const originalRegisterTool = server.registerTool.bind(server);
+    // registerTool signature: (name, config, callback)
+    server.registerTool = function (name, config, callback) {
+        const wrappedCallback = async function (...cbArgs) {
+            const start = Date.now();
+            let success = true;
+            let errorCode;
+            try {
+                const result = await callback(...cbArgs);
+                // Detect soft errors by inspecting toolError() response format
+                if (result && typeof result === "object" && "content" in result) {
+                    const content = result.content;
+                    if (Array.isArray(content) && content.length > 0) {
+                        const first = content[0];
+                        if (first.text) {
+                            try {
+                                const parsed = JSON.parse(first.text);
+                                if (parsed.error === true) {
+                                    success = false;
+                                    errorCode = parsed.code || "SOFT_ERROR";
+                                }
+                            }
+                            catch {
+                                // Not JSON or not error format — that's fine
+                            }
+                        }
+                    }
+                }
+                const durationMs = Date.now() - start;
+                const agentId = extractAgentId(cbArgs);
+                // Fire-and-forget metric recording
+                collector.record({
+                    tool_name: name,
+                    timestamp: new Date().toISOString(),
+                    duration_ms: durationMs,
+                    success,
+                    error_code: errorCode,
+                    agent_id: agentId,
+                }).catch(() => { });
+                return result;
+            }
+            catch (err) {
+                const durationMs = Date.now() - start;
+                const agentId = extractAgentId(cbArgs);
+                collector.record({
+                    tool_name: name,
+                    timestamp: new Date().toISOString(),
+                    duration_ms: durationMs,
+                    success: false,
+                    error_code: err instanceof Error ? err.constructor.name : "UNKNOWN",
+                    agent_id: agentId,
+                }).catch(() => { });
+                throw err;
+            }
+        };
+        return originalRegisterTool(name, config, wrappedCallback);
+    };
+    return server;
+}
+/** Extract agent_id from tool call arguments */
+function extractAgentId(cbArgs) {
+    // MCP tool callbacks receive (args, extra) where args is the parsed tool input
+    if (cbArgs.length > 0 && cbArgs[0] && typeof cbArgs[0] === "object") {
+        const args = cbArgs[0];
+        if (typeof args.agent_id === "string") {
+            return args.agent_id;
+        }
+    }
+    return "unknown";
+}
+//# sourceMappingURL=instrumented-server.js.map

package/dist/analytics/instrumented-server.js.map

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

package/dist/analytics/metrics-collector.d.ts

@@ -0,0 +1,15 @@
+import type { MetricEntry } from "../utils/types.js";
+export declare class MetricsCollector {
+    private readonly metricsPath;
+    private telemetryClient;
+    constructor(twiningDir: string);
+    /** Set an optional telemetry client to forward sanitized events */
+    setTelemetryClient(client: TelemetryClientLike): void;
+    /** Record a tool call metric. Fire-and-forget — never throws. */
+    record(entry: MetricEntry): Promise<void>;
+}
+/** Minimal interface for telemetry client to avoid circular imports */
+export interface TelemetryClientLike {
+    trackToolCalled(toolName: string, durationMs: number, success: boolean): void;
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/analytics/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../src/analytics/metrics-collector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,eAAe,CAAoC;gBAE/C,UAAU,EAAE,MAAM;IAI9B,mEAAmE;IACnE,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIrD,iEAAiE;IAC3D,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhD;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/E"}

package/dist/analytics/metrics-collector.js

@@ -0,0 +1,36 @@
+/**
+ * Metrics collector — appends tool call metrics to .twining/metrics.jsonl.
+ * Fire-and-forget: never fails a tool call, silently logs on error.
+ */
+import path from "node:path";
+import { appendJSONL } from "../storage/file-store.js";
+export class MetricsCollector {
+    metricsPath;
+    telemetryClient = null;
+    constructor(twiningDir) {
+        this.metricsPath = path.join(twiningDir, "metrics.jsonl");
+    }
+    /** Set an optional telemetry client to forward sanitized events */
+    setTelemetryClient(client) {
+        this.telemetryClient = client;
+    }
+    /** Record a tool call metric. Fire-and-forget — never throws. */
+    async record(entry) {
+        try {
+            await appendJSONL(this.metricsPath, entry);
+        }
+        catch (err) {
+            console.error("[twining] Metrics write failed (non-fatal):", err.message);
+        }
+        // Forward to telemetry if configured (sanitized — no args/content)
+        if (this.telemetryClient) {
+            try {
+                this.telemetryClient.trackToolCalled(entry.tool_name, entry.duration_ms, entry.success);
+            }
+            catch {
+                // Silently ignore telemetry failures
+            }
+        }
+    }
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/analytics/metrics-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.js","sourceRoot":"","sources":["../../src/analytics/metrics-collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,OAAO,gBAAgB;IACV,WAAW,CAAS;IAC7B,eAAe,GAA+B,IAAI,CAAC;IAE3D,YAAY,UAAkB;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,mEAAmE;IACnE,kBAAkB,CAAC,MAA2B;QAC5C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;IAChC,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,KAAkB;QAC7B,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QACvF,CAAC;QAED,mEAAmE;QACnE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1F,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/analytics/metrics-store.d.ts

@@ -0,0 +1,20 @@
+import type { ToolUsageSummary, UsageBucket } from "../utils/types.js";
+export declare class MetricsStore {
+    private readonly metricsPath;
+    private cachedEntries;
+    private cachedMtime;
+    constructor(twiningDir: string);
+    /** Read all metrics, using mtime cache when possible */
+    private readAll;
+    /** Get tool usage summary, optionally filtered by time */
+    getToolUsageSummary(since?: string): Promise<ToolUsageSummary[]>;
+    /** Get usage over time in buckets */
+    getUsageOverTime(bucketMinutes?: number): Promise<UsageBucket[]>;
+    /** Get error breakdown by tool and error code */
+    getErrorBreakdown(): Promise<Array<{
+        tool_name: string;
+        error_code: string;
+        count: number;
+    }>>;
+}
+//# sourceMappingURL=metrics-store.d.ts.map

package/dist/analytics/metrics-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-store.d.ts","sourceRoot":"","sources":["../../src/analytics/metrics-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGpF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAa;gBAEpB,UAAU,EAAE,MAAM;IAI9B,wDAAwD;YAC1C,OAAO;IAgBrB,0DAA0D;IACpD,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAoCtE,qCAAqC;IAC/B,gBAAgB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmC1E,iDAAiD;IAC3C,iBAAiB,IAAI,OAAO,CAChC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAChE;CAiBF"}

package/dist/analytics/metrics-store.js

@@ -0,0 +1,109 @@
+/**
+ * Metrics store — reads metrics.jsonl with mtime caching.
+ * Same pattern as BlackboardStore for efficient repeated reads.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { readJSONL } from "../storage/file-store.js";
+export class MetricsStore {
+    metricsPath;
+    cachedEntries = null;
+    cachedMtime = 0;
+    constructor(twiningDir) {
+        this.metricsPath = path.join(twiningDir, "metrics.jsonl");
+    }
+    /** Read all metrics, using mtime cache when possible */
+    async readAll() {
+        try {
+            if (!fs.existsSync(this.metricsPath))
+                return [];
+            const stat = fs.statSync(this.metricsPath);
+            if (this.cachedEntries !== null && stat.mtimeMs === this.cachedMtime) {
+                return this.cachedEntries;
+            }
+            const entries = await readJSONL(this.metricsPath);
+            this.cachedEntries = entries;
+            this.cachedMtime = stat.mtimeMs;
+            return entries;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get tool usage summary, optionally filtered by time */
+    async getToolUsageSummary(since) {
+        const entries = await this.readAll();
+        const filtered = since
+            ? entries.filter((e) => e.timestamp >= since)
+            : entries;
+        const byTool = new Map();
+        for (const entry of filtered) {
+            const existing = byTool.get(entry.tool_name) || [];
+            existing.push(entry);
+            byTool.set(entry.tool_name, existing);
+        }
+        const summaries = [];
+        for (const [tool_name, toolEntries] of byTool) {
+            const durations = toolEntries.map((e) => e.duration_ms).sort((a, b) => a - b);
+            const errorCount = toolEntries.filter((e) => !e.success).length;
+            const avgDuration = durations.reduce((a, b) => a + b, 0) / durations.length;
+            const p95Index = Math.min(Math.ceil(durations.length * 0.95) - 1, durations.length - 1);
+            summaries.push({
+                tool_name,
+                call_count: toolEntries.length,
+                error_count: errorCount,
+                avg_duration_ms: Math.round(avgDuration),
+                p95_duration_ms: durations[p95Index],
+                last_called: toolEntries[toolEntries.length - 1].timestamp,
+            });
+        }
+        return summaries.sort((a, b) => b.call_count - a.call_count);
+    }
+    /** Get usage over time in buckets */
+    async getUsageOverTime(bucketMinutes = 60) {
+        const entries = await this.readAll();
+        if (entries.length === 0)
+            return [];
+        const bucketMs = bucketMinutes * 60 * 1000;
+        const buckets = new Map();
+        for (const entry of entries) {
+            const ts = new Date(entry.timestamp).getTime();
+            const bucketStart = Math.floor(ts / bucketMs) * bucketMs;
+            const existing = buckets.get(bucketStart) || [];
+            existing.push(entry);
+            buckets.set(bucketStart, existing);
+        }
+        const result = [];
+        const sortedKeys = [...buckets.keys()].sort((a, b) => a - b);
+        for (const key of sortedKeys) {
+            const bucketEntries = buckets.get(key);
+            const durations = bucketEntries.map((e) => e.duration_ms);
+            const avgDuration = durations.reduce((a, b) => a + b, 0) / durations.length;
+            result.push({
+                bucket_start: new Date(key).toISOString(),
+                bucket_end: new Date(key + bucketMs).toISOString(),
+                call_count: bucketEntries.length,
+                error_count: bucketEntries.filter((e) => !e.success).length,
+                avg_duration_ms: Math.round(avgDuration),
+            });
+        }
+        return result;
+    }
+    /** Get error breakdown by tool and error code */
+    async getErrorBreakdown() {
+        const entries = await this.readAll();
+        const errors = entries.filter((e) => !e.success);
+        const byKey = new Map();
+        for (const entry of errors) {
+            const key = `${entry.tool_name}::${entry.error_code || "unknown"}`;
+            byKey.set(key, (byKey.get(key) || 0) + 1);
+        }
+        return [...byKey.entries()]
+            .map(([key, count]) => {
+            const [tool_name, error_code] = key.split("::");
+            return { tool_name: tool_name, error_code: error_code, count };
+        })
+            .sort((a, b) => b.count - a.count);
+    }
+}
+//# sourceMappingURL=metrics-store.js.map

package/dist/analytics/metrics-store.js.map

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

package/dist/analytics/telemetry-client.d.ts

@@ -0,0 +1,19 @@
+import type { AnalyticsConfig } from "../utils/types.js";
+export declare class TelemetryClient {
+    private client;
+    private distinctId;
+    private enabled;
+    /** Initialize telemetry. Returns true if enabled and ready. */
+    init(config: AnalyticsConfig | undefined, projectRoot: string, version: string): Promise<boolean>;
+    /** Track server started event */
+    trackServerStarted(version: string): void;
+    /** Track a tool call (sanitized — no args/content/errors) */
+    trackToolCalled(toolName: string, durationMs: number, success: boolean): void;
+    /** Track session summary (periodic aggregate) */
+    trackSessionSummary(callCountsByTool: Record<string, number>, decisionCount: number, entityCount: number): void;
+    /** Flush and shut down */
+    shutdown(): Promise<void>;
+    /** Whether telemetry is active */
+    isEnabled(): boolean;
+}
+//# sourceMappingURL=telemetry-client.d.ts.map

package/dist/analytics/telemetry-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-client.d.ts","sourceRoot":"","sources":["../../src/analytics/telemetry-client.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAczD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,OAAO,CAAkB;IAEjC,+DAA+D;IACzD,IAAI,CACR,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IA2CnB,iCAAiC;IACjC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAkBzC,6DAA6D;IAC7D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAiB7E,iDAAiD;IACjD,mBAAmB,CACjB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,IAAI;IAiBP,0BAA0B;IACpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,kCAAkC;IAClC,SAAS,IAAI,OAAO;CAGrB"}