@arka-labs/nemesis 1.2.0

package/src/commands/team.js

@@ -0,0 +1,572 @@
+import { teamAdd, teamList, teamInspect, teamRemove } from '../../lib/core/team.js';
+import { readRegistry, writeRegistry, getLanes, getPM, updateLaneField } from '../../lib/core/registry.js';
+import { createHcmClient } from '../../lib/sync/hcm-client.js';
+import { pickProfile } from '../../lib/core/profile-picker.js';
+import { askText, askMultiChoice, askConfirm } from '../../lib/ui/prompt.js';
+import { interactiveMenu } from '../../lib/ui/menu.js';
+import { renderTree } from '../../lib/ui/tree.js';
+import { renderTable } from '../../lib/ui/table.js';
+import { titledBox } from '../../lib/ui/box.js';
+import { style } from '../../lib/ui/colors.js';
+import { isPidAlive } from '../../lib/kairos/pid-checker.js';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureProject, pickFromList, getFlag, sanitizeName, BACK_ITEM, HOME_ITEM } from './_helpers.js';
+
+const HELP = `
+nemesis team — Gestion equipe agents
+
+Usage: nemesis team <subcommand> [options]
+
+Subcommands:
+  add               Onboard un nouvel agent
+  list              Affiche l'organigramme
+  panneau [agent]   Panneau agent (alias: inspect)
+  leader [agent]    Active/desactive le flag leader (--on|--off)
+  remove [agent]    Desactive un agent (archive)
+
+Options (add):
+  --profile <id>    Profil Kairos
+  --name <name>     Nom de l'agent
+  --role <role>     Role sur le projet
+  --reports-to <a>  Hierarchie
+  --no-prompt       Mode non-interactif
+  -h, --help        Aide
+`;
+
+export async function handler({ args, flags, config }) {
+  if (flags.help || args.includes('--help') || args.includes('-h')) {
+    console.log(HELP);
+    return;
+  }
+
+  let sub = args[0];
+  let subArgs = args.slice(1);
+
+  if (!sub) {
+    sub = await interactiveMenu([
+      { label: 'list',    value: 'list',    description: 'Affiche l\'organigramme' },
+      { label: 'add',     value: 'add',     description: 'Onboard un nouvel agent' },
+      { label: 'panneau', value: 'panneau', description: 'Panneau agent' },
+      { label: 'leader',  value: 'leader',  description: 'Active/desactive le flag leader' },
+      { label: 'remove',  value: 'remove',  description: 'Desactive un agent' },
+      BACK_ITEM,
+      HOME_ITEM,
+    ], { title: 'nemesis team' });
+    if (!sub || sub === '__back__') return '__back__';
+    if (sub === '__home__') return '__home__';
+    subArgs = [];
+  }
+
+  switch (sub) {
+    case 'add':
+      return handleAdd(subArgs, flags, config);
+    case 'list':
+      return handleList(subArgs, flags, config);
+    case 'panneau':
+    case 'inspect':
+      return handlePanneau(subArgs, flags, config);
+    case 'leader':
+      return handleLeader(subArgs, flags, config);
+    case 'remove':
+      return handleRemove(subArgs, flags, config);
+    default:
+      console.error(`Sous-commande inconnue : ${sub}`);
+      console.log(HELP);
+  }
+}
+
+function getAgentLanes(project) {
+  const registry = readRegistry(project.hcm_dir);
+  return registry ? getLanes(registry) : [];
+}
+
+async function pickAgent(project, title = 'Choisir un agent') {
+  const lanes = getAgentLanes(project);
+  if (lanes.length === 0) {
+    console.log(`\n  ${style.dim('Aucun agent enregistre.')}`);
+    return null;
+  }
+  return pickFromList(
+    lanes.map(l => ({ id: l.id || l.name, title: l.role, ...l })),
+    {
+      title,
+      labelFn: (l) => `${l.name || l.id} \u2014 ${l.role || style.dim('(pas de role)')}`,
+    },
+  );
+}
+
+async function handleAdd(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  console.log(`\n  ${style.bold('Projet')} : ${style.nemesisAccent(project.id)} ${style.dim('(detecte depuis .nemesis/)')}\n`);
+
+  const noPrompt = args.includes('--no-prompt');
+
+  // Profile Kairos — fetch from HCM or manual entry
+  let profileId = getFlag(args, '--profile');
+  let kairosData = null;
+  let hcmLive = !!project.hcm_status?.connected;
+  if (!profileId && !noPrompt) {
+    const client = createHcmClient();
+    const picked = await pickProfile(client, { write: console.log });
+    profileId = picked.id;
+    kairosData = picked.kairosData;
+    if (kairosData) hcmLive = true;
+  }
+
+  // Agent name
+  let agentName = getFlag(args, '--name');
+  if (!agentName && !noPrompt) {
+    agentName = await askText('Nom de l\'agent');
+  }
+  if (!agentName) {
+    console.log(`\n  ${style.red('Nom de l\'agent requis.')}\n`);
+    return;
+  }
+  agentName = sanitizeName(agentName);
+
+  // Role
+  let role = getFlag(args, '--role');
+  if (!role && !noPrompt) {
+    role = await askText('Role sur le projet');
+  }
+  if (!role) {
+    console.log(`\n  ${style.red('Role requis.')}\n`);
+    return;
+  }
+
+  // Reports to — interactive menu
+  let reportsTo = getFlag(args, '--reports-to');
+  if (!reportsTo && !noPrompt) {
+    const registry = readRegistry(project.hcm_dir);
+    const pm = getPM(registry);
+    const pmName = pm?.name || 'PM';
+    const reportsItems = [{ label: `${pmName} (PM)`, value: pmName }];
+    const lanes = getAgentLanes(project);
+    for (const lane of lanes) {
+      reportsItems.push({
+        label: `${lane.name || lane.id} (${lane.role})`,
+        value: (lane.name || lane.id).split(' (')[0],
+      });
+    }
+    reportsTo = await interactiveMenu(reportsItems, { title: 'Reporte a' });
+    if (!reportsTo) reportsTo = pmName;
+  }
+
+  // OdMs
+  let odmIds = [];
+  if (!noPrompt) {
+    const odmDir = join(project.hcm_dir, 'odm');
+    if (existsSync(odmDir)) {
+      const odmFiles = readdirSync(odmDir)
+        .filter(f => f.endsWith('.json') && !f.startsWith('legacy_'));
+      if (odmFiles.length > 0) {
+        const odmChoices = odmFiles.map(f => {
+          try {
+            const data = JSON.parse(readFileSync(join(odmDir, f), 'utf-8'));
+            return {
+              label: `${data.odm_meta?.odm_id || f} \u2014 ${data.odm_payload?.cadrage?.title || ''}`,
+              value: data.odm_meta?.odm_id || f,
+            };
+          } catch {
+            return { label: f, value: f };
+          }
+        });
+        odmIds = await askMultiChoice('OdMs a assigner (optionnel)', odmChoices);
+      }
+    }
+  }
+
+  // Execute
+  console.log('\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n');
+
+  const result = await teamAdd({
+    root: config.cwd,
+    agentName,
+    role,
+    reportsTo,
+    profileId: profileId || null,
+    kairosData,
+    odmIds,
+    environment: {
+      hcm: hcmLive,
+      files: [],
+    },
+  });
+
+  for (const step of result.results) {
+    console.log(`  ${style.green('\u2713')} ${style.bold(step.label)}`);
+    console.log(`    ${style.dim('\u2192')} ${step.detail}`);
+    console.log('');
+  }
+
+  console.log('  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n');
+
+  const { runOnboarding } = await import('../../lib/core/agent-launcher.js');
+  const onboard = await runOnboarding(result.promptPath, result.agentName);
+  if (onboard.displayBox) {
+    console.log('');
+    console.log(onboard.displayBox);
+    console.log('');
+  }
+
+  // Always persist onboarding metadata
+  const reg = readRegistry(result.project.hcm_dir);
+  if (reg) {
+    updateLaneField(reg, result.agentName, 'last_onboarding', new Date().toISOString());
+    if (onboard.sessionId) {
+      updateLaneField(reg, result.agentName, 'session_id', onboard.sessionId);
+    }
+    if (onboard.pid) {
+      updateLaneField(reg, result.agentName, 'pid', onboard.pid);
+    }
+    writeRegistry(result.project.hcm_dir, reg);
+  }
+
+  // Post-onboarding menu — 2 choices
+  if (onboard.sessionId) {
+    console.log('');
+    console.log('  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550');
+    console.log(`  ${style.bold(result.agentName)} est pret.`);
+    console.log('');
+
+    const postAction = await interactiveMenu([
+      { label: 'Rejoindre la session interactive', value: 'join', description: '' },
+      { label: 'Retourner au menu principal',      value: 'back', description: '' },
+    ], { title: 'Que souhaitez-vous faire ?' });
+
+    console.log('  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550');
+
+    if (postAction === 'join') {
+      const { spawn: spawnChild } = await import('node:child_process');
+      console.log(`\n  ${style.bold('Session interactive')} \u2192 ${style.nemesisAccent(result.agentName)}`);
+      console.log(`  ${style.dim('Session ID')}: ${onboard.sessionId}\n`);
+
+      const child = spawnChild('claude', ['--resume', onboard.sessionId, '--dangerously-skip-permissions'], {
+        stdio: 'inherit',
+        env: { ...process.env },
+      });
+
+      await new Promise((resolve) => child.on('close', resolve));
+      process.exit(0);
+    }
+  }
+}
+
+async function handleList(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  console.log(`\n  ${style.bold('Projet')} : ${style.nemesisAccent(project.id)}\n`);
+
+  const result = teamList(project.hcm_dir);
+  if (!result || (result.tree && result.tree.children && result.tree.children.length === 0)) {
+    console.log(`  ${style.dim('Equipe vide \u2014 seul le PM est enregistre.')}`);
+    const doAdd = await askConfirm('Onboard un agent maintenant ?', true);
+    if (doAdd) {
+      return handleAdd([], flags, config);
+    }
+    console.log('');
+    return;
+  }
+
+  console.log(renderTree(result.tree));
+  console.log('');
+}
+
+export { isPidAlive as checkAgentAlive } from '../../lib/kairos/pid-checker.js';
+
+async function handlePanneau(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  let agentId = args[0];
+
+  // If no agent specified → picker from registry
+  if (!agentId) {
+    agentId = await pickAgent(project, 'Quel agent inspecter ?');
+    if (!agentId) {
+      const doAdd = await askConfirm('Onboard un agent maintenant ?', false);
+      if (doAdd) return handleAdd([], flags, config);
+      return;
+    }
+  }
+
+  const result = teamInspect(agentId, config.cwd);
+
+  if (flags.format === 'json') {
+    const { formatOutput } = await import('../../lib/ui/format.js');
+    console.log(formatOutput(result, 'json'));
+    return;
+  }
+
+  const a = result.agent;
+  const alive = isPidAlive(a.pid);
+  const statusText = alive
+    ? `${style.green('\u25CF')} actif  (PID ${a.pid})`
+    : a.session_id
+      ? `${style.yellow('\u25CF')} en veille (session disponible)`
+      : `${style.dim('\u25CB')} pas de session`;
+
+  // --- Zone 1 : Identite ---
+  const identityLines = [
+    `Role       ${a.role}${a.leader ? ' ★ Leader' : ''}`,
+    ...(a.profiles && a.profiles.length > 0 ? [`Profil     ${a.profiles[0]}`] : []),
+    `Reporte a  ${a.reports_to || '?'}`,
+    `Statut     ${statusText}`,
+  ];
+
+  if (result.memory) {
+    const memDate = result.memory.modified
+      ? result.memory.modified.split('-').reverse().join('/')
+      : '';
+    identityLines.push(`Memoire    ${result.memory.path}`);
+    identityLines.push(`           ${result.memory.path.split('/').pop()}  \u2014  ${result.memory.size}  \u2014  maj ${memDate}`);
+  } else {
+    identityLines.push(`Memoire    ${style.dim('(introuvable)')}`);
+  }
+
+  console.log('');
+  console.log(titledBox(a.name || a.id, identityLines, { border: style.nemesisAccent }));
+
+  // --- Zone 2 : Commandes ---
+  const shortName = (a.name || a.id).replace(/^Agent_/, '');
+  const cmdLines = [
+    'Session interactive',
+    `  ${style.bold(`nemesis run agent:${shortName}`)}`,
+    '',
+    'Inject prompt',
+    `  ${style.bold(`nemesis run agent:${shortName} --p "<prompt>"`)}`,
+  ];
+  console.log(titledBox('Commandes', cmdLines, { border: style.nemesisAccent }));
+
+  // --- Zone 3 : Actions ---
+  let stayInPanel = true;
+  while (stayInPanel) {
+    const action = await interactiveMenu([
+      { label: 'Rejoindre la session',     value: 'join',    description: '' },
+      { label: 'Injecter un prompt',       value: 'inject',  description: '' },
+      { label: 'Voir les OdMs assignes',   value: 'odms',    description: '' },
+      { label: 'Voir les CRs recents',     value: 'crs',     description: '' },
+      { label: a.leader ? 'Desactiver Leader' : 'Activer Leader', value: 'leader', description: '' },
+      { label: 'Archiver l\'agent',        value: 'archive', description: '' },
+      BACK_ITEM,
+      HOME_ITEM,
+    ], { title: 'Actions' });
+
+    if (!action || action === '__back__') {
+      break;
+    }
+    if (action === '__home__') return '__home__';
+
+    switch (action) {
+      case 'join':
+        await actionJoin(a, args, flags, config);
+        stayInPanel = false;
+        break;
+      case 'inject':
+        await actionInject(a);
+        break;
+      case 'odms':
+        actionShowOdms(result);
+        break;
+      case 'crs':
+        actionShowCrs(result);
+        break;
+      case 'leader': {
+        const reg = readRegistry(project.hcm_dir);
+        const newVal = !a.leader;
+        updateLaneField(reg, a.id, 'leader', newVal);
+        writeRegistry(project.hcm_dir, reg);
+        a.leader = newVal;
+        if (newVal) {
+          console.log(`\n  ${style.green('★')} leader: ${style.bold('active')}\n`);
+        } else {
+          console.log(`\n  ${style.dim('○')} leader: ${style.bold('desactive')}\n`);
+        }
+        break;
+      }
+      case 'archive':
+        await actionArchive(a, config);
+        stayInPanel = false;
+        break;
+    }
+  }
+}
+
+export async function actionJoin(agent, args, flags, config) {
+  if (!agent.session_id) {
+    console.log(`\n  ${style.dim('Pas de session. Lancez l\'onboarding d\'abord.')}`);
+    const doAdd = await askConfirm('Lancer l\'onboarding ?', true);
+    if (doAdd) return handleAdd(args || [], flags || {}, config);
+    return;
+  }
+  // session_id exists → resume it (PID mort = normal, l'utilisateur n'etait pas connecte)
+  const { spawn: spawnChild } = await import('node:child_process');
+  console.log(`\n  ${style.bold('Session interactive')} \u2192 ${style.nemesisAccent(agent.name || agent.id)}`);
+  console.log(`  ${style.dim('Session ID')}: ${agent.session_id}\n`);
+  const child = spawnChild('claude', ['--resume', agent.session_id, '--dangerously-skip-permissions'], {
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+  await new Promise((resolve) => child.on('close', resolve));
+  process.exit(0);
+}
+
+export async function actionInject(agent) {
+  if (!agent.session_id) {
+    console.log(`\n  ${style.dim('Pas de session active. Lancez l\'onboarding d\'abord.')}\n`);
+    return;
+  }
+  const prompt = await askText('Prompt');
+  if (!prompt) return;
+  const { spawn: spawnChild } = await import('node:child_process');
+  const { createStreamBox } = await import('../../lib/ui/streambox.js');
+  const box = createStreamBox(4);
+  const child = spawnChild('claude', [
+    '--resume', agent.session_id,
+    '-p', prompt,
+    '--output-format', 'stream-json',
+    '--verbose',
+    '--dangerously-skip-permissions',
+  ], { stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env } });
+
+  let finalResult = '';
+  child.stdout.on('data', (chunk) => {
+    for (const raw of chunk.toString().split('\n')) {
+      if (!raw.trim()) continue;
+      try {
+        const evt = JSON.parse(raw);
+        if (evt.type === 'assistant' && evt.message?.content) {
+          for (const block of evt.message.content) {
+            if (block.type === 'text' && block.text) {
+              for (const tl of block.text.split('\n').filter(Boolean)) {
+                box.push(style.dim(tl));
+              }
+            }
+          }
+        }
+        if (evt.type === 'result') finalResult = evt.result || '';
+      } catch { /* ignore */ }
+    }
+  });
+  await new Promise((resolve) => child.on('close', resolve));
+  box.clear();
+  if (finalResult) {
+    console.log(titledBox('Reponse', finalResult.split('\n'), { border: style.nemesisAccent }));
+    console.log('');
+  }
+}
+
+function actionShowOdms(inspectResult) {
+  if (inspectResult.odms.length === 0) {
+    console.log(`\n  ${style.dim('Aucun OdM assigne.')}\n`);
+    return;
+  }
+  console.log('');
+  console.log(renderTable(
+    [
+      { key: 'id', label: 'OdM' },
+      { key: 'status', label: 'Status' },
+      { key: 'title', label: 'Titre' },
+    ],
+    inspectResult.odms,
+  ));
+  console.log('');
+}
+
+function actionShowCrs(inspectResult) {
+  if (inspectResult.crs.length === 0) {
+    console.log(`\n  ${style.dim('Aucun CR recent.')}\n`);
+    return;
+  }
+  console.log('');
+  for (const cr of inspectResult.crs) {
+    console.log(`  - ${cr.id} (${cr.date})`);
+  }
+  console.log('');
+}
+
+async function actionArchive(agent, config) {
+  const confirmed = await askConfirm(
+    `Confirmer la desinscription de ${agent.name || agent.id} ?`, false
+  );
+  if (!confirmed) {
+    console.log('  Annule.\n');
+    return;
+  }
+  teamRemove(agent.id, config.cwd);
+  console.log(`\n  ${style.green('\u2713')} Agent archive.\n`);
+}
+
+async function handleLeader(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  let agentId = args[0];
+
+  if (!agentId) {
+    agentId = await pickAgent(project, 'Quel agent ?');
+    if (!agentId) return;
+  }
+
+  const registry = readRegistry(project.hcm_dir);
+  if (!registry) {
+    console.log(`\n  ${style.red('Registry introuvable.')}\n`);
+    return;
+  }
+
+  const lanes = getLanes(registry);
+  const lane = lanes.find(l => l.id === agentId || l.name === agentId);
+  if (!lane) {
+    console.log(`\n  ${style.red(`Agent ${agentId} non trouve.`)}\n`);
+    return;
+  }
+
+  let newValue;
+  if (flags.on) {
+    newValue = true;
+  } else if (flags.off) {
+    newValue = false;
+  } else {
+    newValue = !lane.leader;
+  }
+
+  updateLaneField(registry, lane.id, 'leader', newValue);
+  writeRegistry(project.hcm_dir, registry);
+
+  if (newValue) {
+    console.log(`\n  ${style.green('★')} leader: ${style.bold('active')} pour ${lane.name || lane.id}\n`);
+  } else {
+    console.log(`\n  ${style.dim('○')} leader: ${style.bold('desactive')} pour ${lane.name || lane.id}\n`);
+  }
+}
+
+async function handleRemove(args, flags, config) {
+  const project = await ensureProject(config, flags);
+  if (!project) return;
+
+  let agentId = args[0];
+
+  // If no agent specified → picker from registry
+  if (!agentId) {
+    agentId = await pickAgent(project, 'Quel agent desactiver ?');
+    if (!agentId) return;
+  }
+
+  const confirmed = await askConfirm(`Confirmer la desinscription de ${agentId} ?`, false);
+  if (!confirmed) {
+    console.log('  Annule.\n');
+    return;
+  }
+
+  const _result = teamRemove(agentId, config.cwd);
+
+  console.log(`\n  ${style.green('\u2713')} Registre mis a jour (lane retiree)`);
+  console.log(`  ${style.green('\u2713')} CLAUDE.md mis a jour (ligne retiree)`);
+  console.log(`  ${style.green('\u2713')} memory.md conserve (archive)`);
+  console.log(`  ${style.green('\u2713')} Contributor card conservee (archive)`);
+  console.log(`\n  L'agent est desactive. Ses fichiers sont conserves pour tracabilite.\n`);
+}

package/src/config.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+
+const CONFIG_DIR = join(homedir(), '.nemesis');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+const DEFAULT_CONFIG = {
+  version: '1.0.0',
+  defaults: {
+    hcm_url: 'https://hcm.arkalabs.app',
+    hcm_api_key_env: 'HCM_API_KEY',
+    claude_md_path: join(homedir(), '.claude', 'CLAUDE.md'),
+    onboarding_template: join(homedir(), '.claude', 'ONBOARDING_AGENT.md'),
+    hcm_protocol: join(homedir(), '.claude', 'HCM_PROTOCOL.md'),
+  },
+  current_project: null,
+};
+
+async function readConfigFile() {
+  try {
+    const raw = await readFile(CONFIG_FILE, 'utf-8');
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+function detectProject(cwd) {
+  // Priority 1: .nemesis/HCM/project/
+  let baseDir = '.nemesis';
+  let projectDir = join(cwd, '.nemesis', 'HCM', 'project');
+
+  // Fallback: .owner/HCM/project/
+  if (!existsSync(projectDir)) {
+    const legacyDir = join(cwd, '.owner', 'HCM', 'project');
+    if (existsSync(legacyDir)) {
+      baseDir = '.owner';
+      projectDir = legacyDir;
+    } else {
+      return null;
+    }
+  }
+
+  try {
+    const files = readdirSync(projectDir);
+    const contextFile = files.find(f => f.startsWith('CONTEXT_PROJECT_') && f.endsWith('.json'));
+    if (!contextFile) return null;
+
+    const raw = readFileSync(join(projectDir, contextFile), 'utf-8');
+    const ctx = JSON.parse(raw);
+    return {
+      id: ctx.project_meta?.project_id || contextFile.replace('CONTEXT_PROJECT_', '').replace('.json', ''),
+      name: ctx.project_meta?.name || null,
+      context_file: join(projectDir, contextFile),
+      hcm_dir: join(cwd, baseDir, 'HCM'),
+      root: cwd,
+      legacy: baseDir === '.owner',
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function loadConfig(cwd = process.cwd()) {
+  const fileConfig = await readConfigFile();
+  const merged = {
+    ...DEFAULT_CONFIG,
+    ...fileConfig,
+    defaults: { ...DEFAULT_CONFIG.defaults, ...fileConfig.defaults },
+  };
+
+  const project = detectProject(cwd);
+  if (project) {
+    merged.current_project = project;
+  }
+
+  merged.cwd = cwd;
+  merged.config_dir = CONFIG_DIR;
+  merged.config_file = CONFIG_FILE;
+
+  return merged;
+}

package/src/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from './cli.js';
+
+run(process.argv.slice(2));

package/templates/project-context.json

@@ -0,0 +1,10 @@
+{
+  "project_meta": {
+    "project_id": "",
+    "name": "",
+    "description": "",
+    "status": "ACTIVE",
+    "created_at": "",
+    "created_by": "PM"
+  }
+}

package/templates/template_CONTRIB-NAME.json

@@ -0,0 +1,22 @@
+{
+  "schema": "arka.contributor_card.v1",
+  "contributor_meta": {
+    "contributor_id": "",
+    "kind": "",
+    "project_id": ""
+  },
+  "contributor_payload": {
+    "identity": {
+      "display_name": "",
+      "role": "",
+      "organization": "Arka Labs"
+    },
+    "expertise": {
+      "domains": [],
+      "description": ""
+    },
+    "runtime": null,
+    "capabilities": [],
+    "profiles": []
+  }
+}