elanous 0.2.6 → 0.2.7

package/src/harness/aside-run-status.ts

@@ -0,0 +1,33 @@
+import { stripScreenAnsi } from './harness-screen.js';
+
+export type AsideRunStatus = {
+  kind: 'ok' | 'not-running' | 'auth-timeout' | 'repl-error' | 'no-marker';
+  hint?: string;
+};
+
+export function classifyAsideRun({ stdout, stderr, exitCode, timedOut = false }: {
+  stdout: string;
+  stderr: string;
+  exitCode: number | null;
+  /** We killed `aside` at our own timeout. */
+  timedOut?: boolean;
+}): AsideRunStatus {
+  const diagnosticStdout = stripScreenAnsi(stdout).split(/\r?\n/).filter((line) => {
+    try { JSON.parse(line.trim()); return false; } catch { return true; }
+  }).join('\n');
+  const diagnostics = `${diagnosticStdout}\n${stripScreenAnsi(stderr)}`;
+  if (exitCode !== 0 && /Aside isn't running/i.test(diagnostics)) {
+    return { kind: 'not-running', hint: 'Aside 브라우저가 안 떠 있음 — Aside 브라우저를 켜고 다시 · 또는 `aside exec --host <host>`' };
+  }
+  if (exitCode !== 0 && /daemon auth challenge/i.test(diagnostics) && /timeout|timed out/i.test(diagnostics)) {
+    return { kind: 'auth-timeout', hint: 'Aside 인증 요청 시간 초과 — Aside 브라우저를 켜고 다시 · 또는 `aside exec --host <host>`' };
+  }
+  // Killed by our timeout with nothing printed: aside never answered — the browser daemon is not reachable.
+  if (timedOut && !stripScreenAnsi(stdout).trim()) {
+    return { kind: 'auth-timeout', hint: 'Aside 가 응답하지 않음 — Aside 브라우저가 떠 있는지 확인하고 다시 · 또는 `aside exec --host <host>`' };
+  }
+  const marker = stripScreenAnsi(stdout).trimEnd().match(/\[(ok|error)\s*\|[^\]]+\]\s*$/);
+  if (marker?.[1] === 'error') return { kind: 'repl-error' };
+  if (marker?.[1] === 'ok') return { kind: 'ok' };
+  return { kind: 'no-marker' };
+}

package/src/harness/browser-verify.ts

@@ -16,9 +16,12 @@ import { createCdpClientFromEndpoint, CdpUnavailable, type CdpClient } from '../
 import { captureWithTimeout, describeCaptureFailure } from './browser-capture-timeout.js';
 import { debug } from '../debug/log.js';
 import { stripScreenAnsi } from './harness-screen.js';
+import { classifyAsideRun, type AsideRunStatus } from './aside-run-status.js';
+import { IMAGE_LOAD_STATE_SOURCE } from './image-load-state.js';
 
 const execFileAsync = promisify(execFile);
-const DEFAULT_ASIDE_TIMEOUT_MS = 10_000;
+// Longer than aside's own ~10 s daemon auth-challenge timeout, so «Aside isn't running» reaches stderr before we kill it (10-01 live).
+const DEFAULT_ASIDE_TIMEOUT_MS = 30_000;
 // Observed load events and complete page content arrive within this window; timeout remains non-blocking.
 const CDP_LOAD_WAIT_TIMEOUT_MS = 3_000;
 
@@ -74,6 +77,8 @@ export interface DeployVerifyResult {
   title?: string;
   bodyLength?: number;
   screenshotBytes?: number;
+  /** 아직 화면 밖이라 요청되지 않은 lazy 그림 수(실패가 아님). */
+  pendingLazyImages?: number;
   /** 렌더 문제(빈 페이지·에러 등). ok=false 면 최소 1건. */
   findings: string[];
   /** findings와 병행하는 등급 있는 판정. 정상·CDP 미가용 결과에는 생략해 기존 결과 모양을 보존한다. */
@@ -81,10 +86,10 @@ export interface DeployVerifyResult {
   /** 측정하지 못한 선택적 신호. 빈 배열은 생략하므로 문제 없음과 구별된다. */
   unmeasured?: DeployUnmeasuredCheck[];
   /** 관측 백엔드 미가용으로 검증 스킵됨(배포는 막지 않음). */
-  skipped?: 'no-cdp' | 'no-aside';
+  skipped?: 'no-cdp' | 'no-aside' | 'aside-not-running';
 }
 
-export type AsideRunner = (command: string, args: string[], options: { timeout: number }) => Promise<{ stdout: string }>;
+export type AsideRunner = (command: string, args: string[], options: { timeout: number }) => Promise<{ stdout: string; stderr?: string; exitCode?: number | null; timedOut?: boolean }>;
 
 export interface DeployVerifyDeps {
   /** 기본 CDP 또는 별도 브라우저 세션을 쓰는 aside. */
@@ -121,9 +126,18 @@ interface PageState {
   title: string;
   bodyLength: number;
   unloadedImageCount: number;
+  pendingLazyImages: number;
   consecutiveDuplicateText: string | null;
 }
 
+const IMAGE_COUNTS_EXPRESSION = `(${IMAGE_LOAD_STATE_SOURCE})(Array.from(document.images, (image) => {
+  const rect = image.getBoundingClientRect();
+  return {
+    complete: image.complete, naturalWidth: image.naturalWidth, loading: image.loading,
+    inViewport: rect.bottom > 0 && rect.right > 0 && rect.top < window.innerHeight && rect.left < window.innerWidth,
+  };
+}))`;
+
 const PAGE_STATE_EXPRESSION = `(() => {
   const isVisible = (element) => {
     for (let current = element; current; current = current.parentElement) {
@@ -141,10 +155,12 @@ const PAGE_STATE_EXPRESSION = `(() => {
     }
   }
   const consecutiveDuplicateText = textUnits.find((text, index) => text === textUnits[index + 1]) ?? null;
+  const imageCounts = ${IMAGE_COUNTS_EXPRESSION};
   return {
     title: document.title,
     bodyLength: document.body ? document.body.innerText.length : 0,
-    unloadedImageCount: Array.from(document.images).filter((image) => !image.complete || image.naturalWidth === 0).length,
+    unloadedImageCount: imageCounts.broken,
+    pendingLazyImages: imageCounts.pendingLazy,
     consecutiveDuplicateText,
   };
 })()`;
@@ -169,7 +185,7 @@ function buildAsideScript(url: string): string {
     '  const page = await openTab(url);',
     '  try {',
     '    const title = await page.title();',
-    "    const state = await page.evaluate(() => ({ bodyLength: document.body?.innerText.length ?? 0, unloadedImageCount: Array.from(document.images).filter((image) => !image.complete || image.naturalWidth === 0).length }));",
+    `    const state = await page.evaluate(() => { const imageCounts = ${IMAGE_COUNTS_EXPRESSION}; return { bodyLength: document.body?.innerText.length ?? 0, unloadedImageCount: imageCounts.broken, pendingLazyImages: imageCounts.pendingLazy }; });`,
     '    const screenshot = await page.screenshot({ fullPage: true });',
     '    console.log(JSON.stringify({ title, ...state, screenshotBytes: screenshot?.length ?? 0 }));',
     '  } finally { try { await closeTab(page); } catch {} }',
@@ -177,7 +193,7 @@ function buildAsideScript(url: string): string {
   ].join('\n');
 }
 
-function parseAsideObservation(stdout: string): { title: string; bodyLength: number; unloadedImageCount: number; screenshotBytes: number } {
+function parseAsideObservation(stdout: string): { title: string; bodyLength: number; unloadedImageCount: number; pendingLazyImages: number; screenshotBytes: number } {
   const normalizedStdout = stripScreenAnsi(stdout);
   const verdict = normalizedStdout.trimEnd().match(/\[(ok|error)\s*\|[^\]]+\]\s*$/);
   if (!verdict) throw new Error('aside observation output missing completion marker');
@@ -189,16 +205,17 @@ function parseAsideObservation(stdout: string): { title: string; bodyLength: num
       const result: unknown = JSON.parse(line.trim());
       parsedJson = true;
       if (!result || typeof result !== 'object' || Array.isArray(result)) throw new Error('aside observation JSON must be an object');
-      const { title, bodyLength, unloadedImageCount, screenshotBytes } = result as Record<string, unknown>;
+      const { title, bodyLength, unloadedImageCount, pendingLazyImages = 0, screenshotBytes } = result as Record<string, unknown>;
       if (
         typeof title !== 'string'
         || typeof bodyLength !== 'number' || !Number.isFinite(bodyLength) || bodyLength < 0
         || typeof unloadedImageCount !== 'number' || !Number.isFinite(unloadedImageCount) || unloadedImageCount < 0
+        || typeof pendingLazyImages !== 'number' || !Number.isFinite(pendingLazyImages) || pendingLazyImages < 0
         || typeof screenshotBytes !== 'number' || !Number.isFinite(screenshotBytes) || screenshotBytes < 0
       ) {
         throw new Error('aside observation JSON has invalid required fields');
       }
-      return { title, bodyLength, unloadedImageCount, screenshotBytes };
+      return { title, bodyLength, unloadedImageCount, pendingLazyImages, screenshotBytes };
     } catch (error) {
       if (parsedJson) throw error;
     }
@@ -206,9 +223,9 @@ function parseAsideObservation(stdout: string): { title: string; bodyLength: num
   throw new Error('aside observation output missing JSON');
 }
 
-function asideErrorResult(url: string, error: unknown): DeployVerifyResult {
+function asideErrorResult(url: string, error: unknown, kind?: AsideRunStatus['kind']): DeployVerifyResult {
   const message = error instanceof Error ? error.message : String(error);
-  const errorFinding = finding('aside-error', `aside 검증 오류: ${message.slice(0, 120)}`, 'confirmed');
+  const errorFinding = finding('aside-error', `aside 검증 오류: ${message.slice(0, 120)}${kind ? ` (${kind})` : ''}`, 'confirmed');
   observe('verify-aside-failed', { url: url.slice(0, 80), error: message.slice(0, 120) });
   return { ok: false, url, findings: [errorFinding.message], structuredFindings: [errorFinding], unmeasured: ['javascript-errors'] };
 }
@@ -224,15 +241,21 @@ async function verifyAsidePage(url: string, deps: DeployVerifyDeps): Promise<Dep
     const runAside = deps.runAside ?? (async (command, args, options) => {
       try {
         const result = await execFileAsync(command, args, { ...options, encoding: 'utf8' });
-        return { stdout: result.stdout };
+        return { stdout: result.stdout, stderr: result.stderr, exitCode: 0 };
       } catch (error) {
         if ((error as NodeJS.ErrnoException).code === 'ENOENT') throw error;
-        const stdout = (error as { stdout?: unknown }).stdout;
-        if (typeof stdout === 'string') return { stdout };
+        const { stdout, stderr, code, killed, signal } = error as { stdout?: unknown; stderr?: unknown; code?: unknown; killed?: unknown; signal?: unknown };
+        if (typeof stdout === 'string' || typeof stderr === 'string') {
+          return {
+            stdout: typeof stdout === 'string' ? stdout : '', stderr: typeof stderr === 'string' ? stderr : '',
+            exitCode: typeof code === 'number' ? code : null,
+            ...(killed === true || typeof signal === 'string' ? { timedOut: true } : {}),
+          };
+        }
         throw error;
       }
     });
-    let observation: { stdout: string };
+    let observation: Awaited<ReturnType<AsideRunner>>;
     try {
       observation = await runAside(deps.asideCommand ?? 'aside', ['repl', script], { timeout: deps.asideTimeoutMs ?? DEFAULT_ASIDE_TIMEOUT_MS });
     } catch (error) {
@@ -242,13 +265,20 @@ async function verifyAsidePage(url: string, deps: DeployVerifyDeps): Promise<Dep
       }
       return asideErrorResult(url, error);
     }
+    const status = classifyAsideRun({ stdout: observation.stdout, stderr: observation.stderr ?? '', exitCode: observation.exitCode ?? null, timedOut: observation.timedOut === true });
+    if (status.kind === 'not-running' || status.kind === 'auth-timeout') {
+      observe('verify-aside-skipped', { url, kind: status.kind });
+      return { ok: false, url, skipped: 'aside-not-running', findings: [status.hint ?? 'Aside 브라우저를 켜고 다시'], unmeasured: ['javascript-errors', 'screenshot'] };
+    }
+    if (status.kind === 'repl-error') return asideErrorResult(url, new Error('aside repl reported error'), status.kind);
+    if (status.kind === 'no-marker') return asideErrorResult(url, new Error('aside observation output missing completion marker'), status.kind);
     const state = parseAsideObservation(observation.stdout);
     const structuredFindings: DeployVerifyFinding[] = [];
     if (state.bodyLength < minBody) structuredFindings.push(finding('empty-body', `페이지 본문이 비어있음(len=${state.bodyLength}·렌더 실패 의심)`, 'suspected'));
     if (state.unloadedImageCount) structuredFindings.push(finding('unloaded-image', `로드되지 못한 그림 ${state.unloadedImageCount}개`, 'confirmed'));
     if (!state.title.trim()) structuredFindings.push(finding('empty-title', '문서 제목이 비어있음', 'confirmed'));
     const findings = structuredFindings.map(({ message }) => message);
-    const result: DeployVerifyResult = { ok: findings.length === 0, url, title: state.title, bodyLength: state.bodyLength, screenshotBytes: state.screenshotBytes, findings, unmeasured: ['javascript-errors'], ...(structuredFindings.length ? { structuredFindings } : {}) };
+    const result: DeployVerifyResult = { ok: findings.length === 0, url, title: state.title, bodyLength: state.bodyLength, screenshotBytes: state.screenshotBytes, findings, unmeasured: ['javascript-errors'], ...(state.pendingLazyImages ? { pendingLazyImages: state.pendingLazyImages } : {}), ...(structuredFindings.length ? { structuredFindings } : {}) };
     observe('verified-aside', { url: url.slice(0, 80), ok: result.ok, bodyLength: state.bodyLength, bytes: state.screenshotBytes, findings: findings.length, unmeasured: result.unmeasured });
     return result;
   } catch (error) {
@@ -334,6 +364,7 @@ async function verifyCdpPage(url: string, deps: DeployVerifyDeps): Promise<Deplo
     return {
       ok, url, title, bodyLength, screenshotBytes: buf?.length ?? 0, findings,
       ...(structuredFindings.length ? { structuredFindings } : {}),
+      ...(state?.pendingLazyImages ? { pendingLazyImages: state.pendingLazyImages } : {}),
       ...(unmeasured ? { unmeasured } : {}),
     };
   } catch (e) {
@@ -362,9 +393,9 @@ export function formatVerifyUrlReport(
   const shotNote = shot === undefined ? '' : shot.written ? ` → ${shot.path}` : ` → ⛔ 못 씀(${shot.path})`;
   const lines = [
     `\n━━ 배포 검증: ${url} ━━`,
-    `  ${result.ok ? '✅ 렌더 정상' : '⚠️ 문제 감지'}`,
+    `  ${result.skipped === 'aside-not-running' ? '⚪ Aside 검증 건너뜀' : result.ok ? '✅ 렌더 정상' : '⚠️ 문제 감지'}`,
     `  title: ${result.title || '(없음)'}`,
-    `  본문 길이: ${result.bodyLength ?? '?'} · 스크린샷: ${result.screenshotBytes ?? 0} bytes${shotNote}`,
+    `  본문 길이: ${result.bodyLength ?? '?'} · 스크린샷: ${result.skipped === 'aside-not-running' ? '못 쟀다' : `${result.screenshotBytes ?? 0} bytes`}${shotNote}`,
   ];
   for (const f of result.findings) lines.push(`  - ${f}`);
   // ⛔⭐ 「못 쟀다」는 초록도 빨강도 아닌 «제 칸»이다 — 「없다」로 접지 않는다.

package/src/harness/harness-cli-command.ts

@@ -21,6 +21,7 @@ import { getUserConfig } from '../user-config.js';
 import { installHarnessCliSinkHook } from './harness-cli-sink.js';
 import { resolveHarnessSubstrate, type ResolvedHarnessSubstrate } from './harness-substrate-default.js';
 import { runHarnessPlanRfc } from './harness-plan-rfc.js';
+import { classifyGarbage, isGarbageProcessTarget, type GarbageProcess } from './process-garbage.js';
 import type { MissionSolveOutcome } from './mission-solve-loop.js';
 import { formatAxis, formatAxisObservations, inspectAskMarkers, inspectUnpressedDecisionSignals } from '../../scripts/ask-marker-check.js';
 
@@ -75,6 +76,7 @@ export class HarnessCliInputError extends Error {
   constructor(message: string) {
     super(message);
     this.name = 'HarnessCliInputError';
+    Object.defineProperty(this, Symbol.for('elanous.cli.HarnessCliInputError'), { value: true });
   }
 }
 
@@ -565,6 +567,7 @@ export interface HarnessProcessReport {
   readonly resourceConsuming: readonly HarnessProcessObservationRow[];
   readonly longRunningOnly: readonly HarnessProcessObservationRow[];
   readonly parentUnknown: readonly HarnessProcessObservationRow[];
+  readonly garbage: readonly GarbageProcess[];
 }
 
 export interface HarnessProcessObservationDeps {
@@ -762,16 +765,22 @@ export function buildHarnessProcessReport(
       resourceConsuming: [],
       longRunningOnly: [],
       parentUnknown: [],
+      garbage: [],
     };
   }
   const livePids = new Set(listed.livePids ?? listed.records.map((record) => record.pid));
   const universe = listed.pidUniverse ?? pidUniverse;
+  const garbage = classifyGarbage(listed.records.map((record) => ({
+    ...record,
+    launchd: resolveHarnessProcessLaunchdEvidence(record.pid, launchd),
+  })), { nowMs }).garbage;
   const resourceConsuming: HarnessProcessObservationRow[] = [];
   const longRunningOnly: HarnessProcessObservationRow[] = [];
   const parentUnknown: HarnessProcessObservationRow[] = [];
   let unclassifiedCount = 0;
   let parentPresentCount = 0;
   for (const record of listed.records) {
+    if (!record.command.includes('elanous.mjs')) continue;
     const classification = classifyHarnessProcess(record, thresholds);
     if (classification === undefined) {
       unclassifiedCount += 1;
@@ -811,6 +820,7 @@ export function buildHarnessProcessReport(
       resourceConsuming,
       longRunningOnly,
       parentUnknown,
+      garbage,
     };
   }
   return {
@@ -822,6 +832,7 @@ export function buildHarnessProcessReport(
     resourceConsuming,
     longRunningOnly,
     parentUnknown,
+    garbage,
   };
 }
 
@@ -855,6 +866,13 @@ function renderHarnessProcessRow(row: HarnessProcessObservationRow): string[] {
   ];
 }
 
+function renderGarbageGroup(garbage: readonly GarbageProcess[]): string[] {
+  return [
+    `가비지 ${garbage.length}:`,
+    ...garbage.map((row) => `- pid=${row.pid} ppid=${row.ppid} elapsed=${formatHarnessProcessElapsed(row.elapsedSeconds)} reason=${row.reason} command=${row.command.slice(0, 120)}`),
+  ];
+}
+
 export function renderHarnessProcessReport(report: HarnessProcessReport): string[] {
   const { resourceCpuPercent, longRunningElapsedSeconds } = report.thresholds;
   const lines = [
@@ -868,6 +886,7 @@ export function renderHarnessProcessReport(report: HarnessProcessReport): string
     const failure = report.observationFailure;
     lines.push(`관찰 실패/확인 불가 (${failure?.stage ?? 'ps-exec'}: ${failure?.reason ?? 'unknown observation failure'})`);
     lines.push('자원소비와 장기실행만은 확인하지 않았다 — 빈 관찰이 아니다');
+    lines.push('가비지 확인 불가 — ps 관찰 실패');
     return lines;
   }
   if (report.observationStatus === 'incomplete') {
@@ -877,7 +896,7 @@ export function renderHarnessProcessReport(report: HarnessProcessReport): string
   }
   if (report.excludedCount > 0) {
     lines.push(`모집단 제외 ${report.excludedCount}행`);
-    lines.push('제외 기준: command에 elanous.mjs를 포함하지 않은 행');
+    lines.push('제외 기준: command에 elanous.mjs가 없고 시험 데몬·러너 대상도 아닌 행');
   }
   lines.push(`분류 제외 ${report.unclassifiedCount}행`);
   lines.push(`부모 생존 제외 ${report.parentPresentCount}행`);
@@ -885,11 +904,13 @@ export function renderHarnessProcessReport(report: HarnessProcessReport): string
   if (report.parentUnknown.length > 0) lines.push(`부모 확인 불가 ${report.parentUnknown.length} — 자원소비/장기실행만에 넣지 않았다`);
   const empty = report.resourceConsuming.length === 0 && report.longRunningOnly.length === 0 && report.parentUnknown.length === 0;
   if (empty && report.observationStatus === 'ok') {
-    lines.push('관찰 대상 없음');
+    if (report.garbage.length === 0) lines.push('관찰 대상 없음');
+    lines.push(...renderGarbageGroup(report.garbage));
     return lines;
   }
   if (empty && report.observationStatus === 'incomplete') {
     lines.push('해석된 행 중 분류 대상이 없다 — 빈 관찰이 아니다');
+    lines.push(...renderGarbageGroup(report.garbage));
     return lines;
   }
   if (report.resourceConsuming.length > 0) {
@@ -904,6 +925,7 @@ export function renderHarnessProcessReport(report: HarnessProcessReport): string
     lines.push('부모 확인 불가:');
     for (const row of report.parentUnknown) lines.push(...renderHarnessProcessRow(row));
   }
+  lines.push(...renderGarbageGroup(report.garbage));
   return lines;
 }
 
@@ -944,7 +966,7 @@ function parseHarnessProcessPsLine(line: string): ParsedHarnessProcessPsLine {
   if (!match) return { kind: 'malformed', line: trimmed, pid: parseHarnessProcessPsPid(line) };
   const command = match[5]!.trim();
   const pid = Number(match[1]);
-  if (!command.includes('elanous.mjs')) return { kind: 'excluded', pid };
+  if (!isGarbageProcessTarget(command)) return { kind: 'excluded', pid };
   const elapsedSeconds = parsePsEtime(match[4]!);
   if (elapsedSeconds === undefined) return { kind: 'malformed', line: trimmed, pid };
   return {

package/src/harness/image-load-state.ts

@@ -0,0 +1,21 @@
+export interface ImageLoadState {
+  complete: boolean;
+  naturalWidth: number;
+  loading: string;
+  inViewport: boolean;
+}
+
+/** Shared by Node tests and the injected browser expression. */
+export function classifyImages(images: ImageLoadState[]): { broken: number; pendingLazy: number } {
+  let broken = 0;
+  let pendingLazy = 0;
+  for (const image of images) {
+    if (image.complete && image.naturalWidth === 0) broken++;
+    else if (!image.complete && image.loading === 'lazy' && !image.inViewport) pendingLazy++;
+    else if (!image.complete) broken++;
+  }
+  return { broken, pendingLazy };
+}
+
+/** Executable function source for CDP and aside, without a module import in the page. */
+export const IMAGE_LOAD_STATE_SOURCE = classifyImages.toString();

package/src/harness/process-garbage.ts

@@ -0,0 +1,45 @@
+export interface GarbageProcessRow {
+  readonly pid: number;
+  readonly ppid: number;
+  readonly elapsedSeconds: number;
+  readonly command: string;
+  readonly launchd?: 'managed' | 'no-evidence' | 'unqueried';
+}
+
+export interface GarbageProcess extends Pick<GarbageProcessRow, 'pid' | 'ppid' | 'elapsedSeconds' | 'command'> {
+  readonly reason: 'orphan-test-daemon' | 'orphan-test-runner' | 'orphan-elanous';
+}
+
+const TEST_PATH = /elanous|repo\.worktrees|self-impl|\.elanous-test|gate-baseline/i;
+const TEST_DAEMON = /(?:^|[\s/])daemon\.ts(?:\s|$)/;
+const TEST_RUNNER = /\bbun\s+test\b|\bgate(?:[-\s]baseline|\b)/i;
+const NEXUS_RUN = /\bnexus\s+run\b/;
+const TEST_MARKER = /\.elanous-test|(?:^|\s)--test(?:\s|$)/;
+
+/** A candidate for inspection only; this module never signals or removes a process. */
+export function isGarbageProcessTarget(command: string): boolean {
+  return command.includes('elanous.mjs')
+    || (TEST_DAEMON.test(command) && /elanous-nexus-|\.elanous-test/.test(command))
+    || (TEST_RUNNER.test(command) && TEST_PATH.test(command));
+}
+
+export function classifyGarbage(
+  rows: readonly GarbageProcessRow[],
+  options: { nowMs?: number; minOrphanSeconds?: number } = {},
+): { garbage: GarbageProcess[] } {
+  const minOrphanSeconds = options.minOrphanSeconds ?? 3 * 60 * 60;
+  const garbage: GarbageProcess[] = [];
+  for (const row of rows) {
+    if (row.ppid !== 1 || row.elapsedSeconds < minOrphanSeconds || row.launchd === 'managed') continue;
+    if (!isGarbageProcessTarget(row.command)) continue;
+    if (NEXUS_RUN.test(row.command) && !TEST_MARKER.test(row.command)) continue;
+    const reason: GarbageProcess['reason'] = TEST_DAEMON.test(row.command)
+      && /elanous-nexus-|\.elanous-test/.test(row.command)
+      ? 'orphan-test-daemon'
+      : TEST_RUNNER.test(row.command) && TEST_PATH.test(row.command)
+        ? 'orphan-test-runner'
+        : 'orphan-elanous';
+    garbage.push({ pid: row.pid, ppid: row.ppid, elapsedSeconds: row.elapsedSeconds, command: row.command, reason });
+  }
+  return { garbage };
+}

package/src/index.ts

@@ -62,6 +62,7 @@ import { registerModelWatchCommand } from './cli/model-watch-cli.js';
 import { registerIntakeCommands } from './cli/intake-cli.js';
 import { registerTasksCommands } from './cli/tasks-cli.js';
 import { registerLabelsCommands } from './cli/labels-cli.js';
+import { registerMsgCommands } from './cli/msg-cli.js';
 import { registerDoctorCommand } from './cli/doctor-cli.js';
 import { registerProviderCommands } from './cli/provider-cli.js';
 export { buildCodexAccountImportGuidance, setCodexAccountLogSinkModuleForTesting } from './cli/provider-cli.js';
@@ -74,6 +75,7 @@ import { registerGraphCommands } from './graph-runner/graph-cli.js';
 import { registerLoopCommands } from './loops/loop-cli.js';
 import { registerCardCommand } from './task-cards/card-cli.js';
 import { registerLaunchHeadCommands } from './launch-head/launch-head-cli.js';
+import { acpServerHelpText } from './boot/acp-server-help.js';
 // IMPORTANT: parse `--config-dir <dir>` + `--test-state-dir <dir>`
 // BEFORE Commander loads — the resolvers are read at module-init
 // time by several config-touching imports below, so the override
@@ -95,7 +97,8 @@ import type { AdPipelinePlan, AdPipelineResult } from './ad-pipeline/run.js';
 import type { AcpPermissionApprover } from './acp/client.js';
 import { runGitCommand } from './git-fs/runner.js';
 import { debug, redactSecretText, redactSecrets } from './debug/log.js';
-import { HarnessCliInputError, installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
+import { installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
+import { formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
 import { dispatchSolveMission } from './skills/tools/solve-mission.js';
 import { performBrowserAction, type BrowserActionDeps, type BrowserActionResult } from './harness/browser-act.js';
 import { decideTypeAction, type TypeActionDecision, type TypeTarget } from './harness/browser-act-type.js';
@@ -152,7 +155,7 @@ async function readStdinLine(prompt: string = ''): Promise<string> {
   finally { rl.close(); }
 }
 import { loginWithCodex, CODEX_DEVICE_LOGIN_URL } from './oauth/codex.js';
-import { authStorePath, loadTokens, deleteTokens, listProviders as listAuthProviders } from './oauth/store.js';
+import { authStorePath, loadTokens, deleteTokens, saveTokens, listProviders as listAuthProviders, type CodexMirrorResult } from './oauth/store.js';
 import { renderKeyHelp, CONTEXT_LABELS, type KeyContext } from './keybindings.js';
 import { auditKeybindings, renderKeymapAudit } from './keymap-audit.js';
 import { runCodexSetup } from './codex/setup.js';
@@ -164,6 +167,7 @@ import { initSessionWorkingDir } from './session/working-dir.js';
 import { rewriteBareNexusToStatus } from './cli/nexus-entry.js';
 import { registerIngestTokenCommands } from './cli/ingest-token-cli.js';
 import { registerMcpGatewayCommands } from './cli/mcp-gateway-cli.js';
+import { registerRelayCommand } from './relay/relay-cli.js';
 import type { ReviewImage } from './agent-substrate/pr-reviewer.js';
 import {
   describeMissionRouting,
@@ -864,6 +868,14 @@ registerDoctorCommand(program);
 registerControlCommands(program);
 registerHooksCommands(program);
 registerSetupCommand(program);
+program.commands.find(command => command.name() === 'setup')!
+  .option('--terminal', 'Run the terminal onboarding wizard')
+  .hook('preAction', async (_command, action) => {
+    if (action.name() === 'setup' && action.opts().terminal) {
+      const completed = await runOnboardingForCli();
+      process.exit(completed ? 0 : (process.exitCode || 2));
+    }
+  });
 registerStartCommand(program);
 registerGroundingSourcesCli(program);
 registerGraphCommands(program);
@@ -905,6 +917,10 @@ marketCmd.command('publish').description('Publish a local signed marketplace ind
         console.log(`Published ${result.published.length} plugins (sequence ${result.sequence}); skipped ${result.skipped.length}`);
         for (const warning of result.warnings) console.warn(`⚠ ${warning.dir}: ${warning.graph} uses recipes it does not ship (${warning.recipes.join(', ')}) — third-party graphs should use their own recipes.yaml or custom nodes`);
       }
+      for (const item of result.skipped) {
+        for (const hit of item.hits ?? []) console.error(`${item.dir}/${hit.file}:${hit.line}: ${hit.marker}`);
+      }
+      if (!result.ok) process.exitCode = 1;
     } catch (error) {
       console.error(`market publish: ${error instanceof Error ? error.message : 'failed'}`);
       process.exitCode = 1;
@@ -1002,7 +1018,7 @@ program.command('self-update')
 
 program
   .name('elanous')
-  .description('TUI skill runner — Yazi-style 3-pane + multi-LLM, with remote sync, smart diff, and SQLite logging')
+  .description('말 한 줄로 시작: elanous harness say "…" — 끝까지 간다 · 다 보인다 · 스스로를 만들었다')
   .version(cliVersion())
   // Documentation-only entry — the flag is extracted from argv by
   // `applyConfigDirFlagFromArgv` at module init (above) so Commander
@@ -1028,6 +1044,7 @@ program
     '--test',
     '격리 테스트 인스턴스로 실행 — cwd 의 git 트리(worktree 포함)에서 `<트리>/.elanous-test` 를 루트로 잡고 state·config 두 축을 함께 격리한다. config 사본이 없으면 자동 물질화. `--test=<dir>` 로 루트 직접 지정 가능(값 문법은 `=` 형태 하나 — 모호함 없음). ELANOUS_STATE_DIR/--config-dir 을 손으로 줄 필요가 없다.',
   );
+program.addHelpText('after', acpServerHelpText());
 
 program
   .command('measure-fabric-arc-ab')
@@ -1076,6 +1093,8 @@ const mcpCmd = program
   .description('MCP (Model Context Protocol) server / client integration');
 registerMcpGatewayCommands(mcpCmd);
 
+registerRelayCommand(program);
+
 mcpCmd
   .command('serve')
   .description('Run a stdio MCP server exposing the configured mcp.servers as proxy tools (used by `claude mcp add elanous -- elanous mcp serve`)')
@@ -2952,6 +2971,9 @@ const harnessOrchestrateCmd = registerHarnessOrchestrateCapabilityOptions(
 
 const selfCmd = program.command('self').description('Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상');
 
+// M12 Claude Code 의존도 계기판 — `elanous self dependence [--since] [--until] [--json]`(읽기만).
+{ const { registerDependenceCommand } = await import('./cli/dependence-gauge.js'); registerDependenceCommand(selfCmd); }
+
 function printExtendedOrchestrateHelp(command: Command, positional = '[goals...]'): void {
   const optionLines = command.options
     .filter((option) => option.long !== '--help-all')
@@ -7019,6 +7041,7 @@ missionCmd
 
 registerTasksCommands(program);
 registerLabelsCommands(program);
+registerMsgCommands(program);
 
 // ── ask alias (script-friendly one-shot query) ──
 program
@@ -7027,7 +7050,28 @@ program
   .option('--reuse', 'Reuse the active CLI session instead of creating a new one')
   .option('--session <id>', 'Continue an explicit session (id or unique prefix). Overrides --reuse and active session.')
   .option('--json', 'Emit a single JSON line {sessionId, provider, model, reply, logPath, budget} instead of streaming text + ui.info trailer. Stable shape for LLM self-spawn.')
-  .action(async (parts: string[], opts: { reuse?: boolean; session?: string; json?: boolean }) => {
+  .option('--bare', 'Send only this text to the model: no Elanous preamble, project tree, memory, tools or session')
+  .action(async (parts: string[], opts: { reuse?: boolean; session?: string; json?: boolean; bare?: boolean }) => {
+    if (opts.bare) {
+      try {
+        const { askBare } = await import('./cli/ask-bare.js');
+        const llm = await import('./llm.js');
+        const { getUserConfig } = await import('./user-config.js');
+        const { trimToBudget } = await import('./tokens.js');
+        const result = await askBare({ text: parts.join(' '), deps: {
+          getUserConfig, decideProviderForConfig: llm.decideProviderForConfig, getProviderForConfig: llm.getProviderForConfig,
+          streamLLM: llm.streamLLM, trimToBudget,
+        } });
+        if (opts.json) process.stdout.write(JSON.stringify({ sessionId: null, ...result, logPath: null, budget: null, bare: true }) + '\n');
+        else process.stdout.write(result.reply.endsWith('\n') ? result.reply : `${result.reply}\n`);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (opts.json) process.stdout.write(JSON.stringify({ error: message, bare: true }) + '\n');
+        else console.error(`ask --bare failed: ${message}`);
+        process.exitCode = 1;
+      }
+      return;
+    }
     const cfg = reloadUserConfig();
     await runChatTurnCli({
       cfg,
@@ -7193,9 +7237,13 @@ program
   });
 
 // ── login (provider OAuth) ──
-export function codexLoginSuccessMessage(mirrorResult?: 'written' | 'not-created-missing-cli-fields' | 'write-failed'): string {
+export function codexLoginSuccessMessage(mirrorResult?: CodexMirrorResult): string {
   const prefix = `Signed in. Tokens at ${authStorePath()}.`;
   if (mirrorResult === 'written') return `${prefix} Mirrored to ~/.codex/auth.json.`;
+  if (mirrorResult === 'skipped-different-account') {
+    return `${prefix} Your Codex CLI login (~/.codex/auth.json) belongs to a different account — left unchanged. To switch it, run \`elanous login openai-codex --replace-codex-cli-login\`.`;
+  }
+  if (mirrorResult === 'skipped-unknown-account') return `${prefix} Codex CLI login left unchanged.`;
   if (mirrorResult === 'not-created-missing-cli-fields') {
     return `${prefix} Codex CLI mirror was not created because this login response lacked its required fields; run \`codex login\` once to initialize ~/.codex/auth.json.`;
   }
@@ -7208,7 +7256,8 @@ const loginCmd = program.command('login').description('Authenticate to an LLM pr
 loginCmd
   .command('openai-codex')
   .description('Sign in to OpenAI Codex via the ChatGPT device-code flow')
-  .action(async () => {
+  .option('--replace-codex-cli-login', 'if the Codex CLI (~/.codex/auth.json) is signed in to a different account, replace it with this login')
+  .action(async (opts: { replaceCodexCliLogin?: boolean }) => {
     ui.header('OpenAI Codex — device-code sign-in');
     try {
       const state = await loginWithCodex({
@@ -7233,7 +7282,21 @@ loginCmd
           }
         },
       });
-      ui.info(codexLoginSuccessMessage(state.codexMirrorResult));
+      // AUTH1 — another account's Codex CLI login is left alone unless the user says to replace it.
+      let mirrorResult = state.codexMirrorResult;
+      if (mirrorResult === 'skipped-different-account') {
+        let replace = opts.replaceCodexCliLogin === true;
+        if (!replace && process.stdin.isTTY && process.stdout.isTTY) {
+          const { createInterface } = await import('node:readline/promises');
+          const rl = createInterface({ input: process.stdin, output: process.stdout });
+          try {
+            const answer = await rl.question('  Your Codex CLI (~/.codex/auth.json) is signed in to a different account. Replace it with this login? [y/N] ');
+            replace = /^y(es)?$/i.test(answer.trim());
+          } finally { rl.close(); }
+        }
+        if (replace) mirrorResult = saveTokens('openai-codex', state.tokens, { replaceDifferentCodexAccount: true }).codexMirrorResult;
+      }
+      ui.info(codexLoginSuccessMessage(mirrorResult));
       ui.info(`Expires in ~${state.tokens.expiresAt ? Math.round((state.tokens.expiresAt - Date.now()) / 60000) : '?'}min; auto-refresh on next use.`);
     } catch (err: any) {
       ui.error(`login failed: ${err?.message ?? err}`);
@@ -7821,6 +7884,15 @@ sessionCmd
     console.log(res.formatted ?? '(no context)');
   });
 
+async function runFirstSetupForCli(cfg: ReturnType<typeof getUserConfig>, announceFallback = false): Promise<boolean> {
+  if (cfg.onboarding.webFirst === true) {
+    const { runWebFirstSetup } = await import('./onboarding/web-first.js');
+    if (await runWebFirstSetup({ config: cfg }) === 'link-shown') return false;
+    if (announceFallback) ui.info('No config yet — launching setup wizard first.');
+  }
+  return runOnboardingForCli();
+}
+
 async function runOnboardingForCli(): Promise<boolean> {
   try {
     await runOnboarding();
@@ -7856,8 +7928,8 @@ program
     if (opts.tools) announceChatToolsCompatibility();
     const cfg = getUserConfig();
     if (needsOnboarding(cfg)) {
-      ui.info('No config yet — launching setup wizard first.');
-      if (!await runOnboardingForCli()) return;
+      if (cfg.onboarding.webFirst !== true) ui.info('No config yet — launching setup wizard first.');
+      if (!await runFirstSetupForCli(cfg, true)) return;
     }
     const refreshed = reloadUserConfig();
     // ★ 관측갭 수리(2026-07-21·제1원칙·트랙A) — self-implement 자식 goal-loop(`chat --goal-loop`)은 데몬과
@@ -7923,8 +7995,8 @@ program
     }
     const cfg = getUserConfig();
     if (needsOnboarding(cfg)) {
-      ui.info('No config yet — launching setup wizard first.');
-      if (!await runOnboardingForCli()) return;
+      if (cfg.onboarding.webFirst !== true) ui.info('No config yet — launching setup wizard first.');
+      if (!await runFirstSetupForCli(cfg, true)) return;
     }
     const refreshed = reloadUserConfig();
     const { runRepl } = await import('./repl/index.js');
@@ -10597,7 +10669,7 @@ async function main(): Promise<void> {
   // gates on config completeness — no entry-mode branch.)
   const cfg = getUserConfig();
   if (needsOnboarding(cfg)) {
-    if (!await runOnboardingForCli()) return;
+    if (!await runFirstSetupForCli(cfg)) return;
   }
 
   // Active-provider banner so users know WHICH model/auth is about to
@@ -10681,8 +10753,8 @@ async function main(): Promise<void> {
 export function runCli(): void {
   main().catch((err) => {
     closeTui();
-    if (err instanceof HarnessCliInputError) {
-      console.error(`❌ ${err.message}`);
+    if (isCliUserError(err)) {
+      console.error(formatCliUserError(err));
       process.exit(1);
     }
     throw err;