elanous 0.2.24 → 0.2.25

package/src/grok.ts

@@ -14,7 +14,8 @@
 import type { GrokAnalysis, DiffResult, EnvDelta } from './types.js';
 import * as ui from './ui.js';
 import { getUserConfig } from './user-config.js';
-import { getProviderForConfig, anyProviderAvailable, textOnly, type LLMMessage } from './llm.js';
+import { getProviderForConfig, anyProviderAvailable, logAgentTurnUsage, type LLMMessage } from './llm.js';
+import type { LLMUsage } from './prompt-cache/types.js';
 
 /** True when any provider (env OR user-config, including Codex OAuth)
  *  can answer. Thin wrapper around llm.anyProviderAvailable() kept
@@ -34,19 +35,24 @@ async function callAnalyzer(prompt: string, systemPrompt?: string): Promise<stri
   if (systemPrompt) messages.push({ role: 'system', content: systemPrompt });
   messages.push({ role: 'user', content: prompt });
 
-  const events = provider.streamChat
-    ? provider.streamChat(messages, { temperature: 0.1, maxTokens: 1024 })
-    : null;
+  const llmOpts = { temperature: 0.1, maxTokens: 1024 };
   let text = '';
-  if (events) {
-    for await (const delta of textOnly(events)) text += delta;
+  let usage: LLMUsage = {};
+  if (provider.streamChat) {
+    for await (const ev of provider.streamChat(messages, llmOpts)) {
+      if (ev.type === 'text' && ev.delta) text += ev.delta;
+      else if (ev.type === 'usage') usage = { ...usage, ...ev.usage };
+    }
   } else {
     // Fallback to text-only chat (shouldn't happen — every provider
     // ships streamChat now).
-    for await (const chunk of provider.chat(messages, { temperature: 0.1, maxTokens: 1024 })) {
+    for await (const chunk of provider.chat(messages, llmOpts)) {
       text += chunk;
     }
   }
+  try {
+    logAgentTurnUsage(provider.defaultModel, usage, { providerName: provider.name, site: 'grok.direct' });
+  } catch { /* best-effort observation */ }
   return text;
 }
 

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

@@ -19,11 +19,12 @@ import { Command, Option } from 'commander';
 import { runGitCommand } from '../git-fs/runner.js';
 import { GOAL_TYPES, lintGoalFile, parseGoalId, parseGoalType, resolveGoalAuthorGrade, tracedPathReferences, type GoalAuthorGrade, type GoalAuthorGradeSelection, type GoalType } from '../self-implement/goal-author.js';
 import { templateForGoalType } from '../self-implement/graph-templates.js';
-import { listRunLedgers, loadFederatedRunLedger, loadRunLedger, queryRunScreenKey, runLedgerDir, type RunLedgerMatch } from '../self-implement/run-ledger.js';
+import { appendRunLedgerEntry, listRunLedgers, loadFederatedRunLedger, loadRunLedger, queryRunScreenKey, runLedgerDir, type RunLedgerEntry, type RunLedgerMatch, type RunLedgerWriter } from '../self-implement/run-ledger.js';
+import { classifyPodExit, type PodExitClass } from '../task-orchestrator/surfaces/pod-failure-reason.js';
 import { classifyPodExitStop, recordRunStop, runStopRecorded, RUN_STOP_EVENT } from '../self-implement/run-stop.js';
 import { ensureOpenRouterChildModelLive, resolveChildLlmEffort, resolveImplementationChildModel } from '../self-dev/dev-cli.js';
 import { resolveHarnessTarget } from '../self-implement/harness-target-options.js';
-import { buildRunProgressRows, queryRunningRuns, renderRunProgressTable } from '../self-implement/running-runs.js';
+import { buildRunProgressRows, isPartialRunningRuns, queryRunningRuns, renderRunProgressTable } from '../self-implement/running-runs.js';
 import { DevPipelineError } from '../self-dev/dev-pipeline.js';
 import { collectDraftMetrics, collectOverlapMetrics, DRAFT_SWEEP_CONCURRENCY, mapBounded, resolveDraftSweepCloseCap, runDraftSweep, sweepFailureReason, type DraftSweepAdapters, type DraftSweepResult, type OverlapMetricAdapters, type SweepDraft, type SweepMergedPr, type SweepReviewGate } from '../self-dev/draft-sweep.js';
 import { readAskPreflightRowsSince, readSalvagedRowsSince } from '../self-dev/ask-launch-io.js';
@@ -34,11 +35,10 @@ import { debug } from '../debug/log.js';
 import { installHarnessSalvageCommand, installHarnessSalvageRetentionCommand } from './harness-salvage-cli.js';
 import { decideNestedElanousLaunch, readNestedElanousDepth } from './nested-elanous-policy.js';
 import { dispatchTask, type DispatchTaskInput, type DispatchTaskDeps } from '../execution-loop/dispatch-task.js';
-import { launchRequestId, preLaunchGate, type PreLaunchGateDeps } from '../execution-loop/launch-gate.js';
+import { harnessLaunchBudgetDecision, launchRequestId, preLaunchGate, resolveLaunchBudget, type PreLaunchGateDeps } from '../execution-loop/launch-gate.js';
 import { PR_LABELS } from '../github/pr-labels.js';
 import { ghAutomationEnv } from '../autopilot/pr-manager.js';
-import { CODEX_PROVIDER, GROK_PROVIDER, decideBudget, decideLaunchBudget, readBudgetInputsLive, type BudgetDecision, type BudgetInputs } from '../self-implement/budget-gate.js';
-import { DEFAULT_FALLBACK_CHAIN } from '../oauth/fallback-chain.js';
+import { decideBudget, readBudgetInputsLive, type BudgetDecision, type BudgetInputs } from '../self-implement/budget-gate.js';
 import { installDeliverableVerifyCliCommand, type InstallDeliverableVerifyCliDeps } from './deliverable-verify-cli.js';
 import { getUserConfig } from '../user-config.js';
 import type { SiblingResyncAdapters, SiblingResyncResult, SiblingRunTarget } from '../self-implement/sibling-resync.js';
@@ -701,7 +701,7 @@ async function onPod(opts: unknown, entrance: 'cli-harness-ask' | 'cli-harness-s
     const classified = classifyHarnessPodExit({ status }, output, { ...(runId ? { runId } : {}) });
     recordClassifiedHarnessPodExit(runId ?? harnessPodRunId(output), classified.reason, status,
       { entrance, seat: o.seat, output });
-    recordHarnessPodStop(runId ?? harnessPodRunId(output), status, classified);
+    recordHarnessPodStop(runId ?? harnessPodRunId(output), status, classified, output);
     for (const line of classified.lines) console.error(line);
     process.exitCode = status;
   }
@@ -716,25 +716,62 @@ export function recordHarnessPodStop(
   runId: string | undefined,
   status: number,
   classified: { reason: string; lines: string[] },
-  deps: { loadLedger?: typeof loadRunLedger; record?: typeof recordRunStop } = {},
+  output?: string,
+  deps: { loadLedger?: typeof loadRunLedger; record?: typeof recordRunStop; write?: RunLedgerWriter } = {},
 ): boolean {
   if (!runId) return false;
   try {
     if (runStopRecorded(runId)) return false;
     if ((deps.loadLedger ?? loadRunLedger)(runId)?.some((entry) => entry.event === RUN_STOP_EVENT)) return false;
+    const nextMove = classified.reason === 'no-launch' ? 'Check Pod launch gate and pool, then relaunch'
+      : 'Inspect Pod exit classification and harvest the branch before relaunch';
+    const evidenceRef = `logs:harness.pod/exit-classified:${runId}`;
+    // AUT-POD-EXIT-UNCLASSIFIED ⓑ — only an unclassified exit reads the child output; classified reasons stay byte-identical.
+    const detail = classified.reason === 'unknown' ? podExitDetail(runId, status, output) : undefined;
+    if (detail) {
+      const write = deps.write ?? ((entry: RunLedgerEntry) => appendRunLedgerEntry(entry));
+      (deps.record ?? recordRunStop)({
+        runId, site: 'pod-exit', class: classifyPodExitStop(classified.reason),
+        cause: `Pod exit ${status}: ${detail.podExitClass}${detail.lead ? ` — ${detail.lead}` : ''}`,
+        evidenceRef, nextMove,
+      }, (entry) => write({ ...entry, data: { ...entry.data, podExitClass: detail.podExitClass, tail: detail.tail } }));
+      return true;
+    }
     // The classified line is our own one-line verdict («Pod 안 자식이 실패했다 — OOMKilled»), not the raw output tail.
     const verdict = classified.lines[0]?.split(' — ').slice(1).join(' — ').trim();
     (deps.record ?? recordRunStop)({
       runId, site: 'pod-exit', class: classifyPodExitStop(classified.reason),
       cause: `Pod exit ${status}: ${classified.reason}${verdict ? ` — ${verdict}` : ''}`,
-      evidenceRef: `logs:harness.pod/exit-classified:${runId}`,
-      nextMove: classified.reason === 'no-launch' ? 'Check Pod launch gate and pool, then relaunch'
-        : 'Inspect Pod exit classification and harvest the branch before relaunch',
-    });
+      evidenceRef, nextMove,
+    }, ...(deps.write ? [deps.write] : []));
     return true;
   } catch { return false; /* ledger observation cannot change Pod output or exit */ }
 }
 
+const POD_EXIT_TAIL_LINES = 5;
+const POD_EXIT_TAIL_LINE_CHARS = 240;
+const POD_EXIT_CAUSE_LEAD_CHARS = 160;
+
+/**
+ * The closed Pod exit class ⊕ the last meaningful output lines for an exit the host could not classify.
+ * Empty output is no evidence at all — `unknown` with an empty tail, never a guess. Fail-soft: a throw reads as `unknown`.
+ */
+function podExitDetail(runId: string, status: number, output: string | undefined): { podExitClass: PodExitClass; tail: string[]; lead: string } {
+  let podExitClass: PodExitClass = 'unknown';
+  let tail: string[] = [];
+  if (output?.trim()) {
+    try {
+      const exit = classifyPodExit({ logs: output, containerExitCode: status });
+      podExitClass = exit.class;
+      tail = exit.tail.slice(-POD_EXIT_TAIL_LINES).map((line) => Array.from(line).slice(0, POD_EXIT_TAIL_LINE_CHARS).join(''));
+    } catch { podExitClass = 'unknown'; tail = []; }
+  }
+  // The last meaningful line is where the child died (`Error: ENOSPC …`) — earlier tail lines are context.
+  const lead = Array.from(tail.at(-1) ?? '').slice(0, POD_EXIT_CAUSE_LEAD_CHARS).join('');
+  try { debug.log('harness.pod', 'exit-classified-detail', { runId, podExitClass, tailLines: tail.length }); } catch { /* observation is fail-soft */ }
+  return { podExitClass, tail, lead };
+}
+
 /**
  * POD-ANTHROPIC-PROVIDER ⓓ — 발사 관문과 Pod 가 «한 목록»(`POD_CHILD_PROVIDERS`)을 본다.
  * 🩸 10-10: 관문은 anthropic 을 «예산 판정 밖» 으로 통과시켰고 Pod 단계가 rc=2 로 죽었다(관문·Pod 목록 엇갈림).
@@ -754,39 +791,7 @@ function refusePodChildProviderBeforeLaunch(resolved: ResolvedHarnessSubstrate,
   return true;
 }
 
-const LAUNCH_BUDGET_PROVIDER: Readonly<Record<string, string>> = { 'codex-rotate': CODEX_PROVIDER, grok: GROK_PROVIDER };
-
-/**
- * L6 발사 관문의 예산 입력 보정 — 발사 우주의 config 에 체인이 없으면(작업 트리 = 시험 우주) 막지 않고
- * 코드 기본 체인으로 판단한다. `--child-llm-provider` 를 명시했으면 그것이 체인이다(예산 판정 밖 provider 는 통과).
- */
-export function harnessLaunchBudgetDecision(
-  inputs: BudgetInputs,
-  opts: { readonly childLlmProvider?: string; readonly childLlmModel?: string } = {},
-): { readonly decision: BudgetDecision; readonly warning?: string; readonly unmeasuredProvider?: string } {
-  const explicit = opts.childLlmProvider?.trim();
-  const judged = (selected: BudgetInputs) => {
-    const { decision, unmeasuredProvider } = decideLaunchBudget(selected);
-    return { decision, ...(unmeasuredProvider ? { unmeasuredProvider, warning: `budget: ${unmeasuredProvider} usage unmeasured — launching` } : {}) };
-  };
-  if (explicit) {
-    if (explicit !== CODEX_PROVIDER && explicit !== GROK_PROVIDER) {
-      return {
-        decision: { action: 'proceed', provider: explicit, ...(opts.childLlmModel ? { model: opts.childLlmModel } : {}), reasons: [`${explicit}: 명시 provider — 예산 판정 밖`] },
-        warning: `budget: ${explicit} is outside the budget gate — launched as requested`,
-      };
-    }
-    const chain = [{ provider: explicit, ...(opts.childLlmModel ? { model: opts.childLlmModel } : {}) }];
-    return judged({ ...inputs, preference: { ...inputs.preference, chain } });
-  }
-  if (inputs.preference.chain.length > 0) return judged(inputs);
-  const chain = DEFAULT_FALLBACK_CHAIN.map((step) => ({ provider: LAUNCH_BUDGET_PROVIDER[step] ?? step }));
-  const result = judged({ ...inputs, preference: { ...inputs.preference, chain } });
-  return {
-    ...result,
-    warning: `budget: no chain in this universe's config — judged with the code default ${DEFAULT_FALLBACK_CHAIN.join(',')}${result.warning ? ` · ${result.warning}` : ''}`,
-  };
-}
+export { harnessLaunchBudgetDecision } from '../execution-loop/launch-gate.js';
 
 async function readHarnessLaunchBudget(
   opts: { readonly childLlmProvider?: string; readonly childLlmModel?: string } = {},
@@ -1036,8 +1041,12 @@ async function dispatchHarnessAskSay(
     }
     enterJourneyNode('launch-gate', journey);
     const decision = await withJourneyNode('launch-gate', journey, async () => {
-      const budget = await (gate.readBudget ?? (() => readHarnessLaunchBudget(opts)))();
-      return preLaunchGate({ goalId, budget, forceLaunch: opts.forceGate === true }, gate);
+      const { budget, budgetSource, snapshotAgeSec } = await resolveLaunchBudget({
+        provider: opts.childLlmProvider,
+        measureLocal: gate.readBudget ?? (() => readHarnessLaunchBudget(opts)),
+        env: gate.readBudget ? { ELANOUS_SUBSTRATE: 'local' } : process.env,   // an injected budget reader is a host measurement, whatever substrate runs the test
+      });
+      return preLaunchGate({ goalId, budget, budgetSource, ...(snapshotAgeSec !== undefined ? { snapshotAgeSec } : {}), forceLaunch: opts.forceGate === true }, gate);
     });
     exitJourneyNode('launch-gate', { ...journey, outcome: decision.action === 'proceed' ? 'pass' : 'refuse', data: { action: decision.action } });
     if (decision.action !== 'proceed') {
@@ -3195,7 +3204,7 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
         const nowMs = (deps.progress?.nowMs ?? Date.now)();
         if (opts.json) {
           console.log(JSON.stringify(buildRunProgressRows(result, nowMs)));
-          if (result.completeness === 'partial') console.error(renderRunProgressTable(result, nowMs).split('\n')[0]);
+          if (isPartialRunningRuns(result)) console.error(renderRunProgressTable(result, nowMs).split('\n')[0]);
         } else console.log(renderRunProgressTable(result, nowMs));
       } catch (error) {
         console.error(humanErrorLine(error));

package/src/harness/harness-stop.ts

@@ -3,10 +3,12 @@
 // 🩸 2026-09-27: 멈추려면 사람이 PID 둘(harness ask 부모 · self orchestrate 자식)과 Job 이름을 손으로 찾아야 했고,
 //   그 사이 떠 있던 조각이 main 에 병합됐다(#21048). 부모를 죽이면 자식이 PPID 1 고아로 2h36m 더 돌았다(🅞 보고).
 // B 조각(#21171)이 오케스트레이터에 `self-dev-runs/<runId>/pid.json` ⊕ SIGTERM 정리(새 잡 멈춤 · 자기 Job 삭제 · cancelled)를 넣었다.
-// 이 파일은 그 기록과 런 원장·프로세스 표를 읽고, 시작 시각이 확인된 후보에만 신호를 보내며, `elanous.run=<runId>` 라벨 Job 을 지운다.
+// 이 파일은 그 기록과 런 원장·프로세스 표를 읽고, 시작 시각이 확인된 후보에만 신호를 보내며, 라벨 일치 Pod Job 을 지운다.
 //
 // ⛔ 불변식: 기록된 시작 시각과 실제 프로세스 시작 시각이 다르면 신호를 보내지 않는다(PID 재사용 방지).
-// ⛔ 불변식: `elanous.run=<runId>` 라벨이 붙은 Job 만 지운다.
+// ⛔ 불변식: 라벨이 붙은 Job 만 지운다 — `elanous.run=<runId>` · 그 라벨이 0 이면 `elanous.child-run=<runId>` 폴백(자식 런 id 로 쳤을 때).
+//   지우는 것은 라벨 일치 Job 뿐이다: 이름 추측 없음 · Pod 직접 삭제 없음 · namespace 기본값(elanous-test) 불변.
+//   (HARNESS-STOP-POD-LABEL 2026-10-11) 문맥마다 삭제 결과를 넷으로 가르고 관측 `harness.stop` `job-delete`(context·outcome·matchedBy) 로 남긴다.
 // ⛔ 불변식: 짧은 runId 의 후보가 둘 이상이면 프로세스 신호·Job 삭제 전에 중단한다.
 
 import { existsSync, readdirSync, readFileSync, readlinkSync } from 'node:fs';
@@ -151,6 +153,19 @@ export interface HarnessStopDeps {
   graceMs: number;
 }
 
+export type HarnessStopJobMatchedBy = 'elanous.run' | 'elanous.child-run';
+
+/**
+ * 문맥 하나의 Pod Job 삭제 결과(HARNESS-STOP-POD-LABEL) — «0개 지움» 의 종류를 가른다.
+ *   deleted N — 라벨 일치 Job N 개 삭제 · none — 두 라벨 다 Job 0(진짜 없음 · Pod 생성 전 등)
+ *   unreachable — kubectl 실패(그 0 을 진짜 0 으로 믿을 수 없다) · pods-only — Job 0 인데 같은 라벨 Pod 잔존
+ */
+export type HarnessStopJobDelete =
+  | { context: string; outcome: 'deleted'; matchedBy: HarnessStopJobMatchedBy; deleted: number }
+  | { context: string; outcome: 'none'; matchedBy: null; deleted: 0 }
+  | { context: string; outcome: 'unreachable'; matchedBy: null; deleted: 0; error: string }
+  | { context: string; outcome: 'pods-only'; matchedBy: null; deleted: 0; podsRemaining: number };
+
 export interface HarnessStopResult {
   runId: string;
   givenRunId?: string;
@@ -161,6 +176,8 @@ export interface HarnessStopResult {
   pidRecordFound: boolean;
   dryRun: boolean;
   jobsDeleted: number;
+  /** 문맥별 Job 삭제 분류 — 출력 한 줄과 `--json` 의 근원. */
+  jobDeletes: HarnessStopJobDelete[];
   contexts: string[];
 }
 
@@ -231,6 +248,56 @@ export function defaultHarnessStopDeps(overrides: Partial<HarnessStopDeps> = {},
   };
 }
 
+/** Pod Job 라벨 — `elanous.run` = 부모(오케스트레이터) 런 id · `elanous.child-run` = 자식 런 id(self-implement-pod podRunLabels). */
+const POD_JOB_LABELS = ['elanous.run', 'elanous.child-run'] as const;
+
+/** `kubectl get -o name` 출력에서 `<prefix>` 로 시작하는 줄 수를 센다. */
+function countOutputLines(stdout: string, prefix: string): number {
+  return stdout.split('\n').filter((line) => line.startsWith(prefix)).length;
+}
+
+/**
+ * `kubectl delete job -o name` 출력에서 삭제된 Job 줄 수를 센다.
+ * `-o name` 출력은 `job.batch/<name>` 한 줄씩이지만, 일부 kubectl 버전·설정에서는
+ * `job.batch "<name>" deleted` 꼴도 나타난다(#26194). 두 꼴을 모두 센다.
+ */
+function countDeletedJobLines(stdout: string): number {
+  return stdout.split('\n').filter((line) => /^job\.batch(?:\/|\s+")/.test(line.trim())).length;
+}
+
+/** 문맥 하나의 Pod Job 삭제 — 결과를 넷(deleted·none·unreachable·pods-only)으로 가르고 문맥마다 관측 `harness.stop` `job-delete` 를 남긴다. */
+function deleteRunPodJobs(deps: HarnessStopDeps, runId: string, context: string): HarnessStopJobDelete {
+  const unreachable = (stderr: string): HarnessStopJobDelete => {
+    const error = stderr.slice(0, 200);
+    debug.log('harness.stop', 'job-delete', { runId, context, outcome: 'unreachable', matchedBy: null, error }, { level: 'warn' });
+    return { context, outcome: 'unreachable', matchedBy: null, deleted: 0, error };
+  };
+  // ① `elanous.run=<runId>` — 0 이면 `elanous.child-run=<runId>` 로 한 번 더 고른다(자식 런 id 로 쳤을 때). 지우는 것은 라벨 일치 Job 뿐이다.
+  for (const label of POD_JOB_LABELS) {
+    // `-o name` → «job.batch/<name>» 한 줄씩. 맨 출력은 «job.batch "<name>" deleted» 라 «job.batch/» 로만 세면
+    //   지워도 늘 0 이었다(10-11 · 여섯 번 «0개 지움» 뒤 Pod Terminating). 두 꼴을 다 센다(#26194).
+    const r = deps.kubectl(['--context', context, '-n', deps.namespace, 'delete', 'job', '-l', `${label}=${runId}`, '--wait=false', '-o', 'name']);
+    if (r.status !== 0) return unreachable(r.stderr);
+    const deleted = countDeletedJobLines(r.stdout);
+    if (deleted > 0) {
+      debug.log('harness.stop', 'job-delete', { runId, context, outcome: 'deleted', matchedBy: label, deleted });
+      return { context, outcome: 'deleted', matchedBy: label, deleted };
+    }
+  }
+  // ② 두 라벨 다 Job 0 — 같은 라벨 Pod(`get pods -l <라벨>=<runId>`)로 none 과 pods-only 를 가른다. Pod 는 직접 지우지 않는다.
+  for (const label of POD_JOB_LABELS) {
+    const p = deps.kubectl(['--context', context, '-n', deps.namespace, 'get', 'pods', '-l', `${label}=${runId}`, '-o', 'name']);
+    if (p.status !== 0) return unreachable(p.stderr);
+    const podsRemaining = countOutputLines(p.stdout, 'pod/');
+    if (podsRemaining > 0) {
+      debug.log('harness.stop', 'job-delete', { runId, context, outcome: 'pods-only', matchedBy: null, podsRemaining });
+      return { context, outcome: 'pods-only', matchedBy: null, deleted: 0, podsRemaining };
+    }
+  }
+  debug.log('harness.stop', 'job-delete', { runId, context, outcome: 'none', matchedBy: null });
+  return { context, outcome: 'none', matchedBy: null, deleted: 0 };
+}
+
 export async function stopHarnessRun(runId: string, deps: HarnessStopDeps, contexts?: readonly string[], dryRun = false): Promise<HarnessStopResult> {
   if (!RUN_ID.test(runId)) throw new Error(`invalid run id: ${runId}`);
   const given = runId;
@@ -297,15 +364,9 @@ export async function stopHarnessRun(runId: string, deps: HarnessStopDeps, conte
   }
   // ── ⓑ Pod Job (라벨로만) ───────────────────────────────────
   const targets = dryRun ? [] : contexts && contexts.length > 0 ? [...contexts] : deps.kubeContexts();
-  let jobsDeleted = 0;
-  for (const context of targets) {
-    // `-o name` → «job.batch/<name>» 한 줄씩. 맨 출력은 «job.batch "<name>" deleted» 라 «job.batch/» 로만 세면
-    //   지워도 늘 0 이었다(10-11 · 여섯 번 «0개 지움» 뒤 Pod Terminating). 두 꼴을 다 센다.
-    const r = deps.kubectl(['--context', context, '-n', deps.namespace, 'delete', 'job', '-l', `elanous.run=${runId}`, '--wait=false', '-o', 'name']);
-    if (r.status === 0) jobsDeleted += r.stdout.split('\n').filter((line) => /^job\.batch(?:\/|\s+")/.test(line.trim())).length;
-    else debug.log('harness.stop', 'job-delete-failed', { runId, context, error: r.stderr.slice(0, 200) }, { level: 'warn' });
-  }
-  const result: HarnessStopResult = { runId, ...(given !== runId ? { givenRunId: given } : {}), process: processState, ...(record ? { pid: record.pid } : {}), candidates, scanned: scan.status === 'ok', pidRecordFound: record !== null, dryRun, jobsDeleted, contexts: targets };
+  const jobDeletes = targets.map((context) => deleteRunPodJobs(deps, runId, context));
+  const jobsDeleted = jobDeletes.reduce((sum, job) => sum + job.deleted, 0);
+  const result: HarnessStopResult = { runId, ...(given !== runId ? { givenRunId: given } : {}), process: processState, ...(record ? { pid: record.pid } : {}), candidates, scanned: scan.status === 'ok', pidRecordFound: record !== null, dryRun, jobsDeleted, jobDeletes, contexts: targets };
   debug.log('harness.stop', 'stopped', { runId, process: processState, jobsDeleted, contexts: targets.length });
   return result;
 }
@@ -326,6 +387,15 @@ export function formatHarnessStop(r: HarnessStopResult): string {
     ...r.candidates.map(({ pid, startedAt, via }) => `  후보: pid ${pid} · 시작 ${new Date(startedAt).toISOString()} · ${via}`),
     r.dryRun
       ? `  Pod Job: dry-run(조회·삭제하지 않음 · 라벨 elanous.run=${r.runId})`
-      : `  Pod Job: ${r.jobsDeleted}개 지움 (문맥 ${r.contexts.length}개 · 라벨 elanous.run=${r.runId})`,
+      : `  Pod Job: ${r.jobsDeleted}개 지움 (문맥 ${r.contexts.length}개 · 라벨 elanous.run=${r.runId} · child-run 폴백)`,
+    ...r.jobDeletes.map(formatHarnessStopJobDelete),
   ].join('\n');
 }
+
+/** 문맥 하나의 Pod Job 결과 줄 — none·unreachable·pods-only 는 서로 다른 문면으로 갈라 읽힌다. */
+function formatHarnessStopJobDelete(job: HarnessStopJobDelete): string {
+  if (job.outcome === 'deleted') return `    ${job.context}: ${job.deleted}개 지움 (라벨 ${job.matchedBy})`;
+  if (job.outcome === 'pods-only') return `    ${job.context}: Job 0 · 같은 라벨 Pod ${job.podsRemaining} 남음 (Pod 는 직접 지우지 않는다)`;
+  if (job.outcome === 'unreachable') return `    ${job.context}: 못 닿음 (kubectl 실패: ${job.error})`;
+  return `    ${job.context}: 없음 (라벨 맞는 Job 0)`;
+}

package/src/index.ts

@@ -9,6 +9,7 @@ import { LOGS_SINCE_OPTION, registerLogsCommands } from './cli/logs-cli.js';
 import { registerDocsCommands } from './cli/docs-cli.js';
 import { registerBenchCommands } from './cli/bench-cli.js';
 import { registerRetroCommands } from './cli/retro-cli.js';
+import { registerMemoryCommands } from './cli/memory-cli.js';
 import { registerA2ACommands } from './cli/a2a-cli.js';
 import { registerPluginCommands } from './cli/plugin-cli.js';
 import { registerMakeCommand } from './cli/make-cli.js';
@@ -93,6 +94,7 @@ import { registerStartCommand } from './cli/start-cli.js';
 import { registerGroundingSourcesCli } from './grounding/sources-cli.js';
 import { registerGraphCommands } from './graph-runner/graph-cli.js';
 import { registerLoopCommands } from './loops/loop-cli.js';
+import { registerResourceCommands } from './cli/resource-cli.js';
 import { registerHqMovePlanCommand } from './hq/hq.js';
 import { registerCardCommand } from './task-cards/card-cli.js';
 import { registerLaunchHeadCommands } from './launch-head/launch-head-cli.js';
@@ -121,6 +123,8 @@ import { runGitCommand } from './git-fs/runner.js';
 import { debug, redactSecretText, redactSecrets } from './debug/log.js';
 import { installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
 import { CliUserError, formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
+import { classifyFriendlyError, formatFriendlyError } from './cli/friendly-errors.js';
+import { detectLocale } from './expression/locale.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';
@@ -201,11 +205,6 @@ import {
 } from './cli/mission-config.js';
 import { DEFAULT_THEME_TOKENS, resolveThemeTokens } from './theme/tokens.js';
 import { conatusPath } from './domains/conatus-data-dir.js';
-import {
-  saveMemory, loadMemory, listMemories, deleteMemory, searchMemories,
-  readIndex, memoryRoot, memoryIndexPath,
-  type MemoryType,
-} from './memory.js';
 
 /** 원본 전용 봇랩 도구 — 공개본엔 없다(release/public-export.yaml · scripts/botlab/**). */
 const BOTLAB_STATE_PATHS_MODULE: string = '../scripts/botlab/botlab-state-paths.js';
@@ -1268,6 +1267,7 @@ registerStartCommand(program);
 registerGroundingSourcesCli(program);
 registerGraphCommands(program);
 registerLoopCommands(program);
+registerResourceCommands(program);
 // RFC 실행·착지 루프 §3 — 태스크 컨텍스트 카드(`elanous card list|show` · ⛔ `task`/`tasks` 는 TOX 몫).
 registerCardCommand(program);
 registerLaunchHeadCommands(program);
@@ -1935,174 +1935,7 @@ registerAutopilotCommands(program);
 registerRetroCommands(program);
 
 // ── memory ──
-const memCmd = program.command('memory').description('Persistent memories injected into every chat turn (user / feedback / project / reference)');
-
-memCmd
-  .command('list [type]')
-  .description('List memories (optionally filtered by type)')
-  .option('-n, --limit <n>', 'Max entries to show', '30')
-  .action((type?: string, opts?: { limit: string }) => {
-    const t = type as MemoryType | undefined;
-    const entries = listMemories({ type: t, limit: parseInt(opts?.limit ?? '30', 10) });
-    if (entries.length === 0) {
-      ui.info('No memories yet. Add one with `elanous memory add <type> "<name>" "<description>"`.');
-      return;
-    }
-    ui.header(`memories (${entries.length})`);
-    for (const e of entries) {
-      console.log(`  ${e.id.slice(0, 8)}  [${e.type.padEnd(9)}]  ${e.name}`);
-      if (e.description) console.log(`             ${e.description.slice(0, 100)}`);
-    }
-  });
-
-memCmd
-  .command('add <type> <name> [description...]')
-  .description('Create a memory (type: user|feedback|project|reference). Body piped via stdin if available.')
-  .action(async (type: string, name: string, descParts: string[]) => {
-    if (!['user', 'feedback', 'project', 'reference'].includes(type)) {
-      ui.error(`invalid type "${type}". Use: user | feedback | project | reference`);
-      process.exit(1);
-    }
-    const description = (descParts || []).join(' ');
-    // Read body from stdin if piped; otherwise use description as body too.
-    let body = description;
-    const pipedBody = await readPipedStdin();   // ★ OBS-T3 — 비-TTY 는 파이프를 뜻하지 않는다(소켓이면 EOF 가 안 온다)
-    if (pipedBody) body = pipedBody;
-    const e = saveMemory({ type: type as MemoryType, name, description, body });
-    ui.info(`saved ${e.id.slice(0, 8)} [${e.type}] "${e.name}"`);
-  });
-
-// 3번째 recall 레버(2026-07-19) — pin(항상주입) / priority(매칭 시 순위 부스트).
-memCmd
-  .command('pin <idPrefix>')
-  .description('Pin a memory so it is ALWAYS injected (bypass keyword gate). Optionally set priority.')
-  .option('-p, --priority <n>', 'priority boost (higher = ranked/kept first)', '5')
-  .action((prefix: string, opts: { priority: string }) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, pinned: true, priority: parseInt(opts.priority, 10) || 0 });
-    ui.info(`📌 pinned ${e.id.slice(0, 8)} "${e.name}" (priority ${opts.priority})`);
-  });
-
-memCmd
-  .command('unpin <idPrefix>')
-  .description('Un-pin a memory (back to keyword-gated recall).')
-  .action((prefix: string) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, pinned: false, priority: e.priority });
-    ui.info(`unpinned ${e.id.slice(0, 8)} "${e.name}"`);
-  });
-
-memCmd
-  .command('priority <idPrefix> <n>')
-  .description('Set a memory\'s injection priority boost (0 = default). Added to match score.')
-  .action((prefix: string, n: string) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, priority: parseInt(n, 10) || 0, pinned: e.pinned });
-    ui.info(`priority ${e.id.slice(0, 8)} "${e.name}" → ${parseInt(n, 10) || 0}`);
-  });
-
-// 통합 관리 뷰(2026-07-19) — 2 시스템(큐레이션 파일메모리 + 에피소드 self-log)을 한 화면에.
-memCmd
-  .command('status')
-  .description('Unified memory overview — ① curated file-memory + ② self-log (surface_events)')
-  .action(async () => {
-    const { memoryRoot } = await import('./memory.js');
-    const mems = listMemories();
-    const byType: Record<string, number> = {};
-    let pinned = 0;
-    for (const e of mems) { byType[e.type] = (byType[e.type] ?? 0) + 1; if (e.pinned) pinned += 1; }
-    ui.header('memory (unified)');
-    console.log(`① 큐레이션 파일메모리: ${mems.length}건  [${Object.entries(byType).map(([k, v]) => `${k}:${v}`).join(' ') || '-'}]  📌pinned ${pinned}`);
-    console.log(`   ${memoryRoot()}  (LLM-judge/luna recall · MEMORY.md 항상주입)`);
-    try {
-      const { surfaceEventsDbPath, openSurfaceEventsDb } = await import('./domains/surface-events.js');
-      const path = surfaceEventsDbPath();
-      // 항상 open — legacy conatus/ → memory/ 자가치유 마이그레이션이 여기서 실행된다(존재 체크 먼저
-      // 하면 신 경로 부재로 마이그레이션이 스킵됨). 없으면 빈 store 생성(무해).
-      const db = openSurfaceEventsDb(path);
-      const n = (db.prepare('SELECT count(*) c FROM events').get() as { c: number }).c;
-      const recent = (db.prepare('SELECT ts FROM events ORDER BY ts DESC LIMIT 1').get() as { ts: string } | undefined)?.ts;
-      db.close();
-      console.log(`② 에피소드 self-log: ${n.toLocaleString()} events  (최근 ${recent?.slice(0, 16) ?? '-'})`);
-      console.log(`   ${path}  (FTS5 bm25+recency+myelin rerank · ambient 회상)`);
-    } catch (e) { console.log(`② self-log 조회 실패: ${(e as Error).message}`); }
-    try {
-      const { openKnowledgeDb, knowledgeDbPath } = await import('./domains/knowledge.js');
-      const kdb = openKnowledgeDb(); // 기본 경로 → legacy conatus/ 자가치유 이전
-      const kn = (kdb.prepare('SELECT count(*) c FROM docs').get() as { c: number }).c;
-      const dom = (kdb.prepare("SELECT domain, count(*) c FROM docs GROUP BY domain ORDER BY c DESC LIMIT 3").all() as Array<{ domain: string | null; c: number }>);
-      kdb.close();
-      console.log(`③ 시맨틱 knowledge: ${kn.toLocaleString()} docs  [${dom.map(d => `${d.domain ?? 'null'}:${d.c}`).join(' ')}]`);
-      console.log(`   ${knowledgeDbPath()}  (임베딩 벡터+BM25 하이브리드 · 의미 회상)`);
-    } catch (e) { console.log(`③ knowledge 조회 실패: ${(e as Error).message}`); }
-  });
-
-memCmd
-  .command('show <idPrefix>')
-  .description('Print full memory body')
-  .action((prefix: string) => {
-    const entries = listMemories();
-    const hit = entries.find(e => e.id.startsWith(prefix));
-    if (!hit) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    const full = loadMemory(hit.id)!;
-    ui.header(`${full.type}: ${full.name}`);
-    console.log(`  id          ${full.id}`);
-    console.log(`  created     ${full.createdAt}`);
-    console.log(`  updated     ${full.updatedAt}`);
-    console.log(`  description ${full.description}`);
-    console.log('');
-    console.log(full.body);
-  });
-
-memCmd
-  .command('search <query...>')
-  .description('Keyword search across all memories')
-  .option('--type <t>', 'Filter by type')
-  .option('-n, --limit <n>', 'Max results', '10')
-  .action((parts: string[], opts) => {
-    const hits = searchMemories(parts.join(' '), {
-      type: opts.type as MemoryType | undefined,
-      limit: parseInt(opts.limit, 10),
-    });
-    if (hits.length === 0) { ui.info('No matches.'); return; }
-    ui.header(`matches (${hits.length})`);
-    for (const h of hits) {
-      console.log(`  ${h.entry.id.slice(0, 8)}  score ${h.score}  [${h.entry.type}]  ${h.entry.name}`);
-      if (h.entry.description) console.log(`             ${h.entry.description.slice(0, 100)}`);
-    }
-  });
-
-memCmd
-  .command('delete <idPrefix>')
-  .description('Delete a memory')
-  .action((prefix: string) => {
-    const entries = listMemories();
-    const hit = entries.find(e => e.id.startsWith(prefix));
-    if (!hit) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    deleteMemory(hit.id);
-    ui.info(`deleted ${hit.id.slice(0, 8)}`);
-  });
-
-memCmd
-  .command('index')
-  .description('Print MEMORY.md index verbatim')
-  .action(() => {
-    const idx = readIndex();
-    if (!idx) { ui.info('empty (no memories yet)'); return; }
-    console.log(idx);
-  });
-
-memCmd
-  .command('where')
-  .description('Show the memory storage path')
-  .action(() => {
-    console.log(`memory dir   ${memoryRoot()}`);
-    console.log(`index file   ${memoryIndexPath()}`);
-  });
-
+registerMemoryCommands(program);
 // ── self (self-awareness memory — 외부 도구가 elanous 구현 이력을 주입/회상) ──
 // ── decide (Jev · System One — ⛔ 텍스트를 «생성하지 않는다». 확률이 붙은 판정만 받는다) ──
 program
@@ -5865,6 +5698,8 @@ selfCmd
         return (prompt: string) =>
           streamLLM([{ role: 'user', content: prompt }], () => {}, {
             model,
+            // ⛔ 어댑터 기본 2048 은 리뷰 응답을 자른다(VERDICT/MUST-FIX 줄이 잘리면 reviewed=false 로 접힌다).
+            maxTokens: 16_000,
             ...(o?.pinProvider ? { provider: getProvider(model) } : {}),
             ...(o?.onResolved ? { onResolvedProvider: o.onResolved } : {}),
             ...(effort ? { reasoningEffort: effort } : {}),
@@ -5878,7 +5713,7 @@ selfCmd
         return async (prompt: string, images?: readonly ReviewImage[]) => {
           if (!made) {
             const { makeLazyAcpReviewLLM } = await import('./agent-substrate/acp-reviewer.js');
-            made = makeLazyAcpReviewLLM({ cwd: process.cwd(), backend: o.backend, model: o.model, timeoutMs: o.timeoutMs });
+            made = makeLazyAcpReviewLLM({ cwd: o.cwd ?? process.cwd(), backend: o.backend, model: o.model, timeoutMs: o.timeoutMs });
           }
           return made(prompt, images);
         };
@@ -5894,7 +5729,7 @@ selfCmd
         // handshakeTimeoutMs left to the adapter default (min(timeoutMs, 60s)) — the harness lane passes none either.
         return {
           backend: 'claude',
-          llm: makeRoleAcpReviewLLM({ cwd: process.cwd(), backend: 'claude', backendSpec: spawn.backendSpec, env: spawn.env, timeoutMs: o.timeoutMs }),
+          llm: makeRoleAcpReviewLLM({ cwd: o.cwd ?? process.cwd(), backend: 'claude', backendSpec: spawn.backendSpec, env: spawn.env, timeoutMs: o.timeoutMs }),
         };
       },
       // SUBSCRIPTION-EXHAUST-REROUTE — role reviewer unavailable ⇒ GLM on OpenRouter (the review policy's first
@@ -11941,6 +11776,13 @@ export function runCli(): void {
       console.error(formatCliUserError(err));
       process.exit(1);
     }
+    const friendlyCode = classifyFriendlyError(err);
+    if (friendlyCode) {
+      const locale = detectLocale();
+      console.error(formatFriendlyError(friendlyCode, locale));
+      debug.log('cli.friendly-error', 'shown', { code: friendlyCode, locale });
+      process.exit(1);
+    }
     // ER1 — a real crash is reported once (consented · scrubbed · never blocks more than the send timeout).
     try {
       const { reportError } = await import('./error-report/report.js');

package/src/intake-plane/collect-github.ts

@@ -29,6 +29,9 @@ export const DEFAULT_GITHUB_STAR_DAYS = 30;
  */
 export const DEFAULT_GITHUB_STAR_PER_QUERY = 20;
 
+/** 하루당 별 증가 상위 이 개수 행만 README 를 싣고 `surge.score` 를 받는다. */
+const GITHUB_SURGE_TOP = 3;
+
 export interface GithubStarRepo {
   fullName: string;
   url: string;
@@ -223,7 +226,7 @@ export async function collectGithubStars(
   }).sort((a, b) => (b.starsPerDay ?? -Infinity) - (a.starsPerDay ?? -Infinity) || b.stars - a.stars);
   const readmes = new Map<string, string>();
   if (!opts.dryRun) {
-    for (const row of repos.slice(0, 3)) {
+    for (const row of repos.slice(0, GITHUB_SURGE_TOP)) {
       try {
         readmes.set(row.repo, `README:\n${(await (opts.fetchReadme ?? ghApiFetchReadme)(row.repo)).slice(0, 1_500)}`);
       } catch {
@@ -231,7 +234,7 @@ export async function collectGithubStars(
       }
     }
   }
-  const raws: RawIntakeItem[] = repos.map((row) => ({
+  const raws: RawIntakeItem[] = repos.map((row, rank) => ({
     url: row.url,
     title: row.title,
     // 모든 행 첫 줄에 라이선스: SPDX · 확인된 부재는 «없음» · 응답이 알려 주지 않으면 «미상»(없음으로 읽지 않는다).
@@ -240,6 +243,8 @@ export async function collectGithubStars(
       stars: row.stars,
       ...(row.starsDelta !== undefined ? { starsDelta: row.starsDelta } : {}),
       ...(row.starsPerDay !== undefined ? { starsPerDay: row.starsPerDay } : {}),
+      // 급등 상위 3 행(README 를 싣는 그 셋)만 1위 3 · 2위 2 · 3위 1 — pickAbsorbQueue 가 `.score` 로 앞세운다.
+      ...(rank < GITHUB_SURGE_TOP ? { 'surge.score': GITHUB_SURGE_TOP - rank } : {}),
     },
   }));
   const result: CollectGithubResult = {