@arka-labs/nemesis 1.2.0

package/src/commands/inbox.js

@@ -0,0 +1,333 @@
+/**
+ * nemesis inbox — Manage human document inbox pipeline.
+ *
+ * Subcommands:
+ *   list             List pending documents
+ *   add <file>       Add a document to the inbox
+ *   process [docId]  Dispatch a document to the Leader for MC draft
+ *   history          Show completed documents
+ *
+ * Options:
+ *   -h, --help       Help
+ */
+
+import { resolve } from 'node:path';
+import { ensureProject, pickFromList, BACK_ITEM, HOME_ITEM } from './_helpers.js';
+import { readRegistry, getLanes } from '../../lib/core/registry.js';
+import {
+  addDocument,
+  addDocumentFromText,
+  listDocuments,
+  readDocument,
+  markProcessing,
+  cleanupDone,
+} from '../../lib/core/inbox.js';
+import { launchHeadless } from '../../lib/kairos/agent-runner.js';
+import { createDispatchTransaction } from '../../lib/kairos/dispatcher-router.js';
+import { titledBox } from '../../lib/ui/box.js';
+import { style } from '../../lib/ui/colors.js';
+import { interactiveMenu } from '../../lib/ui/menu.js';
+import { askText } from '../../lib/ui/prompt.js';
+import { formatError, COMMON_HINTS } from '../../lib/ui/error-hints.js';
+
+export async function handler({ args, flags, config }) {
+  if (flags.help) {
+    printHelp();
+    return;
+  }
+
+  const sub = args[0];
+  const subArgs = args.slice(1);
+
+  if (sub === 'list') return handleList(config);
+  if (sub === 'add') return handleAdd(subArgs, config);
+  if (sub === 'process') return handleProcess(subArgs, flags, config);
+  if (sub === 'history') return handleHistory(config);
+
+  // No subcommand → interactive menu
+  const choice = await interactiveMenu([
+    { label: 'Documents en attente', value: 'list', description: 'Voir les documents pending' },
+    { label: 'Ajouter un document', value: 'add', description: 'Ajouter un fichier a l\'inbox' },
+    { label: 'Traiter un document', value: 'process', description: 'Dispatcher au Leader' },
+    { label: 'Historique', value: 'history', description: 'Documents traites' },
+    BACK_ITEM, HOME_ITEM,
+  ], { title: 'nemesis › Inbox' });
+
+  if (!choice || choice === '__back__') return '__back__';
+  if (choice === '__home__') return '__home__';
+
+  if (choice === 'list') return handleList(config);
+  if (choice === 'add') return handleAdd(subArgs, config);
+  if (choice === 'process') return handleProcess(subArgs, flags, config);
+  if (choice === 'history') return handleHistory(config);
+}
+
+// ---------------------------------------------------------------------------
+// List pending documents
+// ---------------------------------------------------------------------------
+
+async function handleList(config) {
+  const root = config.cwd;
+  const docs = listDocuments(root, 'pending');
+  const processing = listDocuments(root, 'processing');
+
+  if (docs.length === 0 && processing.length === 0) {
+    console.log(`\n  ${style.dim('Aucun document en attente.')}`);
+    console.log(`  ${style.dim('Ajoutez un document :')} nemesis inbox add <fichier>\n`);
+    return;
+  }
+
+  if (docs.length > 0) {
+    console.log('');
+    const lines = docs.map(d => {
+      const age = formatRelativeTime(d.created_at);
+      return `${style.bold(d.id)}  ${d.title}  ${style.dim(age)}  [${d.source}]`;
+    });
+    console.log(titledBox(`Pending (${docs.length})`, lines, { border: style.yellow }));
+  }
+
+  if (processing.length > 0) {
+    console.log('');
+    const lines = processing.map(d => {
+      const age = formatRelativeTime(d.processing_at || d.created_at);
+      return `${style.bold(d.id)}  ${d.title}  ${style.dim(age)}  ${style.nemesisAccent('en cours')}`;
+    });
+    console.log(titledBox(`En cours (${processing.length})`, lines, { border: style.nemesisAccent }));
+  }
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Add document
+// ---------------------------------------------------------------------------
+
+async function handleAdd(args, config) {
+  const root = config.cwd;
+
+  const filePath = args[0];
+
+  if (filePath) {
+    const absPath = resolve(root, filePath);
+    try {
+      const { id } = addDocument(root, absPath);
+      console.log(`\n  ${style.green('✓')} Document ${style.bold(id)} ajoute a l'inbox.`);
+      console.log(`  ${style.dim('→ Traitez-le :')} nemesis inbox process ${id}\n`);
+    } catch (err) {
+      console.log(`\n  ${style.red('✗')} ${err.message}\n`);
+    }
+    return;
+  }
+
+  // Interactive: ask for text or file
+  const choice = await interactiveMenu([
+    { label: 'Depuis un fichier', value: 'file', description: 'Copier un fichier dans l\'inbox' },
+    { label: 'Texte libre', value: 'text', description: 'Saisir le contenu directement' },
+    BACK_ITEM,
+  ], { title: 'Type de document' });
+
+  if (!choice || choice === '__back__') return '__back__';
+
+  if (choice === 'file') {
+    const path = await askText('Chemin du fichier');
+    if (!path) return;
+    const absPath = resolve(root, path);
+    try {
+      const { id } = addDocument(root, absPath);
+      console.log(`\n  ${style.green('✓')} Document ${style.bold(id)} ajoute.\n`);
+    } catch (err) {
+      console.log(`\n  ${style.red('✗')} ${err.message}\n`);
+    }
+  } else {
+    const title = await askText('Titre du document');
+    const content = await askText('Contenu');
+    if (!content) return;
+    const { id } = addDocumentFromText(root, content, { title: title || undefined });
+    console.log(`\n  ${style.green('✓')} Document ${style.bold(id)} ajoute.\n`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Process — dispatch document to Leader
+// ---------------------------------------------------------------------------
+
+async function handleProcess(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  const root = config.cwd;
+  const hcmDir = project.hcm_dir;
+
+  // Find the Leader
+  const registry = readRegistry(hcmDir);
+  if (!registry) {
+    console.log(formatError('Registry introuvable.', COMMON_HINTS.REGISTRY_NOT_FOUND));
+    return;
+  }
+
+  const lanes = getLanes(registry);
+  const leader = lanes.find(l => l.leader);
+  if (!leader) {
+    console.log(formatError('Aucun Leader dans l\'equipe.', {
+      hint: 'Ajoutez un agent Leader avec nemesis team add.',
+      command: 'nemesis team add',
+    }));
+    return;
+  }
+
+  if (!leader.session_id) {
+    console.log(formatError(`Le Leader "${leader.name}" n'a pas de session.`, COMMON_HINTS.AGENT_NO_SESSION));
+    return;
+  }
+
+  // Pick document
+  let docId = args[0];
+  if (!docId) {
+    const docs = listDocuments(root, 'pending');
+    if (docs.length === 0) {
+      console.log(`\n  ${style.dim('Aucun document en attente.')}\n`);
+      return;
+    }
+
+    docId = await pickFromList(docs, {
+      title: 'Document a traiter',
+      labelFn: d => `${d.id}  ${d.title}  ${style.dim(formatRelativeTime(d.created_at))}`,
+    });
+    if (!docId) return;
+  }
+
+  const doc = readDocument(root, docId, 'pending');
+  if (!doc) {
+    console.log(`\n  ${style.red('✗')} Document "${docId}" introuvable dans pending.\n`);
+    return;
+  }
+
+  // Build inbox prompt for Leader
+  const prompt = buildInboxPrompt(doc);
+
+  // Create transaction
+  const txnResult = createDispatchTransaction({
+    from: 'PM',
+    to: leader.name,
+    projectId: project.id,
+    root,
+  });
+
+  // Launch headless
+  try {
+    const { pid, txnId } = await launchHeadless(leader, prompt, {
+      txnId: txnResult.txnId,
+      projectId: project.id,
+      root,
+    });
+
+    // Mark as processing
+    markProcessing(root, docId, { txnId, agentName: leader.name });
+
+    console.log('');
+    console.log(titledBox('Document dispatche au Leader', [
+      `${style.bold('Document')} : ${doc.metadata.title} (${docId})`,
+      `${style.bold('Leader')} : ${leader.name}`,
+      `${style.bold('TXN')} : ${txnId}`,
+      `${style.bold('PID')} : ${pid || 'detache'}`,
+      '',
+      `Le Leader analysera le document et proposera un Mission Contract.`,
+    ], { border: style.green }));
+    console.log('');
+  } catch (err) {
+    console.log(`\n  ${style.red('✗')} ${err.message}\n`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// History — completed documents
+// ---------------------------------------------------------------------------
+
+async function handleHistory(config) {
+  const root = config.cwd;
+  const docs = listDocuments(root, 'done');
+
+  if (docs.length === 0) {
+    console.log(`\n  ${style.dim('Aucun document traite.')}\n`);
+    return;
+  }
+
+  console.log('');
+  const lines = docs.map(d => {
+    const age = formatRelativeTime(d.done_at || d.created_at);
+    const mc = d.mission_id ? ` → ${style.green(d.mission_id)}` : '';
+    return `${style.bold(d.id)}  ${d.title}  ${style.dim(age)}${mc}`;
+  });
+  console.log(titledBox(`Traites (${docs.length})`, lines, { border: style.green }));
+  console.log('');
+
+  // Cleanup old done
+  const cleaned = cleanupDone(root);
+  if (cleaned > 0) {
+    console.log(`  ${style.dim(`${cleaned} document(s) archive(s) nettoye(s) (>30j)`)}\n`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Build a prompt for the Leader to analyze an inbox document and produce an MC draft.
+ */
+function buildInboxPrompt(doc) {
+  const parts = [
+    '# Document inbox a analyser',
+    '',
+    `**Titre** : ${doc.metadata.title}`,
+    `**Source** : ${doc.metadata.source}`,
+    `**Date** : ${doc.metadata.created_at}`,
+    '',
+    '## Contenu du document',
+    '',
+    doc.content,
+    '',
+    '## Instructions',
+    '',
+    'Lis ce document attentivement. Propose un Mission Contract avec :',
+    '- Titre et objectifs',
+    '- Scope (in/out)',
+    '- Liste des OdMs necessaires avec assignation agent',
+    '- Criteres de succes',
+    '',
+    'Depose le MC draft dans .nemesis/HCM/contracts/ au format JSON structure.',
+    'Utilise le template mission_contract : nemesis mission init <ID>',
+    '',
+  ];
+  return parts.join('\n');
+}
+
+export { buildInboxPrompt };
+
+function formatRelativeTime(isoDate) {
+  if (!isoDate) return '';
+  const diff = Date.now() - new Date(isoDate).getTime();
+  const minutes = Math.floor(diff / 60000);
+  if (minutes < 1) return 'a l\'instant';
+  if (minutes < 60) return `il y a ${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `il y a ${hours}h`;
+  const days = Math.floor(hours / 24);
+  return `il y a ${days}j`;
+}
+
+function printHelp() {
+  console.log(`
+  ${style.bold('nemesis inbox')} — Pipeline de documents humains
+
+  ${style.bold('Usage:')} nemesis inbox [subcommand] [options]
+
+  ${style.bold('Subcommands:')}
+    list              Documents en attente
+    add <file>        Ajouter un document a l'inbox
+    process [docId]   Dispatcher au Leader pour MC draft
+    history           Documents traites
+
+  ${style.bold('Options:')}
+    -h, --help        Aide
+`);
+}

package/src/commands/init.js

@@ -0,0 +1,160 @@
+import { initProject, storeHcmStatus } from '../../lib/core/project.js';
+import { createHcmClient } from '../../lib/sync/hcm-client.js';
+import { askText } from '../../lib/ui/prompt.js';
+import { createMultiStepSpinner } from '../../lib/ui/spinner.js';
+import { renderBrandHeader } from '../../lib/ui/brand.js';
+import { style } from '../../lib/ui/colors.js';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const HELP = `
+nemesis init — Scaffold structure projet
+
+Usage: nemesis init [options]
+
+Options:
+  --bare              Mode non-interactif (defaults)
+  --id <id>           ID du projet
+  --name <name>       Nom du projet
+  --desc <desc>       Description
+  -h, --help          Aide
+`;
+
+export async function handler({ args, flags, config }) {
+  if (flags.help || args.includes('--help') || args.includes('-h')) {
+    console.log(HELP);
+    return;
+  }
+
+  const bare = args.includes('--bare');
+
+  if (!bare) {
+    const header = renderBrandHeader();
+    for (const line of header) console.log(line);
+  }
+
+  let projectId, projectName, description;
+
+  if (bare) {
+    projectId = getFlag(args, '--id') || 'PROJECT-001';
+    projectName = getFlag(args, '--name') || projectId;
+    description = getFlag(args, '--desc') || '';
+  } else {
+    projectName = await askText('Nom du projet');
+    projectId = await askText('ID projet', projectName.toUpperCase().replace(/\s+/g, '-'));
+    description = await askText('Description', '');
+  }
+
+  const multiSpinner = createMultiStepSpinner(['Initialisation du projet', 'Validation HCM']);
+  multiSpinner.start();
+
+  const result = initProject({
+    projectId,
+    projectName,
+    description,
+    root: config.cwd,
+  });
+
+  multiSpinner.nextStep();
+
+  // Validate HCM connectivity
+  const client = createHcmClient();
+  const ping = await client.ping();
+  storeHcmStatus(result.hcmDir, projectId, {
+    connected: ping.ok,
+    url: client.baseUrl,
+    latency: ping.latency,
+    checked_at: new Date().toISOString(),
+    ...(ping.error ? { error: ping.error } : {}),
+  });
+
+  if (ping.ok) {
+    multiSpinner.complete('Projet initialise');
+    writeMcpConfig(config.cwd, client.baseUrl);
+  } else {
+    multiSpinner.fail('HCM non connecte');
+    console.log(`  ${style.dim('\u2192')} ${style.dim(ping.error || 'timeout')}`);
+    console.log(`  ${style.dim('\u2192 Configurez avec')} nemesis auth login`);
+  }
+
+  console.log('');
+  console.log('  Cree :');
+  for (const dir of result.created) {
+    console.log(`  ${style.green('\u2713')} .nemesis/HCM/${dir}/`);
+  }
+  if (result.created.length === 0) {
+    console.log('  (structure deja existante)');
+  }
+  console.log(`  ${style.green('\u2713')} .nemesis/HCM/PROCESS.md`);
+  console.log(`  ${style.green('\u2713')} .nemesis/template/ (templates)`);
+  console.log(`  ${style.green('\u2713')} .nemesis/HCM/project/CONTEXT_PROJECT_${projectId}.json`);
+  console.log(`  ${style.green('\u2713')} .nemesis/HCM/project/REGISTRY-${projectId}.json (PM seul)`);
+  console.log('');
+}
+
+/**
+ * Write or update .mcp.json at project root with HCM MCP server config.
+ * Reads saved auth from ~/.nemesis/config.json for API key and MCP server path.
+ * Creates the file if missing, updates the API key if stale.
+ */
+function writeMcpConfig(root, hcmUrl) {
+  const mcpPath = join(root, '.mcp.json');
+  const saved = loadSavedNemesisConfig();
+  const apiKey = saved.hcm_api_key || process.env.HCM_API_KEY || '';
+  const mcpServerPath = saved.hcm_mcp_path || process.env.HCM_MCP_PATH || '';
+
+  // Update existing .mcp.json if API key is stale
+  if (existsSync(mcpPath)) {
+    try {
+      const existing = JSON.parse(readFileSync(mcpPath, 'utf-8'));
+      const currentKey = existing?.mcpServers?.HCM_Sipher?.env?.HCM_API_KEY || '';
+      if (apiKey && currentKey !== apiKey) {
+        existing.mcpServers.HCM_Sipher.env.HCM_API_KEY = apiKey;
+        if (hcmUrl) existing.mcpServers.HCM_Sipher.env.HCM_API_URL = hcmUrl;
+        writeFileSync(mcpPath, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+        console.log(`  ${style.green('\u2713')} .mcp.json mis a jour (cle API synchronisee)`);
+      }
+    } catch { /* malformed — recreate below */ }
+    return;
+  }
+
+  if (!mcpServerPath) {
+    console.log(`  ${style.yellow('\u26A0')} .mcp.json non genere — hcm_mcp_path absent`);
+    console.log(`  ${style.dim('\u2192 Ajoutez "hcm_mcp_path" dans ~/.nemesis/config.json')}`);
+    console.log(`  ${style.dim('  ou definissez HCM_MCP_PATH dans l\'environnement')}`);
+    return;
+  }
+
+  const mcpConfig = {
+    mcpServers: {
+      HCM_Sipher: {
+        type: 'stdio',
+        command: 'npx',
+        args: ['tsx', mcpServerPath],
+        env: {
+          HCM_API_URL: hcmUrl,
+          ...(apiKey ? { HCM_API_KEY: apiKey } : {}),
+        },
+      },
+    },
+  };
+
+  writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n', 'utf-8');
+  console.log(`  ${style.green('\u2713')} .mcp.json (MCP HCM pour tous les agents)`);
+}
+
+function loadSavedNemesisConfig() {
+  const configFile = join(homedir(), '.nemesis', 'config.json');
+  if (!existsSync(configFile)) return {};
+  try {
+    return JSON.parse(readFileSync(configFile, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+function getFlag(args, flag) {
+  const idx = args.indexOf(flag);
+  return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : null;
+}