agentboss 0.1.0 → 0.1.1

package/bin/aboss.js

@@ -1,288 +1,288 @@
-#!/usr/bin/env node
-/**
- * Agent Boss CLI entry point.
- * Usage: aboss [--port PORT] [--no-open]
- *
- * Startup sequence (design doc §12.3):
- *  1. Parse CLI args
- *  2. Print banner
- *  3. Initialise database
- *  4. Detect data sources
- *  5. Run ETL sync (incremental)
- *  6. Calculate active times
- *  7. Start analysis job (background)
- *  8. Start Express server (with port auto-increment)
- *  9. Open browser (unless --no-open)
- * 10. Handle graceful shutdown
- *
- * @author Felix
- */
-
-'use strict';
-
-const { getDb, closeDb } = require('../server/db/connection');
-const { detectSources } = require('../server/etl/detect');
-const { backfillSubagents } = require('../server/etl/backfill-subagents');
-const { collectOpenCode } = require('../server/etl/opencode');
-const { collectClaudeCode } = require('../server/etl/claude-code');
-const { calculateActiveTime } = require('../server/etl/active-time');
-const { runAnalysisJob } = require('../server/analysis/job');
-const { startServer } = require('../server/index');
-
-// ---------------------------------------------------------------------------
-// CLI arg parsing
-// ---------------------------------------------------------------------------
-
-/**
- * Parse process.argv into { port, noOpen }.
- * @returns {{ port: number, noOpen: boolean }}
- */
-function parseArgs() {
-  const args = process.argv.slice(2);
-  let port = 3141;
-  let noOpen = false;
-
-  for (let i = 0; i < args.length; i++) {
-    if ((args[i] === '--port' || args[i] === '-p') && args[i + 1]) {
-      const parsed = Number(args[i + 1]);
-      if (!Number.isNaN(parsed) && parsed > 0 && parsed < 65536) {
-        port = parsed;
-      }
-      i++; // skip next arg (the port value)
-    } else if (args[i] === '--no-open') {
-      noOpen = true;
-    }
-  }
-
-  return { port, noOpen };
-}
-
-// ---------------------------------------------------------------------------
-// Banner
-// ---------------------------------------------------------------------------
-
-function printBanner() {
-  console.log('');
-  console.log('  ___                    _     ____');
-  console.log(' / _ \\  __ _  ___ _ __ | |_  | __ )  ___  ___ ___');
-  console.log("| |_| |/ _` |/ _ \\ '_ \\| __| |  _ \\ / _ \\/ __/ __|");
-  console.log('| ___ | (_| |  __/ | | | |_  | |_) | (_) \\__ \\__ \\');
-  console.log('|_| |_|\\__, |\\___|_| |_|\\__| |____/ \\___/|___/___/');
-  console.log('       |___/');
-  console.log('');
-  console.log('  Agent Boss v0.1.0');
-  console.log('  Be your AI agent\'s boss, not its babysitter.');
-  console.log('');
-}
-
-// ---------------------------------------------------------------------------
-// Port auto-increment helper
-// ---------------------------------------------------------------------------
-
-/**
- * Try starting the server on `startPort`, auto-incrementing on EADDRINUSE.
- * @param {object} db
- * @param {number} startPort
- * @param {number} maxAttempts
- * @returns {Promise<number>} the actual port used
- */
-async function startWithPortRetry(db, startPort, maxAttempts = 10) {
-  for (let i = 0; i < maxAttempts; i++) {
-    const port = startPort + i;
-    try {
-      await startServer(db, port);
-      if (port !== startPort) {
-        console.log(`[server]   Port ${startPort} is busy, using ${port} instead`);
-      }
-      return port;
-    } catch (err) {
-      if (err.code === 'EADDRINUSE' && i < maxAttempts - 1) {
-        continue; // try next port
-      }
-      throw err;
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-async function main() {
-  const { port: requestedPort, noOpen } = parseArgs();
-
-  // 1. Banner
-  printBanner();
-
-  // 2. Initialise database
-  let db;
-  try {
-    db = await getDb();
-    console.log('[db]       Database initialised');
-  } catch (err) {
-    console.error('[db]       Failed to initialise database:', err.message);
-    process.exit(1);
-  }
-
-  // 3. Detect data sources
-  let sources;
-  try {
-    sources = await detectSources(db);
-  } catch (err) {
-    console.error('[detect]   Source detection failed:', err.message);
-    sources = {
-      opencode: { status: 'not_found', path: '' },
-      claudeCode: { status: 'not_found', path: '' },
-    };
-  }
-
-  const ocAvailable = sources.opencode.status === 'available';
-  const ccAvailable = sources.claudeCode.status === 'available';
-
-  console.log(
-    `[detect]   OpenCode:   ${ocAvailable ? 'available' : 'not found'}` +
-      (ocAvailable ? ` (${sources.opencode.path})` : '')
-  );
-  console.log(
-    `[detect]   Claude Code: ${ccAvailable ? 'available' : 'not found'}` +
-      (ccAvailable ? ` (${sources.claudeCode.path})` : '')
-  );
-
-  // 4. Run ETL sync (incremental)
-  if (ocAvailable) {
-    try {
-      console.log('[etl]      Starting OpenCode ETL sync...');
-      const stats = await collectOpenCode(db, sources.opencode.path, {
-        onProgress: (msg) => console.log(`[etl]      ${msg}`),
-      });
-      console.log(
-        `[etl]      OpenCode ETL done: ${stats.sessionCount} sessions, ` +
-          `${stats.messageCount} messages, ${stats.toolCallCount} tool calls` +
-          (stats.errorSessionCount ? `, ${stats.errorSessionCount} failed` : '')
-      );
-    } catch (err) {
-      console.error('[etl]      OpenCode ETL sync failed:', err.message);
-    }
-  }
-
-  if (ccAvailable) {
-    try {
-      console.log('[etl]      Starting Claude Code ETL sync...');
-      const stats = await collectClaudeCode(db, sources.claudeCode.path, {
-        onProgress: (msg) => console.log(`[etl]      ${msg}`),
-      });
-      console.log(
-        `[etl]      Claude Code ETL done: ${stats.sessionCount} sessions, ` +
-          `${stats.messageCount} messages, ${stats.toolCallCount} tool calls` +
-          (stats.errorSessionCount ? `, ${stats.errorSessionCount} failed` : '')
-      );
-    } catch (err) {
-      console.error('[etl]      Claude Code ETL sync failed:', err.message);
-    }
-  }
-
-  if (!ocAvailable && !ccAvailable) {
-    console.log('[etl]      Skipping ETL (no data sources available)');
-  }
-
-  // 5. Calculate active times
-  try {
-    const updated = calculateActiveTime(db);
-    if (updated > 0) {
-      console.log(`[active]   Updated active_minutes for ${updated} session(s)`);
-    }
-  } catch (err) {
-    console.error('[active]   Active-time calculation failed:', err.message);
-  }
-
-  // 5.5 Backfill parent_session_id / agent_type for legacy rows imported
-  //     before the subagent linkage columns existed.  Idempotent + cheap
-  //     after the first run.  Failures are non-fatal.
-  if (ocAvailable) {
-    try {
-      const r = await backfillSubagents(db);
-      if (r.updated > 0) {
-        console.log(
-          `[backfill] Marked ${r.updated} subagent session(s) ` +
-          `(scanned ${r.scanned})`
-        );
-      } else if (r.reason) {
-        console.log(`[backfill] Skipped: ${r.reason}`);
-      }
-    } catch (err) {
-      console.error('[backfill] Subagent backfill failed:', err.message);
-    }
-  }
-
-  // 6. Start analysis job in background (don't await)
-  runAnalysisJob(db, {
-    onProgress: (p) => {
-      if (p.error) {
-        console.log(`[analysis] Error on ${p.date} session ${p.sessionId}: ${p.error}`);
-      } else if (p.aggregationError) {
-        console.log(`[analysis] Aggregation error for ${p.date}: ${p.aggregationError}`);
-      } else {
-        console.log(`[analysis] ${p.analyzed}/${p.total} sessions (${p.date})`);
-      }
-    },
-  })
-    .then((result) => {
-      console.log(
-        `[analysis] Background job complete: ${result.analyzed || 0} sessions analyzed`
-      );
-    })
-    .catch((err) => {
-      console.error('[analysis] Background job failed:', err.message);
-    });
-  console.log('[analysis] Analysis job started in background...');
-
-  // 7. Start Express server (with port auto-increment on EADDRINUSE)
-  let actualPort;
-  try {
-    actualPort = await startWithPortRetry(db, requestedPort);
-  } catch (err) {
-    console.error('[server]   Failed to start server:', err.message);
-    process.exit(1);
-  }
-
-  // 8. Open browser (unless --no-open)
-  if (!noOpen) {
-    const url = `http://localhost:${actualPort}`;
-    import('open')
-      .then((m) => m.default(url))
-      .catch(() => {
-        // 'open' is optional — if it fails, just print the URL
-        console.log(`[browser]  Could not open browser. Visit: ${url}`);
-      });
-  }
-
-  // 9. Graceful shutdown
-  process.on('SIGINT', async () => {
-    console.log('\n[shutdown] Shutting down gracefully...');
-    try {
-      await closeDb();
-    } catch (_) {
-      // best-effort
-    }
-    process.exit(0);
-  });
-
-  process.on('SIGTERM', async () => {
-    console.log('\n[shutdown] Received SIGTERM, shutting down...');
-    try {
-      await closeDb();
-    } catch (_) {
-      // best-effort
-    }
-    process.exit(0);
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Run
-// ---------------------------------------------------------------------------
-
-main().catch((err) => {
-  console.error('Fatal error:', err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * Agent Boss CLI entry point.
+ * Usage: aboss [--port PORT] [--no-open]
+ *
+ * Startup sequence (design doc §12.3):
+ *  1. Parse CLI args
+ *  2. Print banner
+ *  3. Initialise database
+ *  4. Detect data sources
+ *  5. Run ETL sync (incremental)
+ *  6. Calculate active times
+ *  7. Start analysis job (background)
+ *  8. Start Express server (with port auto-increment)
+ *  9. Open browser (unless --no-open)
+ * 10. Handle graceful shutdown
+ *
+ * @author Felix
+ */
+
+'use strict';
+
+const { getDb, closeDb } = require('../server/db/connection');
+const { detectSources } = require('../server/etl/detect');
+const { backfillSubagents } = require('../server/etl/backfill-subagents');
+const { collectOpenCode } = require('../server/etl/opencode');
+const { collectClaudeCode } = require('../server/etl/claude-code');
+const { calculateActiveTime } = require('../server/etl/active-time');
+const { runAnalysisJob } = require('../server/analysis/job');
+const { startServer } = require('../server/index');
+
+// ---------------------------------------------------------------------------
+// CLI arg parsing
+// ---------------------------------------------------------------------------
+
+/**
+ * Parse process.argv into { port, noOpen }.
+ * @returns {{ port: number, noOpen: boolean }}
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let port = 3141;
+  let noOpen = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === '--port' || args[i] === '-p') && args[i + 1]) {
+      const parsed = Number(args[i + 1]);
+      if (!Number.isNaN(parsed) && parsed > 0 && parsed < 65536) {
+        port = parsed;
+      }
+      i++; // skip next arg (the port value)
+    } else if (args[i] === '--no-open') {
+      noOpen = true;
+    }
+  }
+
+  return { port, noOpen };
+}
+
+// ---------------------------------------------------------------------------
+// Banner
+// ---------------------------------------------------------------------------
+
+function printBanner() {
+  console.log('');
+  console.log('  ___                    _     ____');
+  console.log(' / _ \\  __ _  ___ _ __ | |_  | __ )  ___  ___ ___');
+  console.log("| |_| |/ _` |/ _ \\ '_ \\| __| |  _ \\ / _ \\/ __/ __|");
+  console.log('| ___ | (_| |  __/ | | | |_  | |_) | (_) \\__ \\__ \\');
+  console.log('|_| |_|\\__, |\\___|_| |_|\\__| |____/ \\___/|___/___/');
+  console.log('       |___/');
+  console.log('');
+  console.log('  Agent Boss v0.1.0');
+  console.log('  Be your AI agent\'s boss, not its babysitter.');
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Port auto-increment helper
+// ---------------------------------------------------------------------------
+
+/**
+ * Try starting the server on `startPort`, auto-incrementing on EADDRINUSE.
+ * @param {object} db
+ * @param {number} startPort
+ * @param {number} maxAttempts
+ * @returns {Promise<number>} the actual port used
+ */
+async function startWithPortRetry(db, startPort, maxAttempts = 10) {
+  for (let i = 0; i < maxAttempts; i++) {
+    const port = startPort + i;
+    try {
+      await startServer(db, port);
+      if (port !== startPort) {
+        console.log(`[server]   Port ${startPort} is busy, using ${port} instead`);
+      }
+      return port;
+    } catch (err) {
+      if (err.code === 'EADDRINUSE' && i < maxAttempts - 1) {
+        continue; // try next port
+      }
+      throw err;
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  const { port: requestedPort, noOpen } = parseArgs();
+
+  // 1. Banner
+  printBanner();
+
+  // 2. Initialise database
+  let db;
+  try {
+    db = await getDb();
+    console.log('[db]       Database initialised');
+  } catch (err) {
+    console.error('[db]       Failed to initialise database:', err.message);
+    process.exit(1);
+  }
+
+  // 3. Detect data sources
+  let sources;
+  try {
+    sources = await detectSources(db);
+  } catch (err) {
+    console.error('[detect]   Source detection failed:', err.message);
+    sources = {
+      opencode: { status: 'not_found', path: '' },
+      claudeCode: { status: 'not_found', path: '' },
+    };
+  }
+
+  const ocAvailable = sources.opencode.status === 'available';
+  const ccAvailable = sources.claudeCode.status === 'available';
+
+  console.log(
+    `[detect]   OpenCode:   ${ocAvailable ? 'available' : 'not found'}` +
+      (ocAvailable ? ` (${sources.opencode.path})` : '')
+  );
+  console.log(
+    `[detect]   Claude Code: ${ccAvailable ? 'available' : 'not found'}` +
+      (ccAvailable ? ` (${sources.claudeCode.path})` : '')
+  );
+
+  // 4. Run ETL sync (incremental)
+  if (ocAvailable) {
+    try {
+      console.log('[etl]      Starting OpenCode ETL sync...');
+      const stats = await collectOpenCode(db, sources.opencode.path, {
+        onProgress: (msg) => console.log(`[etl]      ${msg}`),
+      });
+      console.log(
+        `[etl]      OpenCode ETL done: ${stats.sessionCount} sessions, ` +
+          `${stats.messageCount} messages, ${stats.toolCallCount} tool calls` +
+          (stats.errorSessionCount ? `, ${stats.errorSessionCount} failed` : '')
+      );
+    } catch (err) {
+      console.error('[etl]      OpenCode ETL sync failed:', err.message);
+    }
+  }
+
+  if (ccAvailable) {
+    try {
+      console.log('[etl]      Starting Claude Code ETL sync...');
+      const stats = await collectClaudeCode(db, sources.claudeCode.path, {
+        onProgress: (msg) => console.log(`[etl]      ${msg}`),
+      });
+      console.log(
+        `[etl]      Claude Code ETL done: ${stats.sessionCount} sessions, ` +
+          `${stats.messageCount} messages, ${stats.toolCallCount} tool calls` +
+          (stats.errorSessionCount ? `, ${stats.errorSessionCount} failed` : '')
+      );
+    } catch (err) {
+      console.error('[etl]      Claude Code ETL sync failed:', err.message);
+    }
+  }
+
+  if (!ocAvailable && !ccAvailable) {
+    console.log('[etl]      Skipping ETL (no data sources available)');
+  }
+
+  // 5. Calculate active times
+  try {
+    const updated = calculateActiveTime(db);
+    if (updated > 0) {
+      console.log(`[active]   Updated active_minutes for ${updated} session(s)`);
+    }
+  } catch (err) {
+    console.error('[active]   Active-time calculation failed:', err.message);
+  }
+
+  // 5.5 Backfill parent_session_id / agent_type for legacy rows imported
+  //     before the subagent linkage columns existed.  Idempotent + cheap
+  //     after the first run.  Failures are non-fatal.
+  if (ocAvailable) {
+    try {
+      const r = await backfillSubagents(db);
+      if (r.updated > 0) {
+        console.log(
+          `[backfill] Marked ${r.updated} subagent session(s) ` +
+          `(scanned ${r.scanned})`
+        );
+      } else if (r.reason) {
+        console.log(`[backfill] Skipped: ${r.reason}`);
+      }
+    } catch (err) {
+      console.error('[backfill] Subagent backfill failed:', err.message);
+    }
+  }
+
+  // 6. Start analysis job in background (don't await)
+  runAnalysisJob(db, {
+    onProgress: (p) => {
+      if (p.error) {
+        console.log(`[analysis] Error on ${p.date} session ${p.sessionId}: ${p.error}`);
+      } else if (p.aggregationError) {
+        console.log(`[analysis] Aggregation error for ${p.date}: ${p.aggregationError}`);
+      } else {
+        console.log(`[analysis] ${p.analyzed}/${p.total} sessions (${p.date})`);
+      }
+    },
+  })
+    .then((result) => {
+      console.log(
+        `[analysis] Background job complete: ${result.analyzed || 0} sessions analyzed`
+      );
+    })
+    .catch((err) => {
+      console.error('[analysis] Background job failed:', err.message);
+    });
+  console.log('[analysis] Analysis job started in background...');
+
+  // 7. Start Express server (with port auto-increment on EADDRINUSE)
+  let actualPort;
+  try {
+    actualPort = await startWithPortRetry(db, requestedPort);
+  } catch (err) {
+    console.error('[server]   Failed to start server:', err.message);
+    process.exit(1);
+  }
+
+  // 8. Open browser (unless --no-open)
+  if (!noOpen) {
+    const url = `http://localhost:${actualPort}`;
+    import('open')
+      .then((m) => m.default(url))
+      .catch(() => {
+        // 'open' is optional — if it fails, just print the URL
+        console.log(`[browser]  Could not open browser. Visit: ${url}`);
+      });
+  }
+
+  // 9. Graceful shutdown
+  process.on('SIGINT', async () => {
+    console.log('\n[shutdown] Shutting down gracefully...');
+    try {
+      await closeDb();
+    } catch (_) {
+      // best-effort
+    }
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', async () => {
+    console.log('\n[shutdown] Received SIGTERM, shutting down...');
+    try {
+      await closeDb();
+    } catch (_) {
+      // best-effort
+    }
+    process.exit(0);
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Run
+// ---------------------------------------------------------------------------
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});