@axplusb/kepler 2.0.7 → 2.3.0

package/src/ui/mission-report.mjs

@@ -5,18 +5,17 @@
  * structured summary:
  *
  *   ───────────────────────────────────────────────────
- *   ✅ MISSION ACCOMPLISHED · Fix JWT expiration bug
+ *   ✓ done
  *   ───────────────────────────────────────────────────
  *   📂 Files       auth.py, tests/test_auth.py
- *   🛠️ Tools       read(4)  edit(2)  shell(1)  test(1)
+ *   🛠️ Tools read(4)  edit(2)  shell(1)  test(1) · ⏱ Time 2m 18s
  *   🛰️ Sub-agents  explore(1)  plan(1) · saved ≈ $0.08
- *   💰 Cost        $0.14    ⏱  Time  2m 18s
  *   ✅ Health      24/24 tests pass
  *   ───────────────────────────────────────────────────
  *
  *   Next:  /commit   /pr   /undo   /report
  *
- * Failure variant (PRD §11.1) uses ❌ MISSION HELD and lists blockers.
+ * Failure variant uses "held" and lists blockers.
  *
  * `renderMissionReport(state)` returns the ANSI block; `toMarkdown(state)`
  * returns the plain-markdown version saved by `/report`.
@@ -24,6 +23,7 @@
 
 import path from 'node:path';
 import fs from 'node:fs';
+import { execFileSync } from 'node:child_process';
 import { paint, width as visibleWidth } from './palette.mjs';
 import { icons } from './icons.mjs';
 import { toolFamily } from './icons.mjs';
@@ -39,6 +39,7 @@ const WIDTH = 56;
  *   task         — string (the user's prompt for this session)
  *   success      — boolean (overall outcome)
  *   filesChanged — string[]
+ *   filesRead    — string[]
  *   toolCounts   — { [tool]: count } or array of {tool}
  *   subAgents    — array of { type, costUsd?, tokens? } or { explore:1, plan:1 }
  *   costUsd      — number
@@ -46,46 +47,41 @@ const WIDTH = 56;
  *   testsPass    — { passed: number, total: number } | null
  *   blockers     — string[] (for failure variant)
  *   nextActions  — string[] (slash-command hints)
+ *   cwd          — string (used to derive git repo + author metadata)
  */
 export function renderMissionReport(state) {
   const success = state.success !== false;
   const lines = [];
   const rule  = paint.text.dim('─'.repeat(WIDTH));
 
-  const titleIcon = success ? paint.state.success('✅') : paint.state.danger('❌');
-  const titleText = success ? 'MISSION ACCOMPLISHED' : 'MISSION HELD';
-  const titleAccent = success ? paint.state.success : paint.state.danger;
+  const statusIcon = success ? paint.state.success('✓') : paint.state.danger('✗');
+  const statusText = success ? paint.state.success('done') : paint.state.danger('held');
   const headerTask = state.task ? paint.text.dim(' · ') + paint.text.primary(truncate(state.task, 60)) : '';
 
   lines.push('');
   lines.push(rule);
-  lines.push(`${titleIcon} ${paint.bold(titleAccent(titleText))}${headerTask}`);
+  lines.push(`${statusIcon} ${statusText}${headerTask}`);
   lines.push(rule);
 
   if (Array.isArray(state.filesChanged) && state.filesChanged.length) {
     lines.push(row('📂', 'Files',      formatFiles(state.filesChanged)));
   }
+  if (Array.isArray(state.filesRead) && state.filesRead.length) {
+    lines.push(row('📖', 'Read',       formatFiles(state.filesRead)));
+  }
 
   const toolSummary = formatToolCounts(state.toolCounts);
-  if (toolSummary) {
-    lines.push(row(icons.write, 'Tools', toolSummary));
-  }
+  const time = state.durationS != null ? paint.brand.data(formatDuration(state.durationS)) : '';
+  const metricSegments = [];
+  if (toolSummary) metricSegments.push(`${icons.write} ${paint.text.dim('Tools')} ${toolSummary}`);
+  if (time) metricSegments.push(`${paint.text.dim('⏱ Time')} ${time}`);
+  if (metricSegments.length) lines.push('  ' + metricSegments.join(paint.text.dim(' · ')));
 
   if (state.subAgents) {
     const subSummary = formatSubAgents(state.subAgents);
     if (subSummary) lines.push(row(icons.subAgent, 'Sub-agents', subSummary));
   }
 
-  // Cost + time on one row.
-  const cost = state.costUsd != null ? paint.brand.data(formatCost(state.costUsd)) : '';
-  const time = state.durationS != null ? paint.brand.data(formatDuration(state.durationS)) : '';
-  if (cost || time) {
-    const segments = [];
-    if (cost) segments.push(`${paint.text.dim('💰 Cost')}        ${cost}`);
-    if (time) segments.push(`${paint.text.dim('⏱  Time')}  ${time}`);
-    lines.push('  ' + segments.join('    '));
-  }
-
   // Test health.
   if (state.testsPass && typeof state.testsPass.total === 'number' && state.testsPass.total > 0) {
     const { passed = 0, total = 0 } = state.testsPass;
@@ -126,12 +122,18 @@ export function renderMissionReport(state) {
  */
 export function toMarkdown(state) {
   const success = state.success !== false;
+  const meta = resolveReportMeta(state);
   const out = [];
-  out.push(`# ${success ? '✅ Mission Accomplished' : '❌ Mission Held'}${state.task ? ' — ' + state.task : ''}`);
+  out.push(`# ${success ? 'Done' : 'Held'}${state.task ? ' — ' + state.task : ''}`);
   out.push('');
+  out.push('**Repo**: ' + meta.repo);
+  out.push('**Author**: ' + meta.author);
   if (Array.isArray(state.filesChanged) && state.filesChanged.length) {
     out.push('**Files**: ' + state.filesChanged.join(', '));
   }
+  if (Array.isArray(state.filesRead) && state.filesRead.length) {
+    out.push('**Read**: ' + state.filesRead.join(', '));
+  }
   const toolSummary = stripAnsi(formatToolCounts(state.toolCounts) || '');
   if (toolSummary) out.push('**Tools**: ' + toolSummary);
   if (state.subAgents) {
@@ -178,6 +180,37 @@ function row(icon, label, value, alreadyIcon = false) {
   return `  ${i} ${labelText} ${value}`;
 }
 
+function resolveReportMeta(state = {}) {
+  const cwd = state.cwd || process.cwd();
+  return {
+    repo: state.repo || gitValue(cwd, ['remote', 'get-url', 'origin']) ||
+      gitValue(cwd, ['rev-parse', '--show-toplevel'], value => path.basename(value)) ||
+      path.basename(cwd),
+    author: state.author || gitAuthor(cwd) || 'unknown',
+  };
+}
+
+function gitAuthor(cwd) {
+  const name = gitValue(cwd, ['config', '--get', 'user.name']);
+  const email = gitValue(cwd, ['config', '--get', 'user.email']);
+  if (name && email) return `${name} <${email}>`;
+  return name || email || '';
+}
+
+function gitValue(cwd, args, transform = value => value) {
+  try {
+    const value = execFileSync('git', args, {
+      cwd,
+      encoding: 'utf-8',
+      timeout: 1500,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+    return value ? transform(value) : '';
+  } catch {
+    return '';
+  }
+}
+
 function formatFiles(files) {
   const shortened = files.map(f => paint.text.primary(path.basename(f)));
   if (shortened.length <= 4) return shortened.join(paint.text.dim(', '));

package/src/ui/slash-commands.mjs

@@ -29,6 +29,29 @@ export const COMMANDS = {
     '/whoami':   { description: 'Show logged-in user', handler: cmdWhoami },
 };
 
+const COMMAND_GROUPS = [
+    {
+        key: 'worktree',
+        title: 'Worktree',
+        commands: ['/git', '/status', '/commit', '/diff', '/index'],
+    },
+    {
+        key: 'session',
+        title: 'Session',
+        commands: ['/clear', '/sessions', '/exit', '/quit'],
+    },
+    {
+        key: 'usage',
+        title: 'Usage',
+        commands: ['/model', '/tokens', '/cost'],
+    },
+    {
+        key: 'settings',
+        title: 'Settings',
+        commands: ['/config', '/login', '/refresh', '/sync', '/whoami'],
+    },
+];
+
 function run(cmd) {
     try {
         return execSync(cmd, { encoding: 'utf-8', timeout: 15_000, stdio: ['pipe', 'pipe', 'pipe'] });
@@ -37,17 +60,37 @@ function run(cmd) {
     }
 }
 
-function cmdHelp(ctx) {
+function cmdHelp(ctx, args = []) {
     const BOLD = '\x1b[1m', CYAN = '\x1b[36m', DIM = '\x1b[2m', GREEN = '\x1b[32m', BLUE = '\x1b[34m', RESET = '\x1b[0m';
+    const topic = String(args[0] || '').toLowerCase();
+    const group = COMMAND_GROUPS.find(g => g.key === topic || g.title.toLowerCase() === topic);
 
     process.stderr.write(`\n${BLUE}┌──────────────────────────────────────────────┐${RESET}\n`);
     process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Kepler Help${RESET}                                   ${BLUE}│${RESET}\n`);
     process.stderr.write(`${BLUE}├──────────────────────────────────────────────┤${RESET}\n`);
     process.stderr.write(`${BLUE}│${RESET}                                              ${BLUE}│${RESET}\n`);
-    process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Commands:${RESET}                                   ${BLUE}│${RESET}\n`);
-    for (const [name, { description }] of Object.entries(COMMANDS)) {
-        const line = `  ${CYAN}${name.padEnd(12)}${RESET} ${description}`;
-        process.stderr.write(`${BLUE}│${RESET}${line}${' '.repeat(Math.max(0, 44 - name.length - description.length))}${BLUE}│${RESET}\n`);
+    if (topic === 'all') {
+        process.stderr.write(`${BLUE}│${RESET}  ${BOLD}All commands:${RESET}                               ${BLUE}│${RESET}\n`);
+        for (const [name, { description }] of Object.entries(COMMANDS)) {
+            writeHelpCommandLine(BLUE, CYAN, RESET, name, description);
+        }
+    } else if (group) {
+        process.stderr.write(`${BLUE}│${RESET}  ${BOLD}${group.title}:${RESET}${' '.repeat(Math.max(0, 40 - group.title.length))}${BLUE}│${RESET}\n`);
+        for (const name of group.commands) {
+            writeHelpCommandLine(BLUE, CYAN, RESET, name, COMMANDS[name]?.description || '');
+        }
+    } else {
+        process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Top commands:${RESET}                               ${BLUE}│${RESET}\n`);
+        for (const name of ['/help', '/status', '/sessions', '/config', '/whoami', '/exit']) {
+            writeHelpCommandLine(BLUE, CYAN, RESET, name, COMMANDS[name]?.description || '');
+        }
+        process.stderr.write(`${BLUE}│${RESET}                                              ${BLUE}│${RESET}\n`);
+        process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Categories:${RESET}                                 ${BLUE}│${RESET}\n`);
+        for (const g of COMMAND_GROUPS) {
+            const line = `  ${CYAN}${('/help ' + g.key).padEnd(16)}${RESET} ${g.title}`;
+            process.stderr.write(`${BLUE}│${RESET}${line}${' '.repeat(Math.max(0, 44 - visibleLen(`/help ${g.key}`) - g.title.length))}${BLUE}│${RESET}\n`);
+        }
+        process.stderr.write(`${BLUE}│${RESET}  ${DIM}/help all for legacy command list${RESET}        ${BLUE}│${RESET}\n`);
     }
     process.stderr.write(`${BLUE}│${RESET}                                              ${BLUE}│${RESET}\n`);
     process.stderr.write(`${BLUE}│${RESET}  ${BOLD}Keyboard:${RESET}                                   ${BLUE}│${RESET}\n`);
@@ -61,6 +104,15 @@ function cmdHelp(ctx) {
     process.stderr.write(`${BLUE}└──────────────────────────────────────────────┘${RESET}\n\n`);
 }
 
+function writeHelpCommandLine(BLUE, CYAN, RESET, name, description) {
+    const line = `  ${CYAN}${name.padEnd(12)}${RESET} ${description}`;
+    process.stderr.write(`${BLUE}│${RESET}${line}${' '.repeat(Math.max(0, 44 - name.length - description.length))}${BLUE}│${RESET}\n`);
+}
+
+function visibleLen(s) {
+    return String(s || '').length;
+}
+
 function cmdGit() {
     process.stdout.write(run('git status --short --branch') + '\n');
 }

package/src/ui/tool-card.mjs

@@ -76,6 +76,14 @@ export function summarizeResult(tool, data) {
   if (data._blocked) {
     return { text: firstOutputLine(data) || 'blocked', tone: 'danger' };
   }
+  if (data._observation_timeout) {
+    const ms = data._observation_timeout_ms;
+    const duration = typeof ms === 'number' ? formatDuration(ms) : '';
+    return { text: duration ? `observed ${duration} tail` : 'observed output tail', tone: 'warn' };
+  }
+  if (data._timed_out) {
+    return { text: 'timed out', tone: 'danger' };
+  }
   if (data.success === false) {
     const msg = String(data.error || firstOutputLine(data) || 'failed').slice(0, 140);
     return { text: msg, tone: 'danger' };
@@ -224,6 +232,16 @@ export function formatCardHead(tool, args, opts = {}) {
 
   const leadVisible = visibleWidth(`${indent}${label}`);
   const budget = Math.max(20, cols - leadVisible - 4);
+
+  if (tool === 'shell' && visibleWidth(argsText) > budget) {
+    const wrapWidth = Math.max(32, cols - visibleWidth(indent) - 4);
+    const command = toolDisplaySummary(tool, args || {}, { cwd });
+    const commandLines = wrapCommand(command, wrapWidth)
+      .map(line => `${indent}${paint.text.dim('  ')}${formatShellCommand(line, paintShellAdapter)}`);
+    const head = `${indent}${paintLabel(tool, label)}`;
+    return `${head}\n${commandLines.join('\n')}`;
+  }
+
   const argsTruncated = truncateMiddle(argsText, budget);
 
   const head = `${indent}${paintLabel(tool, label)}`;
@@ -255,7 +273,7 @@ export function formatCard({ tool, args, result, durationMs, indent, columns, cw
   const tail  = showDuration ? paint.text.dim(` · ${duration}`) : '';
 
   const candidate = `${head}  ${arrow} ${body}${tail}`;
-  if (visibleWidth(candidate) <= cols) return candidate;
+  if (!head.includes('\n') && visibleWidth(candidate) <= cols) return candidate;
 
   // Doesn't fit on one line → push outcome to a separate gutter line.
   const gutterIndent = (indent || '  ') + paint.text.dim('⎿  ');
@@ -274,6 +292,38 @@ function truncateMiddle(text, max) {
   return paint.text.muted(`${head}…${tail}`);
 }
 
+function wrapCommand(command, width) {
+  const text = String(command || '');
+  if (!text) return ['(empty command)'];
+  const lines = [];
+  let line = '';
+  for (const token of text.match(/\S+\s*/g) || [text]) {
+    const next = line + token;
+    if (line && visibleWidth(next.trimEnd()) > width) {
+      lines.push(line.trimEnd());
+      line = token;
+      continue;
+    }
+    if (!line && visibleWidth(token.trimEnd()) > width) {
+      lines.push(...chunkLongToken(token.trimEnd(), width));
+      line = '';
+      continue;
+    }
+    line = next;
+  }
+  if (line.trimEnd()) lines.push(line.trimEnd());
+  return lines.length ? lines : ['(empty command)'];
+}
+
+function chunkLongToken(token, width) {
+  const chunks = [];
+  const size = Math.max(8, width);
+  for (let i = 0; i < token.length; i += size) {
+    chunks.push(token.slice(i, i + size));
+  }
+  return chunks;
+}
+
 function formatDuration(ms) {
   if (ms == null || !Number.isFinite(ms)) return '';
   if (ms < 1000) return `${Math.round(ms)}ms`;