@eltonssouza/development-utility-kit 1.0.0

package/scripts/hooks/telemetry-writer.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * telemetry-writer.js
+ * Reads a SubagentStop JSON payload from stdin, normalises the model name,
+ * and persists the event to ~/.claude/telemetry.db via better-sqlite3.
+ * Falls back to sql.js, then to NDJSON queue if native bindings are absent.
+ * Never throws an uncaught exception — all errors are silently logged.
+ */
+
+const fs   = require('fs');
+const os   = require('os');
+const path = require('path');
+
+const CLAUDE_DIR    = path.join(os.homedir(), '.claude');
+const DB_PATH       = path.join(CLAUDE_DIR, 'telemetry.db');
+const QUEUE_PATH    = path.join(CLAUDE_DIR, 'telemetry-queue.ndjson');
+const ERROR_LOG     = path.join(CLAUDE_DIR, 'telemetry-errors.log');
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+function logError(msg, err) {
+  try {
+    const line = `${new Date().toISOString()} ${msg}${err ? ': ' + err.message : ''}\n`;
+    fs.appendFileSync(ERROR_LOG, line);
+  } catch (_) {
+    // last-resort: swallow
+  }
+}
+
+function normaliseModel(raw) {
+  if (!raw || typeof raw !== 'string') return 'other';
+  const lower = raw.toLowerCase();
+  if (lower.includes('opus'))   return 'opus';
+  if (lower.includes('sonnet')) return 'sonnet';
+  if (lower.includes('haiku'))  return 'haiku';
+  return 'other';
+}
+
+const CREATE_TABLE = `
+  CREATE TABLE IF NOT EXISTS events (
+    id            INTEGER PRIMARY KEY AUTOINCREMENT,
+    project_path  TEXT    NOT NULL,
+    project_name  TEXT    NOT NULL,
+    model         TEXT    NOT NULL,
+    input_tokens  INTEGER NOT NULL DEFAULT 0,
+    output_tokens INTEGER NOT NULL DEFAULT 0,
+    subagent_type TEXT,
+    session_id    TEXT,
+    agent_id      TEXT,
+    agent_type    TEXT,
+    ts            INTEGER NOT NULL
+  )
+`;
+
+const CREATE_IDX_TS      = 'CREATE INDEX IF NOT EXISTS idx_events_ts      ON events(ts)';
+const CREATE_IDX_PROJECT = 'CREATE INDEX IF NOT EXISTS idx_events_project ON events(project_path)';
+const CREATE_IDX_SESSION = 'CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id)';
+
+// Idempotent migrations for DBs created by previous writer versions.
+const ALTER_STATEMENTS = [
+  'ALTER TABLE events ADD COLUMN session_id TEXT',
+  'ALTER TABLE events ADD COLUMN agent_id TEXT',
+  'ALTER TABLE events ADD COLUMN agent_type TEXT',
+];
+
+const INSERT_SQL = `
+  INSERT INTO events
+    (project_path, project_name, model, input_tokens, output_tokens,
+     subagent_type, session_id, agent_id, agent_type, ts)
+  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+`;
+
+// ── SQLite backends ───────────────────────────────────────────────────────────
+
+/**
+ * Attempt to open DB via better-sqlite3 (native, synchronous).
+ * Returns a { run(sql, params) } adapter or throws.
+ */
+function tryBetterSqlite3(event) {
+  // Look for better-sqlite3 relative to the dashboard/ directory first
+  // (Sprint 2 will install it there), then fall back to standard resolution.
+  const candidates = [
+    path.join(__dirname, '..', '..', 'dashboard', 'node_modules', 'better-sqlite3'),
+    'better-sqlite3',
+  ];
+
+  let Database;
+  for (const candidate of candidates) {
+    try {
+      Database = require(candidate);
+      break;
+    } catch (_) {
+      // try next
+    }
+  }
+
+  if (!Database) throw new Error('better-sqlite3 not available');
+
+  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+  const db = new Database(DB_PATH);
+  db.exec(CREATE_TABLE);
+  db.exec(CREATE_IDX_TS);
+  db.exec(CREATE_IDX_PROJECT);
+  db.exec(CREATE_IDX_SESSION);
+  for (const stmt of ALTER_STATEMENTS) {
+    try { db.exec(stmt); } catch (_) { /* column already exists */ }
+  }
+  db.prepare(INSERT_SQL).run(
+    event.project_path,
+    event.project_name,
+    event.model,
+    event.input_tokens,
+    event.output_tokens,
+    event.subagent_type,
+    event.session_id,
+    event.agent_id,
+    event.agent_type,
+    event.ts
+  );
+  db.close();
+}
+
+/**
+ * Attempt to open DB via sql.js (pure-JS, WASM).
+ * Returns after persisting or throws.
+ */
+function trySqlJs(event) {
+  const initSqlJs = require('sql.js');
+
+  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+
+  // Load existing DB bytes if available
+  let fileBuffer = null;
+  if (fs.existsSync(DB_PATH)) {
+    fileBuffer = fs.readFileSync(DB_PATH);
+  }
+
+  // initSqlJs returns a Promise
+  return initSqlJs().then((SQL) => {
+    const db = fileBuffer ? new SQL.Database(fileBuffer) : new SQL.Database();
+    db.run(CREATE_TABLE);
+    db.run(CREATE_IDX_TS);
+    db.run(CREATE_IDX_PROJECT);
+    db.run(CREATE_IDX_SESSION);
+    for (const stmt of ALTER_STATEMENTS) {
+      try { db.run(stmt); } catch (_) { /* column already exists */ }
+    }
+    db.run(INSERT_SQL, [
+      event.project_path,
+      event.project_name,
+      event.model,
+      event.input_tokens,
+      event.output_tokens,
+      event.subagent_type,
+      event.session_id,
+      event.agent_id,
+      event.agent_type,
+      event.ts,
+    ]);
+    const data = db.export();
+    fs.writeFileSync(DB_PATH, Buffer.from(data));
+    db.close();
+  });
+}
+
+/**
+ * Last-resort fallback: append event as NDJSON line.
+ */
+function appendNdjson(event) {
+  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+  const line = JSON.stringify(event) + '\n';
+  fs.appendFileSync(QUEUE_PATH, line);
+}
+
+// ── main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  // Read all stdin
+  let raw = '';
+  try {
+    await new Promise((resolve, reject) => {
+      process.stdin.setEncoding('utf8');
+      process.stdin.on('data', (chunk) => { raw += chunk; });
+      process.stdin.on('end', resolve);
+      process.stdin.on('error', reject);
+    });
+  } catch (err) {
+    logError('stdin read error', err);
+    process.exit(0);
+  }
+
+  // Parse JSON — tolerate empty / invalid stdin gracefully
+  let payload = {};
+  try {
+    if (raw.trim()) {
+      payload = JSON.parse(raw.trim());
+    }
+  } catch (err) {
+    logError('stdin JSON parse error', err);
+    // Continue with empty payload — we still record the event with defaults
+  }
+
+  // Build event record.
+  // Prefer `cwd` from the payload (Claude Code injects it for every hook event);
+  // fall back to CLAUDE_PROJECT_DIR for environments that still set it.
+  const projectPath = payload.cwd || process.env.CLAUDE_PROJECT_DIR || 'unknown';
+  const segments    = projectPath.split(/[\\/]/);
+  const projectName = segments[segments.length - 1] || 'unknown';
+
+  const usage = payload.usage || {};
+  const event = {
+    project_path:  projectPath,
+    project_name:  projectName,
+    model:         normaliseModel(payload.model),
+    input_tokens:  parseInt(usage.input_tokens, 10) || 0,
+    output_tokens: parseInt(usage.output_tokens, 10) || 0,
+    subagent_type: payload.agent_type || payload.type || null,
+    session_id:    payload.session_id || null,
+    agent_id:      payload.agent_id || null,
+    agent_type:    payload.agent_type || null,
+    ts:            (Date.now() / 1000) | 0,
+  };
+
+  // Persistence — try each backend in order
+  try {
+    tryBetterSqlite3(event);
+    process.exit(0);
+  } catch (e1) {
+    logError('better-sqlite3 failed, trying sql.js', e1);
+  }
+
+  try {
+    await trySqlJs(event);
+    process.exit(0);
+  } catch (e2) {
+    logError('sql.js failed, falling back to NDJSON', e2);
+  }
+
+  try {
+    appendNdjson(event);
+  } catch (e3) {
+    logError('NDJSON append failed', e3);
+  }
+
+  process.exit(0);
+}
+
+main();

package/scripts/latest-versions.json

@@ -0,0 +1,56 @@
+{
+  "_updated": "2026-05-27",
+  "_source": "manually curated; refresh via `duk install --refresh-versions` (future) or edit here",
+  "java": {
+    "latest_lts": "25",
+    "latest": "26"
+  },
+  "spring-boot": {
+    "latest": "4.0.0",
+    "latest_3x": "3.4.0"
+  },
+  "angular": {
+    "latest": "21.1.0"
+  },
+  "node": {
+    "latest_lts": "22",
+    "latest": "24"
+  },
+  "react": {
+    "latest": "19.0.0"
+  },
+  "react-native": {
+    "latest": "0.84.0"
+  },
+  "expo": {
+    "latest": "54.0.0"
+  },
+  "python": {
+    "latest_stable": "3.13",
+    "latest": "3.14"
+  },
+  "django": {
+    "latest": "5.1.0"
+  },
+  "fastapi": {
+    "latest": "0.115.0"
+  },
+  "go": {
+    "latest": "1.23.0"
+  },
+  "gin": {
+    "latest": "1.10.0"
+  },
+  "echo": {
+    "latest": "4.13.0"
+  },
+  "postgres": {
+    "latest_stable": "17"
+  },
+  "redis": {
+    "latest_stable": "7"
+  },
+  "mongodb": {
+    "latest_stable": "8"
+  }
+}