testronaut 1.10.1 → 1.11.0

package/bin/cli.js

@@ -57,6 +57,7 @@ import { discoverMissionFiles } from '../core/missionDiscovery.js';
 import { loadMissionModule } from '../core/missionLoader.js';
 import { loadConfig } from '../core/config.js';
 import { matchesTagFilter, normalizeTagMatch, normalizeTags } from '../core/tags.js';
+import { createTerminalUi } from './terminalUi.js';
 
 // Keep PW browsers inside the project to avoid global cache skew
 process.env.PLAYWRIGHT_BROWSERS_PATH = process.env.PLAYWRIGHT_BROWSERS_PATH || '0';
@@ -78,6 +79,7 @@ const jsonOutput = args.includes('--json');
 const quietOutput = args.includes('--quiet') || jsonOutput;
 args = args.filter(arg => arg !== '--json' && arg !== '--quiet');
 const writeOutput = value => process.stdout.write(`${typeof value === 'string' ? value : JSON.stringify(value, null, 2)}\n`);
+const terminalUi = createTerminalUi({ quiet: quietOutput });
 if (quietOutput) {
   console.log = () => {};
   console.warn = () => {};
@@ -879,14 +881,14 @@ if (args.length === 1 && args[0] === 'list') {
   const listedMissions = [];
   const listTags = cliTags ?? normalizeTags(tagConfig?.tags, { allowUntagged: true });
   const listTagMatch = normalizeTagMatch(cliTagMatch ?? tagConfig?.tagMatch);
-  if (!jsonOutput) console.log(`Missions in ${path.relative(process.cwd(), missionsRoot) || '.'}:`);
+  if (!jsonOutput) terminalUi.phase('preflight', `Missions in ${path.relative(process.cwd(), missionsRoot) || '.'}`);
   for (const file of discoveredMissions) {
     try {
       const mission = await loadMissionModule(path.resolve(missionsRoot, file));
       const tags = normalizeTags(mission.tags);
       const selected = matchesTagFilter(tags, listTags, listTagMatch);
       listedMissions.push({ file, tags, selected });
-      if (!jsonOutput) console.log(`  ${selected ? '✓' : '·'} ${file}${tags.length ? `  [${tags.join(', ')}]` : ''}`);
+      if (!jsonOutput) terminalUi.mission(selected, file, tags);
     } catch (error) {
       console.log(`  ${file}  [could not load: ${error.message}]`);
       process.exitCode = 1;
@@ -943,6 +945,17 @@ if (dryRun) {
   return;
 }
 
+if (!jsonOutput) {
+  const previewModel = resolveProviderModel({ cwd: process.cwd() });
+  terminalUi.banner({
+    version: CLI_VERSION,
+    provider: previewModel.provider,
+    model: previewModel.model,
+    session: sessionMode,
+  });
+  terminalUi.phase('preflight', `${explicitFiles ? args.length : discoveredMissions.length} mission file(s) queued`);
+}
+
 const runFile = async (filePath) => {
   const modulePath = resolveMissionPath(filePath, { cwd: process.cwd(), missionsRoot });
   try {
@@ -960,6 +973,7 @@ const runFile = async (filePath) => {
     }
 
     if (typeof missionsModule.executeMission === 'function') {
+      if (!jsonOutput) terminalUi.phase('launch', path.relative(process.cwd(), modulePath) || filePath);
       const result = await missionsModule.executeMission();
       if (result == null) {
         console.error(`❌ Mission did not return a result: ${filePath}`);
@@ -1053,8 +1067,10 @@ report.tags = normalizeTags(flatMissions.flatMap(m =>
 
 fs.mkdirSync(outputDir, { recursive: true });
 fs.writeFileSync(path.join(outputDir, `${runId}.json`), JSON.stringify(report, null, 2));
-generateHtmlReport(report, path.join(outputDir, `${runId}.html`));
+const htmlReportPath = path.join(outputDir, `${runId}.html`);
+generateHtmlReport(report, htmlReportPath);
 if (jsonOutput) writeOutput(report);
+else terminalUi.summary({ ...report.summary, reportPath: path.relative(process.cwd(), htmlReportPath) });
 
   try {
     if (!process.env.TN_KEEP_TMP && fs.existsSync(TMP_DIR)) {

package/bin/terminalUi.js

@@ -0,0 +1,51 @@
+const ANSI = {
+  reset: '\u001b[0m',
+  bold: '\u001b[1m',
+  dim: '\u001b[2m',
+  orange: '\u001b[38;5;208m',
+  cyan: '\u001b[38;5;81m',
+  teal: '\u001b[38;5;43m',
+  red: '\u001b[38;5;203m',
+  cream: '\u001b[38;5;230m',
+};
+
+export function shouldUseColor(stream = process.stdout, env = process.env) {
+  return Boolean(stream?.isTTY) && !('NO_COLOR' in env) && env.TERM !== 'dumb';
+}
+
+export function createTerminalUi({
+  stream = process.stdout,
+  color = shouldUseColor(stream),
+  quiet = false,
+} = {}) {
+  const paint = (codes, value) => color ? `${codes}${value}${ANSI.reset}` : String(value);
+  const write = value => {
+    if (!quiet) stream.write(`${value}\n`);
+  };
+  const label = value => paint(`${ANSI.bold}${ANSI.orange}`, value.padEnd(10));
+
+  return {
+    banner({ version, provider, model, session }) {
+      write(paint(`${ANSI.bold}${ANSI.cream}`, '🧑‍🚀 TESTRONAUT  /  MISSION RUNNER'));
+      write(paint(ANSI.dim, `   v${version}  •  ${provider}/${model}  •  ${session}`));
+      write(paint(ANSI.dim, '   ─────────────────────────────────────────'));
+    },
+    phase(name, message) {
+      write(`${label(name.toUpperCase())}${paint(ANSI.cyan, message)}`);
+    },
+    mission(selected, file, tags = []) {
+      const marker = selected ? paint(ANSI.teal, '●') : paint(ANSI.dim, '○');
+      const tagText = tags.length ? paint(ANSI.dim, `  ${tags.map(tag => `#${tag}`).join(' ')}`) : '';
+      write(`   ${marker} ${file}${tagText}`);
+    },
+    summary({ totalMissions = 0, passed = 0, failed = 0, reportPath }) {
+      const status = failed === 0
+        ? paint(`${ANSI.bold}${ANSI.teal}`, 'MISSION COMPLETE')
+        : paint(`${ANSI.bold}${ANSI.red}`, 'MISSION NEEDS REVIEW');
+      write('');
+      write(`${label('COMPLETE')}${status}`);
+      write(`   ${paint(ANSI.teal, `${passed} passed`)}  ${paint(failed ? ANSI.red : ANSI.dim, `${failed} failed`)}  ${paint(ANSI.dim, `${totalMissions} total`)}`);
+      if (reportPath) write(paint(ANSI.dim, `   Report: ${reportPath}`));
+    },
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testronaut",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "main": "./runner/testronaut.js",
   "bin": {
     "testronaut": "bin/cli.js"
@@ -51,7 +51,7 @@
     "cli"
   ],
   "devDependencies": {
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.5.0",
     "periapsis": "^2.0.1",
     "vitest": "^4.1.11"
   },

package/tests/binTests/cli.helpers.test.js

@@ -271,11 +271,11 @@ describe('cli helpers', () => {
     });
 
     it('returns "testronaut" when argv[1] basename is testronaut (global install)', () => {
-      expect(detectCliName(undefined, '/usr/local/bin/testronaut')).toBe('testronaut');
+      expect(detectCliName(null, '/usr/local/bin/testronaut')).toBe('testronaut');
     });
 
     it('returns "npx testronaut" when argv[1] is cli.js (direct node invocation)', () => {
-      expect(detectCliName(undefined, '/home/user/testronaut-cli/bin/cli.js')).toBe('npx testronaut');
+      expect(detectCliName(null, '/home/user/testronaut-cli/bin/cli.js')).toBe('npx testronaut');
     });
 
     it('npm_command=exec takes precedence over a global-bin argv[1]', () => {
@@ -283,11 +283,11 @@ describe('cli helpers', () => {
     });
 
     it('returns "npx testronaut" when argv[1] is undefined', () => {
-      expect(detectCliName(undefined, undefined)).toBe('npx testronaut');
+      expect(detectCliName(null, null)).toBe('npx testronaut');
     });
 
     it('returns "npx testronaut" when argv[1] is empty string', () => {
-      expect(detectCliName(undefined, '')).toBe('npx testronaut');
+      expect(detectCliName(null, '')).toBe('npx testronaut');
     });
   });
 });

package/tests/binTests/terminalUi.test.js

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest';
+import { createTerminalUi, shouldUseColor } from '../../bin/terminalUi.js';
+
+function capture() {
+  let output = '';
+  return {
+    stream: { isTTY: false, write(value) { output += value; } },
+    read: () => output,
+  };
+}
+
+describe('terminal UI', () => {
+  it('renders a readable color-free mission lifecycle', () => {
+    const target = capture();
+    const ui = createTerminalUi({ stream: target.stream, color: false });
+
+    ui.banner({ version: '1.2.3', provider: 'openai', model: 'gpt-test', session: 'isolated' });
+    ui.phase('launch', 'login.mission.js');
+    ui.mission(true, 'login.mission.js', ['smoke']);
+    ui.summary({ totalMissions: 1, passed: 1, failed: 0, reportPath: 'reports/run.html' });
+
+    expect(target.read()).toContain('🧑‍🚀 TESTRONAUT  /  MISSION RUNNER');
+    expect(target.read()).toContain('LAUNCH    login.mission.js');
+    expect(target.read()).toContain('#smoke');
+    expect(target.read()).toContain('MISSION COMPLETE');
+    expect(target.read()).not.toContain('\u001b[');
+  });
+
+  it('honors terminal capability and NO_COLOR', () => {
+    expect(shouldUseColor({ isTTY: true }, {})).toBe(true);
+    expect(shouldUseColor({ isTTY: true }, { NO_COLOR: '' })).toBe(false);
+    expect(shouldUseColor({ isTTY: false }, {})).toBe(false);
+  });
+});

package/tests/toolsTests/generateHtmlReport.test.js

@@ -55,6 +55,9 @@ describe('generateHtmlReport', () => {
     const html = fs.readFileSync(outPath, 'utf8');
 
     expect(html).toContain('Testronaut Report');
+    expect(html).toContain('Mission Control · Flight Report');
+    expect(html).toContain('--orange:#ff8a43');
+    expect(html).toContain('--cyan:#79d7df');
     expect(html).toContain('Mission A');
     expect(html).toContain('Turn 1 (re-attempt 1/5)');
     expect(html).toContain('⚠️ Turn Issues');

package/tests/toolsTests/turnLoopUtils.test.js

@@ -37,4 +37,21 @@ describe('tools/turnLoopUtils', () => {
       logSpy.mockRestore();
     }
   });
+
+  it('uses the mission transmission frame without changing result data', () => {
+    const logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
+    try {
+      expect(finalResponseHandler({ content: 'SUCCESS: Docking complete' })).toEqual({
+        finalMessage: 'SUCCESS: Docking complete',
+        success: true,
+      });
+      const printed = logSpy.mock.calls.flat().join('\n');
+      expect(printed).toContain('🧑‍🚀 MISSION TRANSMISSION / SUCCESS');
+      expect(printed).toContain('│ SUCCESS: Docking complete');
+      expect(printed).toContain('END TRANSMISSION');
+      expect(printed).not.toContain('FINAL AGENT RESPONSE');
+    } finally {
+      logSpy.mockRestore();
+    }
+  });
 });

package/tools/generateHtmlReport.js

@@ -196,55 +196,71 @@ export function generateHtmlReport(report, outputPath) {
   <title>Testronaut Report – ${esc(runId)}</title>
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <style>
-    /* ===== Brand + surface tokens (match splash/app) ===== */
+    /* ===== Testronaut launch-control tokens ===== */
     :root{
-      --bg-top:#0b1022;
-      --bg-mid:#0f172a;
-      --bg-btm:#0b1022;
-
-      --hairline:rgba(255,255,255,.12);
-      --hairline-strong:rgba(255,255,255,.18);
+      --bg-top:#050b18;
+      --bg-mid:#081426;
+      --bg-btm:#030712;
+      --panel:rgba(8,24,45,.78);
+      --panel-strong:rgba(7,19,36,.94);
+      --orange:#ff8a43;
+      --amber:#ffc15b;
+      --cyan:#79d7df;
+
+      --hairline:rgba(121,215,223,.20);
+      --hairline-strong:rgba(121,215,223,.34);
 
       --text:rgba(255,255,255,.92);
       --text-muted:rgba(255,255,255,.65);
 
-      --ok:#22c55e;     /* green-500 */
-      --bad:#ef4444;    /* red-500 */
+      --ok:#39d9aa;
+      --bad:#ff6678;
 
       --chip-ok-bg:rgba(34,197,94,.14);
       --chip-bad-bg:rgba(239,68,68,.16);
-      --chip-border:rgba(255,255,255,.22);
+      --chip-border:rgba(121,215,223,.30);
       --chip-ok-border:rgba(34,197,94,.40);
       --chip-bad-border:rgba(239,68,68,.45);
     }
 
     /* ===== Base ===== */
-    html,body{height:100%;}
+    html,body{min-height:100%;}
     body{
       margin:0; padding:24px;
       font-family: ui-sans-serif,system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Helvetica,Arial;
-      background: linear-gradient(180deg,var(--bg-top) 0%,var(--bg-mid) 60%,var(--bg-btm) 100%);
+      background:
+        radial-gradient(circle at 84% 8%,rgba(255,138,67,.16),transparent 25rem),
+        radial-gradient(circle at 10% 32%,rgba(121,215,223,.10),transparent 28rem),
+        linear-gradient(180deg,var(--bg-top) 0%,var(--bg-mid) 60%,var(--bg-btm) 100%);
+      background-attachment:fixed;
       color: var(--text);
       -webkit-font-smoothing: antialiased;
       -moz-osx-font-smoothing: grayscale;
     }
+    body::before{
+      content:"";position:fixed;inset:0;pointer-events:none;opacity:.22;
+      background-image:linear-gradient(rgba(121,215,223,.08) 1px,transparent 1px),linear-gradient(90deg,rgba(121,215,223,.08) 1px,transparent 1px);
+      background-size:42px 42px;mask-image:linear-gradient(to bottom,black,transparent 82%);
+    }
 
     /* ===== Utilities ===== */
     .gradient-text{
-      background: linear-gradient(90deg,#60a5fa,#a78bfa,#34d399);
+      background: linear-gradient(90deg,#fff7e7,var(--amber),var(--orange));
       -webkit-background-clip:text; background-clip:text; color:transparent;
     }
     .glass{
-      background: rgba(255,255,255,.05);
+      background: var(--panel);
       border: 1px solid var(--hairline);
       border-radius:16px;
       backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
-      box-shadow: 0 10px 30px rgba(59,130,246,.20);
+      box-shadow: 0 18px 45px rgba(0,0,0,.28), inset 0 1px rgba(255,255,255,.035);
     }
 
     /* ===== Header ===== */
-    .header{ max-width:960px; margin:0 auto 16px; padding:16px 18px; }
-    h1{ margin:0 0 6px; font-size:22px; font-weight:800; color:#fff; }
+    .header{ max-width:960px; margin:0 auto 16px; padding:22px 24px; position:relative; overflow:hidden; }
+    .header::after{content:"";position:absolute;right:0;top:0;width:92px;height:4px;background:linear-gradient(90deg,var(--orange),var(--amber));}
+    .eyebrow{margin-bottom:7px;color:var(--cyan);font-size:11px;font-weight:800;letter-spacing:.18em;text-transform:uppercase;}
+    h1{ margin:0 0 12px; font-size:27px; font-weight:850; color:#fff; letter-spacing:-.02em; }
     .run-meta{ color:var(--text-muted); display:grid; gap:4px; }
     .provider-meta{ display:inline-flex; align-items:center; gap:7px; }
     .provider-logo{ width:20px; height:20px; color:var(--text); flex:none; }
@@ -258,6 +274,7 @@ export function generateHtmlReport(report, outputPath) {
       padding:6px 12px; border-radius:999px; font-size:12px; color:var(--text);
       letter-spacing:.2px;
     }
+    .pill:first-child{border-color:rgba(255,138,67,.5);box-shadow:inset 3px 0 var(--orange);}
     .pill.ok{ background: var(--chip-ok-bg); color: var(--ok); border-color: var(--chip-ok-border); font-weight:700; }
     .pill.bad{ background: var(--chip-bad-bg); color: var(--bad); border-color: var(--chip-bad-border); font-weight:700; }
     .tag-filter{max-width:928px;margin:0 auto 20px;padding:18px 16px;background:rgba(2,6,23,.30);}
@@ -267,7 +284,7 @@ export function generateHtmlReport(report, outputPath) {
     .match-count{margin-left:auto;color:var(--text-muted);font-size:12px;}
     .tag-buttons,.mission-tags{display:flex;gap:6px;flex-wrap:wrap;align-items:center;}
     .tag-button,.tag-small{border:1px solid var(--chip-border);background:rgba(255,255,255,.06);color:var(--text);border-radius:999px;padding:5px 10px;font-size:11px;font-weight:700;}
-    .tag-button{cursor:pointer;transition:transform .15s ease,background .15s ease}.tag-button:hover{transform:translateY(-1px);background:rgba(255,255,255,.11)}.tag-button.active{box-shadow:0 0 0 2px rgba(96,165,250,.38);}
+    .tag-button{cursor:pointer;transition:transform .15s ease,background .15s ease}.tag-button:hover{transform:translateY(-1px);background:rgba(121,215,223,.12)}.tag-button.active{box-shadow:0 0 0 2px rgba(255,138,67,.48);}
     .filter-controls{display:flex;gap:16px;align-items:center;margin-top:14px;font-size:12px;color:var(--text-muted);flex-wrap:wrap;}
     .filter-controls select{color:var(--text);background:#111a31;border:1px solid var(--chip-border);border-radius:8px;padding:6px 24px 6px 8px;}
     .show-control{cursor:help;display:flex;align-items:center;gap:5px;}
@@ -277,12 +294,12 @@ export function generateHtmlReport(report, outputPath) {
     @media(max-width:640px){.match-count{width:100%;margin-left:0}.tag-filter{padding:14px 12px}.meta{display:none}}
 
     /* ===== Disclosure blocks ===== */
-    details{ background: rgba(255,255,255,.05); border:1px solid var(--hairline); border-radius:16px; margin:10px 0; overflow:hidden; }
+    details{ background: var(--panel); border:1px solid var(--hairline); border-radius:16px; margin:10px 0; overflow:hidden; }
     summary{
       cursor:pointer; padding:14px 16px; display:flex; align-items:center; gap:12px;
       color:#fff; background: rgba(255,255,255,.04);
     }
-    .mission-group > summary{ font-weight:800; font-size:15px; letter-spacing:.2px; }
+    .mission-group > summary{ font-weight:800; font-size:15px; letter-spacing:.2px; border-left:3px solid var(--orange); }
     .mission-group > summary:hover{ background: rgba(255,255,255,.08); }
 
     .group-body{ padding:12px; display:grid; gap:10px; }
@@ -336,7 +353,7 @@ export function generateHtmlReport(report, outputPath) {
     .tokens{ color: var(--text-muted); font-size:12px; margin-left:auto; font-variant-numeric: tabular-nums; }
 
     .events{
-      background: rgba(2,6,23,.9); /* near #020617 */
+      background: var(--panel-strong);
       color: rgba(255,255,255,.92);
       padding:12px; border-radius:12px; margin:12px 0 0;
       font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New";
@@ -357,6 +374,7 @@ export function generateHtmlReport(report, outputPath) {
 </head>
 <body>
   <div class="header glass">
+    <div class="eyebrow">Mission Control · Flight Report</div>
     <h1>🧑‍🚀 <span class="gradient-text">Testronaut Report</span></h1>
     <div class="run-meta">
       <div class="provider-meta"><span class="provider-logo" title="${esc(provider.name)}" aria-label="${esc(provider.name)}">${provider.logo}</span><strong>${esc(llm.model ?? '—')}</strong></div>

package/tools/turnLoopUtils.js

@@ -5,17 +5,13 @@ export const finalResponseHandler = (msg) => {
   const safeContent = redactPasswordInText(content);
   const final = content.trim().replace(/^[#*_`\s]+/, '');
   const verdict = final.match(/^(?:(?:result|final)\s*:\s*)?(success|failure)\b/i)?.[1]?.toLowerCase();
-  if (verdict === 'success') {
-    console.log('\n┏━ FINAL AGENT RESPONSE ━━━━━━━━━━━━━━━━━━━');
-    console.log(safeContent);
-    console.log('┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    return { finalMessage: safeContent, success: true};
-  }
-  if (verdict === 'failure') {
-    console.log('\n┏━ FINAL AGENT RESPONSE ━━━━━━━━━━━━━━━━━━━');
-    console.log(safeContent);
-    console.log('┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    return { finalMessage: safeContent, success: false};
+  if (verdict === 'success' || verdict === 'failure') {
+    const success = verdict === 'success';
+    const signal = success ? 'SUCCESS' : 'FAILURE';
+    console.log(`\n╭─ 🧑‍🚀 MISSION TRANSMISSION / ${signal} ─────────────────`);
+    safeContent.split('\n').forEach(line => console.log(`│ ${line}`));
+    console.log('╰─ END TRANSMISSION ─────────────────────────────');
+    return { finalMessage: safeContent, success };
   }
   return null;
 }