elanous 0.2.31 → 0.2.34

package/graphs/units/recover.yaml

@@ -0,0 +1,39 @@
+graph_id: recover
+version: 1
+unit:
+  inputs: [ask, context, prior]
+  outputs: [result, evidence]
+  exits: [done, rework, needs-human, failed]
+  entries: [plan, request-review, wait-retry, human-review]
+entry_node: plan
+terminal_nodes: [done, rework, needs-human, failed]
+nodes:
+  - node_id: plan
+    kind: agent
+    recipe: 'cmd:recover-plan'
+    max_visits: 1
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - node_id: request-review
+    kind: agent
+    recipe: 'cmd:recover-plan'
+    max_visits: 1
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - node_id: wait-retry
+    kind: agent
+    recipe: 'cmd:recover-plan'
+    max_visits: 1
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - node_id: human-review
+    kind: agent
+    recipe: 'cmd:recover-plan'
+    max_visits: 1
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: rework, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: needs-human, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: failed, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - { from: plan, on: outcome, map: { done: done, rework: rework, needs-human: needs-human, failed: failed, fail: failed } }
+  - { from: request-review, on: outcome, map: { done: done, rework: rework, needs-human: needs-human, failed: failed, fail: failed } }
+  - { from: wait-retry, on: outcome, map: { done: done, rework: rework, needs-human: needs-human, failed: failed, fail: failed } }
+  - { from: human-review, on: outcome, map: { done: done, rework: rework, needs-human: needs-human, failed: failed, fail: failed } }

package/graphs/units/reflect/recipes.yaml

@@ -0,0 +1,3 @@
+reflect:
+  command: 'bun scripts/graph-units/reflect-node.ts'
+  timeout_ms: 30000

package/graphs/units/reflect/reflect.yaml

@@ -0,0 +1,15 @@
+graph_id: reflect
+version: 1
+unit:
+  inputs: [ask, context, prior]
+  outputs: [result, evidence]
+  exits: [done, wait, needs-human]
+entry_node: reflect
+terminal_nodes: [done, wait, needs-human]
+nodes:
+  - { node_id: reflect, kind: agent, recipe: 'cmd:reflect', max_visits: 1 }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: wait, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: needs-human, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - { from: reflect, on: outcome, map: { done: done, wait: wait, needs-human: needs-human } }

package/graphs/units/task-agent-recover-review.yaml

@@ -0,0 +1,17 @@
+graph_id: task-agent-recover-review
+version: 1
+entry_node: recover
+terminal_nodes: [done, failed]
+nodes:
+  - node_id: recover
+    kind: subgraph
+    recipe: none
+    max_visits: 1
+    call: recover@1
+    call_entry: request-review
+    budget: { inner_steps: 3 }
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: failed, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - { from: recover, on: outcome, map: { done: done, rework: done, needs-human: failed, failed: failed } }

package/graphs/units/task-agent-recover-wait.yaml

@@ -0,0 +1,17 @@
+graph_id: task-agent-recover-wait
+version: 1
+entry_node: recover
+terminal_nodes: [done, failed]
+nodes:
+  - node_id: recover
+    kind: subgraph
+    recipe: none
+    max_visits: 1
+    call: recover@1
+    call_entry: wait-retry
+    budget: { inner_steps: 3 }
+    contract: { inputs: [ask, context, prior], tools: read-only, outputs: [result, evidence] }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: failed, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - { from: recover, on: outcome, map: { done: done, rework: done, needs-human: failed, failed: failed } }

package/graphs/units/verbs/make-doc.yaml

@@ -0,0 +1,34 @@
+graph_id: verb-make-doc
+version: 1
+entry_node: prepare
+terminal_nodes: [done, rework, needs-human, failed]
+unit:
+  inputs: [ask, context, prior]
+  outputs: [result, evidence]
+  exits: [done, rework, needs-human, failed]
+nodes:
+  - node_id: prepare
+    kind: observe
+    recipe: 'cmd:make-doc-input'
+    max_visits: 1
+    contract:
+      inputs: [ask, context, prior]
+      tools: none
+      outputs: [goal, worktree, branch, review-intent, head-sha, base-branch, prior]
+  - node_id: document-draft
+    kind: agent
+    recipe: 'cmd:headless-goal-loop'
+    max_visits: 4
+    contract:
+      inputs: [goal, worktree]
+      tools: worktree-write
+      outputs: [outcome, result, evidence]
+  - { node_id: done, kind: gate, recipe: 'cmd:make-doc-output', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: rework, kind: gate, recipe: 'cmd:make-doc-output', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: needs-human, kind: hitl, recipe: 'cmd:make-doc-output', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: failed, kind: observe, recipe: 'cmd:make-doc-output', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+edges:
+  - { from: prepare, to: document-draft }
+  - from: document-draft
+    on: outcome
+    map: { done: done, rework: rework, needs-human: needs-human, failed: failed }

package/graphs/units/verbs/recipes.yaml

@@ -0,0 +1,33 @@
+make-doc-input:
+  command: 'bun scripts/graph-units/verbs-envelope.ts make-doc-input'
+  timeout_ms: 10000
+make-doc-output:
+  command: 'bun scripts/graph-units/verbs-envelope.ts make-doc-output'
+  timeout_ms: 10000
+verify-envelope:
+  command: 'bun scripts/graph-units/verbs-envelope.ts verify-envelope'
+  timeout_ms: 10000
+verify-output-done:
+  command: 'bun scripts/graph-units/verbs-envelope.ts verify-output done'
+  timeout_ms: 10000
+verify-output-rework:
+  command: 'bun scripts/graph-units/verbs-envelope.ts verify-output rework'
+  timeout_ms: 10000
+verify-output-needs-human:
+  command: 'bun scripts/graph-units/verbs-envelope.ts verify-output needs-human'
+  timeout_ms: 10000
+verify-output-failed:
+  command: 'bun scripts/graph-units/verbs-envelope.ts verify-output failed'
+  timeout_ms: 10000
+headless-goal-loop:
+  command: 'bun scripts/graph-units/verbs/headless-goal-loop.ts'
+  dry_run_command: 'printf ''{"outcome":"done","result":"dry-run","evidence":{}}\n'''
+  timeout_ms: 300000
+gate-baseline:
+  command: 'bun scripts/graph-units/verbs/verify-stage.ts gate'
+  dry_run_command: 'printf ''{"outcome":"pass","passed":true,"gate-log":"dry-run"}\n'''
+  timeout_ms: 600000
+pr-reviewer:
+  command: 'bun scripts/graph-units/verbs/verify-stage.ts review'
+  dry_run_command: 'printf ''{"outcome":"pass","verdict":"pass","must-fix":[],"review-summary":"dry-run"}\n'''
+  timeout_ms: 180000

package/graphs/units/verbs/verify.yaml

@@ -0,0 +1,55 @@
+graph_id: verb-verify
+version: 1
+entry_node: prepare
+terminal_nodes: [done, rework, needs-human, failed]
+unit:
+  inputs: [ask, context, prior]
+  outputs: [result, evidence]
+  exits: [done, rework, needs-human, failed]
+nodes:
+  - node_id: prepare
+    kind: observe
+    recipe: 'cmd:verify-envelope'
+    max_visits: 1
+    contract:
+      inputs: [ask, context, prior]
+      tools: none
+      outputs: [outcome, worktree, changed-files, diff, review-intent, must-fix, gate-log]
+  - node_id: gate
+    kind: gate
+    recipe: 'cmd:gate-baseline'
+    max_visits: 11
+    progress: [gating, gated]
+    terminal_stages: []
+    contract: { inputs: [worktree, changed-files], tools: read-and-run-tests, outputs: [outcome, passed, gate-log] }
+  - node_id: review
+    kind: judge
+    recipe: 'cmd:pr-reviewer'
+    max_visits: 11
+    progress: [reviewing, reviewed]
+    terminal_stages: [review-blocked]
+    contract: { inputs: [diff, review-intent], tools: read-only, outputs: [outcome, verdict, must-fix, review_summary] }
+  - node_id: rework-loop
+    kind: agent
+    recipe: 'cmd:headless-goal-loop'
+    max_visits: 10
+    progress: [implementing]
+    terminal_stages: [gate-failed, review-blocked, no-changes]
+    contract: { inputs: [must-fix, gate-log, worktree], tools: worktree-write, outputs: [outcome, diff, must-fix, evidence] }
+  - { node_id: done, kind: gate, recipe: 'cmd:verify-output-done', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: rework, kind: gate, recipe: 'cmd:verify-output-rework', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: needs-human, kind: hitl, recipe: 'cmd:verify-output-needs-human', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+  - { node_id: failed, kind: observe, recipe: 'cmd:verify-output-failed', max_visits: 1, contract: { inputs: [], tools: none, outputs: [result, evidence] } }
+edges:
+  - from: prepare
+    on: outcome
+    map: { gate: gate, review: review, rework: rework-loop, failed: failed }
+  - from: gate
+    on: outcome
+    map: { pass: review, fail: rework-loop, needs-human: needs-human, failed: failed }
+  - from: review
+    on: outcome
+    map: { pass: done, fail: rework-loop, needs-human: needs-human, failed: failed }
+  - from: rework-loop
+    on: outcome
+    map: { done: gate, needs-human: needs-human, failed: rework }

package/graphs/work/recipes.yaml

@@ -0,0 +1,2 @@
+# work-research-report-rehearsal has no command nodes; its behavior is in called graph units.
+{}

package/graphs/work/research-report.yaml

@@ -0,0 +1,28 @@
+graph_id: work-research-report-rehearsal
+version: 1
+entry_node: make-doc
+terminal_nodes: [done, failed]
+nodes:
+  - node_id: make-doc
+    kind: subgraph
+    recipe: none
+    max_visits: 3
+    call: verb-make-doc@1
+    budget: { inner_steps: 16 }
+    contract: { inputs: [ask, context, prior], tools: worktree-write, outputs: [result, evidence] }
+  - node_id: verify
+    kind: subgraph
+    recipe: none
+    max_visits: 3
+    call: verb-verify@1
+    budget: { inner_steps: 16 }
+    contract: { inputs: [ask, context, prior], tools: read-and-run-tests, outputs: [result, evidence] }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: failed, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - from: make-doc
+    on: outcome
+    map: { done: verify, rework: make-doc, needs-human: failed, failed: failed }
+  - from: verify
+    on: outcome
+    map: { done: done, rework: make-doc, needs-human: failed, failed: failed }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elanous",
   "mcpName": "io.github.ElanvitalAI/elanous",
-  "version": "0.2.31",
+  "version": "0.2.34",
   "description": "Self-healing coding harness where eyes, hands, and memory all turn on one sentence — it authors its own goals, implements them in isolated worktrees, and reviews its own work.",
   "license": "Apache-2.0",
   "author": "Elanvital AI",

package/scripts/ci-typecheck-changed.ts

@@ -1,7 +1,7 @@
 /** Changed-file tsc gate with a visible ratchet for pre-existing test-only debt. */
 import { execFileSync, execSync } from 'node:child_process';
 import { existsSync, mkdtempSync, readFileSync, realpathSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
+import { hostname, tmpdir } from 'node:os';
 import { join } from 'node:path';
 import ts from 'typescript';
 import {
@@ -26,6 +26,7 @@ import {
 } from './tsc-baseline-cache.js';
 import { TSC_OOM_RETRY_HEAP_MB, TSC_HEAP_MB, tscEnv } from '../src/typecheck-ratchet.js';
 import { runIncrementalCachedTsc } from './tsc-incremental-cache.js';
+import type { GateRemoteFlags } from '../src/self-implement/gate-remote.js';
 
 /** Inherited GIT_DIR / GIT_WORK_TREE would make `--cwd <other tree>` still read the launcher's repo. */
 function gitEnv(base: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {
@@ -147,12 +148,12 @@ export function changedTsFiles(run: (cmd: string) => string = sh, env: NodeJS.Pr
   let uncountableBase: { command: string; why: string } | undefined;
   if (head && quietRevision(`git rev-parse ${base}`) === head) {
     const main = quietRevision('git rev-parse origin/main');
-    const merged = main && main !== head ? quietRevision('git merge-base HEAD origin/main') : '';
+    const merged = main ? quietRevision('git merge-base HEAD origin/main') : '';
     if (merged && merged !== head) {
       warnings.push(`base=${base} 가 HEAD 와 같은 커밋 — origin/main (${main})과 달라 merge-base 로 재계산`);
       base = merged;
       baseSource = 'recomputed merge-base(origin/main)';
-    } else if (main && main !== head) {
+    } else if ((merged === head && head) || (!merged && main && main !== head)) {
       uncountableBase = { command: `git rev-parse ${base}`, why: `base 가 HEAD(${head}) 와 같아 변경을 셀 수 없다 — TSC_BASE_REF 로 base 를 주라 (못 셌음 ≠ 0)` };
     }
   }
@@ -838,6 +839,23 @@ export function rebaseWorktreePaths(diagnostics: readonly TypecheckError[], work
 
 export type BaselineCacheIo = BaselineCacheOptions & { log?: (message: string) => void };
 
+/**
+ * 기준 worktree 임시 공간의 루트 — 운영자가 TMPDIR 을 못 박지 않았으면 «호스트 디스크»(/var/tmp)를 먼저 고른다.
+ * 🩸 WSL-GATE-ENV(2026-10-17 · host-e-wsl): WSL 의 /tmp 는 20GiB tmpfs 인데 기준 checkout 하나로 끝날 수 있다
+ *   (`src/self-implement/gate-remote.ts` remoteScript 가 같은 이유로 원격 자식에게 TMPDIR=/var/tmp 를 준다).
+ *   이 게이트가 호스트에서 직접 돌 때(self gate --changed · pod) TMPDIR 이 비어 있으면 기준 측정이 같은 tmpfs 에
+ *   걸리고, 공간이 차면 mkdtemp 가 ENOSPC 으로 죽는다 — 그 throw 는 readMergeBaseDiagnostics 의 try «밖»이라
+ *   게이트가 판정 한 줄 없이 통째로 죽는다. node-c 의 /tmp 는 디스크라 같은 head·base 도 0으로 지나간다
+ *   (「wsl 환경 실패(node-c 는 0)」 · introduced/preexisting 판정 불일치의 몸통).
+ * ⛔ TMPDIR 이 이미 정해져 있으면 «그 값»을 그대로 쓴다(원격 러너·운영자 지정이 최우선 · 받은 env 기준). /var/tmp 가 없는 호스트는
+ *   오늘 길(tmpdir())로 물러난다 — 이 선택은 진단 내용에 닿지 않는다(rebaseWorktreePaths 가 worktree 경로를
+ *   실제 트리로 되돌리고, 캐시는 ROOT_PLACEHOLDER 로 저장한다).
+ */
+export function baselineWorkspaceRoot(env: NodeJS.ProcessEnv = process.env, present: (path: string) => boolean = existsSync): string {
+  if (env.TMPDIR) return env.TMPDIR;
+  return present('/var/tmp') ? '/var/tmp' : tmpdir();
+}
+
 /**
  * 같은 base 커밋 ⊕ 같은 명령 ⊕ 같은 설정 해시 ⊕ 같은 작업 트리 설치 키면 저장된 진단을 재사용한다(워크트리·tsc 0회).
  * 캐시의 어떤 실패도 던지지 않는다 — miss 로 떨어져 아래 측정이 그대로 돈다.
@@ -858,7 +876,15 @@ export function readMergeBaseDiagnostics(base: string, command: string, cwd = pr
     const cached = lookupCachedBaseline(cacheKey, command, cwd, cacheIo, installKey);
     if (cached) return cached;
   }
-  const workspace = mkdtempSync(join(tmpdir(), 'ci-typecheck-baseline-'));
+  // ⛔ WSL-GATE-ENV: 임시 공간은 baselineWorkspaceRoot 가 고르고, 고른 루트가 못 쓰이면(권한·용량) 오늘 길로
+  //    물러난다. mkdtemp 실패가 판정 없이 게이트를 통째로 죽이던 길(ENOSPC · try 밖 throw)을 없앤다.
+  //    둘 다 못 쓰이면 던지지 않고 «기준을 못 얻었다»(unavailable)로 판정을 낸다.
+  let workspace: string;
+  try { workspace = mkdtempSync(join(baselineWorkspaceRoot(cacheIo.env ?? process.env), 'ci-typecheck-baseline-')); }
+  catch {
+    try { workspace = mkdtempSync(join(tmpdir(), 'ci-typecheck-baseline-')); }
+    catch (error) { return { unavailable: `기준 임시 공간을 만들 수 없다: ${error instanceof Error ? error.message : String(error)}` }; }
+  }
   const worktree = join(workspace, 'base');
   try {
     execFileSync('git', ['worktree', 'add', '--detach', worktree, base], { cwd, stdio: 'pipe', env: gitEnv() });
@@ -898,6 +924,10 @@ export type GateIo = {
   baseRef?: string;
   /** Source of TSC_GATE_ROOTS / ELANOUS_TSC_AFFECTED_ROOTS. Defaults to process.env. */
   env?: NodeJS.ProcessEnv;
+  /** Refuse an unbounded root program on the MBP seat before starting tsc. */
+  forbidFullLocal?: boolean;
+  /** Only pr land may measure a dependency-free target with the installed compiler. */
+  allowMissingCheckoutDependencies?: boolean;
   /** Changed gate sources → themselves plus their direct importers. Defaults to the repository import-graph reader. */
   affectedRoots?: (cwd: string, changed: ReadonlySet<string>) => AffectedRoots;
   log: (message: string) => void;
@@ -920,10 +950,11 @@ export function formatOutsideChangedWarning(outsideChanged: readonly { file: str
   return `[tsc-gate] ⚠ 변경 파일 밖 진단 ${total}건이 파일 ${fileCount}개에서 버려짐: ${nameText}`;
 }
 
-function inspectTscResult(tsc: TscRun, changed: ReadonlySet<string>, baseline: ReadonlyMap<string, number>, error: (message: string) => void, warn: (message: string) => void, wholeRepository = false, excludedPrefixes: readonly string[] = [], includedPrefixes: readonly string[] = [], promotionBaseline?: BaselineDiagnostics, excludeTests = false): boolean {
+function inspectTscResult(tsc: TscRun, changed: ReadonlySet<string>, baseline: ReadonlyMap<string, number>, error: (message: string) => void, warn: (message: string) => void, wholeRepository = false, excludedPrefixes: readonly string[] = [], includedPrefixes: readonly string[] = [], promotionBaseline?: BaselineDiagnostics, excludeTests = false, requireAllDiagnostics = false): boolean {
   if (!tsc.ran) {
     error(`[tsc-gate] ⛔ 실행 판정 실패 — ${tsc.why}`);
     if (tsc.out.trim()) error(tsc.out.trim().slice(0, 2000));
+    if (tsc.why?.includes('ENOENT') || tsc.why?.includes('종료코드 127') || /Module not found ["'].*typescript\/bin\/tsc/.test(tsc.out)) error('[tsc-gate] TypeScript 실행 파일을 확인하십시오 — 대상 트리 또는 설치본에서 bun install --frozen-lockfile 뒤 재실행하십시오.');
     error('[tsc-gate] FAIL — tsc 가 정상 실행됐음을 확인할 수 없다(통과로 읽지 않는다).');
     return false;
   }
@@ -943,7 +974,11 @@ function inspectTscResult(tsc: TscRun, changed: ReadonlySet<string>, baseline: R
     warn(`[tsc-gate] ⚠ 기준 진단을 얻지 못했다 — ${promotionBaseline.unavailable} (관측만 · 비차단; 현재 진단은 면제하지 않는다).`);
   }
   const promotionDiff = wholeRepository && baselineDiagnostics ? diffTypecheckDiagnostics(diagnostics, baselineDiagnostics) : undefined;
-  const result = classifyTypecheckErrors(promotionDiff?.added ?? diagnostics, wholeRepository ? new Set((promotionDiff?.added ?? diagnostics).map((diagnostic) => diagnostic.file)) : changed, baseline);
+  // Without the target's declarations, even a diagnostic outside the changed files
+  // may be caused by the missing installation. Do not call that measurement clean.
+  const classified = promotionDiff?.added ?? diagnostics;
+  const result = classifyTypecheckErrors(classified, wholeRepository || requireAllDiagnostics
+    ? new Set(classified.map((diagnostic) => diagnostic.file)) : changed, requireAllDiagnostics ? new Map() : baseline);
   if (promotionDiff?.existing.length) {
     const existingByFile = new Map<string, number>();
     for (const diagnostic of promotionDiff.existing) existingByFile.set(diagnostic.file, (existingByFile.get(diagnostic.file) ?? 0) + 1);
@@ -961,7 +996,7 @@ function inspectTscResult(tsc: TscRun, changed: ReadonlySet<string>, baseline: R
   }
   if (result.outsideChanged.length > 0) warn(formatOutsideChangedWarning(result.outsideChanged));
   if (result.failing.length === 0) return true;
-  const failureScope = wholeRepository ? '저장소 전체 범위' : '변경 파일';
+  const failureScope = wholeRepository ? '저장소 전체 범위' : requireAllDiagnostics ? '대상 트리 타입 진단' : '변경 파일';
   error(`\n[tsc-gate] FAIL — ${failureScope}에 타입 에러 ${result.failing.length}건:`);
   for (const entry of result.failing) error('  ' + entry.line);
   error('\n건드린 src/scripts 파일과 baseline 밖 test 파일은 tsc 클린이어야 합니다(touch-clean).');
@@ -1009,7 +1044,7 @@ export function resolveTscScript(cwd: string, scriptsDir = import.meta.dir, pres
   ].find(present);
 }
 
-/** The installed compiler cannot resolve declarations from a checkout without its own dependencies. */
+/** Identify missing target declarations; partial installations and PWA checks remain fail-closed. */
 export function missingCheckoutTypeDependencies(cwd: string, needsPwa = false, present: (path: string) => boolean = existsSync): string[] {
   const missing: string[] = [];
   if (!present(join(cwd, 'node_modules'))) missing.push('node_modules');
@@ -1097,6 +1132,11 @@ export function runGate(io: Partial<GateIo> = {}): void {
     for (const removal of literalRemovals) warn(`  ${removal.referenceFile}:${removal.line}: ${removal.typeName} -= '${removal.literal}' (${removal.file})`);
   }
   const wholeRepository = requiredFields.length > 0 || removedSymbols.length > 0 || parameterIncreases.length > 0;
+  if (io.forbidFullLocal && wholeRepository) {
+    error('[tsc-gate] FAIL — mbp 로 전체 tsc 승격을 실행하지 않는다. --remote 로 다시 재라 (원격 불가=미측정).');
+    exit(1);
+    return;
+  }
   const pwaChanged = new Set([...changed].filter((file) => file.startsWith('apps/pwa/')));
   const rootChanged = new Set([...changed].filter((file) => !pwaChanged.has(file)));
   // 앱 파일은 앱 설정만 소유한다. 전체 승격은 root 설정만 저장소 전체로 올리고,
@@ -1131,11 +1171,14 @@ export function runGate(io: Partial<GateIo> = {}): void {
   }, { level: 'info' });
   log(`[tsc-gate] root 설정 범위 ${rootScope.size}개 관측 (apps/pwa/** 제외).`);
   if (runsPwa) log(`[tsc-gate] PWA 설정 범위 ${pwaScope.size}개 관측.`);
-  // K-OP-039: PWA checks without app dependencies produce fake type errors.
-  // The target checkout's declarations are required even when a compiler is
-  // supplied by the installed CLI or injected by another gate caller.
+  // K-OP-039: partial installations without PWA dependencies produce fake type errors.
+  // A checkout with no root node_modules can instead be measured by the installed compiler;
+  // missing root/PWA declarations and configuration diagnostics must not become a clean pass.
   const missing = missingCheckoutTypeDependencies(cwd, runsPwa || wholeRepository);
-  if (missing.length > 0) {
+  const installedCompilerCanMeasure = io.allowMissingCheckoutDependencies === true && !io.runTscCmd && missing.includes('node_modules')
+    && missing.includes('bun-types') && missing.every((dependency) =>
+      dependency === 'node_modules' || dependency === 'bun-types' || dependency === 'apps/pwa/node_modules');
+  if (missing.length > 0 && !installedCompilerCanMeasure) {
     const quotedCwd = `'${cwd.replaceAll("'", "'\\''")}'`;
     const install = `cd ${quotedCwd} && bun install --frozen-lockfile${missing.includes('apps/pwa/node_modules') ? ' && (cd apps/pwa && bun install --frozen-lockfile)' : ''}`;
     error(`[tsc-gate] ⛔ 대상 트리 타입 의존성 없음: ${missing.join(', ')} — ${install}`);
@@ -1168,13 +1211,18 @@ export function runGate(io: Partial<GateIo> = {}): void {
     if (!cacheEnabled) return runTscCmd(command);
     return runIncrementalCachedTsc({
       cwd, base, head, changed, config, command, cacheDir: cacheDir!, run: runTscCmd, log,
-      decision: (result) => result.ran && inspectTscResult(result, scope, baseline, () => {}, () => {}, wholeRepository, excluded, included, promotionBaseline, excludeTests),
+      decision: (result) => result.ran && inspectTscResult(result, scope, baseline, () => {}, () => {}, wholeRepository, excluded, included, promotionBaseline, excludeTests, installedCompilerCanMeasure),
     });
   };
   const rootPromotionBaseline = wholeRepository ? readBaselineDiagnostics(base, rootCommand) : undefined;
   const pwaPromotionBaseline = wholeRepository && runsPwa ? readBaselineDiagnostics(base, pwaCommand) : undefined;
   const pwaEnvPromotionBaseline = wholeRepository && runsPwaEnv ? readBaselineDiagnostics(base, pwaEnvCommand) : undefined;
   let rootPlan = planRootCheck({ wholeRepository, rootChanged, env: io.env ?? process.env, cwd, affectedRoots: io.affectedRoots ?? reverseImportAffectedRoots });
+  if (io.forbidFullLocal && rootPlan.mode === 'full') {
+    error(`[tsc-gate] FAIL — mbp 로 전체 tsc 를 실행하지 않는다 (${rootPlan.fallbackReason}). --remote 로 다시 재라 (원격 불가=미측정).`);
+    exit(1);
+    return;
+  }
   let rootsConfig: string | undefined;
   if (rootPlan.mode === 'affected') {
     rootsConfig = cacheEnabled ? 'tsconfig.gate-roots.incremental.json' : `tsconfig.gate-roots.${process.pid}.${Date.now()}.json`;
@@ -1204,12 +1252,12 @@ export function runGate(io: Partial<GateIo> = {}): void {
     rootsConfig ?? TYPECHECK_GATE_CONFIG, rootScope, ['apps/pwa/'], [], rootPromotionBaseline); }
   finally { if (rootsConfig) rmSync(join(cwd, rootsConfig), { force: true }); }
   let unmeasured = !rootTsc.ran;
-  let passed = inspectTscResult(rootTsc, rootScope, baseline, error, warn, wholeRepository, ['apps/pwa/'], [], rootPromotionBaseline);
+  let passed = inspectTscResult(rootTsc, rootScope, baseline, error, warn, wholeRepository, ['apps/pwa/'], [], rootPromotionBaseline, false, installedCompilerCanMeasure);
   if (runsPwa) {
     log(`[tsc-gate] PWA 변경 ${pwaChanged.size}개 관측 — apps/pwa/tsconfig.json 검사.`);
     const pwaTsc = checkedTsc(pwaCommand, 'apps/pwa/tsconfig.json', pwaScope, [], ['apps/pwa/'], pwaPromotionBaseline);
     unmeasured = unmeasured || !pwaTsc.ran;
-    passed = inspectTscResult(pwaTsc, pwaScope, baseline, error, warn, wholeRepository, [], ['apps/pwa/'], pwaPromotionBaseline) && passed;
+    passed = inspectTscResult(pwaTsc, pwaScope, baseline, error, warn, wholeRepository, [], ['apps/pwa/'], pwaPromotionBaseline, false, installedCompilerCanMeasure) && passed;
   }
   if (runsPwaEnv) {
     log(`[tsc-gate] PWA env 패스 — 루트 비시험 ${nonTestRootChanged.size}개 (Next ProcessEnv 선언 포함).`);
@@ -1217,6 +1265,13 @@ export function runGate(io: Partial<GateIo> = {}): void {
     unmeasured = unmeasured || !pwaEnvTsc.ran;
     passed = inspectTscResult(pwaEnvTsc, pwaEnvScope, baseline, error, warn, wholeRepository, ['apps/pwa/'], [], pwaEnvPromotionBaseline, true) && passed;
   }
+  if (passed && installedCompilerCanMeasure && missing.includes('apps/pwa/node_modules')) {
+    const quotedCwd = `'${cwd.replaceAll("'", "'\\''")}'`;
+    error(`[tsc-gate] ⛔ 대상 트리 타입 의존성 없음: apps/pwa/node_modules — cd ${quotedCwd} && bun install --frozen-lockfile && (cd apps/pwa && bun install --frozen-lockfile)`);
+    error('[tsc-gate] FAIL — PWA 의존성이 없는 트리의 진단 0건은 통과가 아니다.');
+    exit(1);
+    return;
+  }
   if (passed) { log('[tsc-gate] PASS — 변경 파일에 신규 타입 에러 없음.'); return; }
   // ⛔⭐⭐ T67 — ***마지막 줄은 언제나 「판정」이어야 한다.*** 사람도 도구도 마지막 줄을 읽는다.
   //   🩸 2026-09-11 실측(🅕 보고): 타입 에러 3건이 있는데 `tail -1` 이 «경고»를 집어
@@ -1241,6 +1296,26 @@ export function runGate(io: Partial<GateIo> = {}): void {
 //   ⭐ 그래서 막는 자리는 «여기»뿐이다 — 인-프로세스 호출자(`pr-cli.ts`·`seams.ts`)는
 //      argv 를 안 넘기고, 만약 여기서 `process.argv` 를 «읽으면» 형제 게이트가 경고한 그 사고가 난다
 //      (`elanous pr land` 의 인자를 자기 인자로 읽는다 — `src/cli/pr-cli.ts` 의 `args: []` 주석).
+/** Physical MBP/HQ seat shells need a guard even when the caller explicitly selected --local. */
+export function isHeadquartersTypecheckShell(host: string, cwd: string): boolean {
+  const name = host.toLowerCase();
+  if (/macstudio|macmini|host-e|node-b|node-c/.test(name)) return false;
+  return /macbook|(?:^|[-.])mbp(?:[-.]|$)/.test(name) || /(?:^|\/)elanous-hq\/(?:seats|work)\//.test(cwd);
+}
+
+/** HQ/seat shells default to node-b; a gate Pod, remote worker, or CI measures its own checkout locally. */
+export function forbidFullTypecheckOnLocal(env: NodeJS.ProcessEnv, host: string, cwd: string): boolean {
+  if (env.CI || env.KUBERNETES_SERVICE_HOST || env.ELANOUS_GATE_REMOTE_CHILD === '1') return false;
+  return isHeadquartersTypecheckShell(host, cwd);
+}
+
+export const defaultTypecheckRemote = forbidFullTypecheckOnLocal;
+
+export function typecheckDispatchFlags(flags: GateRemoteFlags, env: NodeJS.ProcessEnv, host: string, cwd: string): GateRemoteFlags {
+  return defaultTypecheckRemote(env, host, cwd) && flags.remote === undefined && !flags.local
+    ? { ...flags, remote: 'node-b' } : flags;
+}
+
 if (import.meta.main) void (async () => {
   // GATE-REMOTE (10-06): the only accepted arguments are the dispatch flags `--remote [host]` / `--local` — they choose
   //   «where» the same commit is measured, never «what» (the base stays merge-base(origin/main) on both sides).
@@ -1256,14 +1331,17 @@ if (import.meta.main) void (async () => {
     process.exit(2);
   }
   const repo = sh('git rev-parse --show-toplevel').trim();
+  const onMbp = forbidFullTypecheckOnLocal(process.env, hostname(), repo);
+  const dispatchFlags = typecheckDispatchFlags(flags, process.env, hostname(), repo);
   const baseRef = process.env.TSC_BASE_REF;
   const passEnv = (sha: (ref: string) => string) => (['NODE_OPTIONS', 'TSC_BASE_REF', 'TSC_HEAP_MB'] as const).filter((key) => process.env[key])
     .map((key) => `${key}=${key === 'TSC_BASE_REF' && baseRef !== 'origin/main' ? sha(baseRef!) : process.env[key]}`);
   // exitCode, not exit(): piped stdout/stderr drain before the process ends.
   process.exitCode = await dispatchHeavyCheck({
-    tool: 'ci-typecheck-changed', repo, flags,
+    tool: 'ci-typecheck-changed', repo, flags: dispatchFlags, explicitRemoteOnly: dispatchFlags.remote !== undefined,
+    stableCheckout: true, installPwa: true,
     remoteArgv: (sha) => { const vars = passEnv(sha); return [...(vars.length ? ['env', ...vars] : []), 'bun', 'run', 'scripts/ci-typecheck-changed.ts', '--local']; },
     refs: baseRef ? [baseRef] : [],
-    runLocal: () => { runGate(); return 0; },
+    runLocal: () => { runGate({ forbidFullLocal: onMbp }); return 0; },
   });
 })();

package/scripts/docs/generate-graph-anatomy.ts

@@ -26,6 +26,7 @@ import {
   type GraphParseIssue,
   type GraphTemplateSpec,
 } from '../../src/self-implement/graph-yaml.js';
+import { flattenGraphTemplate } from '../../src/self-implement/graph-unit-resolver.js';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 
 /** drafts/ · overlays/ 는 스캔에서 뺀다(실측 10-05). 그 이름인 디렉터리와 그 아래는 안 읽는다. */
@@ -104,7 +105,22 @@ function graphFileNames(abs: string): string[] {
 
 /** loadGraphTemplates for harness dirs; the runner's reading for workflow-graph dirs (same result shape). */
 function loadDir(abs: string): GraphLoadResult {
-  if (!isRunnerDir(abs)) return loadGraphTemplates(abs);
+  if (!isRunnerDir(abs)) {
+    const loaded = loadGraphTemplates(abs);
+    if (loaded.scannedFiles === 0) return loaded;
+    const errors = [...loaded.errors];
+    const templates: Record<string, GraphTemplateSpec> = {};
+    for (const file of graphFileNames(abs)) {
+      let source: string;
+      try { source = readFileSync(join(abs, file), 'utf8'); }
+      catch (error) { errors.push({ path: file, message: `읽기 실패: ${String(error)}` }); continue; }
+      const parsed = parseGraphTemplateYaml(source, file);
+      if (!parsed.template || parsed.errors.length) continue;
+      try { templates[parsed.template.graphId] = flattenGraphTemplate(parsed.template, join(abs, file)); }
+      catch (error) { errors.push({ path: file, message: `unit 펼침 실패: ${error instanceof Error ? error.message : String(error)}` }); }
+    }
+    return { ...loaded, templates, errors };
+  }
   const errors: GraphParseIssue[] = [];
   const warnings: GraphParseIssue[] = [];
   const templates: Record<string, GraphTemplateSpec> = {};
@@ -120,7 +136,8 @@ function loadDir(abs: string): GraphLoadResult {
     warnings.push(...result.warnings);
     if (!result.template) continue;
     if (templates[result.template.graphId]) { errors.push({ path: file, message: `graph_id '${result.template.graphId}' 가 중복이다` }); continue; }
-    templates[result.template.graphId] = result.template;
+    try { templates[result.template.graphId] = flattenGraphTemplate(result.template, join(abs, file)); }
+    catch (error) { errors.push({ path: file, message: `unit 펼침 실패: ${error instanceof Error ? error.message : String(error)}` }); }
   }
   return { templates, errors, warnings, scannedFiles: files.length };
 }

package/scripts/graph-harvest-unit.ts

@@ -0,0 +1,22 @@
+import { readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { runHarvestUnit, type HarvestInput } from '../src/task-agent/harvest-unit.js';
+
+type GraphContext = { input?: HarvestInput };
+if (process.argv.includes('--dry-run')) {
+  console.log(JSON.stringify({ outcome: 'done', result: { dryRun: true }, evidence: { reviewerInvoked: false } }));
+  process.exit(0);
+}
+const contextPath = process.env.ELANOUS_GRAPH_CONTEXT;
+if (!contextPath) throw new Error('ELANOUS_GRAPH_CONTEXT is required');
+const graphContext = JSON.parse(readFileSync(contextPath, 'utf8')) as GraphContext;
+
+const result = await runHarvestUnit(graphContext.input ?? {}, async ({ pr, intent }) => {
+  const command = process.env.ELANOUS_BIN ?? 'eln';
+  const child = spawnSync(command, [
+    'self', 'review', pr, '--intent', intent, '--json', '--save', 'ta-harvest',
+  ], { encoding: 'utf8', timeout: 300_000, maxBuffer: 8 * 1024 * 1024 });
+  if (child.error) throw child.error;
+  return { stdout: child.stdout ?? '', stderr: child.stderr ?? '', exitCode: child.status };
+});
+console.log(JSON.stringify(result));

package/scripts/graph-units/journey-stub.ts

@@ -0,0 +1,6 @@
+const stage = process.argv[2] ?? 'unknown';
+process.stdout.write(`${JSON.stringify({
+  outcome: 'needs-human',
+  result: { stage, state: 'stub' },
+  evidence: { reason: 'owner unit has not been integrated' },
+})}\n`);