elanous 0.2.28 → 0.2.31

package/graphs/release/recipes.yaml

@@ -11,6 +11,9 @@ gate:
   command: 'bun scripts/release-loop/gate-node.ts --json'
   # 4h — the Pod gate took 2h02m on 09-30 (G1f ②) and the 0.2.5 loop was cut at exactly 2h with no verdict; K9 (≤15 min) is the real fix.
   timeout_ms: 14400000
+gate-triage:
+  command: 'bun scripts/release-loop/gate-triage-node.ts'
+  timeout_ms: 60000
 mac-smoke:
   command: 'bun scripts/release-loop/mac-smoke-node.ts'
   timeout_ms: 1800000

package/graphs/release/release-loop.yaml

@@ -15,10 +15,13 @@ nodes:
   - { node_id: cutoff, kind: judge, recipe: 'cmd:cutoff', max_visits: 1 }
   - { node_id: checklist-gate, kind: gate, recipe: 'cmd:checklist-gate', max_visits: 1 }
   # cmd:docs dispatches by graph node ID: bounded prefetch before gate, TUI join after upgrade, docs write after both.
+  # Public export is checked before expensive prefetch/gate work; a leak stops the release immediately.
+  - { node_id: export-check, kind: gate, recipe: 'cmd:export-check', max_visits: 1 }
   - { node_id: prefetch, kind: agent, recipe: 'cmd:docs', max_visits: 1 }
   - { node_id: gate, kind: gate, recipe: 'cmd:gate', max_visits: 1, notify: { on: [fail] } }
+  # S1 shadow: classify and record only; all exits still terminate through the existing failed node.
+  - { node_id: gate-triage, kind: judge, recipe: 'cmd:gate-triage', max_visits: 1 }
   - { node_id: mac-smoke, kind: gate, recipe: 'cmd:mac-smoke', max_visits: 1 }
-  - { node_id: export-check, kind: gate, recipe: 'cmd:export-check', max_visits: 1 }
   - { node_id: pwa, kind: gate, recipe: 'cmd:pwa', max_visits: 1, notify: { on: [fail] } }
   - { node_id: prepare, kind: agent, recipe: 'cmd:prepare', max_visits: 1, notify: { on: [fail] } }
   - { node_id: upgrade, kind: gate, recipe: 'cmd:upgrade', max_visits: 1 }
@@ -36,18 +39,20 @@ nodes:
   - { node_id: release-story, kind: gate, recipe: 'cmd:release-story', max_visits: 1 }
   - { node_id: ops-upgrade, kind: agent, recipe: 'cmd:ops-upgrade', max_visits: 1 }
   - { node_id: version-dev-bump, kind: git, recipe: 'cmd:version-dev-bump', max_visits: 1 }
+  - { node_id: version-dev-bump-after-failure, kind: git, recipe: 'cmd:version-dev-bump', max_visits: 1 }
   - { node_id: done, kind: gate, max_visits: 1 }
   - { node_id: failed, kind: gate, max_visits: 1 }
 edges:
   - { from: version-release, on: outcome, map: { ok: cutoff, fail: failed, error: failed } }
   - { from: cutoff, on: outcome, map: { ok: checklist-gate, fail: failed, error: failed } }
-  - { from: checklist-gate, on: outcome, map: { ok: prefetch, fail: failed, error: failed } }
+  - { from: checklist-gate, on: outcome, map: { ok: export-check, fail: failed, error: failed } }
+  - { from: export-check, on: outcome, map: { ok: prefetch, fail: failed, error: failed } }
   # Prefetch never gates: even a crashed prefetch node is a cache miss — the late nodes take their original paths.
   - { from: prefetch, on: outcome, map: { ok: gate, fail: gate, error: gate } }
-  - { from: gate, on: outcome, map: { ok: mac-smoke, fail: failed, error: failed } }
+  - { from: gate, on: outcome, map: { ok: mac-smoke, fail: gate-triage, error: gate-triage } }
+  - { from: gate-triage, on: outcome, map: { ok: failed, fail: failed, error: failed } }
   # Warning-only: a macOS failure or unmeasured run never blocks publishing — auto-approve shows it as a warning row.
-  - { from: mac-smoke, on: outcome, map: { ok: export-check, fail: export-check, error: export-check } }
-  - { from: export-check, on: outcome, map: { ok: pwa, fail: failed, error: failed } }
+  - { from: mac-smoke, on: outcome, map: { ok: pwa, fail: pwa, error: pwa } }
   - { from: pwa, on: outcome, map: { ok: prepare, fail: failed, error: failed } }
   - { from: prepare, on: outcome, map: { ok: upgrade, fail: failed, error: failed } }
   - { from: upgrade, on: outcome, map: { ok: tui, fail: failed, error: failed } }
@@ -59,10 +64,13 @@ edges:
   - { from: approve-publish, on: outcome, map: { ok: publish, fail: failed } }
   - { from: publish, on: outcome, map: { ok: npm-publish, fail: failed, error: failed } }
   - { from: npm-publish, on: outcome, map: { ok: docs-land, fail: docs-land, error: docs-land } }
-  - { from: docs-land, on: outcome, map: { ok: verify, fail: failed, error: failed } }
-  - { from: verify, on: outcome, map: { ok: vault-note, fail: failed, error: failed } }
+  # RELEASE-DEVBUMP-ALWAYS: after a successful publish every fail/error routes through version-dev-bump —
+  # a published release always hands main to its own next -dev, then still finishes failed.
+  - { from: docs-land, on: outcome, map: { ok: verify, fail: version-dev-bump-after-failure, error: version-dev-bump-after-failure } }
+  - { from: verify, on: outcome, map: { ok: vault-note, fail: version-dev-bump-after-failure, error: version-dev-bump-after-failure } }
   # Warning-only: vault note and release story failures after publication never block operational upgrades.
   - { from: vault-note, on: outcome, map: { ok: release-story, fail: release-story, error: release-story } }
   - { from: release-story, on: outcome, map: { ok: ops-upgrade, fail: ops-upgrade, error: ops-upgrade } }
   - { from: ops-upgrade, on: outcome, map: { ok: version-dev-bump, fail: version-dev-bump, error: version-dev-bump } }
   - { from: version-dev-bump, on: outcome, map: { ok: done, fail: failed, error: failed } }
+  - { from: version-dev-bump-after-failure, on: outcome, map: { ok: failed, fail: failed, error: failed } }

package/graphs/units/recipes.yaml

@@ -0,0 +1,3 @@
+plan:
+  command: 'bun scripts/release-loop/gate-recheck-plan-node.ts'
+  timeout_ms: 60000

package/graphs/units/release-gate-recheck.yaml

@@ -0,0 +1,15 @@
+# Shadow G1 unit: plan only. TC connects gate-node's existing sweep to kind: recheck after #27800.
+graph_id: release-gate-recheck
+version: 1
+unit:
+  inputs: [version, commit, measuredCommit, failures, errors, ledgerRoot]
+  outputs: [planPath, files]
+  exits: [done, failed]
+entry_node: plan
+terminal_nodes: [done, failed]
+nodes:
+  - { node_id: plan, kind: agent, recipe: 'cmd:plan', max_visits: 1 }
+  - { node_id: done, kind: gate, recipe: none, max_visits: 1 }
+  - { node_id: failed, kind: gate, recipe: none, max_visits: 1 }
+edges:
+  - { from: plan, on: outcome, map: { ok: done, fail: failed } }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elanous",
   "mcpName": "io.github.ElanvitalAI/elanous",
-  "version": "0.2.28",
+  "version": "0.2.31",
   "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",
@@ -129,6 +129,7 @@
     "telegram": "^2.26.22"
   },
   "devDependencies": {
+    "@copilotkit/aimock": "1.45.1",
     "@types/bun": "^1.2.0",
     "@types/diff": "^8.0.0",
     "@types/node-cron": "^3.0.11",

package/plugins/agent-team/agents/research.md

@@ -33,6 +33,7 @@ You do **not**:
 ## Source priority
 
 1. **Local ref repos** (`~/source/ref/<project>/`) — fastest, token-cheap. Always check first.
+   - Exception: never open non-public copies of Claude Code under the ref root. For Claude Code, use only the public documentation (code.claude.com).
 2. **`~/.claude/skills/omni-crawl`** — web search (firecrawl + grok web/x/reddit + apify).
 3. **`~/.claude/skills/omni-digest`** — URL / PDF / X / YouTube / GitHub deep-dive.
 4. **`WebFetch` / `WebSearch`** — last resort for one-off lookups.

package/scripts/check-native-tool-wiring.ts

@@ -28,6 +28,7 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { nativeToolCatalog } from '../src/native-tool-catalog.js';
+import { TUI_SOURCE_DIRS, tuiSourceText } from '../test/helpers/dashboard-source.js';
 
 const verbose = process.argv.includes('--verbose');
 const strict  = process.argv.includes('--strict');
@@ -68,7 +69,7 @@ const SKIP_TOOLS: ReadonlySet<string> = new Set([
 //      ⇒ 그러므로 이 스크립트가 내는 issue 수는 «결함 수가 아니라 이 자로 잰 수»다. 분류는 후속.
 const root = resolve(import.meta.dir, '..');
 const skillDispatchSrc = readFileSync(resolve(root, 'src/tool-runtime/registry.ts'), 'utf8');
-const tuiSrc   = readFileSync(resolve(root, 'src/dashboard/index.ts'), 'utf8');
+const tuiSrc   = tuiSourceText(root); // TUI 소스 묶음(src/dashboard/** ⊕ src/tui/**) — 경로 무관
 
 interface Issue { tool: string; surface: string; kind: 'missing' | 'extra'; detail: string; }
 
@@ -103,7 +104,7 @@ for (const entry of nativeToolCatalog) {
         tool: entry.id,
         surface: 'tui',
         kind: 'missing',
-        detail: `dashboard/index.ts does not mention alias "${pascal}" (catalog lists host:'tui')`,
+        detail: `TUI source bundle (${TUI_SOURCE_DIRS.join(' + ')}) does not mention alias "${pascal}" (catalog lists host:'tui')`,
       });
     }
   }

package/scripts/ci-android-unit-tests.ts

@@ -26,6 +26,7 @@
 import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { spawnSync } from 'node:child_process';
+import { androidToolchainMissing } from './lib/android-toolchain.js';
 
 const ROOT = join(import.meta.dir, '..');
 
@@ -225,6 +226,8 @@ export type AndroidGateIo = {
   readonly cwd?: string;
   readonly log?: (line: string) => void;
   readonly error?: (line: string) => void;
+  /** 툴체인 판정 심 — 기본은 bun 시험의 skip 관문과 «같은» `androidToolchainMissing()`. 다 있으면 null. */
+  readonly toolchainMissing?: () => string | null;
   /** 시험 실행 심 — 시험에서 주입한다. */
   readonly runGradle?: (androidDir: string) => { readonly status: number | null; readonly output: string };
   /** 결과 XML 읽기 심. */
@@ -382,6 +385,19 @@ export function runAndroidUnitTestGate(io: AndroidGateIo = {}): number {
       log(`[android-gate] 해당 없음 — 변경 ${changed.length}개 중 ${ANDROID_PREFIX} 아래 파일 0개.`);
       return 0;
     }
+    // ⭐ R5a(0.2.31 · OP #8961): 바뀐 안드로이드 파일이 «전부» bun 시험(.test.ts)이고 이 호스트에 툴체인이 없으면
+    //    Gradle 축은 «측정 대상 아님»이다 — 그 파일들은 Kotlin 컴파일러가 안 읽어 Gradle 결과를 못 바꾸고,
+    //    그 자체는 bun 러너가 잰다(툴체인이 없으면 시험이 «전제 없음» 이유를 찍고 skip).
+    //    ⛔ 「Gradle 통과」로 말하지 않는다. Kotlin·Gradle 설정이 하나라도 바뀌었으면 아래 기존 판정(0 = 실패) 그대로다.
+    //    면제는 «Kotlin 소스셋 안»의 bun 시험만이다(`androidKotlinSourcesetTestTsFiles` · r2 리뷰) — 그 밖의 .test.ts 는 기존 판정.
+    if (androidKotlinSourcesetTestTsFiles(hits).length === hits.length) {
+      const missing = (io.toolchainMissing ?? androidToolchainMissing)();
+      if (missing) {
+        log(`[android-gate] 측정 대상 아님 — 이 호스트에 안드로이드 툴체인이 없다: ${missing}`);
+        log(`   바뀐 안드로이드 파일 ${hits.length}개가 전부 bun 시험(.test.ts)이라 Gradle 결과를 바꾸지 못한다 — 그 시험은 bun 러너가 잰다. ⛔ 「Gradle 통과」가 아니라 「Gradle 안 잼」이다.`);
+        return 0;
+      }
+    }
     log(`[android-gate] 대상 ${hits.length}개 (변경 ${changed.length}개 중) — 시험을 돌린다.`);
   }
 

package/scripts/ci-typecheck-changed.ts

@@ -25,6 +25,7 @@ import {
   type BaselineCacheOptions,
 } 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';
 
 /** 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 {
@@ -49,7 +50,7 @@ function sh(cmd: string, cwd = process.cwd()): string {
   return execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], cwd, env: gitEnv() });
 }
 
-export type TscRun = { out: string; ran: boolean; why?: string };
+export type TscRun = { out: string; ran: boolean; why?: string; exitCode?: number };
 
 export { TSC_HEAP_MB, TSC_OOM_RETRY_HEAP_MB, tscEnv } from '../src/typecheck-ratchet.js';
 /** V8 힙 부족의 얼굴 — 「타입 에러」와 «다른 값»이다. */
@@ -70,7 +71,7 @@ export function runTsc(cmd: string, exec = execSync): TscRun {
   const result = (attempt: Attempt, env: NodeJS.ProcessEnv): TscRun => {
     const { out, error: e } = attempt;
     if (OOM.test(out)) return { out, ran: false, why: `tsc 가 V8 힙 부족(OOM)으로 죽었다 — 타입 에러가 아니다 (NODE_OPTIONS=${env.NODE_OPTIONS})` };
-    if (!e) return { out, ran: true };
+    if (!e) return { out, ran: true, exitCode: 0 };
     if (e.signal || e.code === 'ENOENT' || e.status === null || e.status === undefined) {
       return { out, ran: false, why: `tsc 실행 실패 (signal=${String(e.signal)} code=${String(e.code)} status=${String(e.status)})` };
     }
@@ -81,7 +82,7 @@ export function runTsc(cmd: string, exec = execSync): TscRun {
     if (!/error TS\d+/.test(out)) {
       return { out, ran: false, why: `tsc 가 종료코드 ${e.status} 로 끝났는데 TS 진단이 한 건도 없다(래퍼 실패로 본다)` };
     }
-    return { out, ran: true };
+    return { out, ran: true, exitCode: e.status };
   };
 
   const initialEnv = tscEnv();
@@ -140,6 +141,10 @@ export function changedTsFiles(run: (cmd: string) => string = sh, env: NodeJS.Pr
   const quietRevision = (command: string): string => { try { return run(command).trim(); } catch { return ''; } };
   const head = quietRevision('git rev-parse HEAD') || undefined;
   const warnings: string[] = [];
+  // base==HEAD ⊕ HEAD 가 origin/main 의 조상(merge-base 가 HEAD 자신) — 아래 수집이 git diff --name-only HEAD
+  // (커밋 안 된 변경) ⊕ git ls-files --others(untracked) 를 계속 모으므로 «변경을 셀 수 없다» 판정은
+  // 그 수집 결과에 따라 갈린다. 결정만 여기서 미뤄 수집 뒤에 넣는다.
+  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') : '';
@@ -148,14 +153,18 @@ export function changedTsFiles(run: (cmd: string) => string = sh, env: NodeJS.Pr
       base = merged;
       baseSource = 'recomputed merge-base(origin/main)';
     } else if (main && main !== head) {
-      failures.push({ command: `git rev-parse ${base}`, why: `base 가 HEAD(${head}) 와 같아 변경을 셀 수 없다 — TSC_BASE_REF 로 base 를 주라 (못 셌음 ≠ 0)` });
+      uncountableBase = { command: `git rev-parse ${base}`, why: `base 가 HEAD(${head}) 와 같아 변경을 셀 수 없다 — TSC_BASE_REF 로 base 를 주라 (못 셌음 ≠ 0)` };
     }
   }
 
   const files = new Set<string>();
   const diffFiles = new Set<string>();
+  // 커밋 안 된 변경 ⊕ untracked 를 내는 명령 — uncountableBase 판정의 분모다.
+  const dirtyCommands = new Set(['git diff --name-only HEAD', 'git ls-files --others --exclude-standard']);
+  let dirtyCount = 0;
   const commands = [`git diff --name-only ${base}...HEAD`, 'git diff --name-only HEAD', 'git ls-files --others --exclude-standard'];
   for (const command of commands) {
+    const countsDirty = uncountableBase !== undefined && dirtyCommands.has(command);
     try {
       for (const line of run(command).split('\n')) {
         const file = line.trim().replace(/^\.\//, '');
@@ -164,13 +173,22 @@ export function changedTsFiles(run: (cmd: string) => string = sh, env: NodeJS.Pr
         // A deleted .ts is not a compile candidate, so it must not count as «should have been collected».
         // existsSync is bound to the landing tree — process.cwd() would count the launcher's files.
         const present = existsSync(join(cwd, file));
-        if (!ts || present) diffFiles.add(file);
+        if ((!ts || present) && !diffFiles.has(file)) {
+          diffFiles.add(file);
+          if (countsDirty) dirtyCount += 1;
+        }
         if (ts && present) files.add(file);
       }
     } catch (cause) {
       failures.push({ command, why: cause instanceof Error ? cause.message : String(cause) });
     }
   }
+  if (uncountableBase) {
+    // 커밋 안 된 변경·untracked 를 1개라도 셌으면 그 수(N)와 baseSource 를 경고에 실어 판정을 지속한다 —
+    // «못 셌음 ≠ 0» 실패는 둘 다 0일 때만 그대로 남긴다.
+    if (dirtyCount > 0) warnings.push(`base=HEAD — 커밋 안 된 변경 ${dirtyCount} 개만 센다 (baseSource=${baseSource})`);
+    else failures.push(uncountableBase);
+  }
   return { files, base, baseSource, head, diffFiles, warnings, failures };
 }
 
@@ -950,7 +968,7 @@ function inspectTscResult(tsc: TscRun, changed: ReadonlySet<string>, baseline: R
   return false;
 }
 
-/** Above this many roots a narrowed program stops being much smaller than the whole one. */
+/** Observation threshold only: a large affected program is still narrower than the whole repository. */
 export const TSC_GATE_ROOT_LIMIT = 400;
 /** Files tsconfig.gate.json compiles as roots (its `include`); other changed .ts files are never part of that program. */
 const GATE_ROOT_SOURCE = /^(?:src|scripts|test)\/.*\.ts$/;
@@ -980,7 +998,6 @@ export function planRootCheck(input: {
     return { mode: 'full', fallbackReason: '루트 계산 실패: 변경 파일 누락' };
   }
   const roots = [...computed.roots].filter((file) => GATE_ROOT_SOURCE.test(file)).sort();
-  if (roots.length > TSC_GATE_ROOT_LIMIT) return { mode: 'full', fallbackReason: `루트 ${roots.length}개 > 상한 ${TSC_GATE_ROOT_LIMIT}`, roots: roots.length };
   return { mode: 'affected', roots, changedCount: gateChanged.size };
 }
 /** Target checkout first, then the installed CLI's top-level and nested dependencies. */
@@ -1145,13 +1162,22 @@ export function runGate(io: Partial<GateIo> = {}): void {
   const rootCommand = `${tscBin} --noEmit -p ${TYPECHECK_GATE_CONFIG}`;
   const pwaCommand = `${tscBin} --noEmit -p apps/pwa/tsconfig.json`;
   const pwaEnvCommand = `${tscBin} --noEmit -p tsconfig.pwa-env.json`;
+  const cacheDir = (io.env ?? process.env).ELANOUS_TSC_CACHE_DIR;
+  const cacheEnabled = !!cacheDir && !io.runTscCmd && base !== 'injected test seam';
+  const checkedTsc = (command: string, config: string, scope: ReadonlySet<string>, excluded: readonly string[], included: readonly string[], promotionBaseline?: BaselineDiagnostics, excludeTests = false): TscRun => {
+    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),
+    });
+  };
   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 });
   let rootsConfig: string | undefined;
   if (rootPlan.mode === 'affected') {
-    rootsConfig = `tsconfig.gate-roots.${process.pid}.${Date.now()}.json`;
+    rootsConfig = cacheEnabled ? 'tsconfig.gate-roots.incremental.json' : `tsconfig.gate-roots.${process.pid}.${Date.now()}.json`;
     try {
       // `include` is replaced (not merged) so only the listed roots plus ambient declarations enter the program.
       writeFileSync(join(cwd, rootsConfig), JSON.stringify({ extends: `./${TYPECHECK_GATE_CONFIG}`, include: ['src/**/*.d.ts', 'scripts/**/*.d.ts', 'test/**/*.d.ts'], files: rootPlan.roots }, null, 2), { flag: 'wx' });
@@ -1164,27 +1190,30 @@ export function runGate(io: Partial<GateIo> = {}): void {
       rootPlan = { mode: 'full', fallbackReason: `임시 tsconfig 쓰기 실패: ${cause instanceof Error ? cause.message : String(cause)}`, roots: rootPlan.roots.length };
     }
   }
+  log(`[tsc-gate] root-plan ${JSON.stringify({ mode: rootPlan.mode, roots: rootPlan.mode === 'affected' ? rootPlan.roots.length : rootPlan.roots ?? null, promoted: rootPlan.mode === 'full', reason: rootPlan.mode === 'full' ? rootPlan.fallbackReason : rootPlan.roots.length > TSC_GATE_ROOT_LIMIT ? 'large-affected-kept' : null })}`);
   if (rootPlan.mode === 'affected') {
     log(`[tsc-gate] 영향 루트 ${rootPlan.roots.length}개 (변경 ${rootPlan.changedCount} + importer·전역 선언 ${rootPlan.roots.length - rootPlan.changedCount}) — 임시 tsconfig 로 root 검사.`);
+    if (rootPlan.roots.length > TSC_GATE_ROOT_LIMIT) warn(`[tsc-gate] ⚠ 영향 루트 ${rootPlan.roots.length}개 > 관측선 ${TSC_GATE_ROOT_LIMIT} — 전체 승격 사유가 없어 영향 루트 검사를 유지한다.`);
     debug.log('typecheck.gate', 'roots', { mode: 'affected', roots: rootPlan.roots.length, fallbackReason: null }, { level: 'info' });
   } else {
     log(`[tsc-gate] 영향 루트 ${rootPlan.roots ?? '?'}개(전체로 폴백: ${rootPlan.fallbackReason})`);
     debug.log('typecheck.gate', 'roots', { mode: 'full', roots: rootPlan.roots ?? null, fallbackReason: rootPlan.fallbackReason }, { level: 'info' });
   }
   let rootTsc: TscRun;
-  try { rootTsc = runTscCmd(rootsConfig ? `${tscBin} --noEmit -p ${rootsConfig}` : rootCommand); }
+  try { rootTsc = checkedTsc(rootsConfig ? `${tscBin} --noEmit -p ${rootsConfig}` : rootCommand,
+    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);
   if (runsPwa) {
     log(`[tsc-gate] PWA 변경 ${pwaChanged.size}개 관측 — apps/pwa/tsconfig.json 검사.`);
-    const pwaTsc = runTscCmd(pwaCommand);
+    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;
   }
   if (runsPwaEnv) {
     log(`[tsc-gate] PWA env 패스 — 루트 비시험 ${nonTestRootChanged.size}개 (Next ProcessEnv 선언 포함).`);
-    const pwaEnvTsc = runTscCmd(pwaEnvCommand);
+    const pwaEnvTsc = checkedTsc(pwaEnvCommand, 'tsconfig.pwa-env.json', pwaEnvScope, ['apps/pwa/'], [], pwaEnvPromotionBaseline, true);
     unmeasured = unmeasured || !pwaEnvTsc.ran;
     passed = inspectTscResult(pwaEnvTsc, pwaEnvScope, baseline, error, warn, wholeRepository, ['apps/pwa/'], [], pwaEnvPromotionBaseline, true) && passed;
   }

package/scripts/coord-channel-watch.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
 # ch5730-watch.sh — 조율 채널 감시자의 **단일 인스턴스 런처**
 #
-# ⭐ 채널 번호는 «인자»다 — 기본값은 아래 `PR_NUM`, 정본은 `MANUAL-multi-agent-coordination-channel` 머리말이다.
-#   ⛔ 채널이 바뀌면 이 파일의 기본값 «한 줄»과 그 매뉴얼 머리말 «둘»만 고친다(이름은 안 바꾼다).
-#    (2026-08-12 #5730→#8328 · 08-25 #8328→#12577 · 09-10 #12577→#16815 · 09-27 #16815→#20798).
+# ⭐ 채널 번호는 `CH_PR` 우선, 기본값은 `MANUAL-multi-agent-coordination-channel` 머리말에서 읽는다.
+#   ⛔ 채널이 바뀌면 매뉴얼 머리말을 고친다(이름은 안 바꾼다).
+#    (2026-08-12 #5730→#8328 · 08-25 #8328→#12577 · 09-10 #12577→#16815 · 09-27 #16815→#20798 · 10-03 #20798→#23032 · 10-07 #23032→#24694 · 10-11 #24694→#26146 · 10-15 #26146→#27708).
 #    ⛔ 채널은 «막힐 수 있다» — GitHub 은 코멘트 2500 을 넘기면 댓글을 차단한다. 그때의 절차 =
 #    `내부 문서 `COORDINATION-CHANNEL`` 「채널이 막히면 — 순서」.
 #
@@ -49,9 +49,48 @@
 set -u
 set -o pipefail
 
-PR_NUM="${CH_PR:-24694}"  # ⛔ 2026-10-07: #23032 가 2,500 상한 → 채널 «7»(OP)  # ⛔ 2026-10-03: #20798 가 2,500 상한 → 채널 «6»(OP)  # ⛔ 2026-09-27: #16815 가 2,500 상한에 닿아 채널 «5» 로 옮김(🅞 · 벽에 «닿은 뒤» — 미리 못 옮겼다)
-#   📏 이력: #5730(07-28~08-12) → #8328(08-11~08-25) → #12577(08-25~09-10) → #16815(09-10~09-27) → #20798(09-27~10-03) → #23032(10-03~10-07) → #24694.
-#   ***수명이 «2주 안팎»이다 — 세 판이 전부 그랬다.*** 다음 벽은 09-24 언저리.
+# WATCH1: help must still report a fixed token, even when the archived manual
+# no longer has a current channel heading.
+if [ -n "${GH_TOKEN:-}${GITHUB_TOKEN:-}" ]; then
+  if [ "${WATCH_KEEP_TOKEN:-}" = "1" ]; then
+    echo "⚠️ [watch] GH_TOKEN/GITHUB_TOKEN 고정 토큰으로 읽는다(WATCH_KEEP_TOKEN=1) — 만료되면 «⛔ 조회 실패» 줄이 뜬다"
+  else
+    echo "⚠️ [watch] GH_TOKEN/GITHUB_TOKEN 이 들어 있어 비웠다 — 읽기는 keyring gh 인증으로(고정 토큰은 만료돼 감시가 눈이 먼다 · WATCH1)"
+    unset GH_TOKEN GITHUB_TOKEN
+  fi
+fi
+
+for arg in "$@"; do
+  case "$arg" in -h|--help)
+    echo '⛔ PR 조율 채널은 퇴역했다. 자리 간 소통은 eln msg post/list 를 사용한다.'
+    sed -n '1,40p' "$0"
+    exit 0 ;;
+  esac
+done
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) || { echo '⛔ 스크립트 위치를 못 읽었다' >&2; exit 3; }
+CANON="$SCRIPT_DIR/../docs/manual/MANUAL-multi-agent-coordination-channel-2026-07-28.md"
+resolve_pr() {
+  [ -f "$CANON" ] || return 3
+  # 머리말의 실제 인용 제목만 읽는다. 설명·과거 채널·손상된 제목에서 추측하지 않는다.
+  head -40 "$CANON" | awk '
+    /^> ## / && /마지막 채널/ {
+      count++
+      if ($0 !~ /^> ## .*마지막 채널 = \[PR #[0-9]+\]\(https:\/\/github\.com\/ElanvitalAI\/elanous-agent\/pull\/[0-9]+\)/) { bad=1; next }
+      id=$0; sub(/^.*마지막 채널 = \[PR #/, "", id); sub(/\].*$/, "", id)
+      url=$0; sub(/^.*\]\(https:\/\/github\.com\/ElanvitalAI\/elanous-agent\/pull\//, "", url); sub(/\).*$/, "", url)
+      if (id != url) bad=1
+    }
+    END { if (count == 1 && !bad) print id; else exit 3 }
+  '
+}
+PR_NUM="${CH_PR:-$(resolve_pr)}"
+if ! [[ "$PR_NUM" =~ ^[0-9]+$ ]]; then
+  echo "⛔ 채널 번호를 못 읽었다 — $CANON 머리말 또는 CH_PR 를 확인한다" >&2
+  exit 3
+fi
+#   📏 이력: #5730 → #8328 → #12577 → #16815 → #20798 → #23032 → #24694 → #26146 → #27708.
+#   수명은 판마다 달랐다. 2,300코멘트에 닿으면 다음 채널을 준비한다.
 #   🩹 발신이 rc=1 이면 먼저 세라: gh api repos/ElanvitalAI/elanous/issues/<n> --jq .comments
 REPO="${CH_REPO:-ElanvitalAI/elanous}"
 INTERVAL="${CH_INTERVAL:-60}"
@@ -80,18 +119,6 @@ WATCH_EXIT_ANNOUNCED=0    # 종료 줄 중복 방지(INT→EXIT 로 trap 이 두
 # 「거의 비었다」로 «의심»할 자수 — 이 아래로 떨어지면 «변경»이 아니라 «의심»으로 말한다.
 BODY_MIN="${CH_BODY_MIN:-100}"
 
-# ⛔⭐ WATCH1(10-03 MK 6시간 실명): 감시자에 고정 토큰(GH_TOKEN·GITHUB_TOKEN — App 토큰은 1시간)을 넣어 띄우면
-#   만료 뒤 조회가 조용히 계속 실패한다. 읽기는 신원이 필요 없다 ⇒ 고정 토큰을 «비우고» keyring gh 인증으로 읽는다.
-#   그 토큰을 꼭 써야 하면 WATCH_KEEP_TOKEN=1 (그때도 경고 줄은 낸다).
-if [ -n "${GH_TOKEN:-}${GITHUB_TOKEN:-}" ]; then
-  if [ "${WATCH_KEEP_TOKEN:-}" = "1" ]; then
-    echo "⚠️ [watch] GH_TOKEN/GITHUB_TOKEN 고정 토큰으로 읽는다(WATCH_KEEP_TOKEN=1) — 만료되면 «⛔ 조회 실패» 줄이 뜬다"
-  else
-    echo "⚠️ [watch] GH_TOKEN/GITHUB_TOKEN 이 들어 있어 비웠다 — 읽기는 keyring gh 인증으로(고정 토큰은 만료돼 감시가 눈이 먼다 · WATCH1)"
-    unset GH_TOKEN GITHUB_TOKEN
-  fi
-fi
-
 CMD="ensure"
 TRACK=""
 ADOPT_PID=""
@@ -101,7 +128,6 @@ while [ $# -gt 0 ]; do
     ensure|status|stop|restart|adopt|discover|delivery) CMD="$1" ;;
     --track) shift; TRACK="${1:-}" ;;
     --pid)   shift; ADOPT_PID="${1:-}" ;;
-    -h|--help) sed -n '1,40p' "$0"; exit 0 ;;
     *) echo "⛔ 모르는 인자: $1" >&2; exit 2 ;;
   esac
   shift