@arka-labs/nemesis 1.2.0

package/src/cli.js

@@ -0,0 +1,457 @@
+import { loadConfig } from './config.js';
+import { renderBrandHeader, renderBrandBanner } from '../lib/ui/brand.js';
+import { titledBox } from '../lib/ui/box.js';
+import { style } from '../lib/ui/colors.js';
+import { interactiveMenu } from '../lib/ui/menu.js';
+import { clearScreen, waitForKey, BACK_ITEM, HOME_ITEM } from './commands/_helpers.js';
+import { detectProject, storeHcmStatus } from '../lib/core/project.js';
+import { readRegistry, getLanes, getPM } from '../lib/core/registry.js';
+import { createHcmClient } from '../lib/sync/hcm-client.js';
+
+const COMMANDS = {
+  init: () => import('./commands/init.js'),
+  team: () => import('./commands/team.js'),
+  project: () => import('./commands/project.js'),
+  status: () => import('./commands/status.js'),
+  doctor: () => import('./commands/doctor.js'),
+  mission: () => import('./commands/mission.js'),
+  odm: () => import('./commands/odm.js'),
+  hcm: () => import('./commands/hcm.js'),
+  audit: () => import('./commands/audit.js'),
+  services: () => import('./commands/services.js'),
+  kars: () => import('./commands/kars.js'),
+  notes: () => import('./commands/notes.js'),
+  notewriter: () => import('./commands/notewriter.js'),
+  kairos: () => import('./commands/kairos.js'),
+  auth: () => import('./commands/auth.js'),
+  run: () => import('./commands/run.js'),
+  orch: () => import('./commands/orch.js'),
+  inbox: () => import('./commands/inbox.js'),
+};
+
+const VERSION = '1.0.1';
+
+// ---------------------------------------------------------------------------
+// Menu principal — 2 zones : acces rapide agents + categories
+// ---------------------------------------------------------------------------
+
+export function buildMainMenu(config) {
+  const items = [];
+
+  // --- Zone Acces rapide (si projet detecte) ---
+  const project = detectProject(config.cwd);
+  if (project) {
+    const registry = readRegistry(project.hcm_dir);
+    if (registry) {
+      const lanes = getLanes(registry);
+      const pm = getPM(registry);
+      // Agents directs du PM
+      const directReports = lanes.filter(l =>
+        l.reports_to === pm?.name || l.reports_to === pm?.id || l.reports_to === 'PM'
+      );
+      // Si aucun reports_to defini, afficher tous les agents (max 5)
+      const agents = directReports.length > 0 ? directReports : lanes;
+
+      for (const agent of agents.slice(0, 5)) {
+        const { checkAgentAlive } = require_team();
+        const alive = checkAgentAlive(agent.pid);
+        const dot = alive ? style.green('\u25CF') : agent.session_id ? style.yellow('\u25CF') : style.dim('\u25CB');
+        const statusText = alive ? 'actif' : agent.session_id ? 'en veille' : '';
+        items.push({
+          label: `${agent.name}  ${dot} ${style.dim(statusText)}`,
+          value: `__agent__:${agent.name}`,
+          description: agent.role || '',
+        });
+      }
+      if (lanes.length > 0) {
+        items.push({ label: style.dim('Voir tous \u2192'), value: '__all_agents__', description: '' });
+      }
+      // Separateur visuel
+      items.push({ label: style.dim('\u2500'.repeat(35)), value: '__sep__', description: '' });
+    }
+  }
+
+  // --- Zone Categories ---
+  items.push(
+    { label: 'Projet',  value: '__cat_projet__',  description: 'Status, init, diagnostic' },
+    { label: 'Equipe',  value: '__cat_equipe__',  description: 'Agents, profils' },
+    { label: 'Travail', value: '__cat_travail__', description: 'Missions, OdMs, audits' },
+    { label: 'Memoire', value: '__cat_memoire__', description: 'Notes, CR, contexte agent' },
+    { label: 'Infra',   value: '__cat_infra__',   description: 'Connexions LLM, HCM' },
+  );
+
+  return items;
+}
+
+// Delegates to pid-checker for centralized PID logic
+import { isPidAlive } from '../lib/kairos/pid-checker.js';
+function require_team() {
+  return { checkAgentAlive: isPidAlive };
+}
+
+// ---------------------------------------------------------------------------
+// Sous-menus categories
+// ---------------------------------------------------------------------------
+
+const CAT_PROJET = [
+  { label: 'status', value: 'status', description: 'Etat du projet + alertes' },
+  { label: 'init',   value: 'init',   description: 'Scaffold structure projet' },
+  { label: 'doctor', value: 'doctor', description: 'Diagnostic complet' },
+  BACK_ITEM, HOME_ITEM,
+];
+
+const CAT_EQUIPE = [
+  { label: 'Organigramme', value: 'team:list',    description: 'Vue hierarchique de l\'equipe' },
+  { label: 'Agents',       value: 'team:panneau', description: 'Espace de gestion des agents' },
+  { label: 'Ajouter',      value: 'team:add',     description: 'Ajouter un agent' },
+  { label: 'Profils',      value: 'kars',         description: 'Parcourir les profils disponibles' },
+  BACK_ITEM, HOME_ITEM,
+];
+
+const CAT_TRAVAIL = [
+  { label: 'Orchestration', value: 'orch', description: 'Dashboard dispatches & agents' },
+  { label: 'Inbox', value: 'inbox', description: 'Documents humains → MC' },
+  { label: 'Missions', value: 'mission', description: 'Contrats de fonctionnalite' },
+  { label: 'OdMs',     value: 'odm',     description: 'Ordres de mission' },
+  { label: 'Audit',    value: 'audit',   description: 'Audit technique' },
+  BACK_ITEM, HOME_ITEM,
+];
+
+const CAT_MEMOIRE = [
+  { label: 'Notes',    value: 'notes',      description: 'Consulter notes & CR des agents' },
+  { label: 'Contexte', value: 'notewriter', description: 'Gestion du contexte agent' },
+  BACK_ITEM, HOME_ITEM,
+];
+
+const CAT_INFRA = [
+  { label: 'Services', value: 'services', description: 'Connexions LLM' },
+  { label: 'HCM',      value: 'hcm',      description: 'Synchronisation & recherche' },
+  { label: 'Auth',     value: 'auth',     description: 'Connexion HCM' },
+  { label: 'Kairos', value: 'kairos', description: 'Hooks & contexte agent' },
+  BACK_ITEM, HOME_ITEM,
+];
+
+export const CATEGORY_MAP = {
+  '__cat_projet__':  { items: CAT_PROJET,  title: 'nemesis \u203A Projet' },
+  '__cat_equipe__':  { items: CAT_EQUIPE,  title: 'nemesis \u203A Equipe' },
+  '__cat_travail__': { items: CAT_TRAVAIL, title: 'nemesis \u203A Travail' },
+  '__cat_memoire__': { items: CAT_MEMOIRE, title: 'nemesis \u203A Memoire' },
+  '__cat_infra__':   { items: CAT_INFRA,   title: 'nemesis \u203A Infra' },
+};
+
+// Export sub-menus for tests
+export { CAT_PROJET, CAT_EQUIPE, CAT_TRAVAIL, CAT_MEMOIRE, CAT_INFRA };
+
+// Export gate functions for tests
+export { SKIP_HCM_COMMANDS, READ_ONLY_COMMANDS, warnIfHcmDown, blockIfHcmDown };
+
+// ---------------------------------------------------------------------------
+// Ecran rapide agent
+// ---------------------------------------------------------------------------
+
+async function handleQuickAgent(agentName, flags, config) {
+  const { teamInspect } = await import('../lib/core/team.js');
+  const result = teamInspect(agentName, config.cwd);
+  const agent = result.agent;
+
+  const alive = isPidAlive(agent.pid);
+  const dot = alive ? style.green('\u25CF') : agent.session_id ? style.yellow('\u25CF') : style.dim('\u25CB');
+  const statusText = alive ? 'actif' : agent.session_id ? 'en veille' : 'pas de session';
+
+  const choice = await interactiveMenu([
+    { label: 'Rejoindre la session', value: 'join',    description: '' },
+    { label: 'Envoyer un message',   value: 'inject',  description: '' },
+    { label: 'Panneau complet',      value: 'panneau', description: '' },
+    BACK_ITEM,
+  ], { title: `${agentName}  ${dot} ${statusText}` });
+
+  if (!choice || choice === '__back__') return '__back__';
+  if (choice === '__home__') return '__home__';
+
+  const teamMod = await import('./commands/team.js');
+  switch (choice) {
+    case 'join':    return teamMod.actionJoin(agent, [], flags, config);
+    case 'inject':  return teamMod.actionInject(agent);
+    case 'panneau': return teamMod.handler({ args: ['panneau', agentName], flags, config });
+  }
+}
+
+// ---------------------------------------------------------------------------
+// printHelp — mode direct (inchange)
+// ---------------------------------------------------------------------------
+
+function printHelp() {
+  const header = renderBrandHeader({ version: VERSION });
+  for (const line of header) console.log(line);
+
+  const cmdLines = [
+    `${style.bold('init')}              ${style.gray('Scaffold structure projet')}`,
+    `${style.bold('team')}              ${style.gray('Gestion equipe agents (add, list, panneau, remove)')}`,
+    `${style.bold('project')}           ${style.gray('Vue projet (status, init)')}`,
+    `${style.bold('mission')}           ${style.gray('Mission Contracts (init, list, inspect)')}`,
+    `${style.bold('odm')}               ${style.gray('Ordres de Mission (init, list, inspect)')}`,
+    `${style.bold('status')}            ${style.gray('Raccourci project status + alertes')}`,
+    `${style.bold('hcm')}               ${style.gray('Synchronisation HCM (sync, status, search)')}`,
+    `${style.bold('kars')}              ${style.gray('Recherche profils Kairos (search)')}`,
+    `${style.bold('audit')}             ${style.gray('Audit technique (run, list, reports)')}`,
+    `${style.bold('services')}          ${style.gray('Connexions LLM (connexions add/list/test/remove)')}`,
+    `${style.bold('notes')}             ${style.gray('Notes & CR — consultation memoire')}`,
+    `${style.bold('notewriter')}        ${style.gray('Memoire agent — notes, CR, replay')}`,
+    `${style.bold('kairos')}            ${style.gray('Hooks & contexte agent')}`,
+    `${style.bold('auth')}              ${style.gray('Connexion HCM (login, status, logout)')}`,
+    `${style.bold('inbox')}             ${style.gray('Pipeline documents humains (add, list, process)')}`,
+    `${style.bold('orch')}              ${style.gray('Orchestrateur daemon (dispatch, routing, supervision)')}`,
+    `${style.bold('run')}               ${style.gray('Reprendre session agent (run agent:<NAME>)')}`,
+    `${style.bold('doctor')}            ${style.gray('Diagnostic complet')}`,
+  ];
+
+  const flagLines = [
+    `${style.bold('--format <fmt>')}    ${style.gray('Format de sortie: json, text, yaml (default: text)')}`,
+    `${style.bold('--no-color')}        ${style.gray('Desactiver les couleurs ANSI')}`,
+    `${style.bold('--verbose')}         ${style.gray('Sortie detaillee')}`,
+    `${style.bold('-h, --help')}        ${style.gray('Aide')}`,
+    `${style.bold('-V, --version')}     ${style.gray('Version')}`,
+  ];
+
+  console.log(titledBox('Commands', cmdLines, { border: style.arkaRed }));
+  console.log('');
+  console.log(titledBox('Flags', flagLines, { border: style.arkaRed }));
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// parseGlobalFlags
+// ---------------------------------------------------------------------------
+
+function parseGlobalFlags(args) {
+  const flags = {
+    format: 'text',
+    noColor: false,
+    verbose: false,
+    help: false,
+    version: false,
+  };
+  const remaining = [];
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--format' && i + 1 < args.length) {
+      flags.format = args[++i];
+    } else if (arg === '--no-color') {
+      flags.noColor = true;
+    } else if (arg === '--verbose') {
+      flags.verbose = true;
+    } else if (arg === '-h' || arg === '--help') {
+      flags.help = true;
+    } else if (arg === '-V' || arg === '--version') {
+      flags.version = true;
+    } else {
+      remaining.push(arg);
+    }
+  }
+
+  return { flags, remaining };
+}
+
+// ---------------------------------------------------------------------------
+// HCM gate
+// ---------------------------------------------------------------------------
+
+async function checkHcm(config) {
+  const project = detectProject(config.cwd);
+  const client = createHcmClient({ timeout: 3000 });
+  const ping = await client.ping();
+
+  if (project) {
+    storeHcmStatus(project.hcm_dir, project.id, {
+      connected: ping.ok,
+      url: client.baseUrl,
+      latency: ping.latency,
+      checked_at: new Date().toISOString(),
+      ...(ping.error ? { error: ping.error } : {}),
+    });
+  }
+
+  return ping;
+}
+
+function blockIfHcmDown(ping) {
+  if (ping.ok) return;
+
+  console.log('');
+  console.log(`  ${style.red('\u2717')} ${style.bold('HCM non connecte')}`);
+  console.log('');
+  console.log(`  La CLI necessite une connexion au HCM pour fonctionner.`);
+  if (ping.error) {
+    console.log(`  ${style.dim('\u2192')} ${style.dim(ping.error)}`);
+  }
+  console.log('');
+  console.log(`  ${style.bold('Connectez-vous avec :')}  nemesis auth login`);
+  console.log(`  ${style.bold('Dashboard HCM :')}       ${style.nemesisAccent('https://hcm.arkalabs.app')}`);
+  console.log('');
+  process.exit(1);
+}
+
+const SKIP_HCM_COMMANDS = new Set(['auth', 'init', 'notewriter', 'notes', 'kairos', 'orch', 'inbox']);
+
+const READ_ONLY_COMMANDS = new Set(['status', 'project', 'doctor', 'audit', 'team', 'odm', 'mission']);
+
+function warnIfHcmDown(ping) {
+  if (ping.ok) return;
+  console.log('');
+  console.log(`  ${style.yellow('\u26A0')} ${style.bold('HCM non connecte')} \u2014 mode lecture seule`);
+  console.log(`  ${style.dim('\u2192')} Reconnectez-vous : ${style.bold('nemesis auth login')}`);
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Boucle principale
+// ---------------------------------------------------------------------------
+
+export async function run(argv) {
+  const { flags, remaining } = parseGlobalFlags(argv);
+
+  if (flags.noColor) {
+    process.env.NO_COLOR = '1';
+  }
+
+  if (flags.version) {
+    console.log(`nemesis v${VERSION}`);
+    process.exit(0);
+  }
+
+  const commandName = remaining[0];
+  const commandArgs = remaining.slice(1);
+
+  // --help flag without command -> static help
+  if (flags.help && !commandName) {
+    printHelp();
+    process.exit(0);
+  }
+
+  // No command -> interactive menu loop (screen-based)
+  if (!commandName) {
+    const config = await loadConfig();
+
+    // HCM gate (interactive = warn only)
+    const ping = await checkHcm(config);
+    warnIfHcmDown(ping);
+
+    while (true) {
+      clearScreen();
+      const header = renderBrandHeader({ version: VERSION });
+      for (const line of header) console.log(line);
+
+      const menuItems = buildMainMenu(config);
+      const selected = await interactiveMenu(menuItems, {
+        title: 'Que souhaitez-vous faire ?',
+      });
+
+      if (!selected) {
+        clearScreen();
+        process.exit(0);
+      }
+
+      if (selected === '__sep__' || selected === '__coming_soon__') continue;
+
+      // Acces rapide agent
+      if (selected.startsWith('__agent__:')) {
+        clearScreen();
+        const agentName = selected.replace('__agent__:', '');
+        process.stdout.write(renderBrandBanner({ version: VERSION, section: agentName }));
+        try {
+          const result = await handleQuickAgent(agentName, flags, config);
+          if (result !== '__back__' && result !== '__home__') await waitForKey();
+        } catch (err) {
+          if (flags.verbose) console.error(err);
+          else console.error(`  ${style.red('Erreur')}: ${err.message}\n`);
+          await waitForKey();
+        }
+        continue;
+      }
+
+      // Voir tous -> Equipe panneau
+      if (selected === '__all_agents__') {
+        clearScreen();
+        process.stdout.write(renderBrandBanner({ version: VERSION, section: 'Equipe' }));
+        const mod = await COMMANDS.team();
+        const result = await mod.handler({ args: ['panneau'], flags, config });
+        if (result !== '__back__' && result !== '__home__') await waitForKey();
+        continue;
+      }
+
+      // Categorie -> sous-menu
+      const cat = CATEGORY_MAP[selected];
+      if (cat) {
+        let stayInCategory = true;
+        while (stayInCategory) {
+          clearScreen();
+          process.stdout.write(renderBrandBanner({ version: VERSION, section: cat.title.split(' \u203A ')[1] }));
+
+          const sub = await interactiveMenu(cat.items, { title: cat.title });
+          if (!sub || sub === '__back__') { break; }
+          if (sub === '__home__') { break; }
+          if (sub === '__coming_soon__') continue;
+
+          // Dispatch commande
+          clearScreen();
+          let cmdName = sub;
+          let cmdArgs = [];
+          if (sub.includes(':')) {
+            const [cmd, ...rest] = sub.split(':');
+            cmdName = cmd;
+            cmdArgs = rest;
+          }
+
+          process.stdout.write(renderBrandBanner({ version: VERSION, section: cmdName }));
+          const loader = COMMANDS[cmdName];
+          if (!loader) continue;
+
+          try {
+            const mod = await loader();
+            const result = await mod.handler({ args: cmdArgs, flags, config });
+            if (result === '__home__') { stayInCategory = false; break; }
+            if (result !== '__back__') await waitForKey();
+          } catch (err) {
+            if (flags.verbose) console.error(err);
+            else console.error(`  ${style.red('Erreur')}: ${err.message}\n`);
+            await waitForKey();
+          }
+        }
+        continue;
+      }
+    }
+  }
+
+  // Direct command path
+  const loader = COMMANDS[commandName];
+  if (!loader) {
+    console.error(`Commande inconnue : ${commandName}`);
+    console.error(`Tapez "nemesis --help" pour voir les commandes disponibles.`);
+    process.exit(1);
+  }
+
+  const config = await loadConfig();
+
+  // HCM gate: skip → no ping, read-only → warn, others → block
+  if (!SKIP_HCM_COMMANDS.has(commandName)) {
+    const ping = await checkHcm(config);
+    if (READ_ONLY_COMMANDS.has(commandName)) {
+      warnIfHcmDown(ping);
+    } else {
+      blockIfHcmDown(ping);
+    }
+  }
+
+  try {
+    const mod = await loader();
+    await mod.handler({ args: commandArgs, flags, config });
+  } catch (err) {
+    if (flags.verbose) {
+      console.error(err);
+    } else {
+      console.error(`Erreur: ${err.message}`);
+    }
+    process.exit(1);
+  }
+}

package/src/commands/_helpers.js

@@ -0,0 +1,119 @@
+import { createInterface } from 'node:readline';
+import { detectProject } from '../../lib/core/project.js';
+import { askConfirm } from '../../lib/ui/prompt.js';
+import { interactiveMenu } from '../../lib/ui/menu.js';
+import { style } from '../../lib/ui/colors.js';
+
+const BACK_ITEM = { label: style.dim('\u2190 Retour'), value: '__back__', description: '' };
+const HOME_ITEM = { label: style.dim('\u2302 Accueil'), value: '__home__', description: '' };
+
+/**
+ * Detect project or propose interactive init. Returns project or null.
+ */
+export async function ensureProject(config, flags) {
+  let project = detectProject(config.cwd);
+  if (project) return project;
+
+  console.log(`\n  ${style.yellow('\u26A0')} Aucun projet detecte.`);
+  const doInit = await askConfirm('Initialiser un projet maintenant ?', true);
+  if (doInit) {
+    const initMod = await import('./init.js');
+    await initMod.handler({ args: [], flags, config });
+    project = detectProject(config.cwd);
+  }
+  if (!project) {
+    console.log(`  ${style.dim('Utilisez')} nemesis init ${style.dim('pour creer un projet.')}\n`);
+  }
+  return project || null;
+}
+
+/**
+ * Pick an item from a list via interactive menu.
+ * labelFn is used for display — description is NOT auto-populated from item.title
+ * to avoid duplication when labelFn already includes it.
+ * Returns selected value or null if cancelled.
+ */
+export async function pickFromList(items, opts = {}) {
+  const {
+    title = 'Choisir',
+    labelFn = (item) => item.id || item.label,
+    maxVisible = 0,
+  } = opts;
+
+  if (items.length === 0) return null;
+
+  const menuItems = items.map(item => ({
+    label: labelFn(item),
+    value: item.id || item.value,
+  }));
+
+  return interactiveMenu(menuItems, { title, maxVisible });
+}
+
+/**
+ * Auto-generate the next sequential ID.
+ * @param {string} prefix - e.g. "MCT-NEMESIS" or "ODM-NEMESIS"
+ * @param {string[]} existingIds - list of existing IDs
+ * @returns {string} next ID like "MCT-NEMESIS-003"
+ */
+export function nextId(prefix, existingIds) {
+  let max = 0;
+  for (const id of existingIds) {
+    const match = id.match(/-(\d+)$/);
+    if (match) {
+      const num = parseInt(match[1], 10);
+      if (num > max) max = num;
+    }
+  }
+  return `${prefix}-${String(max + 1).padStart(3, '0')}`;
+}
+
+/**
+ * Clear the terminal screen and move cursor to top-left.
+ */
+export function clearScreen() {
+  process.stdout.write('\x1b[2J\x1b[H');
+}
+
+/**
+ * Wait for the user to press Enter before returning.
+ * Used after command output so user can read it before screen clears.
+ */
+export async function waitForKey() {
+  if (!process.stdin.isTTY) return;
+  console.log(`\n  ${style.dim('Appuyez sur Entree pour revenir au menu...')}`);
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.once('line', () => { rl.close(); resolve(); });
+  });
+}
+
+/**
+ * Extract a flag value from args array: --flag <value>
+ */
+export function getFlag(args, flag) {
+  const idx = args.indexOf(flag);
+  return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : null;
+}
+
+/**
+ * Sanitize agent name: strip existing Agent_ prefix, replace spaces/special chars, re-prefix.
+ * "Agent stratege" → "Agent_Stratege", "Agent_Agent_Foo" → "Agent_Foo"
+ */
+export function sanitizeName(raw) {
+  let name = raw.trim();
+  // Strip existing Agent_ or Agent prefix (with underscore or space)
+  name = name.replace(/^Agent[_ ]?/i, '');
+  // Replace spaces and special chars with underscores, collapse multiples
+  name = name.replace(/[^a-zA-Z0-9_-]/g, '_').replace(/_+/g, '_').replace(/^[_-]+|[_-]+$/g, '');
+  if (!name) return 'Agent_Unknown';
+  // Capitalize first letter
+  name = name.charAt(0).toUpperCase() + name.slice(1);
+  return `Agent_${name}`;
+}
+
+/**
+ * Back menu item — add as last option in submenus.
+ * Home menu item — returns to main CLI menu from any depth.
+ */
+export { BACK_ITEM, HOME_ITEM };