npm - input-kanban - Versions diffs - 0.0.1 → 0.0.3 - Mend

input-kanban 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/ENVIRONMENT.md +7 -1
package/PROJECT_GUIDE.md +24 -0
package/README.en.md +148 -0
package/README.md +87 -96
package/bin/input-kanban.js +12 -1
package/package.json +3 -2
package/public/index.html +85 -8
package/src/orchestrator.js +126 -41
package/src/runners/headlessRunner.js +51 -0
package/src/runners/index.js +13 -0
package/src/runners/tmuxRunner.js +170 -0
package/src/runners/tmuxUtils.js +15 -0
package/src/server.js +3 -3
package/src/tmux.js +139 -0
package/src/utils.js +9 -0

package/public/index.html CHANGED Viewed

@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>Codex 编排看板</title>
+  <title>Input 看板</title>
   <style>
     :root { --bg:#0b1220; --panel:#111827; --panel-2:#0f172a; --line:#334155; --line-strong:#64748b; --text:#e2e8f0; --muted:#94a3b8; --blue:#2563eb; --green:#166534; --red:#991b1b; --gray:#475569; --orange:#b45309; }
     body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 0; background: var(--bg); color: var(--text); }
@@ -32,11 +32,14 @@
     th:nth-child(4), td:nth-child(4) { width: 64px; white-space: nowrap; }
     th:nth-child(5), td:nth-child(5) { width: 70px; }
     th:nth-child(6), td:nth-child(6) { width: 58px; }
-    th:nth-child(8), td:nth-child(8) { width: 66px; }
-    th:nth-child(9), td:nth-child(9) { width: 94px; }
+    th:nth-child(8), td:nth-child(8) { width: 118px; }
+    th:nth-child(9), td:nth-child(9) { width: 66px; }
+    th:nth-child(10), td:nth-child(10) { width: 94px; }
     th { color: #cbd5e1; font-size: 12px; text-transform: uppercase; letter-spacing: .06em; }
     tr:hover { background: #162033; cursor: pointer; }
     .pill { display: inline-block; padding: 3px 8px; border-radius: 999px; font-size: 12px; font-weight: 800; background: var(--gray); line-height: 1.3; }
+    .attention-hint { display: block; margin-top: 6px; color: #fbbf24; font-size: 12px; font-weight: 700; white-space: normal; line-height: 1.35; }
+    .attention-hint code { color: #fde68a; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 11px; word-break: break-all; }
     .completed, .judged, .workers_completed, .planned, .batches_completed { background: var(--green); }
     .running, .planning, .judging { background: var(--blue); }
     .failed, .workers_failed, .plan_failed, .judge_failed, .unknown, .batch_blocked { background: var(--red); }
@@ -75,6 +78,12 @@
     .execution-summary + pre { border-top-left-radius: 0; border-top-right-radius: 0; }
     .notice { margin-top: 10px; padding: 10px 12px; border: 1px solid var(--line); border-radius: 10px; background: #1f2937; color: #cbd5e1; }
     .notice.warning { border-color: #92400e; background: rgba(180,83,9,.18); }
+    .tmux-box { margin: 8px 0 10px; padding: 10px 12px; border: 1px solid var(--line); border-radius: 10px; background: #020617; color: #cbd5e1; font-size: 12px; }
+    .tmux-box.hidden { display: none; }
+    .tmux-box-title { font-weight: 800; color: var(--text); margin-bottom: 5px; }
+    .tmux-actions { margin-top: 7px; display: flex; flex-wrap: wrap; gap: 4px; }
+    .tmux-actions button { margin: 0; }
+    .tmux-inline { display: block; margin-top: 3px; word-break: break-all; }
     .file-content-wrap { position: relative; }
     .floating-copy-btn { position: absolute; top: 8px; left: 8px; z-index: 2; opacity: 0; pointer-events: none; transition: opacity .15s; padding: 5px 8px; background: rgba(71,85,105,.92); }
     .file-content-wrap:hover .floating-copy-btn:not(.hidden), .floating-copy-btn:focus { opacity: 1; pointer-events: auto; }
@@ -82,7 +91,7 @@
   </style>
 </head>
 <body>
-<header><h1>Codex 编排看板</h1></header>
+<header><h1>Input 看板</h1></header>
 <main>
   <div class="sidebar">
     <section>
@@ -144,6 +153,7 @@
         <button class="secondary" onclick="loadFile('verdict.json')">验收结论</button>
       </div>
       <div id="executionSummary" class="execution-summary hidden"></div>
+      <div id="tmuxPanel" class="tmux-box hidden"></div>
       <div class="file-content-wrap">
         <button id="copyLastMessageBtn" class="secondary copy-btn floating-copy-btn hidden" title="复制最终回复内容" onclick="copyFileContent(event)">⧉</button>
         <pre id="fileContent"></pre>
@@ -192,6 +202,13 @@ function durationSeconds(start, end) {
   return Math.max(0, Math.round((endMs - new Date(start).getTime()) / 1000));
 }
 function runTimingText(s) { return `开始时刻 ${formatDateTime(s.createdAt)}｜用时 ${durationSeconds(s.createdAt, s.updatedAt)} 秒`; }
+function isTmuxMode() { return currentState?.runner === 'tmux'; }
+function taskById(id) {
+  if (!currentState) return null;
+  if (id === 'planner') return currentState.planner;
+  if (id === 'judge') return currentState.judge;
+  return (currentState.tasks || []).find(t => t.id === id) || null;
+}
 async function loadHealth() {
   const h = await api('/api/health');
@@ -292,7 +309,14 @@ function taskStatusCell(t) {
     const original = t.originalStatus || t.manualCompletion.originalStatus || t.manualCompletion.previousStatus || 'unknown';
     return `${pill(original)} <span class="pill completed">手动标记成功已完成</span>`;
   }
-  return pill(t?.status);
+  const hint = attentionHintCell(t);
+  return `${pill(t?.status)}${hint}`;
+}
+function attentionHintCell(t) {
+  if (!t?.attentionHint) return '';
+  const command = t.attentionHint.attachCommand ? ` <code>${esc(t.attentionHint.attachCommand)}</code>` : '';
+  const reasons = Array.isArray(t.attentionHint.reasons) && t.attentionHint.reasons.length ? `｜${esc(t.attentionHint.reasons.join(' / '))}` : '';
+  return `<span class="attention-hint" title="${esc(t.attentionHint.message || '')}">可能需要人工介入；请 attach tmux 检查。${command}${reasons}</span>`;
 }
 function taskActionCell(id, t) {
   if (!t || id === 'planner' || id === 'judge') return '-';
@@ -304,6 +328,13 @@ function sessionCell(thread) {
   if (!thread) return '-';
   return `<span class="session-cell">${esc(thread)}</span><button class="copy-btn" title="复制 Codex 会话ID" onclick="copySessionId(event, '${esc(thread)}')">⧉</button>`;
 }
+function tmuxCell(t) {
+  if (!isTmuxMode()) return '-';
+  const tmux = t?.tmux;
+  if (!tmux) return '<span class="muted">未启动终端</span>';
+  const label = tmux.windowName || tmux.target || 'tmux';
+  return `<span class="session-cell" title="${esc(tmux.target || '')}">${esc(label)}</span>`;
+}
 function taskStartedCell(t) {
   return t?.startedAt ? formatDateTime(t.startedAt) : '-';
 }
@@ -314,7 +345,7 @@ function taskDurationCell(t) {
 }
 function taskRow(id, role, t) {
   const thread = t?.codexThread?.id || '';
-  return `<tr class="job-row ${selectedTask === id ? 'selected' : ''}" onclick="selectTask('${id}')"><td><b class="task-name" title="${esc(id)}">${esc(id)}</b><span class="muted task-role">${esc(displayRole(role))}</span></td><td>${taskStatusCell(t)}</td><td>${esc(taskStartedCell(t))}</td><td>${esc(taskDurationCell(t))}</td><td>${esc(t?.pid || '-')}</td><td>${esc(t?.exitCode ?? '-')}</td><td>${sessionCell(thread)}</td><td>${esc(t?.files?.lastMessage?.exists ? '有' : '-')}</td><td>${taskActionCell(id, t)}</td></tr>`;
+  return `<tr class="job-row ${selectedTask === id ? 'selected' : ''}" onclick="selectTask('${id}')"><td><b class="task-name" title="${esc(id)}">${esc(id)}</b><span class="muted task-role">${esc(displayRole(role))}</span></td><td>${taskStatusCell(t)}</td><td>${esc(taskStartedCell(t))}</td><td>${esc(taskDurationCell(t))}</td><td>${esc(t?.pid || '-')}</td><td>${esc(t?.exitCode ?? '-')}</td><td>${sessionCell(thread)}</td><td>${tmuxCell(t)}</td><td>${esc(t?.files?.lastMessage?.exists ? '有' : '-')}</td><td>${taskActionCell(id, t)}</td></tr>`;
 }
 function renderTasks() {
   const s = currentState;
@@ -322,12 +353,12 @@ function renderTasks() {
   if (Array.isArray(s.batches) && s.batches.length) {
     for (const b of s.batches) {
       const done = (b.tasks || []).filter(t => t.status === 'completed').length;
-      rows.push(`<tr class="batch-row"><td colspan="9">${esc(b.name || b.id)} ${pill(b.status)} <span class="muted">${esc(b.id)}｜最大并发 ${esc(b.maxParallel || '-')}｜${done}/${(b.tasks || []).length}</span></td></tr>`);
+      rows.push(`<tr class="batch-row"><td colspan="10">${esc(b.name || b.id)} ${pill(b.status)} <span class="muted">${esc(b.id)}｜最大并发 ${esc(b.maxParallel || '-')}｜${done}/${(b.tasks || []).length}</span></td></tr>`);
       for (const t of b.tasks || []) rows.push(taskRow(t.id, t.name, t));
     }
   } else rows.push(...(s.tasks||[]).map(t => taskRow(t.id, t.name, t)));
   rows.push(taskRow('judge','最终验收',s.judge));
-  document.getElementById('tasks').innerHTML = `<table><tr><th>任务</th><th>状态</th><th>发起时间</th><th>用时</th><th>进程号</th><th>退出码</th><th>Codex 会话ID</th><th>最终回复</th><th>操作</th></tr>${rows.join('')}</table>`;
+  document.getElementById('tasks').innerHTML = `<table><tr><th>任务</th><th>状态</th><th>发起时间</th><th>用时</th><th>进程号</th><th>退出码</th><th>Codex 会话ID</th><th>终端</th><th>最终回复</th><th>操作</th></tr>${rows.join('')}</table>`;
 }
 async function selectTask(id) {
   selectedTask = id;
@@ -347,12 +378,14 @@ async function loadFile(name, { preserveScroll = false } = {}) {
   else pre.scrollTop = 0;
   if (name === 'events.pretty') await renderExecutionSummary();
   else hideExecutionSummary();
+  renderTmuxPanel();
   updateCopyLastMessageButton();
 }
 function clearFileView() {
   document.getElementById('fileTitle').textContent = '点击任务后选择文件';
   document.getElementById('fileContent').textContent = '';
   hideExecutionSummary();
+  hideTmuxPanel();
   updateCopyLastMessageButton();
 }
 function updateCopyLastMessageButton() {
@@ -378,6 +411,50 @@ function hideExecutionSummary() {
   el.classList.add('hidden');
   el.innerHTML = '';
 }
+function hideTmuxPanel() {
+  const el = document.getElementById('tmuxPanel');
+  el.classList.add('hidden');
+  el.innerHTML = '';
+}
+function renderTmuxPanel() {
+  const el = document.getElementById('tmuxPanel');
+  if (!el) return;
+  if (!selectedTask || !currentState) { hideTmuxPanel(); return; }
+  if (!isTmuxMode()) {
+    el.classList.remove('hidden');
+    el.innerHTML = '<div class="tmux-box-title">终端模式</div><span class="muted">当前 runner 为 headless，无需终端附加操作。</span>';
+    return;
+  }
+  const tmux = taskById(selectedTask)?.tmux;
+  if (!tmux) {
+    el.classList.remove('hidden');
+    el.innerHTML = '<div class="tmux-box-title">tmux 终端</div><span class="muted">该任务尚未生成 tmux window。</span>';
+    return;
+  }
+  el.classList.remove('hidden');
+  el.innerHTML = `
+    <div class="tmux-box-title">tmux 终端</div>
+    <span class="tmux-inline">session：${esc(tmux.sessionName || '-')}</span>
+    <span class="tmux-inline">window：${esc(tmux.windowName || '-')}</span>
+    <span class="tmux-inline">target：${esc(tmux.target || '-')}</span>
+    <div class="tmux-actions">
+      ${tmux.attachCommand ? `<button class="secondary" onclick="copyTmuxCommand(event, 'attach')">复制 attach</button>` : ''}
+      ${tmux.selectWindowCommand ? `<button class="secondary" onclick="copyTmuxCommand(event, 'select')">复制 select-window</button>` : ''}
+    </div>`;
+}
+async function copyTmuxCommand(event, kind) {
+  event.stopPropagation();
+  const tmux = taskById(selectedTask)?.tmux;
+  const command = kind === 'attach' ? tmux?.attachCommand : tmux?.selectWindowCommand;
+  if (!command) return;
+  try {
+    await navigator.clipboard.writeText(command);
+    event.currentTarget.textContent = '已复制';
+    setTimeout(() => { event.currentTarget.textContent = kind === 'attach' ? '复制 attach' : '复制 select-window'; }, 900);
+  } catch {
+    prompt(kind === 'attach' ? '复制 attachCommand' : '复制 selectWindowCommand', command);
+  }
+}
 async function renderExecutionSummary() {
   const el = document.getElementById('executionSummary');
   let raw = '';

package/src/orchestrator.js CHANGED Viewed

@@ -1,15 +1,27 @@
-import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import fsp from 'node:fs/promises';
 import path from 'node:path';
 import {
-  CODEX_BIN, DEFAULT_REPO, RUNS_DIR, ensureDir, nowIso, makeRunId, readJson,
+  DEFAULT_REPO, RUNS_DIR, ensureDir, nowIso, makeRunId, readJson,
   writeJsonAtomic, fileInfo, readTextMaybe, extractFirstJsonObject, listRunDirs,
-  pathForRun, roleDir, safeIdPart
+  pathForRun, roleDir, safeIdPart, RUNNER
 } from './utils.js';
 import { matchThreadToMarkers } from './appServerClient.js';
-const runningChildren = new Map(); // key: `${runId}:${taskId}` -> child
+import { defaultRunner } from './runners/index.js';
+const runner = defaultRunner;
+const ATTENTION_IDLE_MS = 5 * 60 * 1000;
+const ATTENTION_MIN_RUNTIME_MS = 10 * 60 * 1000;
+const ATTENTION_KEYWORDS = [
+  'permission',
+  'approval',
+  'approve',
+  'confirm',
+  'continue',
+  'password',
+  'authentication',
+  'authenticate'
+];
 function statePath(runDir) { return path.join(runDir, 'run_state.json'); }
 function planPath(runDir) { return path.join(runDir, 'plan.json'); }
@@ -21,6 +33,7 @@ export async function createRun({ label = 'task', taskText = '', repo = DEFAULT_
   await fsp.writeFile(path.join(runDir, 'task.md'), taskText || '');
   const state = {
     runId, label, repo: path.resolve(repo), maxParallel: Number(maxParallel) || 3,
+    runner: RUNNER,
     status: 'created', createdAt: nowIso(), updatedAt: nowIso(),
     planner: { status: 'pending' }, batches: [], tasks: [], judge: { status: 'pending' }
   };
@@ -132,24 +145,6 @@ Plan: ${path.join(pathForRun(state.runId), 'plan.json')}
 `;
 }
-function spawnCodex({ state, taskId, prompt, sandbox, cwd, outDir }) {
-  const events = path.join(outDir, 'events.jsonl');
-  const stderr = path.join(outDir, 'stderr.log');
-  const last = path.join(outDir, 'last_message.md');
-  fs.writeFileSync(path.join(outDir, 'prompt.md'), prompt);
-  const args = ['exec', '--json', '--sandbox', sandbox, '-C', cwd, '-o', last, prompt];
-  const child = spawn(CODEX_BIN, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
-  child.stdout.pipe(fs.createWriteStream(events, { flags: 'a' }));
-  child.stderr.pipe(fs.createWriteStream(stderr, { flags: 'a' }));
-  const key = `${state.runId}:${taskId}`;
-  runningChildren.set(key, child);
-  child.on('exit', code => {
-    try { fs.writeFileSync(path.join(outDir, 'exit_code'), String(code)); } catch {}
-    runningChildren.delete(key);
-  });
-  return child;
-}
 export async function startPlanner(runId) {
   const state = await loadRun(runId);
   if (!state) throw new Error(`run not found: ${runId}`);
@@ -168,11 +163,11 @@ export async function startPlanner(runId) {
   await fsp.rm(planPath(runDir), { force: true });
   const taskText = await fsp.readFile(path.join(runDir, 'task.md'), 'utf8');
   const prompt = defaultPlannerPrompt(state, taskText);
-  const child = spawnCodex({ state, taskId: 'planner', prompt, sandbox: 'read-only', cwd: state.repo, outDir });
+  const child = await runner.startCodexTask({ runId: state.runId, taskId: 'planner', prompt, sandbox: 'read-only', cwd: state.repo, outDir });
   state.status = 'planning';
   state.planner = { status: 'running', pid: child.pid, startedAt: nowIso(), dir: outDir, attempt: (state.plannerAttempts?.length || 0) + 1 };
   await saveRun(state);
-  child.on('exit', async code => {
+  child.onExit(async code => {
     const s = await loadRun(runId); if (!s || s.status === 'stopped') return;
     s.planner.exitCode = code; s.planner.endedAt = nowIso(); s.planner.status = code === 0 ? 'completed' : 'failed';
     const planResult = await materializePlan(s);
@@ -304,7 +299,7 @@ ORCHESTRATOR_BATCH_ID: ${task.batchId || 'batch-1'}
 ${task.prompt}
 `;
-  const child = spawnCodex({ state, taskId: task.id, prompt: fullPrompt, sandbox: task.sandbox || 'workspace-write', cwd: state.repo, outDir });
+  const child = await runner.startCodexTask({ runId: state.runId, taskId: task.id, prompt: fullPrompt, sandbox: task.sandbox || 'workspace-write', cwd: state.repo, outDir });
   Object.assign(task, { status: 'running', pid: child.pid, startedAt: nowIso(), dir: outDir });
 }
@@ -312,12 +307,7 @@ export async function stopRun(runId, { reason = 'stopped by user' } = {}) {
   const state = await loadRun(runId);
   if (!state) throw new Error(`run not found: ${runId}`);
   const stoppedAt = nowIso();
-  for (const [key, child] of runningChildren.entries()) {
-    if (key.startsWith(`${runId}:`)) {
-      try { child.kill('TERM'); } catch {}
-      runningChildren.delete(key);
-    }
-  }
+  await runner.stopRun(runId);
   for (const roleState of [state.planner, state.judge]) {
     if (roleState?.status === 'running') Object.assign(roleState, { status: 'stopped', stoppedAt, endedAt: stoppedAt });
   }
@@ -400,11 +390,11 @@ export async function startJudge(runId) {
   const judgeInput = await buildJudgeInput(state);
   await writeJsonAtomic(judgeInputPath, judgeInput);
   const prompt = defaultJudgePrompt(state, judgeInputPath);
-  const child = spawnCodex({ state, taskId: 'judge', prompt, sandbox: 'read-only', cwd: state.repo, outDir });
+  const child = await runner.startCodexTask({ runId: state.runId, taskId: 'judge', prompt, sandbox: 'read-only', cwd: state.repo, outDir });
   state.judge = { status: 'running', pid: child.pid, startedAt: nowIso(), dir: outDir };
   state.status = 'judging';
   await saveRun(state);
-  child.on('exit', async code => {
+  child.onExit(async code => {
     const s = await loadRun(runId); if (!s || s.status === 'stopped') return;
     s.judge.exitCode = code; s.judge.endedAt = nowIso(); s.judge.status = code === 0 ? 'completed' : 'failed';
     const text = await readTextMaybe(path.join(outDir, 'last_message.md'), 1000000);
@@ -423,9 +413,12 @@ export async function refreshRun(runId, appClient = null) {
 async function loadAndRefreshRun(runId, appClient = null, { light = false } = {}) {
   const state = await loadRun(runId);
   if (!state) return null;
+  state.runner = state.runner || RUNNER;
   await refreshRole(state, state.planner, roleDir(pathForRun(runId), 'planner'));
+  await recoverCompletedPlanner(state);
   for (const task of state.tasks || []) await refreshTask(state, task);
   await refreshRole(state, state.judge, roleDir(pathForRun(runId), 'judge'));
+  await recoverCompletedJudge(state);
   recomputeRunStatus(state);
   await scheduleMoreWorkers(state);
   recomputeRunStatus(state);
@@ -434,19 +427,43 @@ async function loadAndRefreshRun(runId, appClient = null, { light = false } = {}
   return state;
 }
+async function recoverCompletedPlanner(state) {
+  if (state.planner?.status !== 'completed' || state.tasks?.length || state.batches?.length) return;
+  const planResult = await materializePlan(state);
+  if (planResult.ok) state.status = 'planned';
+  else if (planResult.empty) state.status = 'plan_empty';
+  else state.status = 'plan_failed';
+}
+async function recoverCompletedJudge(state) {
+  if (!['completed', 'failed'].includes(state.judge?.status)) return;
+  if (state.judge.status === 'completed' && !state.judge.verdict) {
+    const outDir = roleDir(pathForRun(state.runId), 'judge');
+    const text = await readTextMaybe(path.join(outDir, 'last_message.md'), 1000000);
+    const verdict = extractFirstJsonObject(text);
+    if (verdict) {
+      state.judge.verdict = verdict;
+      await writeJsonAtomic(path.join(outDir, 'verdict.json'), verdict);
+    }
+  }
+  state.status = state.judge.status === 'completed' ? 'judged' : 'judge_failed';
+}
 async function refreshRole(state, roleState, dir) {
   if (!roleState) return;
   const exitPath = path.join(dir, 'exit_code');
   const exit = await readTextMaybe(exitPath, 1000);
   const exitInfo = await fileInfo(exitPath);
-  const key = `${state.runId}:${roleState === state.judge ? 'judge' : 'planner'}`;
+  const key = roleState === state.judge ? 'judge' : 'planner';
   if (exit !== '') {
     roleState.exitCode = Number(exit.trim());
     if (!roleState.endedAt && exitInfo.exists) roleState.endedAt = exitInfo.mtime;
     if (roleState.status === 'running') roleState.status = roleState.exitCode === 0 ? 'completed' : 'failed';
   }
-  else if (roleState.status === 'running' && !runningChildren.has(key)) roleState.status = 'unknown';
+  else if (roleState.status === 'running' && !runner.hasRunning(state.runId, key)) roleState.status = 'unknown';
   roleState.files = await standardFiles(dir);
+  await attachTmuxMetadata(roleState, dir);
+  roleState.attentionHint = await buildAttentionHint({ state, target: roleState, dir });
 }
 async function refreshTask(state, task) {
@@ -454,13 +471,14 @@ async function refreshTask(state, task) {
   const exitPath = path.join(dir, 'exit_code');
   const exit = await readTextMaybe(exitPath, 1000);
   const exitInfo = await fileInfo(exitPath);
-  const key = `${state.runId}:${task.id}`;
   if (exit !== '') {
     task.exitCode = Number(exit.trim());
     if (!task.endedAt && exitInfo.exists) task.endedAt = exitInfo.mtime;
     if (task.status === 'running') task.status = task.exitCode === 0 ? 'completed' : 'failed';
-  } else if (task.status === 'running' && !runningChildren.has(key)) task.status = 'unknown';
+  } else if (task.status === 'running' && !runner.hasRunning(state.runId, task.id)) task.status = 'unknown';
   task.files = await standardFiles(dir);
+  await attachTmuxMetadata(task, dir);
+  task.attentionHint = await buildAttentionHint({ state, target: task, dir });
   task.artifacts = [];
   for (const rel of task.expectedArtifacts || []) task.artifacts.push({ path: rel, ...(await fileInfo(path.isAbsolute(rel) ? rel : path.join(state.repo, rel))) });
   const batch = (state.batches || []).find(b => b.id === task.batchId);
@@ -470,13 +488,77 @@ async function refreshTask(state, task) {
   }
 }
+async function attachTmuxMetadata(target, dir) {
+  const raw = await readJson(path.join(dir, 'tmux.json'), null);
+  if (!raw || raw.runner !== 'tmux') {
+    delete target.tmux;
+    return;
+  }
+  const selectWindowCommand = raw.selectWindowCommand || raw.selectCommand || '';
+  target.tmux = {
+    runner: 'tmux',
+    sessionName: raw.sessionName || '',
+    windowName: raw.windowName || '',
+    target: raw.target || '',
+    attachCommand: raw.attachCommand || '',
+    selectWindowCommand,
+    runScript: raw.runScript || '',
+    startedAt: raw.startedAt || ''
+  };
+}
+async function buildAttentionHint({ state, target, dir }) {
+  if (!['running', 'unknown'].includes(target?.status) || state?.status === 'stopped') return null;
+  if ((state?.runner || RUNNER) !== 'tmux' && !target.tmux) return null;
+  const reasons = [];
+  const textTail = [
+    await readTextMaybe(path.join(dir, 'stderr.log'), 20000),
+    await readTextMaybe(path.join(dir, 'events.jsonl'), 20000)
+  ].join('\n');
+  const keyword = findAttentionKeyword(textTail);
+  if (keyword) reasons.push(`log tail contains "${keyword}"`);
+  const idle = taskIdleSnapshot(target);
+  if (idle.isLongIdle || (target.status === 'unknown' && idle.isIdle)) reasons.push(`no recent log updates for ${Math.round(idle.idleMs / 1000)}s`);
+  if (!reasons.length) return null;
+  return {
+    message: 'This task may need manual intervention; attach to tmux to inspect.',
+    reasons,
+    attachCommand: target.tmux?.attachCommand || '',
+    detectedAt: nowIso()
+  };
+}
+function findAttentionKeyword(text) {
+  const lower = String(text || '').toLowerCase();
+  return ATTENTION_KEYWORDS.find(keyword => lower.includes(keyword)) || null;
+}
+function taskIdleSnapshot(target) {
+  const now = Date.now();
+  const startedMs = Date.parse(target?.startedAt || '');
+  const runtimeMs = Number.isFinite(startedMs) ? now - startedMs : 0;
+  const recentMs = [target?.files?.events, target?.files?.stderr, target?.files?.lastMessage]
+    .filter(info => info?.exists && Number.isFinite(info.mtimeMs))
+    .map(info => info.mtimeMs)
+    .sort((a, b) => b - a)[0];
+  const idleMs = Number.isFinite(recentMs) ? now - recentMs : runtimeMs;
+  return {
+    idleMs,
+    runtimeMs,
+    isIdle: idleMs >= ATTENTION_IDLE_MS,
+    isLongIdle: runtimeMs >= ATTENTION_MIN_RUNTIME_MS && idleMs >= ATTENTION_IDLE_MS
+  };
+}
 async function standardFiles(dir) {
   return {
     prompt: await fileInfo(path.join(dir, 'prompt.md')),
     events: await fileInfo(path.join(dir, 'events.jsonl')),
     stderr: await fileInfo(path.join(dir, 'stderr.log')),
     lastMessage: await fileInfo(path.join(dir, 'last_message.md')),
-    exitCode: await fileInfo(path.join(dir, 'exit_code'))
+    exitCode: await fileInfo(path.join(dir, 'exit_code')),
+    runScript: await fileInfo(path.join(dir, 'run.sh')),
+    tmux: await fileInfo(path.join(dir, 'tmux.json'))
   };
 }
@@ -567,6 +649,7 @@ async function buildJudgeInput(state) {
       resultJson: await readJson(path.join(dir, 'result.json'), null),
       evidenceJson: await readJson(path.join(dir, 'evidence.json'), null),
       manualCompletion: task.manualCompletion || await readJson(path.join(dir, 'manual_completion.json'), null),
+      tmux: task.tmux || null,
       stderrTail: await readTextMaybe(path.join(dir, 'stderr.log'), 20000)
     });
   }
@@ -579,6 +662,7 @@ async function buildJudgeInput(state) {
       label: state.label,
       repo: state.repo,
       status: state.status,
+      runner: state.runner || RUNNER,
       createdAt: state.createdAt,
       updatedAt: state.updatedAt,
       maxParallel: state.maxParallel
@@ -597,6 +681,7 @@ async function buildJudgeInput(state) {
       exitCode: state.planner?.exitCode ?? null,
       planParseError: state.planner?.planParseError,
       planEmpty: !!state.planner?.planEmpty,
+      tmux: state.planner?.tmux || null,
       lastMessage: await readTextMaybe(path.join(roleDir(runDir, 'planner'), 'last_message.md'), 200000)
     },
     tasks
@@ -629,7 +714,7 @@ async function enrichFromAppServer(state, appClient) {
 function summaryOfRun(s) {
   const tasks = s.tasks || [];
-  return { runId: s.runId, label: s.label, repo: s.repo, status: s.status, archived: !!s.archived, createdAt: s.createdAt, updatedAt: s.updatedAt, total: tasks.length, completed: tasks.filter(t => t.status === 'completed').length, failed: tasks.filter(t => ['failed','unknown'].includes(t.status)).length, running: tasks.filter(t => t.status === 'running').length, batches: (s.batches || []).map(b => ({ id: b.id, name: b.name, status: b.status, total: b.tasks?.length || 0, completed: (b.tasks || []).filter(t => t.status === 'completed').length })) };
+  return { runId: s.runId, label: s.label, repo: s.repo, status: s.status, runner: s.runner || RUNNER, archived: !!s.archived, createdAt: s.createdAt, updatedAt: s.updatedAt, total: tasks.length, completed: tasks.filter(t => t.status === 'completed').length, failed: tasks.filter(t => ['failed','unknown'].includes(t.status)).length, running: tasks.filter(t => t.status === 'running').length, batches: (s.batches || []).map(b => ({ id: b.id, name: b.name, status: b.status, total: b.tasks?.length || 0, completed: (b.tasks || []).filter(t => t.status === 'completed').length })) };
 }
 function formatCodexEventsJsonl(text) {
@@ -718,7 +803,7 @@ export async function readRunTaskText(runId) {
 export async function readRunFile(runId, taskId, name) {
   const runDir = pathForRun(runId);
-  const allowed = new Set(['prompt.md','events.jsonl','events.pretty','stderr.log','last_message.md','exit_code','result.json','evidence.json','verdict.json','judge_input.json','manual_completion.json']);
+  const allowed = new Set(['prompt.md','events.jsonl','events.pretty','stderr.log','last_message.md','exit_code','result.json','evidence.json','verdict.json','judge_input.json','manual_completion.json','run.sh','tmux.json']);
   if (!allowed.has(name)) throw new Error('file not allowed');
   let dir;
   if (taskId === 'planner') dir = roleDir(runDir, 'planner');

package/src/runners/headlessRunner.js ADDED Viewed

@@ -0,0 +1,51 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { CODEX_BIN } from '../utils.js';
+function processKey(runId, taskId) {
+  return `${runId}:${taskId}`;
+}
+export function createHeadlessRunner({ codexBin = CODEX_BIN } = {}) {
+  const runningProcesses = new Map();
+  function startCodexTask({ runId, taskId, prompt, sandbox, cwd, outDir }) {
+    const events = path.join(outDir, 'events.jsonl');
+    const stderr = path.join(outDir, 'stderr.log');
+    const last = path.join(outDir, 'last_message.md');
+    fs.writeFileSync(path.join(outDir, 'prompt.md'), prompt);
+    const args = ['exec', '--json', '--sandbox', sandbox, '-C', cwd, '-o', last, prompt];
+    const child = spawn(codexBin, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+    child.stdout.pipe(fs.createWriteStream(events, { flags: 'a' }));
+    child.stderr.pipe(fs.createWriteStream(stderr, { flags: 'a' }));
+    const key = processKey(runId, taskId);
+    runningProcesses.set(key, child);
+    child.on('exit', code => {
+      try { fs.writeFileSync(path.join(outDir, 'exit_code'), String(code)); } catch {}
+      runningProcesses.delete(key);
+    });
+    return {
+      pid: child.pid,
+      onExit(listener) { child.on('exit', listener); },
+      stop(signal = 'TERM') { child.kill(signal); }
+    };
+  }
+  function stopRun(runId, signal = 'TERM') {
+    for (const [key, child] of runningProcesses.entries()) {
+      if (key.startsWith(`${runId}:`)) {
+        try { child.kill(signal); } catch {}
+        runningProcesses.delete(key);
+      }
+    }
+  }
+  function hasRunning(runId, taskId) {
+    return runningProcesses.has(processKey(runId, taskId));
+  }
+  return { kind: 'headless', startCodexTask, stopRun, hasRunning };
+}
+export const headlessRunner = createHeadlessRunner();

package/src/runners/index.js ADDED Viewed

@@ -0,0 +1,13 @@
+import { headlessRunner } from './headlessRunner.js';
+import { createTmuxRunner } from './tmuxRunner.js';
+import { RUNNER } from '../utils.js';
+export { createHeadlessRunner, headlessRunner } from './headlessRunner.js';
+export { createTmuxRunner } from './tmuxRunner.js';
+export function createDefaultRunner(runnerMode = RUNNER) {
+  if (runnerMode === 'tmux') return createTmuxRunner();
+  return headlessRunner;
+}
+export const defaultRunner = createDefaultRunner();