elanous 0.2.41 → 0.2.43

package/scripts/graph-units/land-enqueue.ts

@@ -2,6 +2,7 @@ import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { isAbsolute } from 'node:path';
 import { debug } from '../../src/debug/log.js';
+import { parseGraphTemplateYaml, type LandUnitTrainPolicySpec } from '../../src/self-implement/graph-yaml.js';
 
 type RecordValue = Record<string, unknown>;
 type EnqueueResult = {
@@ -10,6 +11,93 @@ type EnqueueResult = {
   evidence: RecordValue;
 };
 
+/** Facts collected by the train runner for one landing batch. Keep this input explicit:
+ * the graph unit enqueues one PR and cannot infer batch/theme/scenario facts itself. */
+export type LandTrainObservation = {
+  readonly express: boolean;
+  readonly waitedForBatch: boolean;
+  readonly batchSize: number;
+  readonly groupBy: readonly string[];
+  readonly waitMinutes: number;
+  readonly scenarioSource: string;
+  readonly mockUsed: boolean;
+  readonly gateRuns: number;
+  readonly land: {
+    readonly perPr: string;
+    readonly pinnedHead: boolean;
+    readonly ejectOnFail: boolean;
+    readonly integrationPr: boolean;
+  };
+};
+
+export type LandPolicyDrift = {
+  readonly field: string;
+  readonly expected: unknown;
+  readonly observed: unknown;
+};
+
+function sameMembers(actual: readonly string[], expected: readonly string[]): boolean {
+  return actual.length === expected.length && expected.every((value) => actual.includes(value));
+}
+
+/** Compare runner-measured facts with the declared policy. Missing/invalid facts are drift,
+ * never an implicit pass. Express work bypasses batch size/theme waiting as declared. */
+export function compareLandTrainPolicy(
+  policy: LandUnitTrainPolicySpec,
+  observed: LandTrainObservation,
+): LandPolicyDrift[] {
+  const drift: LandPolicyDrift[] = [];
+  const check = (field: string, expected: unknown, actual: unknown, matches: boolean): void => {
+    if (!matches) drift.push({ field, expected, observed: actual ?? null });
+  };
+  if (typeof observed.express !== 'boolean') {
+    check('/express', 'boolean', observed.express, false);
+  } else if (observed.express) {
+    check('/express/waitsForBatch', policy.express.waitsForBatch, observed.waitedForBatch, observed.waitedForBatch === policy.express.waitsForBatch);
+  } else {
+    const validSize = Number.isSafeInteger(observed.batchSize)
+      && observed.batchSize >= policy.batch.min && observed.batchSize <= policy.batch.max;
+    check('/batch/size', `${policy.batch.min}..${policy.batch.max}`, observed.batchSize, validSize);
+    check('/batch/groupBy', policy.batch.groupBy, observed.groupBy,
+      Array.isArray(observed.groupBy) && sameMembers(observed.groupBy, policy.batch.groupBy));
+    check('/batch/waitMinutes', `<=${policy.batch.maxWaitMin}`, observed.waitMinutes,
+      Number.isFinite(observed.waitMinutes) && observed.waitMinutes >= 0 && observed.waitMinutes <= policy.batch.maxWaitMin);
+  }
+  check('/scenarioPrebuild/source', policy.scenarioPrebuild.source, observed.scenarioSource,
+    policy.scenarioPrebuild.source.includes(observed.scenarioSource as typeof policy.scenarioPrebuild.source[number]));
+  check('/scenarioPrebuild/mock', policy.scenarioPrebuild.mock, observed.mockUsed,
+    observed.mockUsed === (policy.scenarioPrebuild.mock === 'required'));
+  check('/gate/runs', policy.gate.oncePerBatch ? 1 : 'unspecified', observed.gateRuns,
+    !policy.gate.oncePerBatch || observed.gateRuns === 1);
+  check('/land/perPr', policy.land.perPr, observed.land?.perPr, observed.land?.perPr === policy.land.perPr);
+  check('/land/pinnedHead', policy.land.pinnedHead, observed.land?.pinnedHead, observed.land?.pinnedHead === policy.land.pinnedHead);
+  check('/land/ejectOnFail', policy.land.ejectOnFail, observed.land?.ejectOnFail, observed.land?.ejectOnFail === policy.land.ejectOnFail);
+  check('/land/integrationPr', policy.land.integrationPr, observed.land?.integrationPr, observed.land?.integrationPr === policy.land.integrationPr);
+  return drift;
+}
+
+/** Runtime contract for the OP train runner: emit only on measured drift; tests inject the sink. */
+export function observeLandPolicyDrift(
+  policy: LandUnitTrainPolicySpec,
+  observed: LandTrainObservation,
+  emit: (event: 'land.policy-drift', payload: { drift: readonly LandPolicyDrift[] }) => void = (_event, payload) => {
+    debug.log('land', 'policy-drift', payload, { level: 'warn' });
+  },
+): LandPolicyDrift[] {
+  const drift = compareLandTrainPolicy(policy, observed);
+  if (drift.length > 0) emit('land.policy-drift', { drift });
+  return drift;
+}
+
+function observeEnvelopePolicy(context: RecordValue, emit?: Parameters<typeof observeLandPolicyDrift>[2]): void {
+  if (context.landTrainObservation === undefined) return;
+  const parsed = parseGraphTemplateYaml(readFileSync(new URL('../../graphs/units/land/land.yaml', import.meta.url), 'utf8'), 'land.yaml');
+  const policy = parsed.template?.policy;
+  if (!policy) throw new Error(`land policy unavailable: ${parsed.errors.map((issue) => issue.message).join('; ')}`);
+  // Runtime envelopes are untrusted; the comparator treats absent fields as drift evidence.
+  observeLandPolicyDrift(policy, record(context.landTrainObservation) as unknown as LandTrainObservation, emit);
+}
+
 function record(value: unknown): RecordValue {
   return value !== null && typeof value === 'object' && !Array.isArray(value) ? value as RecordValue : {};
 }
@@ -29,8 +117,10 @@ export function runLandEnqueue(
   envelope: unknown,
   executable = process.env.ELANOUS_LAND_ENQUEUE,
   spawn: typeof spawnSync = spawnSync,
+  emitPolicyDrift?: Parameters<typeof observeLandPolicyDrift>[2],
 ): EnqueueResult {
   const context = record(record(envelope).context);
+  observeEnvelopePolicy(context, emitPolicyDrift);
   const rawPr = context.pr;
   const pr = typeof rawPr === 'number' ? rawPr : typeof rawPr === 'string' && /^\d+$/.test(rawPr) ? Number(rawPr) : NaN;
   const expectedHead = text(context.expectedHead);

package/scripts/heal/run-role.ts

@@ -16,7 +16,8 @@ import {
   type HealTriageHistory,
   type PathExists,
 } from '../../src/self-implement/heal-triage.js';
-import { loadRunLedger, runLedgerDir, type RunLedgerEntry } from '../../src/self-implement/run-ledger.js';
+import { appendRunLedgerEntry, loadRunLedger, runLedgerDir, type RunLedgerEntry, type RunLedgerWriter } from '../../src/self-implement/run-ledger.js';
+import { readDoctorVisits } from '../../src/self-implement/doctor-visit.js';
 
 interface GraphContext {
   graphId?: string;
@@ -51,6 +52,38 @@ function citationsOf(value: unknown): HealCitation[] {
   });
 }
 
+function stringsAt(record: Record<string, unknown>, keys: readonly string[]): string[] {
+  return keys.flatMap((key) => {
+    const value = record[key];
+    return typeof value === 'string' ? [value] : Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : [];
+  }).map((value) => value.trim()).filter(Boolean);
+}
+
+function materializedFacts(entries: readonly RunLedgerEntry[]): Record<string, unknown> {
+  const paths = new Set<string>();
+  const passed = new Set<string>();
+  const failed = new Set<string>();
+  const mustFix: string[] = [];
+  const diff: string[] = [];
+  let noProgressReason: string | undefined;
+  let reportDeficit = false;
+  for (const entry of entries) {
+    const data = entry.data ?? {};
+    if (entry.event === 'implemented') {
+      stringsAt(data, ['materializedPaths']).forEach((path) => paths.add(path));
+    }
+    stringsAt(data, ['passedTestNames', 'passedTests', 'testsPassed']).forEach((name) => passed.add(name));
+    stringsAt(data, ['failedTestNames', 'failedTests', 'testsFailed']).forEach((name) => failed.add(name));
+    if (entry.event === 'review-round-triage') stringsAt(data, ['rawMustFix']).forEach((item) => mustFix.push(item));
+    stringsAt(data, ['diffSummary', 'summary']).forEach((line) => diff.push(line.slice(0, 500)));
+    if (typeof data.noProgressReason === 'string') noProgressReason = data.noProgressReason;
+    if (data.terminationReason === 'no-progress') noProgressReason ??= typeof data.cause === 'string' ? data.cause : 'no-progress';
+    if (data.class === 'report-deficit' || data.abandonedClassification === 'report-deficit') reportDeficit = true;
+  }
+  return { ...(entries.length ? { materializedPaths: [...paths] } : {}), passedTestNames: [...passed], failedTestNames: [...failed], mustFix,
+    diffSummary: diff.slice(-10), ...(noProgressReason ? { noProgressReason } : {}), reportDeficit };
+}
+
 function failureOf(ctx: GraphContext): HealFailureSignature {
   const input = asRecord(ctx.input);
   const raw = asRecord(input?.failure) ?? input ?? {};
@@ -66,6 +99,11 @@ function failureOf(ctx: GraphContext): HealFailureSignature {
     ...(typeof raw.environmentClaim === 'string' ? { environmentClaim: raw.environmentClaim } : {}),
     ...(typeof raw.namedSource === 'string' ? { namedSource: raw.namedSource } : {}),
     ...(typeof raw.errorText === 'string' ? { errorText: raw.errorText } : {}),
+    ...(typeof raw.goalText === 'string' ? { goalText: raw.goalText } : {}),
+    ...(typeof raw.noProgressReason === 'string' ? { noProgressReason: raw.noProgressReason } : {}),
+    ...(typeof raw.reportDeficit === 'boolean' ? { reportDeficit: raw.reportDeficit } : {}),
+    ...(Array.isArray(raw.mustFix) ? { mustFix: raw.mustFix.filter((item): item is string => typeof item === 'string') } : {}),
+    ...(Array.isArray(raw.materializedPaths) ? { materializedPaths: raw.materializedPaths.filter((item): item is string => typeof item === 'string') } : {}),
     ...(citations.length ? { citations } : {}),
   };
 }
@@ -103,6 +141,8 @@ export interface HealRoleDeps {
   ledgerDir?: string;
   search?: (query: string) => unknown;
   stateRoot?: string;
+  writeLedger?: RunLedgerWriter;
+  readVisits?: (runId: string) => ReturnType<typeof readDoctorVisits>;
 }
 
 function gitHeadExists(worktree: string, path: string): PathExists {
@@ -132,6 +172,11 @@ function signatureFromUnknown(value: unknown): HealFailureSignature | undefined
     ...(typeof raw.environmentClaim === 'string' ? { environmentClaim: raw.environmentClaim } : {}),
     ...(typeof raw.namedSource === 'string' ? { namedSource: raw.namedSource } : {}),
     ...(typeof raw.errorText === 'string' ? { errorText: raw.errorText } : {}),
+    ...(typeof raw.goalText === 'string' ? { goalText: raw.goalText } : {}),
+    ...(typeof raw.noProgressReason === 'string' ? { noProgressReason: raw.noProgressReason } : {}),
+    ...(typeof raw.reportDeficit === 'boolean' ? { reportDeficit: raw.reportDeficit } : {}),
+    ...(Array.isArray(raw.mustFix) ? { mustFix: raw.mustFix.filter((item): item is string => typeof item === 'string') } : {}),
+    ...(Array.isArray(raw.materializedPaths) ? { materializedPaths: raw.materializedPaths.filter((item): item is string => typeof item === 'string') } : {}),
     ...(citations.length ? { citations } : {}),
   };
   return Object.keys(signature).length ? signature : undefined;
@@ -255,17 +300,36 @@ export function roleResult(role: string, ctx: GraphContext, deps: HealRoleDeps =
           .filter(row => row.source === selector.source && row.ref === selector.ref)
           .sort((a, b) => Date.parse(b.at) - Date.parse(a.at)).at(0);
         if (!event) return withAddedFacts({ outcome: 'empty', reason: 'inbox-event-not-found' }, []);
-        return withAddedFacts({ outcome: 'ok', entries: [{ errorText: event.summary }], event }, ['errorText']);
+        const runId = event.ref;
+        let ledger: RunLedgerEntry[] | null = null;
+        let visits: ReturnType<typeof readDoctorVisits> = [];
+        try {
+          ledger = deps.loadLedger ? deps.loadLedger(runId)
+            : loadRunLedger(runId, deps.ledgerDir ?? (deps.stateRoot ? runLedgerDir(deps.stateRoot) : undefined));
+          visits = deps.readVisits ? deps.readVisits(runId)
+            : readDoctorVisits(runId, deps.ledgerDir || deps.stateRoot ? { dir: deps.ledgerDir ?? runLedgerDir(deps.stateRoot!) } : {});
+        } catch { /* inbox refs can be non-ledger identifiers; absent evidence remains absent */ }
+        const facts = materializedFacts(ledger ?? []);
+        return withAddedFacts({ outcome: 'ok', entries: [{ errorText: event.summary, goalText: event.goalText,
+          goalId: event.goalId, goalFile: event.goalFile, ...facts, doctorVisits: visits }], event }, ['errorText', 'materializedPaths', 'doctorVisits']);
       }
       if (!asRecord(input.failure) && Object.keys(failure).length === 0) return withAddedFacts({ outcome: 'empty' }, []);
       const worktree = typeof input.worktree === 'string' ? input.worktree : '';
+      const runId = typeof input.runId === 'string' ? input.runId : '';
+      const ledger = runId ? (deps.loadLedger
+        ? deps.loadLedger(runId)
+        : loadRunLedger(runId, deps.ledgerDir ?? (process.env.ELANOUS_STATE_DIR ? runLedgerDir(process.env.ELANOUS_STATE_DIR) : undefined))) : null;
+      const doctorVisits = runId ? readDoctorVisits(runId, deps.ledgerDir ? { dir: deps.ledgerDir } : {}) : [];
       const paths = signature.unverified ?? [];
-      if (!worktree || paths.length === 0) return withAddedFacts({ outcome: 'ok', entries: [signature] }, []);
+      const materialized = (ledger ?? []).filter((entry) => ['implemented', 'gated', 'reviewed', 'implement-abort-reason'].includes(entry.event))
+        .map((entry) => ({ event: entry.event, data: entry.data }));
+      const runEvidence = runId ? { materialized, doctorVisits } : {};
+      if (!worktree || paths.length === 0) return withAddedFacts({ outcome: 'ok', entries: [{ ...signature, ...runEvidence }] }, []);
       const exists = deps.exists ?? defaultExists(worktree);
       const marked = markDeletedUnverified(paths, exists);
       const changed = marked.some((path, index) => path !== paths[index]);
       const entry: HealFailureSignature = { ...signature, unverified: marked };
-      return withAddedFacts({ outcome: 'ok', entries: [entry] }, changed ? ['unverified'] : []);
+      return withAddedFacts({ outcome: 'ok', entries: [{ ...entry, ...runEvidence }] }, changed ? ['unverified'] : []);
     }
     case 'triage': {
       const merged = mergedContextSignature(signature, ctx.outputs);
@@ -294,8 +358,38 @@ export function roleResult(role: string, ctx: GraphContext, deps: HealRoleDeps =
       const urls = citations.length ? `\n근거: ${citations.map((citation) => citation.url).join(' · ')}` : '';
       return withAddedFacts({ outcome: 'ok', next: 'implement', 'rework-note': `${file} 의 ${symbol} 을 고친다${urls}` }, []);
     }
+    case 'revise-goal': {
+      const collected = outputRecord(ctx.outputs, 'collect');
+      const collectedEntry = Array.isArray(collected?.entries) ? asRecord(collected.entries[0]) : undefined;
+      const goal = typeof input.goal === 'string' ? input.goal : typeof collectedEntry?.goalText === 'string' ? collectedEntry.goalText
+        : typeof failure.goal === 'string' ? failure.goal : '';
+      const paths = stringsAt(collectedEntry ?? failure, ['materializedPaths']);
+      const failures = stringsAt(collectedEntry ?? failure, ['failedTestNames']);
+      const mustFix = stringsAt(collectedEntry ?? failure, ['mustFix']);
+      const doctorVisits = Array.isArray(collectedEntry?.doctorVisits) ? collectedEntry.doctorVisits : [];
+      const before = goal.split(/\r?\n/).find((line) => /^\s*(?:[-*]\s*)?대상 경로\s*[:：]/i.test(line));
+      if (!paths.length || !before) return withAddedFacts({ outcome: 'fail', reason: 'insufficient-materialized-evidence', needsHuman: true,
+        evidence: { changedPaths: paths, targetLineFound: Boolean(before), doctorVisits } }, []);
+      const after = `대상 경로: ${paths.join(', ')}`;
+      const revised = before !== after ? goal.replace(before, after) : '';
+      if (!revised) return withAddedFacts({ outcome: 'fail', reason: 'goal-not-revisable', needsHuman: true,
+        evidence: { changedPaths: paths, doctorVisits } }, []);
+      const changed = revised !== goal;
+      const diff = changed ? [`- ${before}`, `+ ${after}`] : [];
+      const runId = typeof input.runId === 'string' ? input.runId : typeof ctx.runId === 'string' ? ctx.runId : '';
+      if (runId) {
+        const at = new Date().toISOString();
+        const write = deps.writeLedger ?? ((entry: RunLedgerEntry) => { appendRunLedgerEntry(entry, deps.ledgerDir ?? (process.env.ELANOUS_STATE_DIR ? runLedgerDir(process.env.ELANOUS_STATE_DIR) : undefined)); });
+        write({ timestamp: at, runId, event: 'goal-refined', data: { outcome: 'refined', reason: 'materialized-run-mismatch', changedLines: diff, relaunchCount: 1 } });
+        write({ timestamp: at, runId, event: 'reauthor-relaunch-request', data: { target: 'same-cell', count: 1, revisedGoal: revised } });
+      }
+      return withAddedFacts({ outcome: 'ok', next: 'implement', reauthor: true, revisedGoal: revised,
+        goalDiff: diff, evidence: { changedPaths: paths, failedTests: failures, mustFix, noProgressReason: collectedEntry?.noProgressReason ?? signature.noProgressReason ?? '', doctorVisits,
+          passedTestNames: stringsAt(collectedEntry ?? failure, ['passedTestNames']), diffSummary: stringsAt(collectedEntry ?? failure, ['diffSummary']) },
+        followUpSuggestion: '<CELL>-FU: 남은 한 조각을 별도 칸으로 제안한다.', relaunchCount: 1,
+        event: 'goal-refined', eventData: { reason: 'materialized-run-mismatch', goalDiff: diff } }, ['revisedGoal', 'goalDiff']);
+    }
     case 'verify':
-    case 'revise-goal':
       return withAddedFacts({ outcome: 'fail', reason: 'not-wired' }, []);
     case 'observe-deeper': {
       const runId = typeof input.runId === 'string' ? input.runId : '';

package/scripts/hooks/codex-notify.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# ── Codex CLI notify hook — 손(hand) progress 전달 (HAND-HOOKS-NEXUS-STATUS · 2026-10-30) ──
+#
+# OP #54582 승인 · TC #54571 계약 기반. Codex notify 실행 시 알림 JSON 을 기존 계약
+# `POST /v1/missions/{missionId}/line`(src/agent-mission/mission-line.ts · postMissionLineEvent)로
+# **type:progress** 한 건만 보낸다. final 은 명시적 `mission reply --done` 전용,
+# ask/answer/correct 는 예약 — 이 훅은 progress 만 보낸다.
+#
+# 인증: missionId+attemptId+손별 Bearer. token 은 child env 에만 둔다:
+#   ELANOUS_HAND_TOKEN  — 손별 Bearer token(인자·파일 저장 금지)
+#   ELANOUS_MISSION_ID · ELANOUS_ATTEMPT_ID — 현재 미션/시도
+#   ELANOUS_NEXUS_URL — (선택) 계약 endpoint base
+# 자격이 없으면 조용히 exit 0(fail-soft — 훅이 Codex 를 막지 않는다).
+# PWA 손 카드 제외(TC graphEvents node-added kind=hand · DEMO1104-ARG-ADAPTIVE-VIEW가 렌더).
+# OSC 는 폴백이며 화면 scraping 은 하지 않는다. 병렬 송신 없음(Pod concurrency=1).
+#
+# 인자/stdin: Codex 가 주는 notify JSON {tool_name, cwd, ...} — Codex 는 notify JSON 을
+# 인자 하나(argv[1])로 넘기고, stdin 은 폴백이다.
+
+set -uo pipefail
+# Codex notify 프로그램 규약: JSON 을 argv[1] 로 받는다 — 인자가 없으면 stdin 을 읽는다.
+if [ "$#" -gt 0 ]; then INPUT="$1"; else INPUT="$(cat)"; fi
+
+HAND_CLI="$(cd "$(dirname "$0")/../.." && pwd)/src/agent-mission/hand-hooks.ts"
+
+if [ -n "${ELANOUS_HAND_TOKEN:-}" ] && [ -n "${ELANOUS_MISSION_ID:-}" ] && [ -n "${ELANOUS_ATTEMPT_ID:-}" ] \
+  && command -v bun >/dev/null 2>&1 && [ -f "$HAND_CLI" ]; then
+  # 논블로킹(백그라운드 &)·출력 버림 — notify 경로를 지연시키지 않는다.
+  printf '%s' "$INPUT" | bun "$HAND_CLI" codex-notify >/dev/null 2>&1 &
+fi
+
+exit 0

package/scripts/install.sh

@@ -154,7 +154,6 @@ missing_prerequisites() {
     command -v curl >/dev/null 2>&1 || MISSING+=(curl)
     command -v unzip >/dev/null 2>&1 || MISSING+=(unzip)   # bun 공식 설치기가 쓴다
   fi
-  command -v git >/dev/null 2>&1 || MISSING+=(git)
 }
 missing_prerequisites
 INSTALLED_DEPS=''
@@ -192,8 +191,9 @@ if ! command -v bun >/dev/null 2>&1 && [ "$BOOTSTRAP_BUN" -eq 1 ]; then
   fi
 fi
 
-# Keep this explicit set aligned with catalog/external-commands.yaml required entries.
-REQUIRED_COMMANDS=(git bun)
+# Git enables repository/worktree features but is not needed to boot the installed TUI.
+# Keep this set aligned with the runtime-required entries in catalog/external-commands.yaml.
+REQUIRED_COMMANDS=(bun)
 HARNESS_COMMANDS=(gh rg codex)
 for command in "${REQUIRED_COMMANDS[@]}"; do
   if ! command -v "$command" >/dev/null 2>&1; then
@@ -379,27 +379,23 @@ if [ ! -f "$VERSION_DIR/package.json" ]; then
 fi
 # 🩸 2026-09-24 빈 GCP VM 실측: `--offline` 만 쓰면 bun 캐시가 빈 새 기계에서 의존성이 «전부» failed to resolve — 어떤
 #    새 기계에서도 설치가 안 됐다(이 맥은 캐시가 차 있어 가려졌다). ⇒ 캐시로 먼저(빠르고 네트워크 없음) ⊕ 실패하면 레지스트리.
-# 🩸 2026-09-24 빈 VM 실측: apt `nodejs npm` 이 있으면 PATH 의 node(v18)·node-gyp(9.3.0)가 node-pty 를 빌드해
-#    bun 이 불러오는 순간 panic(uv_version_string)으로 죽었다. ⇒ 빌드 동안만 node=bun · node-gyp=최신 심을 PATH 앞에
-#    (src/native/native-build-env.ts 와 같은 심).
-NATIVE_SHIM="$(mktemp -d "${TMPDIR:-/tmp}/elanous-native-build.XXXXXX")"
-ln -s "$BUN_EXEC" "$NATIVE_SHIM/node"
-printf '#!/bin/sh\nexec "%s" x node-gyp@latest "$@"\n' "$BUN_EXEC" > "$NATIVE_SHIM/node-gyp"
-chmod +x "$NATIVE_SHIM/node-gyp"
-if ! (cd "$VERSION_DIR" && PATH="$NATIVE_SHIM:$PATH" bun add --no-save --offline "$INSTALL_TARBALL" >/dev/null 2>&1); then
+# Bun is the only runtime prerequisite. Skip lifecycle scripts: Bun otherwise runs optional
+# utf-8-validate native builds on bare Ubuntu and fails without Python/compiler. Optional prebuilt
+# packages (for example sharp) remain in the dependency graph.
+if ! (cd "$VERSION_DIR" && bun add --no-save --ignore-scripts --offline "$INSTALL_TARBALL" >/dev/null 2>&1); then
   echo "dependencies not in the local bun cache — fetching them from the npm registry" >&2
   # bun prints «Blocked N postinstalls» and progress noise here — keep it out of the screen unless this step fails.
   ADD_LOG="$(mktemp "${TMPDIR:-/tmp}/elanous-bun-add.XXXXXX")"
   ADD_RC=0
-  (cd "$VERSION_DIR" && PATH="$NATIVE_SHIM:$PATH" bun add --no-save "$INSTALL_TARBALL") >"$ADD_LOG" 2>&1 || ADD_RC=$?
+  (cd "$VERSION_DIR" && bun add --no-save --ignore-scripts "$INSTALL_TARBALL") >"$ADD_LOG" 2>&1 || ADD_RC=$?
   if [ "$ADD_RC" -ne 0 ]; then
     tail -n 20 "$ADD_LOG" >&2
-    rm -f "$ADD_LOG"; rm -rf "$NATIVE_SHIM"
+    rm -f "$ADD_LOG"
     exit "$ADD_RC"
   fi
   rm -f "$ADD_LOG"
 fi
-rm -rf "$NATIVE_SHIM"
+echo "If an optional native feature is unavailable, run 'elanous doctor --fix --yes' for repair guidance. The Bun TUI needs no system Node.js, Python, or compiler." >&2
 ln -sfn "versions/$VERSION_NAME" "$PREFIX/current"
 mkdir -p "$PREFIX/bin"
 # 절대 bun 경로를 설치 때 박고 엔트리는 current 를 거친다 — cron/systemd 의 짧은 PATH 와 판 전환 모두 지원.
@@ -478,30 +474,6 @@ if [ "$START_SETUP" -eq 0 ]; then
 fi
 # 🆕 2026-09-24 빈 VM 실측: 하니스(codex 백엔드)는 Codex CLI 를 자식으로 띄우는데 빈 기계엔 codex·node 가 «둘 다» 없었다.
 #    ⚠️ 아래 설치 줄은 빈 기계에서 아직 «안 쟀다» — `elanous doctor` 의 codex 줄이 판정한다.
-# C++20 toolchain must precede node-pty's rebuild; only suggest missing prerequisites.
-if ! command -v make >/dev/null 2>&1 || ! command -v c++ >/dev/null 2>&1; then
-  case "$(uname -s)" in
-    Darwin) BUILD_HINT='xcode-select --install' ;;
-    Linux)
-      OS_ID='' OS_LIKE=''
-      if [ -r "${ELANOUS_INSTALL_OS_RELEASE_FILE:-/etc/os-release}" ]; then
-        while IFS='=' read -r key value; do
-          value="${value#\"}"; value="${value%\"}"
-          case "$key" in ID) OS_ID="$value" ;; ID_LIKE) OS_LIKE="$value" ;; esac
-        done < "${ELANOUS_INSTALL_OS_RELEASE_FILE:-/etc/os-release}"
-      fi
-      BUILD_HINT=''
-      case " $OS_ID $OS_LIKE " in
-        *' debian '*|*' ubuntu '*) BUILD_HINT='sudo apt-get install -y build-essential' ;;
-        *' fedora '*) BUILD_HINT='sudo dnf groupinstall -y "Development Tools"' ;;
-      esac ;;
-    *) BUILD_HINT='' ;;
-  esac
-  if [ -n "$BUILD_HINT" ]; then
-    echo "  $STEP) $BUILD_HINT"; STEP=$((STEP + 1))
-  fi
-  echo "  $STEP) elanous doctor --fix --yes       # $(t 'rebuild node-pty after installing build tools' '빌드 도구를 깐 뒤 node-pty 다시 빌드')"; STEP=$((STEP + 1))
-fi
 if ! command -v rg >/dev/null 2>&1; then
   if [ -z "${OS_ID:-}" ] && [ -r "${ELANOUS_INSTALL_OS_RELEASE_FILE:-/etc/os-release}" ]; then
     while IFS='=' read -r key value; do

package/scripts/land-global-checks.ts

@@ -62,8 +62,13 @@ function runNextMdCheck(cwd: string): LandGlobalChecksRun {
   const prfaq = join(dir, 'prfaq.md');
   writeFileSync(prfaq, '');
   try {
+    // The parent may itself be a release graph node. Its context points at temporary graph outputs
+    // (including docs worktrees already removed by the time pr land runs); this checker must inspect
+    // the checkout paths passed below instead of inheriting that unrelated graph input.
+    const env = { ...process.env };
+    delete env.ELANOUS_GRAPH_CONTEXT;
     const r = spawnSync('bun', [CHECK_NODE_SCRIPT, '--landing', '--prfaq', prfaq, '--files', 'release/next.md'], {
-      cwd, encoding: 'utf8', maxBuffer: 8 * 1024 * 1024, timeout: 60_000,
+      cwd, encoding: 'utf8', maxBuffer: 8 * 1024 * 1024, timeout: 60_000, env,
     });
     return { status: r.status, output: `${r.stdout ?? ''}\n${r.stderr ?? ''}`, ...(r.error ? { error: r.error.message } : {}) };
   } finally {

package/scripts/landing-heal/land-plan.ts

@@ -0,0 +1,57 @@
+#!/usr/bin/env bun
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute } from 'node:path';
+import { planTrain, type TrainCandidate, type TrainDeferred } from '../../src/self-implement/merge-train.js';
+import type { L8ShadowQueueState } from '../../src/self-implement/l8-merge-queue.js';
+
+export const LAND_PLAN_MAX_BATCH = 8;
+
+type LandPlan = { batch: TrainCandidate[]; deferred: TrainDeferred[] };
+
+function inputPath(args: readonly string[]): string {
+  if (args.length !== 2 || args[0] !== '--input') throw new Error('usage: land-plan.ts --input <absolute-json-path>');
+  const path = args[1];
+  if (!path || !isAbsolute(path)) throw new Error('--input requires an absolute path');
+  if (!existsSync(path)) throw new Error('input file missing');
+  return path;
+}
+
+function isQueueState(value: unknown): value is L8ShadowQueueState {
+  if (!value || typeof value !== 'object' || !('pending' in value) || !Array.isArray(value.pending)
+    || !value.pending.every((item) => item && typeof item === 'object'
+      && Number.isSafeInteger(item.number) && item.number > 0
+      && typeof item.head === 'string' && /^[0-9a-f]{40}$/i.test(item.head)
+      && (item.files === undefined || Array.isArray(item.files) && item.files.every((file: unknown) => typeof file === 'string'))
+      && (item.filesUnmeasured === undefined || item.filesUnmeasured === true))
+    || !('verdicts' in value) || !Array.isArray(value.verdicts)
+    || !('deferred' in value ? Array.isArray(value.deferred) : true)) return false;
+  return true;
+}
+
+function candidates(state: L8ShadowQueueState): TrainCandidate[] {
+  return state.pending.map(({ number, head, files, filesUnmeasured }) => ({
+    number,
+    head,
+    ...(files === undefined ? {} : { files }),
+    ...(filesUnmeasured === undefined ? {} : { filesUnmeasured }),
+  }));
+}
+
+export function planLandQueue(state: unknown): LandPlan {
+  if (!isQueueState(state)) throw new Error('invalid shadow queue ledger');
+  return planTrain(candidates(state), { maxBatch: LAND_PLAN_MAX_BATCH });
+}
+
+export function runLandPlan(args: readonly string[]): LandPlan {
+  const state: unknown = JSON.parse(readFileSync(inputPath(args), 'utf8'));
+  return planLandQueue(state);
+}
+
+if (import.meta.main) {
+  try {
+    process.stdout.write(`${JSON.stringify(runLandPlan(process.argv.slice(2)))}\n`);
+  } catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+  }
+}

package/scripts/lib/decompose-ab.ts

@@ -204,6 +204,7 @@ function armSummary(records: readonly DecomposeAbRecord[], expectedRecords: numb
     'missing-research-context': 0,
     'grounding-empty': 0,
     'authored-empty': 0,
+    'slice-rejected': 0,
     'llm-failed': 0,
   };
   for (const record of observed) outcomes[record.measurement.outcome] += 1;

package/scripts/lib/fixtures/tui-regress/help-insufficient-commands.txt

@@ -0,0 +1,15 @@
+elanous 0.2.41 · owner · daemon: online
+┌─ Dashboard help ─────────────────────────────────────────────┐
+│ Commands                                                     │
+│ ▸ 대화                                                         │
+│   /help       이 명령들 목록                                       │
+│   /new        새 대화 시작                                        │
+│   /quit       종료                                             │
+│                                                              │
+│ Keys                                                         │
+│   Enter       메시지 보내기                                        │
+│   Ctrl+C      입력 지움 · 두 번 누르면 나갑니다                           │
+│   Esc         도움말 닫기                                         │
+│   PgUp/PgDn   스크롤                                            │
+└──────────────────────────────────────────────────────────────┘
+❯

package/scripts/lib/fixtures/tui-regress/help-live.txt

@@ -0,0 +1,42 @@
+PtyShellSnapshot process_id=pty_43b7df65 status=running source=live
+[screen 160x40 cursor=(row 36, col 2, visible true)]
+─┤ ChatLog ├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  elanous | daemon: absent · start: elanous --test=/private/var/folders/ws/f7tkbp2d4mg7_98pvhllpt140000gn/T/elanous-drive-UG60Kh nexus run --hmr
+
+
+
+
+
+                        ┌─────────────────────────────────────────────── Dashboard help ───────────────────────────────────────────────┐
+                        │Commands                                                                                                      │
+                        │▸ 시작                                                 /clear (cls)  대화 기록 지우기                         │
+                        │/help (?)  명령과 키 보기                              /model (m)  모델 바꾸기 — /model 빠름|보통|깊음 (코드… │
+                        │/resume  지난 대화 이어 가기 · /resume <id 앞자리>     /status (st)  지금 상태 — 모델 · 연결 · 계정           │
+                        │▸ 지켜보기                                             /now  현재 맥락과 출처 표 — /now [주제]                │
+                        │/remaining  계정별 남은 사용량                         ▸ 조사하기                                             │
+                        │/context (ctx)  Show / clear / drop attached files     ▸ 판단하기                                             │
+                        │/decide (dec)  열린 결정 카드 보기·답하기 — /decide [… ▸ 만들기                                               │
+                        │/harness  Harness — /harness <goal> (self-dev) · plan… ▸ 기억하기                                             │
+                        │/memory (mem)  Memory ops — list / show / search / ad… /session (sess)  Session resume — list / load / sync … │
+                        │▸ 그 밖                                                /quit (q, exit)  나가기                                │
+                        │/setup  상세 설정 — /setup · /setup reset(다음 실행 …  /side  사이드탭 기초 — 목록 · 셸 생성 · 번호로 PTY 보… │
+                        │                                                                                                              │
+                        │Keys                                                                                                          │
+                        │Enter  Send message                                                                                           │
+                        │Esc  Stop the answer (Esc again = rewind) · clear input / close help                                          │
+                        │Ctrl+U  Clear text before cursor                                                                              │
+                        │Ctrl+W  Delete previous word                                                                                  │
+                        │Ctrl+← / →  Move by word                                                                                      │
+                        │Delete  Delete next character                                                                                 │
+                        │Home / End  Move to start / end of line                                                                       │
+                        │Ctrl+A / E  Move to start / end of line                                                                       │
+                        │PgUp / PgDn  Scroll chat log                                                                                  │
+                        │Ctrl+↑  Recall all queued lines (Enter while answering queues · empty Enter pushes now)                       │
+                        └──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
+
+───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+❯                                                                                                                                                              
+───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+ 📁 work/OP-release-0241-resume  │ ⌥ 트리 HEAD@02594ba │ ▶ 실행 02594ba │ gpt-6-luna │ ⛭ pid:56132 │ ctx 0 │ 🖥 MacBookProM5

package/scripts/lib/fixtures/tui-regress/help-missing-keys.txt

@@ -0,0 +1,21 @@
+elanous 0.2.41 · owner · daemon: online
+┌─ Dashboard help ─────────────────────────────────────────────┐
+│ Commands                                                     │
+│ ▸ 대화                                                         │
+│   /help       이 명령들 목록                                       │
+│   /new        새 대화 시작                                        │
+│   /quit       종료                                             │
+│ ▸ 지시                                                         │
+│   /directive  대표 지시                                          │
+│   /decide     결정 요청                                          │
+│ ▸ 작업                                                         │
+│   /missions   미션 목록                                          │
+│   /tasks      작업 목록                                          │
+│   /review     리뷰 열기                                          │
+│   /publish    발행                                             │
+│ ▸ 시스템                                                        │
+│   /provider   LLM 공급자                                        │
+│   /model      모델                                             │
+│   /settings   설정                                             │
+└──────────────────────────────────────────────────────────────┘
+❯

package/scripts/lib/fixtures/tui-regress/help-original.txt

@@ -0,0 +1,51 @@
+[screen 160x50 cursor=(row 46, col 2, visible true)]
+─┤ ChatLog ├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  elanous | daemon: absent · start: elanous --test=/var/folders/ws/f7tkbp2d4mg7_98pvhllpt140000gn/T/tui-regress-R6-EL8CgF nexus run --hmr
+
+
+
+
+
+
+
+
+
+
+                        ┌─────────────────────────────────────────────── Dashboard help ───────────────────────────────────────────────┐
+                        │Commands                                                                                                      │
+                        │▸ 시작                                                 /clear (cls)  대화 기록 지우기                         │
+                        │/help (?)  명령과 키 보기                              /model (m)  모델 바꾸기 — /model 빠름|보통|깊음 (코드… │
+                        │/resume  지난 대화 이어 가기 · /resume <id 앞자리>     /status (st)  지금 상태 — 모델 · 연결 · 계정           │
+                        │▸ 지켜보기                                             /now  현재 맥락과 출처 표 — /now [주제]                │
+                        │/remaining  계정별 남은 사용량                         ▸ 조사하기                                             │
+                        │/context (ctx)  Show / clear / drop attached files     ▸ 판단하기                                             │
+                        │/decide (dec)  열린 결정 카드 보기·답하기 — /decide [… ▸ 만들기                                               │
+                        │/harness  Harness — /harness <goal> (self-dev) · plan… ▸ 기억하기                                             │
+                        │/memory (mem)  Memory ops — list / show / search / ad… /session (sess)  Session resume — list / load / sync … │
+                        │▸ 그 밖                                                /quit (q, exit)  나가기                                │
+                        │/setup  상세 설정 — /setup · /setup reset(다음 실행 …  /side  사이드탭 기초 — 목록 · 셸 생성 · 번호로 PTY 보… │
+                        │                                                                                                              │
+                        │Keys                                                                                                          │
+                        │Enter  Send message                                                                                           │
+                        │Esc  Stop the answer (Esc again = rewind) · clear input / close help                                          │
+                        │Ctrl+U  Clear text before cursor                                                                              │
+                        │Ctrl+W  Delete previous word                                                                                  │
+                        │Ctrl+← / →  Move by word                                                                                      │
+                        │Delete  Delete next character                                                                                 │
+                        │Home / End  Move to start / end of line                                                                       │
+                        │Ctrl+A / E  Move to start / end of line                                                                       │
+                        │PgUp / PgDn  Scroll chat log                                                                                  │
+                        │Ctrl+↑  Recall all queued lines (Enter while answering queues · empty Enter pushes now)                       │
+                        └──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
+
+
+
+
+
+
+───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+❯                                                                                                                                                              
+───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+
+ 📁 tui-node-jrXm9J/tree  │ ⌥ 트리 HEAD@02594ba │ ▶ 실행 02594ba │ gpt-6-luna │ ctx 0 │ 🖥 MacBookProM5