hive-lite 0.1.0

package/src/cli.js

@@ -0,0 +1,910 @@
+const path = require('path');
+const { requireGitRepo } = require('./lib/git');
+const { evaluateMapHealth } = require('./lib/health');
+const { createMapPrompt, initProject, loadProjectMap, suggestMap, verifyProjectMap } = require('./lib/map');
+const { createContextPacket } = require('./lib/context');
+const { evaluateNextAction } = require('./lib/next');
+const { installSkills, skillsDoctor, syncSkills } = require('./lib/skills');
+const { patternDisplay } = require('./lib/scope');
+const { evaluateWorkspaceStatus } = require('./lib/status');
+const {
+  acceptChange,
+  allDeltas,
+  applyDelta,
+  createOrUpdateChange,
+  latestChangeId,
+  loadChange,
+  rejectDelta,
+  validateChange,
+} = require('./lib/change');
+
+function parseArgs(args) {
+  const positional = [];
+  const flags = {};
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (!arg.startsWith('-')) {
+      positional.push(arg);
+      continue;
+    }
+    if (arg === '--json' || arg === '--commit' || arg === '--reviewed' || arg === '--skip-validation' || arg === '--accept-risk' || arg === '--force' || arg === '--explain' || arg === '--all' || arg === '--dry-run') {
+      flags[arg.slice(2).replace(/-([a-z])/g, (_, ch) => ch.toUpperCase())] = true;
+      continue;
+    }
+    const key = arg === '-m' ? 'message' : arg.slice(2).replace(/-([a-z])/g, (_, ch) => ch.toUpperCase());
+    const next = args[i + 1];
+    if (next === undefined || next.startsWith('--')) {
+      flags[key] = true;
+    } else {
+      flags[key] = next;
+      i += 1;
+    }
+  }
+  return { positional, flags };
+}
+
+function printHelp() {
+  console.log(`
+Hive Lite - local Project Map + Change Control
+
+Usage:
+  hive-lite init
+  hive-lite doctor
+  hive-lite status [--json] [--all]
+  hive-lite next [--json] [--agent codex|claude|gemini|all] [--path <skills-dir>]
+  hive-lite skills doctor [--agent codex|claude|gemini|all] [--path <skills-dir>] [--json]
+  hive-lite skills install --agent codex|claude|gemini|all [--force] [--dry-run] [--json]
+  hive-lite skills sync --agent codex|claude|gemini|all [--dry-run] [--json]
+  hive-lite find "<intent>" [--area <id>] [--max-files 8] [--explain] [--json]
+  hive-lite check [changeId] [--context ctx_id] [--json]
+  hive-lite validate [changeId] [--cmd "..."] [--profile <id>]
+  hive-lite validate [changeId] --manual <profile> --result passed --note "..."
+  hive-lite accept [changeId] [--commit -m "..."] [--reviewed --reason "..."] [--accept-risk --reason "..."] [--skip-validation --reason "..."]
+  hive-lite map verify [--json]
+  hive-lite map suggest
+  hive-lite map health [--area <id>] [--json]
+  hive-lite map prompt [--focus <path-or-topic>] [--from-find ctx_id] [--max-areas 8] [--json]
+  hive-lite map delta list
+  hive-lite map delta apply <deltaId>
+  hive-lite map delta reject <deltaId> --reason "..."
+`);
+}
+
+function relative(root, file) {
+  return path.relative(root, file).replace(/\\/g, '/');
+}
+
+function currentCliCommandArgv() {
+  if (!process.argv[1]) return ['hive-lite'];
+  return [process.execPath, path.resolve(process.argv[1])];
+}
+
+function printInit(result) {
+  console.log('Hive Lite initialized.');
+  console.log(`Repo: ${result.root}`);
+  if (result.created.length > 0) {
+    console.log('\nCreated:');
+    for (const file of result.created) console.log(`  - ${file}`);
+  } else {
+    console.log('\nNo files created; Hive Lite was already initialized.');
+  }
+  if (result.warnings && result.warnings.length > 0) {
+    console.log('\nWarnings:');
+    for (const warning of result.warnings) console.log(`  - ${warning}`);
+    console.log('  Durable files should be committed: .hive/config.yaml and .hive/map/**');
+    console.log('  Ignore only runtime evidence: .hive/context/, .hive/changes/, .hive/patches/, .hive/state/');
+  }
+  console.log('\nNext:');
+  console.log('  1. Edit .hive/map/areas.yaml');
+  console.log('  2. Run: hive-lite find "<intent>"');
+}
+
+function printVerify(root, result) {
+  console.log(`Project Map: ${root}`);
+  if (result.problems.length === 0) console.log('Status: ok');
+  else {
+    console.log('Status: invalid');
+    console.log('\nProblems:');
+    for (const problem of result.problems) console.log(`  - ${problem}`);
+  }
+  if (result.warnings.length > 0) {
+    console.log('\nWarnings:');
+    for (const warning of result.warnings) console.log(`  - ${warning}`);
+  }
+}
+
+function verifyJson(root, result) {
+  return {
+    status: result.problems.length === 0 ? 'ok' : 'invalid',
+    mapDir: path.join(root, '.hive', 'map'),
+    problems: result.problems,
+    errors: result.problems,
+    warnings: result.warnings,
+  };
+}
+
+function printContext(result) {
+  const packet = result.packet;
+  const focus = JSON.stringify(packet.intent.raw);
+  console.log(`Context Packet: ${packet.id}`);
+  console.log('');
+  console.log('Mode:');
+  console.log(`  ${packet.mode}`);
+  console.log('');
+  console.log('Intent:');
+  console.log(`  ${packet.intent.summary}`);
+  console.log('');
+  console.log('Likely Area:');
+  if (packet.area) {
+    console.log(`  ${packet.area.id}`);
+    console.log(`  confidence: ${packet.area.confidence}`);
+    if (packet.area.matchedSignals.length > 0) {
+      console.log('  signals:');
+      for (const signal of packet.area.matchedSignals.slice(0, 8)) console.log(`    - ${signal}`);
+    }
+  } else {
+    console.log('  unknown');
+  }
+  if (!packet.area) {
+    console.log('');
+    console.log('Candidate Areas:');
+    if (!packet.candidateAreas || packet.candidateAreas.length === 0) console.log('  - (none matched)');
+    for (const candidate of packet.candidateAreas || []) {
+      console.log(`  - ${candidate.id} (score ${candidate.score})`);
+      if (candidate.signals.length > 0) {
+        console.log(`    signals: ${candidate.signals.slice(0, 4).join(', ')}`);
+      }
+    }
+    console.log('');
+    console.log('Map Guidance:');
+    console.log('  - Add aliases/concepts that match this intent wording.');
+    console.log('  - Add entrypoints for the files an agent should inspect first.');
+    console.log(`  - Try: hive-lite map prompt --focus ${focus} --from-find ${packet.id}`);
+  }
+  if (packet.warnings && packet.warnings.length > 0) {
+    console.log('');
+    console.log('Warnings:');
+    for (const warning of packet.warnings) console.log(`  - ${warning.code}: ${warning.message}`);
+  }
+  if (packet.reviewGated && packet.reviewGated.length > 0) {
+    console.log('');
+    console.log('Review-Gated Scope:');
+    for (const notice of packet.reviewGated) console.log(`  - ${notice.code}: ${notice.message}`);
+  }
+  if (packet.decompositionSignals && packet.decompositionSignals.length > 0) {
+    console.log('');
+    console.log('Decomposition Signals:');
+    for (const item of packet.decompositionSignals) console.log(`  - ${item.code}: ${item.message}`);
+  }
+  if (packet.splitNote) {
+    console.log('');
+    console.log('Split Note:');
+    console.log(`  ${packet.splitNote.markdownPath}`);
+  }
+  if (packet.phaseDependencyStatus) {
+    console.log('');
+    console.log('Phase Dependency Status:');
+    console.log(`  can start normally: ${packet.phaseDependencyStatus.canStartNormally ? 'yes' : 'no'}`);
+    console.log(`  ${packet.phaseDependencyStatus.message}`);
+    if (packet.phaseDependencyStatus.missingRequiredAcceptedPhases && packet.phaseDependencyStatus.missingRequiredAcceptedPhases.length > 0) {
+      console.log('  missing required phases:');
+      for (const phaseId of packet.phaseDependencyStatus.missingRequiredAcceptedPhases) console.log(`    - ${phaseId}`);
+    }
+  }
+  if (packet.mode === 'needs_decomposition' && packet.candidatePhaseSeeds && packet.candidatePhaseSeeds.length > 0) {
+    console.log('');
+    console.log('Candidate Phase Seeds:');
+    for (const item of packet.candidatePhaseSeeds) {
+      console.log(`  - ${item.id} (${item.areaId})`);
+      console.log(`    find: ${item.findIntent}`);
+      if (item.evidenceClasses && item.evidenceClasses.length > 0) console.log(`    evidence: ${item.evidenceClasses.join(', ')}`);
+      if (item.validationProfiles && item.validationProfiles.length > 0) console.log(`    validation: ${item.validationProfiles.join(', ')}`);
+      console.log(`    risk: ${item.risk}`);
+    }
+  }
+  console.log('');
+  console.log('Relevant Files:');
+  if (packet.relevantFiles.length === 0) console.log('  - (none found)');
+  for (const file of packet.relevantFiles) console.log(`  - ${file.path}\n    reason: ${file.reason}`);
+  console.log('');
+  console.log('Writable Scope:');
+  if (packet.writableScope.length === 0) console.log('  - (none; this is not an edit permit)');
+  for (const item of packet.writableScope) console.log(`  - ${item}`);
+  if (packet.scope) {
+    console.log('');
+    console.log(`Scope Quality: ${packet.scope.quality}`);
+    console.log('');
+    console.log('Conditional Writable Scope:');
+    if (packet.scope.writableConditional.length === 0) console.log('  - (none configured)');
+    for (const item of packet.scope.writableConditional) console.log(`  - ${patternDisplay(item)}`);
+    console.log('');
+    console.log('Broad Fallback Scope:');
+    if (packet.scope.writableBroadFallback.length === 0) console.log('  - (none configured)');
+    for (const item of packet.scope.writableBroadFallback) console.log(`  - ${patternDisplay(item)}`);
+  }
+  console.log('');
+  console.log('Do Not Touch:');
+  if (packet.doNotTouch.length === 0) console.log('  - (none configured)');
+  for (const item of packet.doNotTouch) console.log(`  - ${item}`);
+  console.log('');
+  console.log('Validation:');
+  if (packet.validationPlan.length === 0) console.log('  - (none configured)');
+  for (const item of packet.validationPlan) {
+    if (item.command) console.log(`  - ${item.command}`);
+    else console.log(`  - manual: ${item.description || item.profile}`);
+  }
+  console.log('');
+  console.log('Risk:');
+  console.log(`  ${packet.risk.level}`);
+  console.log('');
+  console.log('Saved:');
+  console.log(`  ${relative(packet.repo.root, result.mdPath)}`);
+  console.log(`  ${relative(packet.repo.root, result.jsonPath)}`);
+  console.log('');
+  if (packet.mode === 'edit_context') {
+    console.log(`Next: give ${relative(packet.repo.root, result.mdPath)} to your coding agent, then run hive-lite check --context ${packet.id}`);
+  } else if (packet.recommendedActions && packet.recommendedActions.length > 0) {
+    console.log('Next:');
+    for (const action of packet.recommendedActions) console.log(`  - ${action}`);
+  } else {
+    console.log(`Next: refine .hive/map/areas.yaml, then run hive-lite find again.`);
+  }
+}
+
+function printFindExplain(packet) {
+  console.log('');
+  console.log('Find Explain');
+  console.log('');
+  console.log('Area Scores:');
+  if (!packet.explain.areaScores.length) console.log('  - (no areas configured)');
+  for (const area of packet.explain.areaScores) {
+    console.log(`  - ${area.id}: ${area.score}`);
+    for (const signal of area.signals) console.log(`    + ${signal}`);
+  }
+  console.log('');
+  console.log(`Selected Area: ${packet.explain.selectedArea || '(none)'}`);
+  console.log(`Scope Quality: ${packet.explain.scopeQuality}`);
+  console.log(`Validation: ${packet.explain.validationQuality}`);
+  if (packet.explain.grepScope) console.log(`Grep Scope: ${packet.explain.grepScope}`);
+  console.log('');
+  console.log('Relevant File Sources:');
+  if (!packet.explain.relevantFileSources.length) console.log('  - (none)');
+  for (const file of packet.explain.relevantFileSources) {
+    console.log(`  - ${file.path}`);
+    console.log(`    source: ${file.source}`);
+    if (file.role) console.log(`    role: ${file.role}`);
+    console.log(`    reason: ${file.reason}`);
+  }
+  if (packet.explain.warnings.length > 0) {
+    console.log('');
+    console.log('Warnings:');
+    for (const warning of packet.explain.warnings) console.log(`  - ${warning.code}: ${warning.message}`);
+  }
+  if (packet.explain.reviewGated && packet.explain.reviewGated.length > 0) {
+    console.log('');
+    console.log('Review-Gated Scope:');
+    for (const notice of packet.explain.reviewGated) console.log(`  - ${notice.code}: ${notice.message}`);
+  }
+  if (packet.explain.decompositionSignals && packet.explain.decompositionSignals.length > 0) {
+    console.log('');
+    console.log('Decomposition Signals:');
+    for (const signal of packet.explain.decompositionSignals) console.log(`  - ${signal.code}: ${signal.message}`);
+  }
+  if (packet.explain.recommendedActions.length > 0) {
+    console.log('');
+    console.log('Recommended:');
+    for (const action of packet.explain.recommendedActions) console.log(`  - ${action}`);
+  }
+}
+
+function printCheck(root, result) {
+  if (result.clean) {
+    console.log('No current change: working tree is clean.');
+    return;
+  }
+  const change = result.change;
+  console.log(`Change: ${change.id}`);
+  console.log('');
+  console.log(`Branch: ${change.repo.branch || '(detached)'}`);
+  console.log(`Baseline: ${change.repo.baselineCommit || '(unknown)'}`);
+  console.log('');
+  console.log('Changed Files:');
+  for (const file of change.diff.changedFiles) console.log(`  - ${file.path}`);
+  console.log('');
+  console.log('Scope:');
+  console.log(`  ${change.scope.status}`);
+  console.log(`  source: ${change.scope.source}`);
+  if (change.scope.quality) console.log(`  quality: ${change.scope.quality}`);
+  if (change.scope.violations.length > 0) {
+    console.log('  violations:');
+    for (const violation of change.scope.violations) console.log(`    - ${violation}`);
+  }
+  if (change.scope.review.length > 0) {
+    console.log('  needs review:');
+    for (const file of change.scope.review) console.log(`    - ${file}`);
+  }
+  if (change.scope.reviewDetails && change.scope.reviewDetails.length > 0) {
+    console.log('  review reasons:');
+    for (const detail of change.scope.reviewDetails) console.log(`    - ${detail}`);
+  }
+  if (change.scope.writableConditional && change.scope.writableConditional.length > 0) {
+    console.log('  conditional writable:');
+    for (const item of change.scope.writableConditional) console.log(`    - ${patternDisplay(item)}`);
+  }
+  if (change.scope.writableBroadFallback && change.scope.writableBroadFallback.length > 0) {
+    console.log('  broad fallback:');
+    for (const item of change.scope.writableBroadFallback) console.log(`    - ${patternDisplay(item)}`);
+  }
+  console.log('');
+  console.log('Validation:');
+  console.log(`  ${change.validation.status}`);
+  const commands = (change.validation.plan || []).filter((item) => item.command).map((item) => item.command);
+  if (commands.length > 0) {
+    console.log('  suggested:');
+    for (const command of commands) console.log(`    - ${command}`);
+  }
+  if (change.validation.results && change.validation.results.length > 0) {
+    console.log('  results:');
+    for (const item of change.validation.results) {
+      const label = item.command ? item.profile : `manual:${item.profile}`;
+      console.log(`    - ${label}: ${item.status}`);
+      if (item.note) console.log(`      note: ${item.note}`);
+    }
+  }
+  if (change.evidencePolicy) {
+    console.log('');
+    console.log('Evidence Policy:');
+    console.log(`  class: ${change.evidencePolicy.class}`);
+    console.log(`  verdict: ${change.evidencePolicy.verdict}`);
+    if (change.evidencePolicy.changedRoles && change.evidencePolicy.changedRoles.length > 0) {
+      console.log('  changed roles:');
+      for (const item of change.evidencePolicy.changedRoles) console.log(`    - ${item.role}: ${item.files.join(', ')}`);
+    }
+    if (change.evidencePolicy.required && change.evidencePolicy.required.length > 0) {
+      console.log('  required:');
+      for (const item of change.evidencePolicy.required) console.log(`    - ${item}`);
+    }
+    if (change.evidencePolicy.recommended && change.evidencePolicy.recommended.length > 0) {
+      console.log('  recommended:');
+      for (const item of change.evidencePolicy.recommended) console.log(`    - ${item}`);
+    }
+    if (change.evidencePolicy.missing && change.evidencePolicy.missing.length > 0) {
+      console.log('  missing:');
+      for (const item of change.evidencePolicy.missing) console.log(`    - ${item}`);
+    }
+    if (change.evidencePolicy.reasons && change.evidencePolicy.reasons.length > 0) {
+      console.log('  reasons:');
+      for (const reason of change.evidencePolicy.reasons) console.log(`    - ${reason}`);
+    }
+  }
+  console.log('');
+  console.log('Risk:');
+  console.log(`  ${change.risk.level}`);
+  if (change.risk.blockingReasons.length > 0) {
+    console.log('  blockers:');
+    for (const reason of change.risk.blockingReasons) console.log(`    - ${reason}`);
+  }
+  if (change.risk.reviewReasons.length > 0) {
+    console.log('  review:');
+    for (const reason of change.risk.reviewReasons) console.log(`    - ${reason}`);
+  }
+  console.log('');
+  console.log(`Verdict: ${change.evidencePolicy ? change.evidencePolicy.verdict : change.risk.verdict}`);
+  console.log('');
+  console.log('Next Actions:');
+  for (const action of change.nextActions) console.log(`  - ${action}`);
+  console.log('');
+  console.log(`Evidence: ${relative(root, path.join(root, '.hive', 'changes', change.id, 'change.json'))}`);
+}
+
+function printValidation(result) {
+  const validation = result.result;
+  console.log(`Validation: ${validation.id}`);
+  console.log('');
+  if (validation.command) console.log(`Command: ${validation.command}`);
+  else console.log(`Manual: ${validation.profile}`);
+  console.log(`Status: ${validation.status}`);
+  console.log(`Exit Code: ${validation.exitCode}`);
+  if (validation.stdoutPath) console.log(`Stdout: ${validation.stdoutPath}`);
+  if (validation.stderrPath) console.log(`Stderr: ${validation.stderrPath}`);
+  if (validation.note) console.log(`Note: ${validation.note}`);
+  console.log('');
+  console.log(`Updated Verdict: ${result.change.evidencePolicy ? result.change.evidencePolicy.verdict : result.change.risk.verdict}`);
+}
+
+function printAccept(result) {
+  console.log(`Accepted Change: ${result.change.id}`);
+  console.log('');
+  if (result.commit) console.log(`Commit: ${result.commit}`);
+  else console.log('Commit: (not created)');
+  console.log(`Evidence: .hive/changes/${result.change.id}/evidence.json`);
+  console.log('');
+  if (result.delta) {
+    console.log('Map Delta Candidate:');
+    console.log(`  ${result.delta.id}`);
+    console.log(`  ${result.delta.claim.text}`);
+    console.log('');
+    console.log(`Next: hive-lite map delta apply ${result.delta.id}`);
+  } else {
+    console.log('Map Delta Candidate: none');
+  }
+  if (result.postAcceptHint) {
+    console.log('');
+    console.log('Split Note Hint:');
+    console.log(`  ${result.postAcceptHint.message}`);
+    if (result.postAcceptHint.readyPhases && result.postAcceptHint.readyPhases.length > 0) {
+      console.log('  Ready phases:');
+      for (const phase of result.postAcceptHint.readyPhases) console.log(`    - ${phase.phaseId}: ${phase.title}`);
+    }
+    if (result.postAcceptHint.waitingPhases && result.postAcceptHint.waitingPhases.length > 0) {
+      console.log('  Waiting phases:');
+      for (const phase of result.postAcceptHint.waitingPhases) {
+        console.log(`    - ${phase.phaseId}: waiting on ${phase.missingRequiredAcceptedPhases.join(', ')}`);
+      }
+    }
+    if (result.postAcceptHint.suggestedNextPhase) {
+      console.log(`  Suggested next phase: ${result.postAcceptHint.suggestedNextPhase.phaseId}`);
+      console.log(`  Find: ${result.postAcceptHint.suggestedNextPhase.findIntent}`);
+    }
+  }
+}
+
+function printDeltas(deltas) {
+  const pending = deltas.filter((delta) => delta.status !== 'applied' && delta.status !== 'rejected');
+  if (pending.length === 0) {
+    console.log('No pending map deltas.');
+    return;
+  }
+  console.log('Pending Map Deltas:');
+  for (const delta of pending) {
+    console.log('');
+    console.log(delta.id);
+    console.log(`  type: ${delta.type}`);
+    console.log(`  status: ${delta.status}`);
+    console.log(`  claim: ${delta.claim && delta.claim.text}`);
+    console.log(`  source change: ${delta.source && delta.source.changeId}`);
+    console.log(`  target area: ${delta.target && delta.target.areaId}`);
+  }
+}
+
+function printMapPrompt(result) {
+  console.log(result.prompt);
+}
+
+function printFindings(title, findings) {
+  if (findings.length === 0) return;
+  console.log('');
+  console.log(`${title}:`);
+  for (const finding of findings) {
+    const area = finding.areaId ? ` ${finding.areaId}` : '';
+    console.log(`  - [${finding.code}]${area}`);
+    console.log(`    ${finding.message}`);
+    if (finding.impact) console.log(`    Impact: ${finding.impact}`);
+    if (finding.fix) console.log(`    Fix: ${finding.fix}`);
+    if (finding.relatedCommand) console.log(`    Try: ${finding.relatedCommand}`);
+  }
+}
+
+function printMapHealth(result) {
+  console.log('Map Health');
+  console.log('');
+  console.log(`Status: ${result.status}`);
+  console.log(`Areas checked: ${result.summary.areasChecked}`);
+  console.log(`Critical: ${result.summary.critical}`);
+  console.log(`Warnings: ${result.summary.warnings}`);
+  console.log(`Info: ${result.summary.info}`);
+
+  if (result.areas.length > 0) {
+    console.log('');
+    console.log('Area Readiness:');
+    for (const area of result.areas) console.log(`  - ${area.id}: ${area.readiness}`);
+  }
+
+  printFindings('Critical', result.findings.filter((finding) => finding.severity === 'critical'));
+  printFindings('Warnings', result.findings.filter((finding) => finding.severity === 'warning'));
+  printFindings('Info', result.findings.filter((finding) => finding.severity === 'info'));
+
+  if (result.suggestions.length > 0) {
+    console.log('');
+    console.log('Suggestions:');
+    for (const suggestion of result.suggestions) console.log(`  - ${suggestion.command}`);
+  }
+}
+
+function printWorkspaceStatus(result) {
+  console.log('Hive Lite Status');
+  console.log('');
+  console.log(`Repo: ${result.root}`);
+  if (result.repo) console.log(`Git Repo: ${result.repo.isGitRepo ? 'yes' : 'no'}`);
+  console.log(`Branch: ${result.branch || '(detached)'}`);
+  console.log(`HEAD: ${result.head || '(unknown)'}`);
+  console.log('');
+  console.log(`Worktree: ${result.worktree.status}`);
+  console.log(`Hive State: ${result.hive.state}`);
+  console.log(`Can Start New Requirement: ${result.canStartNewRequirement ? 'yes' : 'no'}`);
+  console.log(`Reason: ${result.hive.reason}`);
+  if (result.hive.latestChange) {
+    console.log('');
+    console.log('Latest Change:');
+    console.log(`  id: ${result.hive.latestChange.id}`);
+    if (result.hive.latestChange.verdict) console.log(`  verdict: ${result.hive.latestChange.verdict}`);
+    if (result.hive.latestChange.validationStatus) console.log(`  validation: ${result.hive.latestChange.validationStatus}`);
+    console.log(`  current diff matches: ${result.hive.latestChange.currentDiffMatchesLatestChange ? 'yes' : 'no'}`);
+    if (result.hive.latestChange.humanDecision) {
+      console.log(`  decision: ${result.hive.latestChange.humanDecision.status}`);
+      console.log(`  commit: ${result.hive.latestChange.humanDecision.commit || '(not created)'}`);
+    }
+  }
+  if (result.worktree.changedFiles.length > 0) {
+    console.log('');
+    console.log('Changed Files:');
+    for (const file of result.worktree.changedFiles) console.log(`  - ${file.path} (${file.status})`);
+  }
+  if (result.recentSplitNotes && result.recentSplitNotes.length > 0) {
+    console.log('');
+    console.log('Recent Split Notes:');
+    const primarySplitId = result.splitNoteSummary && result.splitNoteSummary.primaryRecentSplitNote
+      ? result.splitNoteSummary.primaryRecentSplitNote.id
+      : null;
+    for (const split of result.recentSplitNotes) {
+      console.log(`  - ${split.id}${split.id === primarySplitId ? ' (primary)' : ''}`);
+      console.log(`    intent: ${split.originalIntent}`);
+      if (split.suggestedNextPhase) {
+        console.log(`    suggested next: ${split.suggestedNextPhase.phaseId}`);
+      }
+    }
+    if (result.splitNoteSummary && result.splitNoteSummary.otherActiveSplitNotes.length > 0) {
+      console.log(`  Other active split notes: ${result.splitNoteSummary.otherActiveSplitNotes.length}`);
+    }
+  }
+  if (result.splitNoteSummary && result.splitNoteSummary.suppressed > 0) {
+    console.log('');
+    console.log(`Split Notes Hidden: ${result.splitNoteSummary.suppressed}`);
+    console.log('  Run: hive-lite status --all');
+  }
+  if (result.recommendedActions.length > 0) {
+    console.log('');
+    console.log('Recommended Actions:');
+    for (const item of result.recommendedActions) {
+      console.log(`  - ${item.label}`);
+      if (item.command) console.log(`    ${item.command}`);
+      if (item.description) console.log(`    ${item.description}`);
+    }
+  }
+}
+
+function printActionBlock(title, action) {
+  if (!action) return;
+  console.log(title);
+  console.log(`  ${action.label}`);
+  if (action.explanation) console.log(`  ${action.explanation}`);
+  if (action.command) {
+    console.log('  Command:');
+    console.log(`    ${action.command}`);
+  }
+  if (action.prompt) {
+    console.log('  Prompt:');
+    for (const line of action.prompt.split(/\r?\n/)) console.log(`    ${line}`);
+  }
+  if (action.disabledReason) console.log(`  Disabled: ${action.disabledReason}`);
+}
+
+function printNext(result) {
+  console.log('Hive Lite Next');
+  console.log('');
+  console.log('Current State:');
+  if (result.state.hive.state === 'repo_setup_required') console.log('  Git Repo: no');
+  console.log(`  Worktree: ${result.state.worktree.status}`);
+  console.log(`  Hive State: ${result.state.hive.state}`);
+  console.log(`  Can Start New Requirement: ${result.state.canStartNewRequirement ? 'yes' : 'no'}`);
+  console.log(`  Map Health: ${result.state.mapHealth.status} (${result.state.mapHealth.critical} critical, ${result.state.mapHealth.warnings} warnings)`);
+  if (result.state.latestChange) {
+    console.log(`  Latest Change: ${result.state.latestChange.id}`);
+    if (result.state.latestChange.verdict) console.log(`  Latest Verdict: ${result.state.latestChange.verdict}`);
+  }
+  console.log('');
+  console.log(`Phase Guess: ${result.phaseGuess}`);
+  console.log('');
+  console.log('Summary:');
+  console.log(`  ${result.summaryForHuman}`);
+  console.log('');
+  printActionBlock('Recommended Next Action:', result.primaryAction);
+
+  if (result.operatorSkillPreflight) {
+    console.log('');
+    console.log('Operator Skill Preflight:');
+    console.log(`  required: ${result.operatorSkillPreflight.requiredSkill}`);
+    console.log(`  ready: ${result.operatorSkillPreflight.ready ? 'yes' : 'no'}`);
+    console.log('  agent detection: not performed');
+    for (const target of result.operatorSkillPreflight.targets) {
+      const scope = target.scope ? `, ${target.scope}` : '';
+      console.log(`  - ${target.agent}: ${target.status} (${target.configuredPath}${scope})`);
+      if (target.note) console.log(`    ${target.note}`);
+    }
+  }
+
+  if (result.secondaryActions.length > 0) {
+    console.log('');
+    console.log('Secondary Actions:');
+    for (const action of result.secondaryActions) {
+      console.log(`  - ${action.label}`);
+      if (action.command) console.log(`    ${action.command}`);
+      if (action.prompt) {
+        console.log('    prompt:');
+        for (const line of action.prompt.split(/\r?\n/)) console.log(`      ${line}`);
+      }
+    }
+  }
+
+  if (result.state.recentSplitNotes.length > 0) {
+    console.log('');
+    console.log('Recent Split Notes:');
+    const primarySplitId = result.state.splitNoteSummary && result.state.splitNoteSummary.primaryRecentSplitNote
+      ? result.state.splitNoteSummary.primaryRecentSplitNote.id
+      : null;
+    for (const split of result.state.recentSplitNotes.slice(0, 3)) {
+      console.log(`  - ${split.id}${split.id === primarySplitId ? ' (primary)' : ''}`);
+      if (split.suggestedNextPhase) console.log(`    suggested next: ${split.suggestedNextPhase.phaseId}`);
+    }
+    if (result.state.splitNoteSummary && result.state.splitNoteSummary.otherActiveSplitNotes.length > 0) {
+      console.log(`  Other active split notes: ${result.state.splitNoteSummary.otherActiveSplitNotes.length}`);
+    }
+  }
+  if (result.state.splitNoteSummary && result.state.splitNoteSummary.suppressed > 0) {
+    console.log('');
+    console.log(`Split Notes Hidden: ${result.state.splitNoteSummary.suppressed}`);
+    console.log('  Run: hive-lite status --all');
+  }
+
+  if (result.warnings.length > 0) {
+    console.log('');
+    console.log('Warnings:');
+    for (const warning of result.warnings) console.log(`  - ${warning}`);
+  }
+}
+
+function printSkillsDoctor(result) {
+  console.log('Hive Lite Skills Doctor');
+  console.log('');
+  console.log(`Source: ${result.sourceDir}`);
+  console.log(`Current: ${result.summary.current}`);
+  console.log(`Stale: ${result.summary.stale}`);
+  console.log(`Missing: ${result.summary.missing}`);
+  if (result.targetSelection) {
+    console.log(`Target Selection: ${result.targetSelection.mode}`);
+    console.log('Agent CLI Detection: not performed');
+  }
+  for (const target of result.targets) {
+    console.log('');
+    console.log(`${target.label}:`);
+    console.log(`  path: ${target.path}`);
+    if (target.scope) console.log(`  scope: ${target.scope}`);
+    if (target.note) console.log(`  note: ${target.note}`);
+    console.log(`  exists: ${target.exists ? 'yes' : 'no'}`);
+    for (const skill of target.skills) {
+      console.log(`  - ${skill.name}: ${skill.status}`);
+    }
+  }
+  if (result.summary.missing > 0 || result.summary.stale > 0) {
+    console.log('');
+    console.log('Next:');
+    console.log('  hive-lite skills install --agent <codex|claude|gemini|all>');
+    console.log('  hive-lite skills sync --agent <codex|claude|gemini|all>');
+  }
+}
+
+function printSkillsMutation(result) {
+  console.log(result.command === 'skills sync' ? 'Hive Lite Skills Sync' : 'Hive Lite Skills Install');
+  console.log('');
+  console.log(`Source: ${result.sourceDir}`);
+  for (const item of result.results) {
+    console.log('');
+    console.log(`${item.label}:`);
+    console.log(`  path: ${item.path}`);
+    if (item.scope) console.log(`  scope: ${item.scope}`);
+    if (item.note) console.log(`  note: ${item.note}`);
+    if (item.dryRun) console.log('  dry run: yes');
+    if (item.installed.length > 0) console.log(`  installed: ${item.installed.join(', ')}`);
+    if (item.updated.length > 0) console.log(`  updated: ${item.updated.join(', ')}`);
+    if (item.unchanged.length > 0) console.log(`  unchanged: ${item.unchanged.join(', ')}`);
+    if (item.skipped.length > 0) {
+      console.log('  skipped:');
+      for (const skipped of item.skipped) console.log(`    - ${skipped.name}: ${skipped.reason}`);
+    }
+    if (!item.installed.length && !item.updated.length && !item.skipped.length) {
+      console.log('  status: already current');
+    }
+  }
+}
+
+async function main(argv) {
+  const [command, subcommand, subsubcommand, ...rest] = argv;
+  if (!command || command === 'help' || command === '--help' || command === '-h') {
+    printHelp();
+    return;
+  }
+
+  if (command === 'init') {
+    requireGitRepo(process.cwd(), 'hive-lite init');
+    printInit(initProject(process.cwd()));
+    return;
+  }
+
+  if (command === 'doctor') {
+    const root = requireGitRepo(process.cwd(), 'hive-lite doctor');
+    const result = verifyProjectMap(root);
+    printVerify(root, result);
+    if (result.problems.length > 0) process.exitCode = 1;
+    return;
+  }
+
+  if (command === 'status') {
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const result = evaluateWorkspaceStatus(process.cwd(), parsed.flags);
+    if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+    else printWorkspaceStatus(result);
+    return;
+  }
+
+  if (command === 'next') {
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const result = evaluateNextAction(process.cwd(), parsed.flags);
+    if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+    else printNext(result);
+    return;
+  }
+
+  if (command === 'skills') {
+    const parsed = parseArgs([subsubcommand, ...rest].filter((item) => item !== undefined));
+    if (subcommand === 'doctor') {
+      const result = skillsDoctor(process.cwd(), parsed.flags);
+      if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+      else printSkillsDoctor(result);
+      return;
+    }
+    if (subcommand === 'install') {
+      const result = installSkills(process.cwd(), parsed.flags);
+      if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+      else printSkillsMutation(result);
+      return;
+    }
+    if (subcommand === 'sync') {
+      const result = syncSkills(process.cwd(), parsed.flags);
+      if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+      else printSkillsMutation(result);
+      return;
+    }
+    throw new Error('skills requires a subcommand: doctor, install, or sync');
+  }
+
+  if (command === 'find') {
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const intent = parsed.positional.join(' ').trim();
+    if (!intent) throw new Error('find requires an intent string');
+    const root = requireGitRepo(process.cwd(), 'hive-lite find');
+    const result = createContextPacket(root, intent, {
+      ...parsed.flags,
+      cliCommandArgv: currentCliCommandArgv(),
+    });
+    if (parsed.flags.json) console.log(JSON.stringify(result.packet, null, 2));
+    else {
+      printContext(result);
+      if (parsed.flags.explain) printFindExplain(result.packet);
+    }
+    return;
+  }
+
+  if (command === 'check') {
+    requireGitRepo(process.cwd(), 'hive-lite check');
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const changeId = parsed.positional[0] || null;
+    const result = createOrUpdateChange(process.cwd(), {
+      changeId,
+      context: parsed.flags.context,
+    });
+    if (parsed.flags.json) console.log(JSON.stringify(result.change || { clean: true }, null, 2));
+    else printCheck(result.root, result);
+    return;
+  }
+
+  if (command === 'validate') {
+    requireGitRepo(process.cwd(), 'hive-lite validate');
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    if (!parsed.flags.json && !parsed.flags.manual) {
+      parsed.flags.onStart = (item) => {
+        console.log(`Running validation: ${item.profile}`);
+        console.log(`Command: ${item.command}`);
+        console.log('');
+      };
+    }
+    const result = validateChange(process.cwd(), parsed.positional[0] || null, parsed.flags);
+    if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+    else printValidation(result);
+    return;
+  }
+
+  if (command === 'accept') {
+    requireGitRepo(process.cwd(), 'hive-lite accept');
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const result = acceptChange(process.cwd(), parsed.positional[0] || null, parsed.flags);
+    if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+    else printAccept(result);
+    return;
+  }
+
+  if (command === 'map') {
+    const root = requireGitRepo(process.cwd(), 'hive-lite map');
+    if (subcommand === 'verify') {
+      const parsed = parseArgs([subsubcommand, ...rest].filter((item) => item !== undefined));
+      const result = verifyProjectMap(root);
+      if (parsed.flags.json) console.log(JSON.stringify(verifyJson(root, result), null, 2));
+      else printVerify(root, result);
+      if (result.problems.length > 0) process.exitCode = 1;
+      return;
+    }
+    if (subcommand === 'suggest') {
+      console.log(JSON.stringify(suggestMap(root), null, 2));
+      return;
+    }
+    if (subcommand === 'health') {
+      const parsed = parseArgs([subsubcommand, ...rest].filter((item) => item !== undefined));
+      const result = evaluateMapHealth(root, parsed.flags);
+      if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+      else printMapHealth(result);
+      process.exitCode = result.exitCode;
+      return;
+    }
+    if (subcommand === 'prompt') {
+      const parsed = parseArgs([subsubcommand, ...rest].filter((item) => item !== undefined));
+      const result = createMapPrompt(root, parsed.flags);
+      if (parsed.flags.json) console.log(JSON.stringify(result, null, 2));
+      else printMapPrompt(result);
+      return;
+    }
+    if (subcommand === 'delta') {
+      if (subsubcommand === 'list') {
+        printDeltas(allDeltas(root));
+        return;
+      }
+      if (subsubcommand === 'apply') {
+        const parsed = parseArgs(rest);
+        const id = parsed.positional[0];
+        if (!id) throw new Error('map delta apply requires a delta id');
+        const result = applyDelta(process.cwd(), id);
+        console.log(`Applied ${result.delta.id}`);
+        console.log(`Updated: .hive/map/areas.yaml`);
+        console.log(result.changed ? 'Status: changed' : 'Status: already present');
+        return;
+      }
+      if (subsubcommand === 'reject') {
+        const parsed = parseArgs(rest);
+        const id = parsed.positional[0];
+        if (!id) throw new Error('map delta reject requires a delta id');
+        const result = rejectDelta(process.cwd(), id, parsed.flags.reason || '');
+        console.log(`Rejected ${result.delta.id}`);
+        return;
+      }
+    }
+  }
+
+  if (command === 'show-change') {
+    const parsed = parseArgs([subcommand, subsubcommand, ...rest].filter((item) => item !== undefined));
+    const root = requireGitRepo(process.cwd(), 'hive-lite show-change');
+    const id = parsed.positional[0] || latestChangeId(root);
+    if (!id) throw new Error('no change id provided and no latest change exists');
+    console.log(JSON.stringify(loadChange(root, id), null, 2));
+    return;
+  }
+
+  if (command === 'map-dump') {
+    console.log(JSON.stringify(loadProjectMap(requireGitRepo(process.cwd(), 'hive-lite map-dump')), null, 2));
+    return;
+  }
+
+  throw new Error(`unknown command: ${command}`);
+}
+
+module.exports = {
+  main,
+  parseArgs,
+};