@jaguilar87/gaia 5.0.0-rc.2

package/bin/gaia-status.js

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+
+/**
+ * @jaguilar87/gaia - System Status CLI
+ *
+ * Quick snapshot of the current gaia-ops system state.
+ *
+ * Usage:
+ *   npx gaia-status
+ */
+
+import { join, dirname, resolve } from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+import chalk from 'chalk';
+
+function findProjectRoot() {
+  if (process.env.INIT_CWD) {
+    if (existsSync(join(process.env.INIT_CWD, '.claude'))) return process.env.INIT_CWD;
+  }
+  let currentDir = process.cwd();
+  const root = resolve('/');
+  while (currentDir !== root) {
+    if (existsSync(join(currentDir, '.claude'))) return currentDir;
+    currentDir = dirname(currentDir);
+  }
+  return process.env.INIT_CWD || process.cwd();
+}
+
+const CWD = findProjectRoot();
+
+// ─────────────────────────────────────────────────────────────
+// DATA READERS
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Read the last non-empty line of a file.
+ */
+async function readLastLine(filePath) {
+  try {
+    const content = await fs.readFile(filePath, 'utf-8');
+    const lines = content.split('\n').filter(l => l.trim());
+    return lines.length > 0 ? lines[lines.length - 1] : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read the episodic memory index. Returns { episodes, lastAgent } where
+ * episodes is the full array and lastAgent is the last entry with an agent field.
+ * Falls back to workflow-episodic-memory/metrics.jsonl for backward compatibility.
+ */
+async function readEpisodicIndex() {
+  // Primary: episodic-memory/index.json
+  try {
+    const indexPath = join(CWD, '.claude', 'project-context', 'episodic-memory', 'index.json');
+    if (existsSync(indexPath)) {
+      const data = JSON.parse(await fs.readFile(indexPath, 'utf-8'));
+      const episodes = data.episodes || [];
+      const withAgent = episodes.filter(e => e.agent);
+      if (withAgent.length > 0) {
+        const lastAgent = withAgent[withAgent.length - 1];
+        return { episodes, lastAgent, source: 'episodic-memory' };
+      }
+      // Episodes exist but none have agent field (pre-backfill) -- fall through
+      if (episodes.length > 0) {
+        return { episodes, lastAgent: null, source: 'episodic-memory' };
+      }
+    }
+  } catch { /* fall through to legacy */ }
+
+  // Fallback: read both old sources
+  const episodes = [];
+  let lastAgent = null;
+
+  try {
+    const metricsPath = join(CWD, '.claude', 'project-context', 'workflow-episodic-memory', 'metrics.jsonl');
+    if (existsSync(metricsPath)) {
+      const line = await readLastLine(metricsPath);
+      if (line) {
+        try { lastAgent = JSON.parse(line); } catch { /* skip */ }
+      }
+    }
+  } catch { /* skip */ }
+
+  return { episodes, lastAgent, source: 'legacy' };
+}
+
+/**
+ * Get pending context update count from index.
+ */
+async function getPendingCount() {
+  const indexPath = join(CWD, '.claude', 'project-context', 'pending-updates', 'pending-index.json');
+  if (!existsSync(indexPath)) return 0;
+  try {
+    const data = JSON.parse(await fs.readFile(indexPath, 'utf-8'));
+    return data.pending_count || 0;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * Count active signal files in workflow-episodic-memory/signals/.
+ */
+async function getAnomalyCount() {
+  const signalsDir = join(CWD, '.claude', 'project-context', 'workflow-episodic-memory', 'signals');
+  if (!existsSync(signalsDir)) return 0;
+  try {
+    const files = await fs.readdir(signalsDir);
+    return files.filter(f => f.endsWith('.flag')).length;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * Get project-context.json last_updated timestamp.
+ */
+async function getContextLastUpdated() {
+  const contextPath = join(CWD, '.claude', 'project-context', 'project-context.json');
+  if (!existsSync(contextPath)) return null;
+  try {
+    const data = JSON.parse(await fs.readFile(contextPath, 'utf-8'));
+    return data.metadata?.last_updated || null;
+  } catch {
+    return null;
+  }
+}
+
+// getEpisodeCount and getMetricsCount removed -- now unified in readEpisodicIndex()
+
+/**
+ * Get response contract validation stats from session result files.
+ * Reads response-contract session directories for last-result.json files.
+ * Returns an object with valid and total counts, or null if no data exists.
+ */
+async function getContractStats() {
+  const contractDir = join(CWD, '.claude', 'session', 'active', 'response-contract');
+  if (!existsSync(contractDir)) return null;
+
+  try {
+    const entries = await fs.readdir(contractDir, { withFileTypes: true });
+    const sessionDirs = entries.filter(e => e.isDirectory() && e.name.startsWith('session-'));
+
+    let valid = 0;
+    let total = 0;
+
+    for (const dir of sessionDirs) {
+      const resultPath = join(contractDir, dir.name, 'last-result.json');
+      try {
+        const data = JSON.parse(await fs.readFile(resultPath, 'utf-8'));
+        if (data.validation) {
+          total++;
+          if (data.validation.valid) valid++;
+        }
+      } catch { /* skip unreadable files */ }
+    }
+
+    return total > 0 ? { valid, total } : null;
+  } catch {
+    return null;
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// FORMAT HELPERS
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Format an ISO timestamp as a short local time string (HH:MM today, or MM-DD HH:MM otherwise).
+ */
+function formatTime(iso) {
+  if (!iso) return 'unknown';
+  try {
+    const d = new Date(iso);
+    const today = new Date().toISOString().slice(0, 10);
+    const dayStr = d.toISOString().slice(0, 10);
+    if (dayStr === today) {
+      return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', hour12: false });
+    }
+    return `${dayStr.slice(5)} ${d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', hour12: false })}`;
+  } catch {
+    return iso.slice(0, 16).replace('T', ' ');
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// MAIN
+// ─────────────────────────────────────────────────────────────
+
+async function main() {
+  process.stderr.write('[DEPRECATED] gaia-status.js is deprecated. Use: python3 bin/gaia status\n[DEPRECATED] Migration guide: see CHANGELOG.md\n');
+
+  const claudeDir = join(CWD, '.claude');
+  if (!existsSync(claudeDir)) {
+    console.log(chalk.yellow('\n  gaia-ops not installed in this directory'));
+    console.log(chalk.gray('  Run: npx gaia-scan\n'));
+    process.exit(1);
+  }
+
+  const [
+    episodicData,
+    pendingCount,
+    anomalyCount,
+    contextUpdated,
+    contractStats,
+  ] = await Promise.all([
+    readEpisodicIndex(),
+    getPendingCount(),
+    getAnomalyCount(),
+    getContextLastUpdated(),
+    getContractStats(),
+  ]);
+
+  const lastAgent = episodicData.lastAgent;
+  const episodeCount = episodicData.episodes.length || null;
+  const agentSessionCount = episodicData.episodes.filter(e => e.agent).length;
+
+  const SEP = chalk.gray('─'.repeat(50));
+
+  console.log(chalk.cyan('\n  Gaia System Status'));
+  console.log('  ' + SEP);
+
+  // Last agent
+  if (lastAgent) {
+    const time = formatTime(lastAgent.timestamp);
+    const status = lastAgent.plan_status || (lastAgent.exit_code === 0 ? 'ok' : 'failed');
+    const statusColor = status === 'COMPLETE' || status === 'ok' ? chalk.green
+      : status === 'BLOCKED' ? chalk.red
+      : chalk.yellow;
+    const agentName = lastAgent.agent || '(unknown)';
+    console.log(
+      `  Last agent:   ${chalk.bold(agentName.padEnd(22))} ${chalk.gray(time)} — ${statusColor(status)}`
+    );
+  } else {
+    console.log(`  Last agent:   ${chalk.gray('no agent sessions recorded yet')}`);
+  }
+
+  // Pending updates
+  const pendingColor = pendingCount > 0 ? chalk.yellow : chalk.green;
+  const pendingNote = pendingCount > 0 ? chalk.gray('  run: npx gaia-review') : '';
+  console.log(`  Pending:      ${pendingColor(`${pendingCount} context update${pendingCount !== 1 ? 's' : ''} to review`)}${pendingNote}`);
+
+  // Anomalies
+  const anomalyColor = anomalyCount > 0 ? chalk.red : chalk.green;
+  const anomalyNote = anomalyCount > 0 ? chalk.gray('  check workflow-episodic-memory/signals/') : '';
+  console.log(`  Anomalies:    ${anomalyColor(`${anomalyCount} active signal${anomalyCount !== 1 ? 's' : ''}`)}${anomalyNote}`);
+
+  // Context
+  if (contextUpdated) {
+    console.log(`  Context:      project-context.json — ${chalk.gray('updated ' + formatTime(contextUpdated))}`);
+  } else {
+    console.log(`  Context:      ${chalk.yellow('project-context.json missing — run gaia-scan')}`);
+  }
+
+
+
+  // Memory
+  const epStr = episodeCount ? `${episodeCount} episodes` : 'no episodic-memory';
+  const agentStr = agentSessionCount > 0 ? `${agentSessionCount} agent sessions` : 'no agent sessions';
+  console.log(`  Memory:       ${chalk.gray(epStr + '  |  ' + agentStr)}`);
+
+  // Contract validation stats (only shown if data exists)
+  if (contractStats) {
+    const pct = Math.round((contractStats.valid / contractStats.total) * 100);
+    const contractColor = pct >= 80 ? chalk.green : pct >= 50 ? chalk.yellow : chalk.red;
+    console.log(`  Contracts:    ${contractColor(`${contractStats.valid} valid / ${contractStats.total} total (${pct}% success rate)`)}`);
+  }
+
+  console.log('  ' + SEP + '\n');
+}
+
+main().catch(err => {
+  console.error(chalk.red(`\n  Error: ${err.message}\n`));
+  process.exit(1);
+});

package/bin/gaia-uninstall.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+/**
+ * @jaguilar87/gaia - Uninstall wrapper
+ *
+ * Safely uninstalls gaia-ops by:
+ * 1. Running gaia-cleanup to remove all generated files
+ * 2. Running npm uninstall to remove the package
+ *
+ * Usage:
+ *   npx gaia-uninstall
+ *   OR
+ *   npm exec gaia-uninstall
+ *
+ * This ensures a clean uninstallation with no leftover files.
+ */
+
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+import chalk from 'chalk';
+import ora from 'ora';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const CWD = process.env.INIT_CWD || process.cwd();
+
+/**
+ * Run gaia-cleanup to remove generated files
+ */
+async function runCleanup() {
+  const spinner = ora('Running cleanup...').start();
+
+  try {
+    // Import and execute gaia-cleanup
+    const cleanupScript = join(__dirname, 'gaia-cleanup.js');
+
+    if (!existsSync(cleanupScript)) {
+      spinner.fail('Cleanup script not found');
+      return false;
+    }
+
+    // Execute cleanup by importing it
+    await import(`file://${cleanupScript}`);
+
+    spinner.succeed('Cleanup completed');
+    return true;
+  } catch (error) {
+    spinner.fail(`Cleanup failed: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Run npm uninstall
+ */
+function runUninstall() {
+  const spinner = ora('Uninstalling @jaguilar87/gaia...').start();
+
+  try {
+    execSync('npm uninstall @jaguilar87/gaia', {
+      cwd: CWD,
+      stdio: 'inherit'
+    });
+
+    spinner.succeed('Package uninstalled');
+    return true;
+  } catch (error) {
+    spinner.fail(`Uninstall failed: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Main function
+ */
+async function main() {
+  console.log(chalk.cyan('\n🗑️  @jaguilar87/gaia uninstaller\n'));
+
+  try {
+    // Step 1: Run cleanup
+    const cleanupSuccess = await runCleanup();
+
+    if (!cleanupSuccess) {
+      console.log(chalk.yellow('\n⚠️  Cleanup had issues, but continuing with uninstall...\n'));
+    }
+
+    console.log('');
+
+    // Step 2: Run uninstall
+    const uninstallSuccess = runUninstall();
+
+    if (uninstallSuccess) {
+      console.log(chalk.green('\n✅ Uninstall complete!\n'));
+      console.log(chalk.gray('All gaia-ops files have been removed.'));
+      console.log(chalk.gray('Your project data (logs, tests, project-context) was preserved.\n'));
+    } else {
+      console.log(chalk.red('\n❌ Uninstall failed\n'));
+      console.log(chalk.yellow('You can try manually:'));
+      console.log(chalk.gray('  1. npx gaia-cleanup'));
+      console.log(chalk.gray('  2. npm uninstall @jaguilar87/gaia\n'));
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Uninstall error: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+
+main();