elanous 0.2.18 → 0.2.19

package/src/cli/release-cli.ts

@@ -47,6 +47,7 @@ import { runReleaseIfReady } from './release-run-if-ready.js';
 import { formatPreflight, releasePreflight } from '../../scripts/release-loop/preflight.js';
 import { autoStartScheduledRelease, type AutoStartDeferral } from '../release-loop/auto-start.js';
 import { landingFreezeMessage, LandingFrozenError, readLandingFreeze } from '../release-loop/landing-freeze.js';
+import { formatLightRc, runLightRc, type LightRcDeps } from '../release-loop/light-rc.js';
 
 export const DEFAULT_PUBLIC_REPO = 'ElanvitalAI/elanous';
 const SEMVER = /^\d+\.\d+\.\d+(?:-(?:rc|alpha|beta)\.\d+)?$/;
@@ -594,7 +595,7 @@ function compareReleaseVersions(a: string, b: string): number {
   return 0;
 }
 
-export function registerReleaseCommands(program: Command, releaseRunDeps: UnattendedReleaseDeps = {}, landedDeps: LandedButYellowDeps = {}, hqDeps: HqDeps = {}): void {
+export function registerReleaseCommands(program: Command, releaseRunDeps: UnattendedReleaseDeps = {}, landedDeps: LandedButYellowDeps = {}, hqDeps: HqDeps = {}, lightRcDeps: LightRcDeps = {}): void {
   const release = program.command('release').description('공개 배포 한 판 — prepare(로컬) → publish(--yes) → verify (docs/manual/MANUAL-versioning-and-release-2026-09-25.md)');
   const schedule = release.command('schedule').description('판별 컷·착지 마감 조회·갱신');
   const scheduleLedgerRoot = () => releaseRunDeps.ledgerRoot ?? releaseLedgerRoot();
@@ -793,17 +794,17 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
   withContext(checklist.command('set <id>').description('칸 상태·근거·담당·처분 갱신'))
     .option('--status <status>', 'green|yellow|red|done').option('--evidence <evidence>', '근거').option('--owner <owner>', '담당')
     .option('--disposition <disposition>', 'move|known-issue|block').option('--kind <kind>', 'screen = 다섯 화면 짝 칸 · 근거에 짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 … 한 줄')
-    .option('--priority <priority>', 'P0|P1|P2').option('--deadline-version <v>', '마감 판').option('--predecessor <id...>', '선행 칸 id')
+    .option('--priority <priority>', 'P0|P1|P2').option('--deadline-version <v>', '마감 판').option('--predecessor <id...>', '선행 칸 id').option('--no-predecessor', '선행 칸 비우기(진짜 의존이 아니면 · CHECKLIST-PRED-CLEAR)')
     .option('--ceo-minutes <minutes>', '대표 손 분량(분)').option('--ceo-date <date>', '대표 손 날짜 YYYY-MM-DD')
     .option('--accelerator', '가속 등급 부여').option('--no-accelerator', '가속 등급 해제(기본은 없음)')
     .option('--ref <path...>', '근거 문서 더하기 — 저장소 상대 경로[#절] (반복 가능 · 중복 제거)')
-    .action((id: string, opts: { ref?: string[]; status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[]; ceoMinutes?: string; ceoDate?: string; accelerator?: boolean }, cmd: Command) => {
+    .action((id: string, opts: { ref?: string[]; status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[] | false; ceoMinutes?: string; ceoDate?: string; accelerator?: boolean }, cmd: Command) => {
       const { version, json } = context(cmd);
       if (opts.status !== undefined && !['green', 'yellow', 'red', 'done'].includes(opts.status)) throw new CliUserError(`잘못된 상태: ${opts.status}`, 'green|yellow|red|done');
       if (opts.disposition !== undefined && !['move', 'known-issue', 'block'].includes(opts.disposition)) throw new CliUserError(`잘못된 처분: ${opts.disposition}`, 'move|known-issue|block');
       if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined && opts.kind === undefined && opts.priority === undefined && opts.deadlineVersion === undefined && opts.predecessor === undefined && opts.ceoMinutes === undefined && opts.ceoDate === undefined && opts.accelerator === undefined && opts.ref === undefined) throw new CliUserError('갱신할 칸을 지정하라', '--ref · --status · --evidence · --owner · --disposition · --kind · --priority · --deadline-version · --predecessor · --ceo-minutes · --ceo-date · --accelerator · --no-accelerator 중 하나');
       if (!mayWrite(cmd)) return;
-      const data = setItem(version, id, { ...(opts.ref !== undefined ? { refs: opts.ref } : {}), ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor } : {}), ...(opts.ceoMinutes !== undefined ? { ceoMinutes: ceoMinutes(opts.ceoMinutes) } : {}), ...(opts.ceoDate !== undefined ? { ceoDate: opts.ceoDate } : {}), ...(opts.accelerator !== undefined ? { accelerator: opts.accelerator ? true : null } : {}) }, process.env.ELANOUS_TRACK || 'cli');
+      const data = setItem(version, id, { ...(opts.ref !== undefined ? { refs: opts.ref } : {}), ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor === false ? [] : opts.predecessor } : {}), ...(opts.ceoMinutes !== undefined ? { ceoMinutes: ceoMinutes(opts.ceoMinutes) } : {}), ...(opts.ceoDate !== undefined ? { ceoDate: opts.ceoDate } : {}), ...(opts.accelerator !== undefined ? { accelerator: opts.accelerator ? true : null } : {}) }, process.env.ELANOUS_TRACK || 'cli');
       const item = data.items.find((entry) => entry.id === id);
       const why = item?.kind === 'screen' && item.status === 'green' ? parityGap(item.evidence) : null;
       if (why) {
@@ -1054,16 +1055,40 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
         process.exitCode = 1;
       }
     });
+  // LIGHT-RC (0.2.19) — read-only for the ledger · never touches the landing freeze or launches Pods.
+  release.command('light-rc')
+    .description('가벼운 RC 점검 — 직전 판 컷(또는 --base) 이후 변경 범위 self gate ⊕ 상시 목록(release/light-rc-always.txt)을 원격 게이트 호스트에서 · 새 회귀(introduced>0)면 exit 1')
+    .requiredOption('--version <v>', '점검할 판(x.y.z)')
+    .option('--base <ref>', '비교 기준(기본: git merge-base origin/main origin/release/<원장 직전 판>)')
+    .option('--remote <host>', '게이트 호스트(기본 config gateRemote.host)')
+    .option('--local', '원격 대신 이 기계에서 돌린다(원격 자식이 이것으로 다시 불린다)')
+    .option('--shards <n>', '시험 분할 수', '4')
+    .option('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
+    .action(async (o: { version: string; base?: string; remote?: string; local?: boolean; shards: string; json?: boolean }) => {
+      // The root strips `--local` from argv (remote-bookmark attach) before Commander sees it — same read as `self gate`.
+      const local = !!o.local || process.argv.slice(2).includes('--local');
+      await jsonAction(o.json, async (log) => {
+        if (o.remote !== undefined && local) throw new Error('release light-rc: --remote and --local cannot be combined');
+        const shards = Number(o.shards);
+        const result = await runLightRc(o.version, { base: o.base, remote: o.remote, local, shards, ledgerRoot: releaseRunDeps.ledgerRoot, log: (l) => console.error(l) }, lightRcDeps);
+        for (const line of formatLightRc(result)) log(line);
+        return result;
+      }, (r) => r.ok);
+    });
   release.command('resume')
     .description('실패한 릴리스 런을 이어 달린다 — cut-branch --append 로 고친 release/<v> 새 끝을 version-release 기록에 반영(빨리감기만·상태 백업) 뒤 --from 노드부터')
     .requiredOption('--run <runId>', '실패한 release-loop 런 ID')
     .requiredOption('--from <node>', '다시 시작할 노드(예: gate)')
+    .option('--partial', 'GATE-PARTIAL — --from gate 에서 앞 게이트 뒤 바뀐 시험 파일 ⊕ 앞 실패 파일만 다시 돈다(시험·문서만 바뀐 경우 · 아니면 전체 게이트로)')
     .option('--json', '결과 한 줄 JSON(stdout)')
-    .action(async (o: { run: string; from: string; json?: boolean }) => {
+    .action(async (o: { run: string; from: string; partial?: boolean; json?: boolean }) => {
       await jsonAction(o.json, async (log) => {
-        const result = await resumeReleaseRun({ runId: o.run, from: o.from });
+        const result = await resumeReleaseRun({ runId: o.run, from: o.from, partial: o.partial });
+        if (result.partial.requested) log(result.partial.applied
+          ? `◐ 부분 재검: ${result.partial.files}파일 · 나머지는 앞 게이트(${result.partial.priorCommit.slice(0, 12)}) 결과를 잇는다`
+          : `● 전체 게이트로: ${result.partial.reason}`);
         log(`${result.tip.changed ? `↻ ${result.tip.branch} ${result.tip.from.slice(0, 12)} → ${result.tip.to.slice(0, 12)} (백업 ${result.tip.backup})` : `· ${result.tip.branch} 끝 그대로 ${result.tip.to.slice(0, 12)}`} · ${o.from} 부터 → ${result.state.status}`);
-        return { tip: result.tip, status: result.state.status, runId: result.state.runId };
+        return { tip: result.tip, partial: result.partial, status: result.state.status, runId: result.state.runId };
       }, (r) => r.status === 'done' || r.status === 'awaiting-approval');
     });
   release.command('auto-start')

package/src/cli/setup-cli.ts

@@ -1,13 +1,16 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { addSource, listSources } from '../intake-plane/intake-sources.js';
+import { effectiveInstanceRoot } from '../instance/resolve.js';
 import { Command } from 'commander';
 import { formatDoctorReport, registerDoctorCommand, runDoctor, type DoctorOptions, type DoctorReport } from './doctor-cli.js';
 import { applyClaudePluginSetup, planClaudePluginSetup } from './claude-plugin-setup.js';
 import { recommendedSetup } from './setup-recommend.js';
 import { detectSkillCliAuth, type CliAuthStatus } from '../onboarding/cli-auth-status.js';
 import { debug } from '../debug/log.js';
-import { getUserConfig, saveUserConfig, type UserConfig } from '../user-config.js';
+import { getUserConfig, saveUserConfig, userConfigPath, type UserConfig } from '../user-config.js';
 
 const ELANOUS_LOGIN_COMMAND = 'elanous login openai-codex';
 const PROVIDER_COMMAND = 'elanous config set llm.provider openai-codex';
@@ -29,6 +32,9 @@ export interface SetupCliDeps extends DoctorOptions {
   homeDir?: () => string;
   getUserConfig?: () => UserConfig;
   saveUserConfig?: (config: UserConfig) => void;
+  watchRoot?: string;
+  /** Test seam: injected configs are treated as already provisioned unless explicitly first-run. */
+  firstRunTopics?: boolean;
   planClaudePluginSetup?: typeof planClaudePluginSetup;
   applyClaudePluginSetup?: typeof applyClaudePluginSetup;
   prompt?: (message: string) => Promise<string | undefined>;
@@ -209,6 +215,7 @@ export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}):
         setExitCode(1);
         return;
       }
+      const isFirstRun = deps.firstRunTopics ?? (!deps.getUserConfig && !existsSync(userConfigPath()));
       let steps = setupSteps(deps);
       const provider = steps[1]!;
       if (!provider.complete) {
@@ -224,6 +231,29 @@ export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}):
       out.log(formatSetupReport(doctor, steps, false));
       showCliSkills(false);
       for (const line of recommendedSetup((deps.getUserConfig ?? getUserConfig)())) out.log(line);
+      let configured = (deps.getUserConfig ?? getUserConfig)();
+      if (!configured.starter?.topics && configured.watch?.enabled !== false
+        && isFirstRun
+        && isStdinTty() && !opts.yes) {
+        const answer = (await prompt('관심 주제는 무엇인가요? (쉼표로 구분 · 건너뛰려면 Enter) '))?.trim();
+        if (answer) {
+          configured = { ...configured, starter: { topics: answer.split(',').map((topic) => topic.trim()).filter(Boolean) } };
+          (deps.saveUserConfig ?? saveUserConfig)(configured);
+        }
+      }
+      const starter = configured.starter;
+      if (Array.isArray(starter?.topics) && configured.watch?.enabled !== false) {
+        const root = deps.watchRoot ?? effectiveInstanceRoot();
+        const existing = listSources({ seat: 'user' }, root);
+        for (const rawTopic of starter.topics) {
+          if (typeof rawTopic !== 'string' || !rawTopic.trim()) continue;
+          const topic = rawTopic.trim();
+          if (existing.some((source) => source.kind === 'github-query' && source.spec === topic)) continue;
+          const id = `watch-${createHash('sha256').update(topic).digest('hex').slice(0, 12)}`;
+          if (listSources({}, root).some((source) => source.id === id)) continue;
+          existing.push(addSource({ id, seat: 'user', kind: 'github-query', spec: topic, every: '1d', why: 'starter.topics' }, root));
+        }
+      }
       const accepted = opts.yes || (isStdinTty() && /^(?:y|yes)?$/i.test((await prompt('추천대로 켤까요? [Y/n] '))?.trim() ?? 'n'));
       if (accepted) {
         const runDoctorFix = deps.runDoctorFix ?? (async (args: readonly string[]) => {

package/src/cli/tasks-cli.ts

@@ -1,11 +1,14 @@
 import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { InvalidArgumentError, Option, type Command } from 'commander';
 import { debug } from '../debug/log.js';
 import { getElanousConfigDir } from '../elanous-config-dir.js';
 import { readNexusRuntime } from '../nexus/runtime.js';
+import { checklistDevVersion } from '../release-loop/checklist.js';
+import { cardsBoard, countBoardTasks, INTERNAL_PACK_PROJECT, mergeBoards, releasePackBoard, type BoardNode } from '../task-agent/board.js';
 import type { Task } from '../task-orchestrator/types.js';
-import { handTask, nextMoveFor, readTaskAgentState, readTaskCard, taskAgentStatePath as taskStatePathDefault, shellQuote, TASK_CARD_PREFIX, TASK_SEATS, type TaskCard, type TaskLauncher, type TaskSeat } from '../task-agent/task-hand.js';
+import { cardPrNumber, COMPLETION_KINDS, handTask, nextMoveFor, readTaskAgentState, readTaskCard, taskAgentStatePath as taskStatePathDefault, shellQuote, TASK_CARD_PREFIX, TASK_SEATS, type CompletionKind, type TaskCard, type TaskLaunchContext, type TaskLaunchReceipt, type TaskLauncher, type TaskSeat } from '../task-agent/task-hand.js';
+import { refreshCardRunBinding, type CardRunEvidenceDeps } from '../task-agent/card-evidence.js';
 import { advanceMission, handMission, MissionAdvanceError, openMissionIds, recordPieceRef, type AdvanceMissionResult, type MissionDecompose, type PieceEvidenceReader } from '../task-agent/mission.js';
 
 type TaskRow = Pick<Task, 'id' | 'title' | 'priority' | 'status' | 'createdAt' | 'approval' | 'generatedBy'>;
@@ -25,6 +28,10 @@ export interface TasksCliDeps {
   missionDecompose?: MissionDecompose;
   /** `task advance` 의 착지 근거 읽기(시험 주입). 기본 = `predecessorState`(gh · 런 원장). */
   pieceEvidence?: PieceEvidenceReader;
+  /** `task board` 의 내부 팩 어댑터(시험 주입). 기본 = 현재 판(`checklistDevVersion()`)의 `releasePackBoard` — 읽기만. */
+  releaseBoard?: () => BoardNode[];
+  /** `tasks show`·`advance` 의 런 근거 읽기(시험 주입) — 기본 = 런 원장(이 우주 ⊕ 연합) ⊕ 호스트 logs 의 Pod job-finished. */
+  cardRunEvidence?: CardRunEvidenceDeps;
 }
 
 /** `<조각id>=<값>` 반복 인자. */
@@ -65,16 +72,28 @@ export async function registerTaskAgentSink(register?: (surface: string) => Prom
  * config-dir 은 명시(`--config-dir`/`--test`)가 있으면 그것, 없으면 운영 루트(`prodInstanceRoot()`)다.
  * (작업 트리에서 그냥 띄우면 test 우주로 가서 동결·몫·풀 상한 밖에서 돈다.)
  */
-export async function defaultTaskLauncher(args: string[]): Promise<void> {
-  const { spawn } = await import('node:child_process');
+/** This package's CLI entry — never `process.argv[1]`, which is whatever script started this process
+ *  (ORCH-LIVE-1008: the orchestrator tick runs `bun …/tick.ts delegate`, so the hand launched `tick.ts --config-dir …
+ *  harness say …`, which exited 2 with stdio ignored — the card said `launched` and no run ever started). */
+export const ELANOUS_CLI_ENTRY = resolve(import.meta.dir, '../../bin/elanous.mjs');
+
+/** argv for a detached `elanous` child that runs `args` in `configDir`. */
+export function taskLauncherArgv(configDir: string, args: readonly string[]): string[] {
+  return [ELANOUS_CLI_ENTRY, '--config-dir', configDir, ...args];
+}
+
+export async function defaultTaskLauncher(args: string[], cwd?: string, context?: TaskLaunchContext, deps: { spawn?: DetachedSpawn } = {}): Promise<void | TaskLaunchReceipt> {
+  const spawn = deps.spawn ?? ((await import('node:child_process')).spawn as unknown as DetachedSpawn);
   const { getElanousConfigDirOverride } = await import('../elanous-config-dir.js');
   const { prodInstanceRoot } = await import('../instance/resolve.js');
   const configDir = getElanousConfigDirOverride() ?? prodInstanceRoot();
-  await spawnDetachedConfirmed(spawn as unknown as DetachedSpawn, process.execPath, [process.argv[1]!, '--config-dir', configDir, ...args]);
+  // TA-CARD-RUN-LINK: 런 id 를 자식 환경에 얹는다 — `harness say` 의 런(호스트 orchestrate)이 그 id 를 상속한다.
+  await spawnDetachedConfirmed(spawn, process.execPath, taskLauncherArgv(configDir, args), SPAWN_CONFIRM_TIMEOUT_MS, cwd, context?.env);
+  return context ? { runId: context.runId } : undefined;
 }
 
 /** `spawn` 의 필요한 면만(시험 주입). */
-export type DetachedSpawn = (command: string, args: string[], options: { detached: true; stdio: 'ignore' }) => {
+export type DetachedSpawn = (command: string, args: string[], options: { detached: true; stdio: 'ignore'; cwd?: string; env?: NodeJS.ProcessEnv }) => {
   pid?: number;
   once(event: 'spawn', listener: () => void): unknown;
   once(event: 'error', listener: (error: Error) => void): unknown;
@@ -89,10 +108,10 @@ export const SPAWN_CONFIRM_TIMEOUT_MS = 2_000;
  * 떼어 띄우고 «떴는지» 확인한다 — 'spawn' 이면 성공, 'error'(ENOENT·EACCES 등)면 던진다.
  * 확인 없이 돌려주면 비동기 error 가 처리되지 않고 카드가 `launched` 로 남는다(사후 리뷰 must-fix).
  */
-export function spawnDetachedConfirmed(spawnFn: DetachedSpawn, command: string, args: string[], timeoutMs = SPAWN_CONFIRM_TIMEOUT_MS): Promise<void> {
+export function spawnDetachedConfirmed(spawnFn: DetachedSpawn, command: string, args: string[], timeoutMs = SPAWN_CONFIRM_TIMEOUT_MS, cwd?: string, env?: Record<string, string>): Promise<void> {
   return new Promise<void>((resolve, reject) => {
     let child: ReturnType<DetachedSpawn>;
-    try { child = spawnFn(command, args, { detached: true, stdio: 'ignore' }); } catch (error) { reject(error); return; }
+    try { child = spawnFn(command, args, { detached: true, stdio: 'ignore', ...(cwd ? { cwd } : {}), ...(env ? { env: { ...process.env, ...env } } : {}) }); } catch (error) { reject(error); return; }
     let settled = false;
     const finish = (error?: Error) => {
       if (settled) return;
@@ -122,10 +141,20 @@ function headLine(text: string): string {
   return first.length > 100 ? `${first.slice(0, 100)}…` : first;
 }
 
+/** 런 연결 한 줄 — 런 id 가 없으면 없다(옛 카드 · shadow). */
+function runLinkLine(card: TaskCard): string[] {
+  if (!card.runId) return [];
+  const number = cardPrNumber(card);
+  const url = typeof card.pr === 'object' ? card.pr.url : undefined;
+  const pr = number !== undefined ? `#${number}${url ? ` ${url}` : ''}` : '-';
+  return [`런: ${card.runId} · 골: ${card.goalId ?? '-'} · PR: ${pr}${card.runChildId ? ` · 자식 런: ${card.runChildId}` : ''}`];
+}
+
 function taskCardLines(card: TaskCard): string[] {
   return [
     [card.id, card.status, card.seat ?? '-', card.checklistId ?? '-', card.createdAt, card.text].join('\t'),
     ...(card.mission ? [`미션: ${card.mission} · after: ${card.after?.length ? card.after.join(', ') : '-'}`] : []),
+    ...runLinkLine(card),
     `다음 수: ${moveLine(card)}`,
   ];
 }
@@ -135,7 +164,8 @@ function missionLines(mission: TaskCard, pieces: TaskCard[]): string[] {
   const edges = pieces.flatMap((piece) => (piece.after ?? []).map((before) => `간선: ${before} -> ${piece.id}`));
   return [
     [mission.id, 'mission', mission.seat ?? '-', mission.checklistId ?? '-', mission.createdAt, `조각 ${pieces.length} · 간선 ${edges.length} · 출처 ${mission.splitSource ?? '-'}`, headLine(mission.text)].join('\t'),
-    ...pieces.map((piece) => [`조각: ${piece.id}`, piece.status, nextMoveFor(piece).kind, `after: ${piece.after?.length ? piece.after.join(',') : '-'}`, headLine(piece.text)].join('\t')),
+    ...pieces.map((piece) => [`조각: ${piece.id}`, piece.status, nextMoveFor(piece).kind, `after: ${piece.after?.length ? piece.after.join(',') : '-'}`, headLine(piece.text),
+      ...(piece.runId ? [`런: ${piece.runId}${cardPrNumber(piece) !== undefined ? ` · PR #${cardPrNumber(piece)}` : ''}`] : [])].join('\t')),
     ...edges,
     ...(mission.greenProposal ? [`green 제안: ${mission.greenProposal.at} · 칸 ${mission.greenProposal.checklistId ?? '-'} · 근거 ${Object.entries(mission.greenProposal.evidence).map(([id, ref]) => `${id}=${ref}`).join(', ')}`] : []),
   ];
@@ -255,16 +285,31 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
     .description('TASK-AGENT 에 과제 한 줄을 넘긴다 — 카드를 적고 첫 수(harness say --substrate pod --merge-by-host)를 고른다 · 기본 shadow(발사 0) · `--mission` 이면 조각 카드 ⊕ 선후로 쪼개 선행 없는 조각만 넘긴다')
     .addOption(new Option('--seat <seat>', `과제 자리 (${TASK_SEATS.join('|')})`).choices([...TASK_SEATS]))
     .option('--checklist <cellId>', '릴리스 체크리스트 칸 id')
+    .addOption(new Option('--completion <kind>', `종결 종류 (${COMPLETION_KINDS.join('|')} · 기본 code-pr = PR 병합)`).choices([...COMPLETION_KINDS]))
     .option('--mission <text>', '미션 문면 — 조각(`- …`·`① …`·`1. …` ⊕ `after: 1`)으로 나열돼 있으면 결정론, 아니면 분해기로 쪼갠다')
+    .option('--project <id>', '프로젝트 id — --target 과 함께')
+    .option('--goal <id>', '보드 소속 목표 id (task board)')
+    .option('--milestone <id>', '보드 소속 이정표 id (task board)')
+    .option('--target <dir>', '프로젝트 대상 디렉터리(있어야 한다 · 상대 경로는 절대로 · git 이 아니면 --completion 이 code-pr 밖이어야 한다) — 발사기를 이 디렉터리에서 띄운다')
     .option('--live', '실제로 발사한다(기본은 shadow — 명령만 출력)')
     .option('--json', 'JSON 출력')
-    .action(async (text: string | undefined, opts: { seat?: TaskSeat; checklist?: string; mission?: string; live?: boolean; json?: boolean }) => {
+    .action(async (text: string | undefined, opts: { seat?: TaskSeat; checklist?: string; completion?: CompletionKind; mission?: string; project?: string; target?: string; goal?: string; milestone?: string; live?: boolean; json?: boolean }) => {
       await registerTaskAgentSink(deps.registerSink);
       if ((text === undefined) === (opts.mission === undefined)) {
         out('과제 한 줄 «또는» --mission <문면> 중 하나만 준다');
         process.exitCode = 1;
         return;
       }
+      if ((opts.project === undefined) !== (opts.target === undefined)) {
+        out('--project <id> 와 --target <dir> 를 함께 줘야 한다');
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.mission !== undefined && (opts.completion !== undefined || opts.project !== undefined || opts.goal !== undefined || opts.milestone !== undefined)) {
+        out('--completion/--project/--target/--goal/--milestone 은 과제 한 줄에만 준다 — --mission 조각은 종전처럼 code-pr 이다');
+        process.exitCode = 1;
+        return;
+      }
       if (opts.mission !== undefined) {
         try {
           const result = await handMission({
@@ -297,8 +342,12 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
       try {
         const result = await handTask({
           text: text!,
+          ...(opts.project !== undefined && opts.target !== undefined ? { project: { id: opts.project, target: opts.target } } : {}),
+          ...(opts.goal !== undefined ? { goal: opts.goal } : {}),
+          ...(opts.milestone !== undefined ? { milestone: opts.milestone } : {}),
           ...(opts.seat ? { seat: opts.seat } : {}),
           ...(opts.checklist ? { checklistId: opts.checklist } : {}),
+          ...(opts.completion ? { completion: opts.completion } : {}),
           live: opts.live === true,
           ...(deps.taskStatePath ? { statePath: deps.taskStatePath } : {}),
           launcher: deps.taskLauncher ?? defaultTaskLauncher,
@@ -307,6 +356,7 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
         else {
           out(`${result.card.id}\t${result.mode}\t${result.launched ? 'launched' : 'not launched'}`);
           out(`elanous ${result.move.command!.map(shellQuote).join(' ')}`);
+          if (result.cwd) out(`(cwd: ${result.cwd})`);
           if (!result.launched) out('(shadow — 띄우지 않았다 · 띄우려면 --live)');
         }
       } catch (error) {
@@ -315,6 +365,37 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
       }
     });
 
+  tasks.command('board')
+    .description('보드 — 프로젝트 › 목표 › 이정표 › 과제. 과제 카드(project·goal·milestone)와 내부 팩(릴리스 체크리스트 = elanous › 판 › 칸)을 합쳐 읽는다(쓰지 않는다)')
+    .option('--project <id>', '이 프로젝트만')
+    .option('--json', 'JSON 출력')
+    .action(async (opts: { project?: string; json?: boolean }) => {
+      await registerTaskAgentSink(deps.registerSink);
+      try {
+        // 내부 팩은 elanous 프로젝트만 낸다 — 다른 프로젝트로 거르면 릴리스 원장을 열지 않는다(그 원장의 오류가 카드 보드를 막지 않게).
+        const wantsPack = opts.project === undefined || opts.project === INTERNAL_PACK_PROJECT;
+        const board = mergeBoards(
+          cardsBoard(deps.taskStatePath ?? taskStatePathDefault()),
+          wantsPack ? (deps.releaseBoard ?? (() => releasePackBoard(checklistDevVersion())))() : [],
+        );
+        // 무소속(unassigned: true)은 어떤 --project 로도 고르지 않는다 — 실제 프로젝트 id 와 겹치지 않게.
+        const selected = opts.project !== undefined ? board.filter((project) => project.unassigned !== true && project.id === opts.project) : board;
+        try { debug.log('task-agent', 'board', { projects: selected.length, tasks: countBoardTasks(selected), project: opts.project ?? null }); } catch { /* fail-soft */ }
+        if (opts.json) out(JSON.stringify(selected));
+        else {
+          const show = (node: BoardNode, depth: number): void => {
+            out(`${'  '.repeat(depth)}${node.level}\t${node.id}\t${node.status}\t${headLine(node.title)}`);
+            for (const next of node.children ?? []) show(next, depth + 1);
+          };
+          if (selected.length === 0) out(opts.project !== undefined ? `프로젝트 없음: ${opts.project}` : '보드가 비어 있다');
+          for (const project of selected) show(project, 0);
+        }
+      } catch (error) {
+        out(error instanceof Error ? error.message : '보드 읽기 실패');
+        process.exitCode = 1;
+      }
+    });
+
   tasks.command('advance [missionId]')
     .description('TASK-AGENT 미션 ② — 조각의 PR 병합(근거: `--pr`/`--goal` 로 카드에 적은 PR 번호·골 id)으로 착지를 가르고 새로 준비된 조각만 한 번 넘긴다 · 모두 착지면 green «제안»만 적는다 · 기본 shadow(발사 0)')
     .option('--all', 'green 제안이 아직 없는 미션 전부')
@@ -366,6 +447,7 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
               ...(statePath ? { statePath } : {}),
               launcher: deps.taskLauncher ?? defaultTaskLauncher,
               ...(deps.pieceEvidence ? { readEvidence: deps.pieceEvidence } : {}),
+              ...(deps.cardRunEvidence ? { runEvidence: deps.cardRunEvidence } : {}),
             }));
           } catch (error) {
             // 미션 id 하나면 그대로 실패 · --all 이면 그 미션만 실패로 적고 다음 미션으로 간다(크론이 한 미션에 막히지 않게).
@@ -405,7 +487,18 @@ export function registerTasksCommands(program: Command, deps: TasksCliDeps = {})
       if (id.startsWith(TASK_CARD_PREFIX)) {
         await registerTaskAgentSink(deps.registerSink);
         let card: TaskCard | undefined;
-        try { card = readTaskCard(id, deps.taskStatePath); } catch (error) {
+        try {
+          card = readTaskCard(id, deps.taskStatePath);
+          // 런 id 가 있으면 원장에서 골 id · PR 을 묶는다(찾았을 때만 적는다 · 실패는 그대로 보인다).
+          const bindable = card?.pieces ? card.pieces : card ? [card.id] : [];
+          for (const cardId of bindable) {
+            try { await refreshCardRunBinding(cardId, deps.taskStatePath ?? taskStatePathDefault(), deps.cardRunEvidence ?? {}); } catch (error) {
+              // 근거 없음으로 보인다 — 원장 부재와 갈리게 실패는 남긴다.
+              try { debug.log('task-agent', 'card-bind-failed', { card: cardId, via: 'show', error: error instanceof Error ? error.message : String(error) }); } catch { /* fail-soft */ }
+            }
+          }
+          if (card) card = readTaskCard(id, deps.taskStatePath);
+        } catch (error) {
           out(error instanceof Error ? error.message : '과제 카드 읽기 실패');
           process.exitCode = 1;
           return;

package/src/context-bus/context-now-public.ts

@@ -72,7 +72,7 @@ export function filterPublicDemoContext(answer: ContextNowAnswer, brandCheck: ty
           id: fact.id ? (rulesMissing || privateIds.has(fact.id) ? '내부 항목' : safe(fact.id, '공개 항목')) : null,
           title: fact.title === null ? null : rulesMissing ? internalItem(1) : privateIds.has(fact.id ?? '') ? '내부 항목' : safe(fact.title, '공개 항목'),
           source: source(fact.source) });
-      } else facts.push({ ...fact, version: safe(fact.version, '공개 판'), source: source(fact.source) });
+      } else if (fact.kind === 'version') facts.push({ ...fact, version: safe(fact.version, '공개 판'), source: source(fact.source) });
     }
     for (const kind of ['cell', 'decision'] as const) {
       if (!collapsed[kind]) continue;

package/src/context-bus/context-now-surfaces.ts

@@ -34,6 +34,9 @@ function factText(fact: ContextFact): string {
     case 'cell': return `${fact.id} ${fact.title} (${fact.status})`;
     case 'decision': return `${fact.id} ${fact.title} (${fact.status})`;
     case 'seat': return `${fact.seat} ${fact.id ?? ''} ${fact.title ?? ''} (${fact.status})`.trim();
+    case 'run': return fact.unreadable ? `못 읽음 · ${fact.unreadable}` : `${fact.goal} · ${fact.phase} · ${fact.elapsed}`;
+    case 'release': return fact.unreadable ? `못 읽음 · ${fact.unreadable}` : `${fact.version} · ${fact.node} · ${fact.status}`;
+    case 'schedule-late': return fact.unreadable ? `못 읽음 · ${fact.unreadable}` : `${fact.count}개 · ${fact.names.join(', ') || '없음'}`;
   }
 }
 
@@ -61,20 +64,27 @@ export function renderTuiNow(input: ContextNowAnswer, audience: ContextNowAudien
     if (source.startsWith('elanous://release/')) return '원장';
     return Array.from(source).slice(0, 40).join('');
   };
-  const factLabels = { version: '판', cell: '칸', decision: '결정', seat: '자리' } as const;
+  const factLabels = { run: '도는 런', release: '발행 런', 'schedule-late': '지연 스케줄', version: '판', cell: '칸', decision: '결정', seat: '자리' } as const;
   const eventLabels: Record<string, string> = { report: '보고', dispatch: '발사', decision: '결정' };
   const events = answer.events.slice().sort((a, b) => Date.parse(b.at) - Date.parse(a.at));
   const rows = [
-    ...answer.facts.map(f => [factLabels[f.kind], shortText(factText(f)), shortSource(f.source)]),
+    ...answer.facts.slice().sort((a, b) => {
+      const priority = (kind: ContextFact['kind']) => ({ run: 0, release: 1, 'schedule-late': 2 } as Partial<Record<ContextFact['kind'], number>>)[kind] ?? 3;
+      return priority(a.kind) - priority(b.kind);
+    }).map(f => [factLabels[f.kind], shortText(factText(f)), shortSource(f.source)]),
     ...events.slice(0, 8).map(e => [eventLabels[e.kind] ?? '소식', shortText(e.summary), shortSource(e.source)]),
     ...answer.guide.map(guide => ['안내', guide, '']),
     ...(events.length > 8 ? [['안내', `… 사건 ${events.length - 8}개 더(/now <주제> 로 좁히기)`, '']] : []),
   ];
+  const clean = (text: string) => text.replaceAll('|', ' ').replaceAll(/\r?\n/g, ' ');
+  const width = (text: string) => Array.from(text).reduce((total, char) => total + (/[\u1100-\u115f\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe6f\uff01-\uff60\uffe0-\uffe6]/u.test(char) ? 2 : 1), 0);
+  const data = [['종류', '사실', '출처'], ...rows].map(row => row.map(clean));
+  const widths = [0, 1].map(i => Math.max(...data.map(row => width(row[i] ?? ''))));
+  const format = (row: string[]) => `${row[0]}${' '.repeat(widths[0]! - width(row[0]!) + 2)}${row[1]}${' '.repeat(widths[1]! - width(row[1]!) + 2)}${row[2]}`;
+  const time = new Intl.DateTimeFormat('en-GB', { timeZone: 'Asia/Seoul', hour: '2-digit', minute: '2-digit', hourCycle: 'h23' }).format(new Date(answer.at));
   return [
-    `지금${answer.topic ? ` · ${answer.topic}` : ''} (${answer.at})`,
-    '| 종류 | 사실 | 출처 |',
-    '| --- | --- | --- |',
-    ...rows.map(row => `| ${row.map(cell => cell.replaceAll('|', '\\|').replaceAll(/\r?\n/g, ' ')).join(' | ')} |`),
+    `지금${answer.topic ? ` · ${answer.topic}` : ''} (${time} KST)`,
+    ...data.map(format),
   ];
 }
 

package/src/context-bus/context-now.ts

@@ -1,4 +1,8 @@
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync, lstatSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { queryRunningRuns, type QueriedRunningRunsResult } from '../self-implement/running-runs.js';
+import { loadRunLedger } from '../self-implement/run-ledger.js';
+import { localLoopRows } from '../dashboard/slash-runtime/loops-table.js';
 import { checkBrand } from '../../scripts/brand/check.js';
 import { debug, redactSecretText } from '../debug/log.js';
 import { DecisionLedger, type DecisionEntry } from '../decisions/decision-ledger.js';
@@ -12,7 +16,10 @@ export type ContextFact =
   | { kind: 'version'; version: string; source: string }
   | { kind: 'cell'; version: string; id: string; title: string; status: string; owner: string | null; source: string }
   | { kind: 'decision'; id: string; title: string; status: string; dueAt: string | null; source: string }
-  | { kind: 'seat'; seat: string; at: string; status: string; id: string | null; title: string | null; source: string };
+  | { kind: 'seat'; seat: string; at: string; status: string; id: string | null; title: string | null; source: string }
+  | { kind: 'run'; goal: string; phase: string; elapsed: string; source: string; unreadable?: string }
+  | { kind: 'release'; version: string; node: string; status: string; source: string; unreadable?: string }
+  | { kind: 'schedule-late'; count: number | null; names: string[]; source: string; unreadable?: string };
 export type ContextEvent = { at: string; kind: string; summary: string; source: string };
 export type ContextNowAnswer = { at: string; topic: string | null; facts: ContextFact[]; events: ContextEvent[]; guide: string[]; hiddenCount?: number };
 
@@ -23,6 +30,10 @@ export interface ContextNowDeps {
   decisions?: () => DecisionEntry[];
   seatEntries?: (now: Date) => Array<{ entry: SeatEntry; source: string }>;
   events?: (since: string) => CoordEvent[];
+  runningRuns?: (now: Date) => Extract<ContextFact, { kind: 'run' }>[];
+  queryRuns?: () => QueriedRunningRunsResult;
+  releaseRun?: () => Extract<ContextFact, { kind: 'release' }> | null;
+  lateSchedules?: (now: Date) => Extract<ContextFact, { kind: 'schedule-late' }> | null;
   brandCheck?: typeof checkBrand;
 }
 
@@ -39,6 +50,75 @@ function todaySeatEntries(now: Date): Array<{ entry: SeatEntry; source: string }
   });
 }
 
+const runSource = 'elanous://self-implement/running-runs';
+const releaseSource = 'elanous://graph-runs/release-loop';
+const scheduleSource = 'elanous://schedules';
+const oneLine = (text: string) => redactSecretText(text.split(/\r?\n/, 1)[0] ?? '').slice(0, 120);
+
+function runningRunFacts(now: Date, queryRuns: () => QueriedRunningRunsResult = () => queryRunningRuns({ includeTest: false, caller: 'context-now' })): Extract<ContextFact, { kind: 'run' }>[] {
+  const observed = queryRuns();
+  const unreadable = observed.completeness === 'partial' || observed.pty.unreadable.length || !!observed.phases?.unreadableTargetCount;
+  const facts = observed.entries.filter(entry => observed.countedStatuses.includes(entry.status)).slice(0, 8).flatMap(entry => {
+    let ledgerReadFailure = false;
+    const starts = entry.ledgerDirectories.flatMap(directory => {
+      try { return loadRunLedger(entry.runId, directory)?.filter(record => record.event === 'start') ?? []; }
+      catch { ledgerReadFailure = true; return []; }
+    });
+    const goalRecord = starts.find(record => typeof record.data.feature === 'string' && record.data.feature.trim());
+    const goal = typeof goalRecord?.data.feature === 'string' ? goalRecord.data.feature : ledgerReadFailure ? '골 관측 불가' : '골 미기록';
+    const started = starts.map(record => record.timestamp ? Date.parse(record.timestamp) : NaN).find(Number.isFinite) ?? NaN;
+    const minutes = Number.isFinite(started)
+      ? Math.max(0, Math.floor((now.getTime() - started) / 60_000)) : null;
+    const fact = { kind: 'run' as const, goal: oneLine(goal),
+      phase: entry.lastPhase ?? '단계 미관측', elapsed: minutes === null ? ledgerReadFailure ? '경과 관측 불가' : '경과 미관측' : `${minutes}분`,
+      source: `${runSource}/${encodeURIComponent(entry.runId)}` };
+    return ledgerReadFailure
+      ? [
+          ...(goalRecord || minutes !== null ? [fact] : []),
+          { kind: 'run' as const, goal: '', phase: '', elapsed: '', source: fact.source, unreadable: '런 원장 일부 관측 불가' },
+        ] : [fact];
+  });
+  return unreadable ? [...facts, { kind: 'run', goal: '', phase: '', elapsed: '', source: runSource, unreadable: '런 원장 또는 관측 대상 일부' }] : facts;
+}
+
+function latestReleaseRun(): Extract<ContextFact, { kind: 'release' }> | null {
+  const dir = join(effectiveInstanceRoot(), 'graph-runs', 'release-loop');
+  let filenames: string[];
+  try { filenames = readdirSync(dir).filter(name => /^[A-Za-z0-9-]+\.json$/.test(name)); }
+  catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return null;
+    throw error;
+  }
+  const runs = filenames.flatMap(filename => {
+    const path = join(dir, filename);
+    let run: { startedAt?: unknown; status?: unknown; input?: { version?: unknown }; path?: unknown; nodes?: unknown };
+    try {
+      if (!lstatSync(path).isFile()) return [];
+      run = JSON.parse(readFileSync(path, 'utf8'));
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === 'ENOENT' || error instanceof SyntaxError) return [];
+      throw error;
+    }
+    if (typeof run.startedAt !== 'string' || typeof run.status !== 'string' || !Array.isArray(run.path) || !Array.isArray(run.nodes)) return [];
+    const steps = run.path.filter((step): step is string => typeof step === 'string');
+    const nodes = run.nodes.filter((node): node is { nodeId: string } => !!node && typeof node.nodeId === 'string');
+    const version = typeof run.input?.version === 'string' && /^\d+\.\d+\.\d+(?:-(?:rc|alpha|beta)\.\d+)?$/.test(run.input.version) ? run.input.version : '판 미기록';
+    const index = Math.min(steps.length, nodes.length + (run.status === 'running' || run.status === 'awaiting-approval' ? 1 : 0));
+    return [{ startedAt: run.startedAt, fact: { kind: 'release' as const, version, node: `${index}/${steps.length}${steps[index - 1] ? ` ${oneLine(steps[index - 1]!)}` : ''}`,
+      status: oneLine(run.status), source: `${releaseSource}/${encodeURIComponent(filename.slice(0, -5))}` } }];
+  });
+  return runs.sort((a, b) => b.startedAt.localeCompare(a.startedAt))[0]?.fact ?? null;
+}
+
+function lateScheduleFact(now: Date): Extract<ContextFact, { kind: 'schedule-late' }> {
+  const names = localLoopRows(now).filter(row => row.verdict === 'late').map(row => oneLine(row.name));
+  return { kind: 'schedule-late', count: names.length, names, source: scheduleSource };
+}
+
+function unreadableReason(error: unknown): string {
+  return oneLine(error instanceof Error ? error.message : String(error)) || '원천 조회 실패';
+}
+
 /** Read a bounded, source-labelled view of current ledgers, never a transcript or decision body. */
 export function contextNow(options: { topic?: string; limit?: number; audience?: 'operator' | 'user' | 'public-demo' } = {}, deps: ContextNowDeps = {}): ContextNowAnswer {
   const now = (deps.now ?? (() => new Date()))();
@@ -71,6 +151,20 @@ export function contextNow(options: { topic?: string; limit?: number; audience?:
   const rawEvents = (deps.events ?? (since => listCoordEvents({ since })))(new Date(now.getTime() - 7 * 86_400_000).toISOString());
   const chronologicalEvents = rawEvents.slice().sort((a, b) => a.at.localeCompare(b.at));
   const matches = (text: string) => !topic || text.toLocaleLowerCase().includes(topic.toLocaleLowerCase());
+  const operational: ContextFact[] = [];
+  if (options.audience !== 'public-demo') {
+    try { operational.push(...(deps.runningRuns ?? (date => runningRunFacts(date, deps.queryRuns)))(now)); }
+    catch (error) { operational.push({ kind: 'run', goal: '', phase: '', elapsed: '', source: runSource, unreadable: unreadableReason(error) }); }
+    try {
+      const release = (deps.releaseRun ?? latestReleaseRun)();
+      if (release) operational.push(release);
+    } catch (error) { operational.push({ kind: 'release', version: '', node: '', status: '', source: releaseSource, unreadable: unreadableReason(error) }); }
+    try { const schedules = (deps.lateSchedules ?? lateScheduleFact)(now); if (schedules) operational.push(schedules); }
+    catch (error) { operational.push({ kind: 'schedule-late', count: null, names: [], source: scheduleSource, unreadable: unreadableReason(error) }); }
+  }
+  const selectedOperational = operational.filter(f => !topic || ('unreadable' in f && !!f.unreadable) || (f.kind === 'run' && matches(`${f.goal} ${f.phase}`))
+    || (f.kind === 'release' && matches(`${f.version} ${f.node} ${f.status}`))
+    || (f.kind === 'schedule-late' && matches(f.names.join(' '))));
   const selectedFacts = facts.filter(f => !topic || (f.kind === 'cell' && matches(`${f.id} ${f.title}`))
     || (f.kind === 'seat' && matches(`${f.id ?? ''} ${f.title ?? ''}`)));
   const groups = (['version', 'cell', 'decision', 'seat'] as const).map(kind => selectedFacts.filter(f => f.kind === kind));
@@ -92,7 +186,7 @@ export function contextNow(options: { topic?: string; limit?: number; audience?:
     chosen[index]!.push(...extra);
     remaining -= extra.length;
   }
-  const boundedFacts = chosen.flat();
+  const boundedFacts = [...selectedOperational.slice(0, limit), ...chosen.flat()];
   const summaries = chronologicalEvents.map(event => ({
     at: event.at, kind: event.kind, summary: redactSecretText(event.summary.split(/\r?\n/, 1)[0] ?? '').slice(0, 120),
     source: event.refs.source ?? event.refs.url ?? `elanous://context/event/${encodeURIComponent(event.id)}`,