elanous 0.2.27 → 0.2.29

package/graphs/steward/release-day.yaml

@@ -0,0 +1,23 @@
+graph_id: steward-release-day
+loop:
+  title: 발행 날 그림자 판정
+  trigger:
+    cron: '*/5 * * * *'
+version: 1
+entry_node: release-day
+terminal_nodes: [done, failed]
+nodes:
+  - node_id: release-day
+    kind: agent
+    recipe: cmd:steward-release-day
+    max_visits: 1
+  - node_id: done
+    kind: gate
+    max_visits: 1
+  - node_id: failed
+    kind: gate
+    max_visits: 1
+edges:
+  - from: release-day
+    on: outcome
+    map: { ok: done, fail: failed }

package/graphs/steward/steward.yaml

@@ -5,9 +5,14 @@ loop:
     cron: '*/15 8-23 * * *'
     events: [directive, linear-webhook]
 version: 1
-entry_node: rejudge
+entry_node: resync
 terminal_nodes: [done, failed]
 nodes:
+  # SMART-MERGE-LIVE-TICK — update eligible PR heads before TA inspects them on this tick.
+  - node_id: resync
+    kind: agent
+    recipe: cmd:steward-resync
+    max_visits: 1
   # TA-REJUDGE-PERIODIC — `tasks rejudge --all` on a cadence (off unless taskAgent.rejudgeEveryMinutes > 0).
   # First so a Linear outage in sync cannot starve it; either outcome continues to sync.
   - node_id: rejudge
@@ -37,6 +42,9 @@ nodes:
     kind: gate
     max_visits: 1
 edges:
+  - from: resync
+    on: outcome
+    map: { ok: rejudge, fail: rejudge }
   - from: rejudge
     on: outcome
     map: { ok: sync, fail: sync }

package/graphs/work/code-pr.yaml

@@ -0,0 +1,23 @@
+# 1판: tasks hand 가 이 조합을 고르되 러너로 실행하지 않는다.
+# make-code 단위가 준비되고 실물 code-pr 완주·재개 시험이 끝날 때까지 harness say 가 실행 주인이다.
+graph_id: work-code-pr
+version: 1
+launcher: harness-say
+entry_node: make-code
+terminal_nodes: [done, needs-human, failed]
+nodes:
+  - node_id: make-code
+    kind: subgraph
+    recipe: none
+    max_visits: 1
+    call: make-code@1
+    covers: [research, decide, make, verify, execute]
+    budget: { inner_steps: 20 }
+    contract: { inputs: [ask, context, prior], tools: harness-say, outputs: [result, evidence] }
+  - { node_id: done, 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: make-code
+    on: outcome
+    map: { done: done, rework: needs-human, needs-human: needs-human, failed: needs-human }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elanous",
   "mcpName": "io.github.ElanvitalAI/elanous",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "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/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/browser-observe-cycle.ts

@@ -4,7 +4,15 @@
 // 기본 MCP 전송은 기존 McpClient 의 initialize + Mcp-Session-Id 수명주기를 탄다.
 // 스케줄러 진입점 배선은 다음 조각의 몫이다. 이 파일은 호출 가능한 함수만 내보낸다.
 
-import { McpClient, McpServerError, type McpHttpFetch } from '../src/mcp/client.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import {
+  McpClient,
+  McpConnectionError,
+  McpServerError,
+  type McpHttpFetch,
+} from '../src/mcp/client.js';
+import { getElanousConfigDir } from '../src/elanous-config-dir.js';
 import { debug } from '../src/debug/log.js';
 
 export const ELANOUS_PWA_URL = 'http://127.0.0.1:31415/app';
@@ -21,6 +29,10 @@ export const BROWSER_OBSERVE_OK = 'ok';
 export const BROWSER_OBSERVE_WRONG_SCREEN = 'wrong-screen';
 /** 관측하지 못했다 */
 export const BROWSER_OBSERVE_UNOBSERVED = 'unobserved';
+/** `unobserved` 사유 — 루프백 owner 토큰을 못 읽어 Authorization 헤더를 못 붙였다 */
+export const BROWSER_OBSERVE_REASON_AUTH_MISSING = 'auth-missing';
+/** `unobserved` 사유 — 루프백 owner 토큰을 붙였는데 서버가 401 로 거부했다 */
+export const BROWSER_OBSERVE_REASON_AUTH_REJECTED = 'auth-rejected';
 
 export type BrowserObserveStatus =
   | typeof BROWSER_OBSERVE_OK
@@ -50,6 +62,39 @@ export interface BrowserObserveResult extends BrowserObserveClassification {
   request: BrowserObserveMcpRequest;
 }
 
+/** 루프백 owner 토큰을 어디서 읽는지 — `src/cli/mcp-reload.ts` 의 기존 꼴과 같은 자리다. */
+export function browserObserveTokenPath(): string {
+  return join(getElanousConfigDir(), 'acp-token');
+}
+
+/**
+ * 루프백 ACP 토큰을 **읽기 전용**으로 얻는다(실패는 null).
+ * ⛔ `ensureAuthToken`(src/auth/acp-token.ts) 을 쓰지 않는다 — 그것은 «없으면 만든다».
+ * 이 조각은 새 토큰 생성 0: 파일이 없거나 비면 그대로 auth-missing 이다.
+ */
+export function readBrowserObserveToken(): string | null {
+  const tokenPath = browserObserveTokenPath();
+  try {
+    if (!existsSync(tokenPath)) return null;
+    const token = readFileSync(tokenPath, 'utf8').trim();
+    return token.length > 0 ? token : null;
+  } catch {
+    return null;
+  }
+}
+
+/** MCP POST 전부에 `Authorization: Bearer <token>` 을 얹는 전송 래퍼. */
+export function withBrowserObserveAuthorization(
+  fetchImpl: BrowserObserveHttpFetch,
+  token: string,
+): BrowserObserveHttpFetch {
+  return (url, init) =>
+    fetchImpl(url, {
+      ...init,
+      headers: { ...init.headers, authorization: `Bearer ${token}` },
+    });
+}
+
 export type BrowserObserveMcpCall = (request: BrowserObserveMcpRequest) => Promise<unknown>;
 export type BrowserObserveLog = (category: string, event: string, data?: unknown) => void;
 export type BrowserObserveHttpFetch = McpHttpFetch;
@@ -58,6 +103,8 @@ export interface BrowserObserveDeps {
   mcpCall?: BrowserObserveMcpCall;
   fetch?: BrowserObserveHttpFetch;
   log?: BrowserObserveLog;
+  /** 토큰 획득 주입 자리 — 시험이 파일 시스템 없이 결정성을 얻는다. 생략하면 `readBrowserObserveToken` */
+  readToken?: () => string | null;
 }
 
 /**
@@ -328,6 +375,15 @@ function emit(
 }
 
 function unobservedFromCaught(caught: unknown): BrowserObserveClassification {
+  // 루프백 토큰을 붙였는데 서버가 401 로 거부한 경우 — McpClient 가
+  // McpConnectionError('auth-required') 로 던진다. 긴 오류 문자열 대신 이유 한 칸으로 가른다.
+  if (caught instanceof McpConnectionError && caught.reason === 'auth-required') {
+    return {
+      status: BROWSER_OBSERVE_UNOBSERVED,
+      observedUrl: null,
+      reason: BROWSER_OBSERVE_REASON_AUTH_REJECTED,
+    };
+  }
   if (caught instanceof McpServerError) {
     return {
       status: BROWSER_OBSERVE_UNOBSERVED,
@@ -342,14 +398,32 @@ function unobservedFromCaught(caught: unknown): BrowserObserveClassification {
   };
 }
 
+/** 기본 전송(McpClient) 에 루프백 토큰을 얹는다. 토큰이 없으면 null — 401 이 보장된 호출은 아예 안 한다. */
+function defaultAuthorizedMcpCall(deps: BrowserObserveDeps): BrowserObserveMcpCall | null {
+  const token = deps.readToken ? deps.readToken() : readBrowserObserveToken();
+  if (token === null) return null;
+  const base: BrowserObserveHttpFetch = deps.fetch ?? ((url, init) => fetch(url, init));
+  const authorized = withBrowserObserveAuthorization(base, token);
+  return (request) => callAsideReplViaMcpClient(request, authorized);
+}
+
 /** MCP 로 브라우저에서 값을 가져와 공개 분류 함수에 넘긴다. 의존성 주입으로 실 데몬 없이 검증한다. */
 export async function observeBrowserCycle(
   deps: BrowserObserveDeps = {},
 ): Promise<BrowserObserveResult> {
   if (!deps.log) await ensureBrowserObserveLogSink();
   const log = deps.log ?? defaultLog;
-  const mcpCall = deps.mcpCall ?? ((request) => callAsideReplViaMcpClient(request, deps.fetch));
   const request = buildBrowserObserveMcpRequest();
+  const mcpCall = deps.mcpCall ?? defaultAuthorizedMcpCall(deps);
+  if (mcpCall === null) {
+    const classified: BrowserObserveClassification = {
+      status: BROWSER_OBSERVE_UNOBSERVED,
+      observedUrl: null,
+      reason: BROWSER_OBSERVE_REASON_AUTH_MISSING,
+    };
+    emit(log, classified);
+    return { ...classified, request };
+  }
   try {
     const response = await mcpCall(request);
     const rpcError = jsonRpcErrorMessage(response);

package/scripts/ci-typecheck-changed.ts

@@ -759,7 +759,7 @@ export function exportedLiteralUnionMembersInChanges(
   pathsResult: ChangedPathResult = changedPathPairs(base),
   readBase: GitFileReader = readGitFile,
   readHead = (file: string) => readFileSync(file, 'utf8'),
-  sources?: RepositorySources,
+  sources?: RepositorySources | (() => RepositorySources),
 ): LiteralUnionMemberCheck {
   if (pathsResult.failure) return { additions: [], failure: pathsResult.failure };
   const additions: LiteralUnionAddition[] = [];
@@ -780,7 +780,7 @@ export function exportedLiteralUnionMembersInChanges(
   }
   if (removals.length === 0) return { additions };
   try {
-    return { additions, removals: literalUnionReferencesInSource(removals, changed, sources ?? repositoryTypeScriptSources()) };
+    return { additions, removals: literalUnionReferencesInSource(removals, changed, typeof sources === 'function' ? sources() : sources ?? repositoryTypeScriptSources()) };
   } catch (error: unknown) {
     return { additions, failure: `저장소 리터럴 참조 탐색 실패: ${error instanceof Error ? error.message : String(error)}` };
   }
@@ -873,6 +873,7 @@ export type GateIo = {
   literalUnionMembers?: (changed: ReadonlySet<string>, base: string) => LiteralUnionMember[] | LiteralUnionMemberCheck;
   readBaselineDiagnostics?: (base: string, command: string) => BaselineDiagnostics;
   runTscCmd: (cmd: string) => TscRun;
+  resolveTscScript?: (cwd: string) => string | undefined;
   /** Landing tree. Git, existsSync, tsc, and the test baseline are measured here — not in process.cwd(). */
   cwd?: string;
   /** Explicit base revision. Same rule as TSC_BASE_REF, without reading the process environment. */
@@ -949,7 +950,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$/;
@@ -979,19 +980,32 @@ 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 };
 }
-/**
- * K-OP-039 · 노하우를 «도구 출력»에 싣는 첫 조각(대표 2026-10-12 «어떤 에이전트가 와도 같은 수준»).
- * 승격된 전체 판정은 `apps/pwa/node_modules` 가 없으면 «가짜» PWA 타입 에러만 낸다 —
- * 10-12 하루 TC·UX 두 자리가 같은 가짜 TS2322(ChatMessage.tsx)로 코드를 고치려 했다.
- * 카드(내부 문서 `KNOWHOW` K-OP-039)의 처방 문면을 그대로 도구 출력에 싣는다.
- */
-const PWA_DEPS_MISSING_HINT = '환경: apps/pwa 의존성 없음 — (cd apps/pwa && bun install --frozen-lockfile) 뒤 재실행 · 코드 결함 아님(K-OP-039)';
+/** Target checkout first, then the installed CLI's top-level and nested dependencies. */
+export function resolveTscScript(cwd: string, scriptsDir = import.meta.dir, present: (path: string) => boolean = existsSync): string | undefined {
+  return [
+    join(cwd, 'node_modules/typescript/bin/tsc'),
+    join(scriptsDir, '../../typescript/bin/tsc'),
+    join(scriptsDir, '../node_modules/typescript/bin/tsc'),
+  ].find(present);
+}
+
+/** The installed compiler cannot resolve declarations from a checkout without its own dependencies. */
+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');
+  if (!present(join(cwd, 'node_modules/bun-types'))) missing.push('bun-types');
+  if (needsPwa && !present(join(cwd, 'apps/pwa/node_modules'))) missing.push('apps/pwa/node_modules');
+  return missing;
+}
 
 export function runGate(io: Partial<GateIo> = {}): void {
   const cwd = io.cwd ?? process.cwd();
+  const targetGit: GitRunner = (command, args, options) => execFileSync(command, args, { ...options, cwd, env: gitEnv() });
+  const targetPaths = (base: string) => changedPathPairs(base, targetGit);
+  const targetFile = (ref: string, path: string) => readGitFile(ref, path, targetGit);
+  const targetSource = (file: string) => readFileSync(join(cwd, file), 'utf8');
   const defaultChanged = () => changedTsFiles((cmd) => sh(cmd, cwd), process.env, cwd, io.baseRef);
   const defaultRunTsc = (cmd: string) => runTsc(cmd, ((command, options) => execSync(command, { ...options, cwd, env: tscExecEnv(options?.env) })) as typeof execSync);
   const { changedTsFiles: getChanged = defaultChanged, runTscCmd = defaultRunTsc, log = (message: string) => console.log(message), warn = (message: string) => console.warn(message), error = (message: string) => console.error(message), exit = ((code: number) => process.exit(code)) as GateIo['exit'] } = io;
@@ -999,10 +1013,10 @@ export function runGate(io: Partial<GateIo> = {}): void {
   // Set 주입은 기존 테스트 심이며 기준 revision이 없다. 실제 ChangedTsFiles 경로만 Git 관측을 요구한다.
   const requiredExportFields = io.requiredExportFields ?? ((changed: ReadonlySet<string>, base: string) => base === 'injected test seam'
     ? { fields: [], removedSymbols: [], parameterIncreases: [] }
-    : requiredExportFieldsInChanges(changed, base));
+    : requiredExportFieldsInChanges(changed, base, targetPaths(base), targetFile, targetSource));
   const literalUnionMembers = io.literalUnionMembers ?? ((changed: ReadonlySet<string>, base: string) => base === 'injected test seam'
     ? { additions: [] }
-    : exportedLiteralUnionMembersInChanges(changed, base));
+    : exportedLiteralUnionMembersInChanges(changed, base, targetPaths(base), targetFile, targetSource, () => repositoryTypeScriptSources(cwd)));
   const changedResult = getChanged();
   const { files: changed, base, baseSource, head, diffFiles, warnings = [], failures = [] } = changedResult instanceof Set
     ? { files: changedResult, base: 'injected test seam', baseSource: 'injected test seam', head: 'injected test seam', diffFiles: new Set<string>(), warnings: [], failures: [] }
@@ -1099,15 +1113,33 @@ 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: 승격된 전체 판정은 apps/pwa 의존성 없이는 «가짜» PWA 타입 에러만 낸다(환경 문제 · 코드 결함 아님).
-  //    그 오류를 내기 «전에» 이 한 줄로 멈춘다(환경 줄이 곧 마지막 줄 = 판정) — 의존성이 있으면 아래
-  //    판정 규칙·출력 형식은 기존 그대로다. «못 쟀다 ≠ 통과» — PWA 미측정을 통과로 접지 않는다.
-  if (wholeRepository && !existsSync(join(cwd, 'apps/pwa/node_modules'))) {
-    error(`[tsc-gate] ${PWA_DEPS_MISSING_HINT}`);
+  // 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.
+  const missing = missingCheckoutTypeDependencies(cwd, runsPwa || wholeRepository);
+  if (missing.length > 0) {
+    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}`);
+    error('[tsc-gate] FAIL — 대상 의존성을 확인하지 못했다(설치본 tsc 존재 ≠ 대상 타입 검사 가능).');
+    exit(1);
+    return;
+  }
+  // The .bin shim uses `#!/usr/bin/env node`. A LaunchAgent can have Bun but no
+  // node on PATH, so invoke the installed compiler with this process's absolute
+  // runtime instead. A missing dependency must fail the gate, never fetch via npx.
+  // Preserve the target checkout's compiler version when available. The
+  // installed CLI may resolve TypeScript from a sibling top-level node_modules
+  // or its own nested node_modules; verify each path before starting a child.
+  const tscScript = (io.resolveTscScript ?? resolveTscScript)(cwd);
+  if (!tscScript) {
+    error('[tsc-gate] ⛔ TypeScript 실행 파일 없음 — 대상 트리 또는 설치본에 bun install --frozen-lockfile 뒤 재실행하십시오.');
+    error('[tsc-gate] FAIL — tsc 를 실행하지 못했다(의존성 없음 ≠ 진단 0건).');
     exit(1);
     return;
   }
-  const tscBin = existsSync(join(cwd, 'node_modules/.bin/tsc')) ? 'node_modules/.bin/tsc' : 'npx tsc';
+  const shellArg = (value: string) => `'${value.replaceAll("'", "'\\''")}'`;
+  const tscBin = `${shellArg(process.execPath)} ${shellArg(tscScript)}`;
   const baseline = readTestTypecheckBaseline(cwd);
   const rootCommand = `${tscBin} --noEmit -p ${TYPECHECK_GATE_CONFIG}`;
   const pwaCommand = `${tscBin} --noEmit -p apps/pwa/tsconfig.json`;
@@ -1131,8 +1163,10 @@ 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})`);

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,29 @@
 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 언저리.
+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}"

package/scripts/coord-role-pack.ts

@@ -0,0 +1,143 @@
+#!/usr/bin/env bun
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+export type RolePackRole = 'coordinator' | 'guardian';
+
+export interface RolePack {
+  role: RolePackRole;
+  version: string;
+  sha256: string;
+  body: string;
+  includedCardIds: string[];
+  excludedCardIds: string[];
+  sources: Array<{ path: string; sha256: string }>;
+  /** Source docs absent from this root, e.g. the published package ships no internal docs. */
+  missingSources: string[];
+}
+
+const SOURCE_PATHS = [
+  'AGENTS.md',
+  'docs/roles/OP.md',
+  'docs/handbook/LOOP-AGENTS.md',
+  'docs/handbook/OPERATIONS.md',
+  'scripts/coord-role-pack.ts',
+] as const;
+
+// OP's 2026-10-14 verified C/G harvest. These are guidance, never an L0 grant.
+// Moving thresholds, dates, paths, and host capacity must be checked in live state.
+const COORDINATOR_CARDS = [
+  ['C1', '기둥 우선순위는 루프 에이전트(L1) > 그래프 엔지니어링(L2) > TUI > 마찰 없는 SETUP > 받침 > 바닥으로 제안한다.'],
+  ['C2', '조율자·수호자·과제 담당 칸의 조기 전력화를 우선한다. M4 전 배치는 현 판 일정과 대표 결정을 다시 확인한다.'],
+  ['C3', '가속 칸은 루브릭 점수가 낮아도 앞 판 후보가 된다. 승인된 점수 밖 이동은 근거에 배치 덮어씀과 결정 출처를 남긴다.'],
+  ['C4', '판 용량은 고정값으로 보지 않는다. 착지 속도를 재고 뒤 판을 당길지 제안한다.'],
+  ['C5', '판과 발행 날짜의 대응은 현 일정 정본에서 확인한다. 과거 날짜 공식만으로 이동을 결정하지 않는다.'],
+  ['C6', '선행 칸의 판은 후행 칸보다 늦지 않게 제안한다. 컷 중인 판과 도는 런 칸은 옮기기 전 상태를 다시 확인한다.'],
+  ['C7', '일반 리뷰는 2라운드째 전제·요구·분할을 적고, 3라운드에 must-fix가 남거나 같은 지적이 2회면 쪼개기·부분 착지·연결골로 트리아지한다.'],
+  ['C8', '조각 착지 뒤에는 착지한 범위로 원 칸을 다시 이름 붙여 green을 제안하고, 잔여는 원 칸 선행과 남은 조각 근거를 가진 새 yellow 칸에 둔다.'],
+  ['C9', '서로 기다리는 PR은 통합 착지 또는 무해한 독립 조각의 순차 착지를 제안한다. 미설정이면 몸이 0인지를 계약으로 확인한다.'],
+  ['C10', 'TA 칸 첫 줄 대상 경로는 origin/main에 실제 있는 저장소 상대 파일로 확인한다. 신설 파일은 별도 신설 줄에 둔다.'],
+  ['C11', '관측·A/B 운영만 하는 칸은 구현 대상 경로를 억지로 넣지 말고 명시적 hold와 판정 근거를 제안한다.'],
+  ['C12', '여러 실패의 공용 원인이 확인되면 수리 칸을 컷 판의 P0·가속 후보로 제안하고, 영향 칸은 사유 있는 hold 뒤 수리 반영을 확인해 재발사를 제안한다.'],
+  ['C13', '최우선은 순서의 맨 앞이라는 뜻이다. 다른 일을 멈추는 조정은 자원이 실제로 부딪칠 때만 제안한다.'],
+  ['C14', '대표가 지정한 관심 태스크는 일반 리뷰 트리아지 상한 밖에서 지적 지점만 최소 수리하며 착지까지 추적한다. 막히면 다른 자리를 붙이도록 제안하고 추적 간격은 현재 지시를 확인한다.'],
+] as const;
+
+const GUARDIAN_CARDS = [
+  ['G1', '착지와 TA 발사의 부하선은 서로 다를 수 있다. 현재 설정과 1분·5분 추세를 함께 재고 대기 루프에서 다시 판정한다.'],
+  ['G2', 'mbp의 무거운 타입검사·게이트·리뷰·빌드는 승인된 원격 호스트에 배치한다. worktree 전수 검색을 피하고 무거운 로그 조회는 자리당 동시 1로 제한한다.'],
+  ['G3', 'node-b의 착지·TUI 전용 슬롯과 일반 게이트 호스트의 현재 임대를 확인한다. 말로만 예약하지 말고 토큰·잠금으로 충돌을 막도록 제안한다.'],
+  ['G4', 'TA 부모와 Pod의 원격 배치, 호스트별 상한, 자리별 주기 한도는 현재 설정과 런 상태로 확인한다.'],
+  ['G5', '착지 슬롯은 전역으로 세고 OP 착지는 한 번에 하나씩 제안한다. 실행기 종료 뒤 고아 표지는 현 슬롯 원장에서 대조한다.'],
+  ['G6', 'heavy-remote의 gate-host-busy는 착지 실패로 단정하지 말고 현재 실행기 규약의 대기·재시도 경로로 보낸다. mbp 로컬 폴백은 제안하지 않는다.'],
+  ['G7', 'macOS 정기 작업의 gh 인증 실패는 keyring 접근 여부를 확인한다. 측정 실패는 못 잼과 종료 코드를 남기고 로그인 세션 루프를 제안한다.'],
+  ['G8', '시험이 운영 상태에 쓴 흔적은 우주 격리 결함으로 기록한다. 격리 수리와 운영 흔적 확인 뒤에만 청소를 제안한다.'],
+  ['G9', '운영 설정 변경은 사전 백업과 사후 diff를 요구한다. 문자열 SHA의 JSON 인용을 확인하고 비밀값은 출력하지 않는다.'],
+  ['G10', '같은 날 shadow→live 전환과 루프 상태 파일이 어긋나면 틱 실패를 의심한다. 임시 복구와 mode별 상태 분리 수리를 구별한다.'],
+  ['G11', '상주 감시는 세션 밖에서 돌리고 Monitor 만료 시 재무장과 심장박동을 확인한다.'],
+  ['G12', 'smbd·Finder의 지속 CPU 점유는 mbp 기저 부하 후보로 관측하고, 본부 이전 전 재측정할 항목으로 남긴다.'],
+] as const;
+
+function sha256(body: string): string {
+  return createHash('sha256').update(body).digest('hex');
+}
+
+/** Deterministic, read-only L0 role pack. Knowledge cards require a separate verified source. */
+export function buildCoordRolePackManifest(role: RolePackRole, root = resolve(import.meta.dir, '..')): RolePack {
+  const repo = resolve(root);
+  // The pack body is inline. Source docs only contribute hashes, so an installed package without them still builds.
+  const present = SOURCE_PATHS.filter((path) => existsSync(resolve(repo, path)));
+  const missingSources = SOURCE_PATHS.filter((path) => !present.includes(path));
+  const sources = present.map((path) => ({ path, sha256: sha256(readFileSync(resolve(repo, path), 'utf8')) }));
+  const packageJson = resolve(repo, 'package.json');
+  const version = existsSync(packageJson)
+    ? (JSON.parse(readFileSync(packageJson, 'utf8')) as { version: string }).version : 'unknown';
+  const roleText = role === 'coordinator'
+    ? [
+        '## 역할: 조율자',
+        '- 전체 칸과 자리의 관측을 모아 우선순위·분배·보류를 제안한다. 칸의 실제 판정은 담당 자리의 근거와 대조한다.',
+        '- 질문에 답하기 전에 메시지, 확인표, 과제 카드, 로그를 읽는다. 못 읽은 값은 측정 불가로 밝힌다.',
+        '- 세 번 실패하거나 새 경계가 반복되면 전제·요구·분할을 먼저 적는다. 핵심은 칸 판정에 필요한 것, 확장은 나머지다.',
+        '- 막힌 칸 하나가 착지 줄 전체를 멈추게 하지 않는다. 다음 준비 완료 칸을 본다.',
+      ]
+    : [
+        '## 역할: 수호자',
+        '- 전체 자원·호스트·임대·계정·과금·무결성을 관측하고 입장 또는 대기를 제안한다.',
+        '- 부하는 1분·5분 추세를 함께 보고, 한 번의 스파이크만으로 창을 닫지 않는다.',
+        '- 무거운 게이트는 원격 호스트에서 한 번만 실행한다. host slot busy는 실행 전 거부이며 그동안 가벼운 검토를 먼저 한다.',
+        '- 실제 공급자 크레딧과 경유 공급자의 비용을 구별하고, 비밀값은 출력하지 않는다.',
+      ];
+  const cards = role === 'coordinator' ? COORDINATOR_CARDS : GUARDIAN_CARDS;
+  const lines = [
+    '# 금지 목록',
+    '- 돈·보안 설정·자격·계정·외부 공개·되돌릴 수 없는 일은 사람 승인 없이 실행하지 않는다.',
+    '- L0에서는 우편 답글 제안만 한다. 칸 변경·잠금·착지·코드 쓰기는 하지 않는다.',
+    '- `pr land` 거부를 우회하거나 `gh pr merge`·force push·rebase를 실행하지 않는다.',
+    '- 자격 파일·토큰 원문을 읽거나 메시지·로그·팩에 싣지 않는다.',
+    '- 관측 실패를 성공 또는 0건으로 바꾸지 않는다.',
+    '',
+    `# ${role} 역할 팩`,
+    `판: ${version}`,
+    '출처: AGENTS.md 요지 · docs/roles/OP.md §1~2 · docs/handbook/LOOP-AGENTS.md §0,§5,§10 · docs/handbook/OPERATIONS.md §2~5 · scripts/coord-role-pack.ts 운영 지식 v1',
+    '권한과 현재 값은 코드·설정·운영 원장으로 다시 확인한다. 이 팩은 권한을 부여하지 않는다.',
+    '',
+    ...roleText,
+    '',
+    '## 검증된 운영 지식 v1',
+    '각 줄은 판단 제안이며 현재 값·권한은 운영 원장과 설정에서 다시 확인한다.',
+    '재는 명령: `eln release checklist status --version <판> --json`(칸·선행·판) · `eln config get harness.podPool`(Pod 풀) · `uptime`(부하 추세) · `eln self gate --help`(호스트·게이트 옵션). 명령이 못 재는 슬롯·런 상태는 담당 원장의 현행 명령을 확인한다.',
+    ...cards.map(([id, rule]) => `- ${id} · ${rule} → 팩 ${role === 'coordinator' ? '조율자' : '수호자'} v1`),
+    '',
+    '## 판단 순서',
+    '1. 원 요청과 지금의 우편 스레드·확인표 칸을 대조한다.',
+    '2. 코드·설정·실행 결과를 읽고, 문서와 충돌하면 현재 실행 결과를 따른다.',
+    '3. 관측·판단 근거·다음 행동을 분리해 답한다. 쓰기는 현재 확인 단계가 허용한 명령으로만 한다.',
+    '4. 근거가 없거나 안전 난간과 충돌하면 보류하고 담당 자리 또는 사람에게 올린다.',
+    '',
+    '위에 명시한 검증된 C/G 카드 외의 노하우 카드는 포함하지 않는다. 현재 관측과 담당 자리의 검증된 원장을 직접 확인한다.',
+    '## 출처 해시',
+    ...sources.map((source) => `- ${source.path}: ${source.sha256}`),
+    ...missingSources.map((path) => `- ${path}: 없음(이 설치본에 미포함)`),
+    '',
+  ];
+  const body = lines.join('\n');
+  return { role, version, sha256: sha256(body), body, includedCardIds: cards.map(([id]) => id), excludedCardIds: [], sources, missingSources };
+}
+
+/** Prompt body consumed by coordinator and guardian agents. */
+export function buildCoordRolePack(role: RolePackRole, root = resolve(import.meta.dir, '..')): string {
+  return buildCoordRolePackManifest(role, root).body;
+}
+
+if (import.meta.main) {
+  const roleArg = process.argv.indexOf('--role');
+  const role = process.argv[roleArg + 1];
+  if (roleArg < 0 || (role !== 'coordinator' && role !== 'guardian')) {
+    console.error('usage: bun scripts/coord-role-pack.ts --role coordinator|guardian [--json]');
+    process.exitCode = 2;
+  } else {
+    const pack = buildCoordRolePackManifest(role);
+    process.stdout.write(process.argv.includes('--json') ? `${JSON.stringify(pack)}\n` : pack.body);
+  }
+}

package/scripts/detect-test-interference.ts

@@ -26,6 +26,9 @@ export type MeasuredRun = {
   fail: number | null;
   status: 'measured' | 'unmeasurable';
   reason?: string;
+  /** Names observed in Bun's failed-test output. Absent names must not be inferred from the selected files. */
+  failedFiles?: string[];
+  failedTests?: string[];
 };
 
 export type InterferenceReport = {
@@ -61,6 +64,32 @@ export function parseFailureCount(output: string): number | null {
   return Number(failures[0]![1]);
 }
 
+/** Bun prints a file heading before its `(fail) name` lines. Only retain names actually printed by that run. */
+export function parseFailedTestNames(output: string): { files: string[]; tests: string[] } {
+  const files = new Set<string>();
+  const tests = new Set<string>();
+  let currentFile: string | undefined;
+  for (const raw of output.replace(/\x1b\[[0-9;]*m/g, '').split(/\r?\n/)) {
+    const line = raw.trim();
+    if (/^(?:\d+\s+(?:pass|fail|skip)|Ran\s+\d+\s+tests?|Bun test v)/i.test(line)) { currentFile = undefined; continue; }
+    const failure = /^\(fail\)\s+(.+?)(?:\s+\[[^\]]+\])?$/.exec(line);
+    if (failure) {
+      tests.add(failure[1]!.trim());
+      if (currentFile) files.add(currentFile);
+      continue;
+    }
+    const heading = /^(.+):$/.exec(line);
+    if (heading) currentFile = /\.(?:test|spec)\.[cm]?[jt]sx?$/.test(heading[1]!) ? heading[1] : undefined;
+  }
+  return { files: [...files], tests: [...tests] };
+}
+
+export function failedNamesFromStreams(result: RunnerResult): { files: string[]; tests: string[] } {
+  const stdout = parseFailedTestNames(result.stdout);
+  const stderr = parseFailedTestNames(result.stderr);
+  return { files: [...new Set([...stdout.files, ...stderr.files])], tests: [...new Set([...stdout.tests, ...stderr.tests])] };
+}
+
 async function measure(files: readonly string[], runner: TestRunner): Promise<MeasuredRun> {
   try {
     const result = await runner(files);
@@ -68,9 +97,10 @@ async function measure(files: readonly string[], runner: TestRunner): Promise<Me
       return { files: [...files], fail: null, status: 'unmeasurable', reason: result.signal ? `runner terminated by ${result.signal}` : 'runner exit code unavailable' };
     }
     const fail = parseFailureCount(`${result.stdout}${result.stderr}`);
+    const names = fail !== null && fail > 0 ? failedNamesFromStreams(result) : undefined;
     return fail === null
       ? { files: [...files], fail: null, status: 'unmeasurable', reason: 'test summary unavailable, ambiguous, or ran zero files' }
-      : { files: [...files], fail, status: 'measured' };
+      : { files: [...files], fail, status: 'measured', ...(names?.files.length ? { failedFiles: names.files } : {}), ...(names?.tests.length ? { failedTests: names.tests } : {}) };
   } catch (error) {
     return { files: [...files], fail: null, status: 'unmeasurable', reason: error instanceof Error ? error.message : String(error) };
   }