elanous 0.2.28 → 0.2.29

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/lib/morning-report-options.ts

@@ -0,0 +1,41 @@
+// ── morning-report 스크립트 CLI 인자 — 명시 서사 모델(--narrative-model) ────────
+//
+// scripts/morning-report.ts 는 지금 인자를 process.argv.includes(...) 인라인으로 읽는다
+// (--dry · --no-narrate · --no-upload). 이 파일은 그 스크립트의 인자 계약을 일반 파서
+// scripts/lib/argv.ts#parseArgv 위에 정의한다. 계약이 스크립트의 네 플래그를 «전부» 아는
+// 것은, 이 헬퍼가 «스크립트 CLI 인자» 전체를 받아 모델 값만 뽑는 목적이어서다 —
+// 다른 플래그가 섞인 실제 argv 가 들어와도 모델 값에 오염이 없다.
+//
+// 반환 계약 — src/domains/morning-report.ts#MorningReportOpts.model 에 그대로 꽂힌다:
+//   · '--narrative-model X' / '--narrative-model=X' 두 철자를 «같게» 읽어 값 문자열 반환.
+//   · 플래그가 없으면 undefined — src/domains/morning-essential.ts 의 기본 provider
+//     경로(model 미지정 ⇒ providerFor(cfg))를 그대로 보존한다. 값이 없거나 빈 값이면
+//     parseArgv 오류를 던져 기본 모델로 조용히 실행되지 않도록 한다.
+//
+// ⛔ 의도된 경계(비연결 선언): 이 유닛은 «정의 + 단위시험» 에서 멈춘다.
+//   scripts/morning-report.ts 탑레벨(CLI 진입) → composeMorningReport(..., { model }) 배선은
+//   의존 형제 샤드(task:d0183079b142)의 몫이다. 지금 이 유닛을 실행 경로에서 부르는 곳은
+//   scripts/lib/morning-report-options.test.ts(bun test, in-process) 다.
+
+import { parseArgv, type ArgvContract } from './argv.js';
+
+/** morning-report 스크립트의 전체 CLI 플래그 — 파서 계약(여기 없는 플래그는 거부된다). */
+const MORNING_REPORT_ARGV: ArgvContract = {
+  known: {
+    '--dry': 'bool',
+    '--no-narrate': 'bool',
+    '--no-upload': 'bool',
+    '--narrative-model': 'value',
+  },
+  label: 'morning-report',
+};
+
+/**
+ * 아침 브리핑 시장서사의 명시 LLM 모델(--narrative-model)을 argv 에서 뽑는다.
+ * 플래그가 없으면 undefined — undefined 자체가 «기본 provider 경로» 값이다.
+ */
+export function parseNarrativeModelArg(argv: string[]): string | undefined {
+  const parsed = parseArgv(argv, MORNING_REPORT_ARGV);
+  if (parsed.errors.length > 0) throw new Error(parsed.errors.join('\n'));
+  return parsed.values['narrative-model'];
+}

package/scripts/pr-land-extra-remote-gates.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env bun
+/** Extra landing gates on the pinned head/main integration tree. */
+import { spawnSync } from 'node:child_process';
+import { runLandGlobalChecksGate } from './land-global-checks.js';
+import { runTestInterferenceGate } from './ci-test-interference-gate.js';
+
+export interface PrLandExtraGateDeps {
+  changedFiles?: (base: string, cwd: string) => string[];
+  runGlobal?: (files: readonly string[], cwd: string) => boolean;
+  runInterference?: (files: readonly string[], cwd: string, log: (message: string) => void) => Promise<number>;
+}
+
+function changedFiles(base: string, cwd: string): string[] {
+  if (!/^[a-f0-9]{40}$/i.test(base)) throw new Error('invalid pinned base');
+  const diff = spawnSync('git', ['diff', '--name-only', '-z', `${base}...HEAD`], { cwd, encoding: 'buffer' });
+  if (diff.error || diff.status !== 0 || !Buffer.isBuffer(diff.stdout)) {
+    throw new Error(`changed files unmeasured: ${diff.error?.message ?? diff.stderr?.toString('utf8') ?? diff.status}`);
+  }
+  return diff.stdout.toString('utf8').split('\0').filter(Boolean);
+}
+
+export async function runPrLandExtraRemoteGates(base: string, cwd = process.cwd(), deps: PrLandExtraGateDeps = {}): Promise<number> {
+  if (!/^[a-f0-9]{40}$/i.test(base)) throw new Error('invalid pinned base');
+  const files = (deps.changedFiles ?? changedFiles)(base, cwd);
+  const globalOk = (deps.runGlobal ?? ((paths, root) => runLandGlobalChecksGate({ changedFiles: paths, cwd: root, log: console.log, error: console.error })))(files, cwd);
+  if (!globalOk) return 1;
+  let interferenceMeasured = true;
+  const interferenceLog = (message: string): void => {
+    console.log(message);
+    if (message.includes('[test-interference-gate] 경고: 측정 불가')) interferenceMeasured = false;
+  };
+  try {
+    const rc = await (deps.runInterference ?? ((paths, root, log) => runTestInterferenceGate({ args: ['--changed-files', ...paths], cwd: root, log })))(files, cwd, interferenceLog);
+    if (rc !== 0) interferenceMeasured = false;
+  } catch (error) {
+    interferenceMeasured = false;
+    console.warn(`[test-interference-gate] 경고: 측정 불가 — ${error instanceof Error ? error.message : String(error)}; 간섭 없음으로 처리하지 않음.`);
+  }
+  console.log(`[pr-land-extra-gates] pass global=measured interference=${interferenceMeasured ? 'measured' : 'unmeasured'} files=${files.length}`);
+  return 0;
+}
+
+if (import.meta.main) {
+  try { process.exitCode = await runPrLandExtraRemoteGates(process.argv[2] ?? ''); }
+  catch (error) {
+    console.error(`[pr-land-extra-gates] unmeasured: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+  }
+}

package/scripts/release-loop/gate-batch-safe.ts

@@ -0,0 +1,23 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Explicit opt-in only. A test enters a shared Pod after its own-Pod and batch verdicts have been compared. */
+export function loadGateBatchSafe(repoRoot: string): Set<string> {
+  const path = join(repoRoot, 'release/gate-batch-safe.json');
+  if (!existsSync(path)) return new Set();
+  let data: unknown;
+  try { data = JSON.parse(readFileSync(path, 'utf8')); }
+  catch (error) { throw new Error(`invalid gate batch safe list: ${path}`, { cause: error }); }
+  if (!data || typeof data !== 'object' || Array.isArray(data)
+    || !('env' in data) || data.env !== 'linux-pod'
+    || !('tests' in data) || !Array.isArray(data.tests)
+    || !data.tests.every((entry: unknown) => entry && typeof entry === 'object' && !Array.isArray(entry)
+      && 'file' in entry && typeof entry.file === 'string'
+      && /^(?:[\w.-]+\/)+[\w.-]+\.test\.tsx?$/.test(entry.file)
+      && 'evidence' in entry && typeof entry.evidence === 'string' && entry.evidence.trim().length > 0)) {
+    throw new Error(`invalid gate batch safe list: ${path}`);
+  }
+  const files = data.tests.map((entry: { file: string }) => entry.file);
+  if (new Set(files).size !== files.length) throw new Error(`invalid gate batch safe list: duplicate file in ${path}`);
+  return new Set(files);
+}