@cleocode/core 2026.4.57 → 2026.4.59

package/dist/telemetry/index.js

@@ -0,0 +1,249 @@
+/**
+ * Telemetry module — opt-in command telemetry for CLEO self-improvement.
+ *
+ * Entry point for all telemetry operations:
+ *   - Recording events (fire-and-forget)
+ *   - Querying patterns for `cleo diagnostics analyze`
+ *   - Managing the anonymous ID and opt-in state
+ *   - Emitting BRAIN observations from high-signal patterns
+ *
+ * Telemetry is DISABLED by default. Enable with `cleo diagnostics enable`.
+ *
+ * @task T624
+ */
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { and, count, desc, gt, sql } from 'drizzle-orm';
+import { getCleoHome } from '../paths.js';
+import { telemetryEvents } from './schema.js';
+import { getTelemetryDb } from './sqlite.js';
+// ---------------------------------------------------------------------------
+// Config I/O
+// ---------------------------------------------------------------------------
+const TELEMETRY_CONFIG_FILENAME = 'telemetry-config.json';
+/** Return the path to the telemetry config JSON file. */
+export function getTelemetryConfigPath() {
+    return join(getCleoHome(), TELEMETRY_CONFIG_FILENAME);
+}
+/** Load telemetry config from disk. Returns default (disabled) config if absent. */
+export function loadTelemetryConfig() {
+    const path = getTelemetryConfigPath();
+    if (!existsSync(path)) {
+        return { enabled: false, anonymousId: '' };
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return { enabled: false, anonymousId: '' };
+    }
+}
+/** Persist telemetry config to disk. */
+export function saveTelemetryConfig(config) {
+    const path = getTelemetryConfigPath();
+    mkdirSync(join(path, '..'), { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
+}
+/** Return true if telemetry collection is currently enabled. */
+export function isTelemetryEnabled() {
+    return loadTelemetryConfig().enabled;
+}
+/**
+ * Enable telemetry and generate a stable anonymous ID.
+ * Idempotent — calling again preserves the existing anonymousId.
+ */
+export function enableTelemetry() {
+    const existing = loadTelemetryConfig();
+    const config = {
+        enabled: true,
+        anonymousId: existing.anonymousId || randomUUID(),
+    };
+    saveTelemetryConfig(config);
+    return config;
+}
+/**
+ * Disable telemetry collection.
+ * Existing data in telemetry.db is not deleted.
+ */
+export function disableTelemetry() {
+    const existing = loadTelemetryConfig();
+    const config = { ...existing, enabled: false };
+    saveTelemetryConfig(config);
+    return config;
+}
+// ---------------------------------------------------------------------------
+// Event recording
+// ---------------------------------------------------------------------------
+/**
+ * Record one telemetry event.
+ * Fire-and-forget — errors are swallowed; never blocks the calling command.
+ * No-op when telemetry is disabled.
+ */
+export async function recordTelemetryEvent(event) {
+    const config = loadTelemetryConfig();
+    if (!config.enabled || !config.anonymousId)
+        return;
+    try {
+        const db = await getTelemetryDb();
+        const command = `${event.domain}.${event.operation}`;
+        await db
+            .insert(telemetryEvents)
+            .values({
+            id: randomUUID(),
+            anonymousId: config.anonymousId,
+            domain: event.domain,
+            gateway: event.gateway,
+            operation: event.operation,
+            command,
+            exitCode: event.exitCode,
+            durationMs: event.durationMs,
+            errorCode: event.errorCode ?? null,
+            timestamp: new Date().toISOString(),
+        })
+            .run();
+    }
+    catch {
+        // Non-fatal: telemetry must never crash the calling command.
+    }
+}
+// ---------------------------------------------------------------------------
+// Analysis
+// ---------------------------------------------------------------------------
+/** ISO-8601 timestamp N days ago. */
+function daysAgo(n) {
+    const d = new Date();
+    d.setDate(d.getDate() - n);
+    return d.toISOString();
+}
+/**
+ * Build a diagnostics report over the last `days` days (default 30).
+ * Requires telemetry to be enabled; returns null if disabled or no data.
+ */
+export async function buildDiagnosticsReport(days = 30) {
+    const config = loadTelemetryConfig();
+    if (!config.enabled)
+        return null;
+    const db = await getTelemetryDb();
+    const from = daysAgo(days);
+    const to = new Date().toISOString();
+    // Total events in window
+    const [totalRow] = await db
+        .select({ n: count(telemetryEvents.id) })
+        .from(telemetryEvents)
+        .where(gt(telemetryEvents.timestamp, from))
+        .all();
+    const totalEvents = totalRow?.n ?? 0;
+    if (totalEvents === 0)
+        return {
+            period: { from, to },
+            totalEvents: 0,
+            topFailing: [],
+            topSlow: [],
+            rareCommands: [],
+            observations: [],
+        };
+    // Per-command aggregates
+    const rows = await db
+        .select({
+        command: telemetryEvents.command,
+        total: count(telemetryEvents.id),
+        failures: sql `SUM(CASE WHEN ${telemetryEvents.exitCode} != 0 THEN 1 ELSE 0 END)`,
+        avgMs: sql `AVG(${telemetryEvents.durationMs})`,
+        maxMs: sql `MAX(${telemetryEvents.durationMs})`,
+    })
+        .from(telemetryEvents)
+        .where(gt(telemetryEvents.timestamp, from))
+        .groupBy(telemetryEvents.command)
+        .all();
+    // Get top error code per command
+    const errorCodeRows = await db
+        .select({
+        command: telemetryEvents.command,
+        errorCode: telemetryEvents.errorCode,
+        n: count(telemetryEvents.id),
+    })
+        .from(telemetryEvents)
+        .where(and(gt(telemetryEvents.timestamp, from), sql `${telemetryEvents.errorCode} IS NOT NULL`))
+        .groupBy(telemetryEvents.command, telemetryEvents.errorCode)
+        .orderBy(desc(count(telemetryEvents.id)))
+        .all();
+    // Build a map: command → top error code
+    const topErrorMap = new Map();
+    for (const r of errorCodeRows) {
+        if (!topErrorMap.has(r.command)) {
+            topErrorMap.set(r.command, r.errorCode ?? '');
+        }
+    }
+    // Build CommandStats
+    const stats = rows.map((r) => {
+        const failures = Number(r.failures) || 0;
+        const total = Number(r.total) || 0;
+        return {
+            command: r.command,
+            count: total,
+            failureCount: failures,
+            failureRate: total > 0 ? failures / total : 0,
+            avgDurationMs: Math.round(Number(r.avgMs) || 0),
+            maxDurationMs: Math.round(Number(r.maxMs) || 0),
+            topErrorCode: topErrorMap.get(r.command) ?? null,
+        };
+    });
+    // Top failing (min 5 invocations, sorted by failure rate desc)
+    const topFailing = stats
+        .filter((s) => s.count >= 5 && s.failureRate > 0)
+        .sort((a, b) => b.failureRate - a.failureRate)
+        .slice(0, 10);
+    // Top slowest (sorted by avgDurationMs desc)
+    const topSlow = [...stats].sort((a, b) => b.avgDurationMs - a.avgDurationMs).slice(0, 10);
+    // Rare commands (invoked only once in the window)
+    const rareCommands = stats.filter((s) => s.count === 1).map((s) => s.command);
+    // Generate high-signal observations for BRAIN
+    const observations = [];
+    for (const s of topFailing.slice(0, 5)) {
+        const pct = Math.round(s.failureRate * 100);
+        const errPart = s.topErrorCode ? ` (most common error: ${s.topErrorCode})` : '';
+        observations.push(`Command '${s.command}' fails ${pct}% of the time across ${s.count} invocations${errPart}. Investigate root cause.`);
+    }
+    // Flag commands 2x slower than median
+    const sortedAvg = stats.map((s) => s.avgDurationMs).sort((a, b) => a - b);
+    const median = sortedAvg[Math.floor(sortedAvg.length / 2)] ?? 0;
+    for (const s of topSlow.slice(0, 5)) {
+        if (median > 0 && s.avgDurationMs > median * 2) {
+            observations.push(`Command '${s.command}' averages ${s.avgDurationMs}ms — ${Math.round(s.avgDurationMs / median)}x slower than the ${median}ms median. Profile for performance improvement.`);
+        }
+    }
+    return { period: { from, to }, totalEvents, topFailing, topSlow, rareCommands, observations };
+}
+/**
+ * Export all telemetry events as a JSON array.
+ * Returns empty array when telemetry is disabled or DB is empty.
+ */
+export async function exportTelemetryEvents(days) {
+    const config = loadTelemetryConfig();
+    if (!config.enabled)
+        return [];
+    const db = await getTelemetryDb();
+    const rows = days
+        ? await db
+            .select()
+            .from(telemetryEvents)
+            .where(gt(telemetryEvents.timestamp, daysAgo(days)))
+            .orderBy(desc(telemetryEvents.timestamp))
+            .all()
+        : await db.select().from(telemetryEvents).orderBy(desc(telemetryEvents.timestamp)).all();
+    return rows.map((r) => ({
+        domain: r.domain,
+        gateway: r.gateway,
+        operation: r.operation,
+        durationMs: r.durationMs,
+        exitCode: r.exitCode,
+        errorCode: r.errorCode,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Re-exports
+// ---------------------------------------------------------------------------
+export * from './schema.js';
+export { getTelemetryDb, getTelemetryDbPath } from './sqlite.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

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

package/dist/telemetry/schema.js

@@ -0,0 +1,60 @@
+/**
+ * Drizzle ORM schema for CLEO telemetry.db (SQLite via node:sqlite + sqlite-proxy).
+ *
+ * Tables: telemetry_events, telemetry_schema_meta
+ *
+ * Stores anonymous, opt-in command telemetry for self-improvement analysis.
+ * Tracks which commands run, how fast they are, and whether they succeed.
+ * Telemetry is DISABLED by default; users must run `cleo diagnostics enable`.
+ *
+ * @task T624
+ */
+import { sql } from 'drizzle-orm';
+import { index, integer, sqliteTable, text } from 'drizzle-orm/sqlite-core';
+// === TELEMETRY_EVENTS TABLE ===
+/**
+ * One row per command invocation captured by the telemetry middleware.
+ *
+ * Fields are intentionally minimal — no params, no output, no user data.
+ * Only the shape of what was invoked and its outcome are stored.
+ */
+export const telemetryEvents = sqliteTable('telemetry_events', {
+    /** UUID primary key. */
+    id: text('id').primaryKey(),
+    /** Anonymous install identifier (UUIDv4, generated once on first enable). */
+    anonymousId: text('anonymous_id').notNull(),
+    /** Canonical domain (e.g. "tasks", "session", "memory", "admin"). */
+    domain: text('domain').notNull(),
+    /** CQRS gateway ("query" or "mutate"). */
+    gateway: text('gateway').notNull(),
+    /** Operation name (e.g. "show", "add", "complete"). */
+    operation: text('operation').notNull(),
+    /** Composed command string "{domain}.{operation}" for easy grouping. */
+    command: text('command').notNull(),
+    /** LAFS exit code (0 = success, non-zero = failure). */
+    exitCode: integer('exit_code').notNull().default(0),
+    /** Wall-clock duration in milliseconds. */
+    durationMs: integer('duration_ms').notNull(),
+    /** Machine-readable error code when exit_code != 0. NULL on success. */
+    errorCode: text('error_code'),
+    /** ISO-8601 timestamp of the invocation. */
+    timestamp: text('timestamp').notNull().default(sql `(datetime('now'))`),
+}, (table) => [
+    index('idx_telemetry_command').on(table.command),
+    index('idx_telemetry_domain').on(table.domain),
+    index('idx_telemetry_exit_code').on(table.exitCode),
+    index('idx_telemetry_timestamp').on(table.timestamp),
+    index('idx_telemetry_duration').on(table.durationMs),
+]);
+// === TELEMETRY_SCHEMA_META TABLE ===
+/**
+ * Key-value store for schema version tracking.
+ * Single row with key='schema_version' on first migration.
+ */
+export const telemetrySchemaMeta = sqliteTable('telemetry_schema_meta', {
+    /** Config key. */
+    key: text('key').primaryKey(),
+    /** Config value. */
+    value: text('value').notNull(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/telemetry/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/telemetry/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE5E,iCAAiC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CACxC,kBAAkB,EAClB;IACE,wBAAwB;IACxB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,6EAA6E;IAC7E,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,qEAAqE;IACrE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,0CAA0C;IAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,uDAAuD;IACvD,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACtC,wEAAwE;IACxE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IAC5C,wEAAwE;IACxE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CACvE,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAChD,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9C,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;IACnD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACpD,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;CACrD,CACF,CAAC;AAEF,sCAAsC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC,uBAAuB,EAAE;IACtE,kBAAkB;IAClB,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;IAC7B,oBAAoB;IACpB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC"}

package/dist/telemetry/sqlite.js

@@ -0,0 +1,111 @@
+/**
+ * SQLite store for telemetry.db via drizzle-orm/node-sqlite + node:sqlite.
+ *
+ * Stores opt-in command telemetry in ~/.local/share/cleo/telemetry.db.
+ * Follows the same singleton + WAL + migration pattern as brain-sqlite.ts.
+ * Telemetry is disabled by default — check isTelemetryEnabled() before writing.
+ *
+ * @task T624
+ */
+import { mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { drizzle } from 'drizzle-orm/node-sqlite';
+import { getCleoHome } from '../paths.js';
+import { ensureColumns, migrateWithRetry, reconcileJournal } from '../store/migration-manager.js';
+import { openNativeDatabase } from '../store/sqlite.js';
+import * as telemetrySchema from './schema.js';
+/** Database file name in the global CLEO home directory. */
+const DB_FILENAME = 'telemetry.db';
+/** Schema version. Single source of truth. */
+export const TELEMETRY_SCHEMA_VERSION = '1.0.0';
+/** Singleton state. */
+let _db = null;
+let _nativeDb = null;
+let _dbPath = null;
+let _initPromise = null;
+/**
+ * Get the absolute path to telemetry.db in the global CLEO home directory.
+ * Linux: ~/.local/share/cleo/telemetry.db
+ */
+export function getTelemetryDbPath() {
+    return join(getCleoHome(), DB_FILENAME);
+}
+/**
+ * Resolve the drizzle-telemetry migrations folder.
+ * Handles both src/ (dev via tsx) and dist/ (bundled) layouts.
+ */
+export function resolveTelemetryMigrationsFolder() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dir = dirname(__filename);
+    // src/telemetry/ → ../../migrations/drizzle-telemetry
+    // dist/          → ../migrations/drizzle-telemetry
+    const isBundled = __dir.endsWith('/dist') || __dir.endsWith('\\dist');
+    const pkgRoot = isBundled ? join(__dir, '..') : join(__dir, '..', '..');
+    return join(pkgRoot, 'migrations', 'drizzle-telemetry');
+}
+/**
+ * Run drizzle migrations to create/update telemetry.db tables.
+ */
+function runTelemetryMigrations(nativeDb, db) {
+    const migrationsFolder = resolveTelemetryMigrationsFolder();
+    reconcileJournal(nativeDb, migrationsFolder, 'telemetry_events', 'telemetry');
+    migrateWithRetry(db, migrationsFolder, nativeDb, 'telemetry_events', 'telemetry');
+    // Safety net: ensure core columns exist even if migration was skipped.
+    ensureColumns(nativeDb, 'telemetry_events', [
+        { name: 'anonymous_id', ddl: "text NOT NULL DEFAULT ''" },
+        { name: 'domain', ddl: "text NOT NULL DEFAULT ''" },
+        { name: 'gateway', ddl: "text NOT NULL DEFAULT 'query'" },
+        { name: 'operation', ddl: "text NOT NULL DEFAULT ''" },
+        { name: 'command', ddl: "text NOT NULL DEFAULT ''" },
+        { name: 'exit_code', ddl: 'integer NOT NULL DEFAULT 0' },
+        { name: 'duration_ms', ddl: 'integer NOT NULL DEFAULT 0' },
+        { name: 'error_code', ddl: 'text' },
+    ], 'telemetry');
+}
+/**
+ * Reset the singleton (used in tests).
+ */
+export function resetTelemetryDbState() {
+    try {
+        _nativeDb?.close();
+    }
+    catch {
+        // ignore
+    }
+    _db = null;
+    _nativeDb = null;
+    _dbPath = null;
+    _initPromise = null;
+}
+/**
+ * Initialize telemetry.db (lazy singleton).
+ * Creates the file and runs migrations on first call.
+ */
+export async function getTelemetryDb() {
+    const requestedPath = getTelemetryDbPath();
+    if (_db && _dbPath !== requestedPath) {
+        resetTelemetryDbState();
+    }
+    if (_db)
+        return _db;
+    if (_initPromise)
+        return _initPromise;
+    _initPromise = (async () => {
+        const dbPath = requestedPath;
+        _dbPath = dbPath;
+        mkdirSync(dirname(dbPath), { recursive: true });
+        const nativeDb = openNativeDatabase(dbPath);
+        _nativeDb = nativeDb;
+        const db = drizzle({ client: nativeDb, schema: telemetrySchema });
+        runTelemetryMigrations(nativeDb, db);
+        // Seed schema version (idempotent)
+        nativeDb
+            .prepare(`INSERT OR IGNORE INTO telemetry_schema_meta (key, value) VALUES ('schemaVersion', '${TELEMETRY_SCHEMA_VERSION}')`)
+            .run();
+        _db = db;
+        return db;
+    })();
+    return _initPromise;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/telemetry/sqlite.js.map

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

package/dist/templates/index.js

@@ -0,0 +1,10 @@
+/**
+ * Core Templates Module
+ *
+ * Barrel export for GitHub issue template parsing logic.
+ *
+ * @task T5705
+ * @epic T5701
+ */
+export { generateTemplateConfig, getTemplateForSubcommand, parseIssueTemplates, validateLabels, } from './parser.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC"}