elanous 0.2.19 → 0.2.21

package/graphs/implement-loop.yaml

@@ -38,8 +38,12 @@
 #      (파일 이름은 RFC 어휘를 남겨 둔다 — 사람이 찾는 이름과 조인 키가 다를 수 있다.)
 graph_id: self-implement
 version: 1
-entry_node: author
-terminal_nodes: [merge]
+# ⭐ HARNESS-FULL-GRAPH (0.2.21 · 대표 10-08) — 입구부터 회수까지 «여정 전체»가 노드다.
+#   📄 내부 문서 `RFC-harness-full-journey-as-graph-2026-10-08` · 코드 = src/self-dev/graph-journey-nodes.ts
+#   ⛔ 여정 노드(intake … stopped)의 id 는 원장·라이브 그래프 화면의 조인 키다 — 바꾸지 마라.
+#   🔀 분기는 «데이터»다(`on:` 상태 키 ⊕ `map:` 값→노드) — 기본 = 풀세트, 환경(substrate·freeze·queue)이 일부를 건너뛴다.
+entry_node: intake
+terminal_nodes: [cleanup, stopped]
 
 # Runner-provided inputs are declared here so contract-flow can distinguish them from undeclared gaps.
 runner_inputs: [ask_text, goal, worktree, branch, review-intent, head-sha, base-branch]
@@ -61,8 +65,13 @@ runner_inputs: [ask_text, goal, worktree, branch, review-intent, head-sha, base-
 #   🔑 ⇒ ***여기 적은 도구 권한은 「선언」이고 「제한」이 아니다.*** 자식의 실제 권한은 코드가 정한다.
 #   ⛔ 그러니 이 칸을 좁혀 「자식이 그 도구를 못 쓴다」고 읽지 마라 — 지금은 안 그렇다.
 #   🔎 반증: rg -n "readonly contract" src/self-implement/graph-templates.ts   (⇒ 0건이면 여전히 그렇다)
+# 🧩 `group:` = 나중에 `graphs/units/*.yaml` 로 들어 올릴 «한 노드로 부르는 부분 그래프» 단위(대표 10-08).
+#   entry · dispatch · author · dispatch-pod · build · verify · land · recover · end
+#   ⛔ 지금 파서는 이 칸을 «읽지 않는다»(무시) — 단위 호출은 0.2.22(RFC §6). 묶음은 «위치»가 아니라 이 태그로 정한다
+#      (오버레이가 /nodes/<번호> 로 가리켜 노드를 재배열할 수 없다).
 nodes:
   - node_id: author
+    group: author
     kind: agent
     recipe: goal-author
     max_visits: 2
@@ -74,6 +83,7 @@ nodes:
       outputs: [goal_path, goal_id, goal_type, grounding_context]
 
   - node_id: plan
+    group: author
     kind: agent
     recipe: harness-plan-rfc
     max_visits: 2
@@ -85,6 +95,7 @@ nodes:
       outputs: [rfc_path, markdown, arcs, open_questions]
 
   - node_id: decompose
+    group: author
     kind: judge
     recipe: fabric-decompose-adapter
     max_visits: 12
@@ -96,6 +107,7 @@ nodes:
       outputs: [pieces, ordering, depends_on_edges, hot_path_edges, omitted_goal_count]
 
   - node_id: implement
+    group: build
     kind: agent
     recipe: headless-goal-loop        # seams.implement → 자식 PTY
     max_visits: 12
@@ -109,6 +121,7 @@ nodes:
       outputs: [diff, summary, changed-files]
 
   - node_id: gate
+    group: verify
     kind: gate
     recipe: gate-baseline              # 변경 파일 «범위» · 새 회귀만
     max_visits: 11
@@ -122,6 +135,7 @@ nodes:
       outputs: [passed, gate-log, reflect-gate-facts]
 
   - node_id: review
+    group: verify
     kind: judge
     recipe: pr-reviewer                # agent-substrate/pr-reviewer
     max_visits: 11
@@ -135,6 +149,7 @@ nodes:
       outputs: [verdict, must-fix, should-fix, review-summary]
 
   - node_id: rework
+    group: verify
     kind: agent
     recipe: headless-goal-loop         # 같은 루프의 다음 라운드
     max_visits: 10
@@ -148,6 +163,7 @@ nodes:
       outputs: [diff, summary]
 
   - node_id: main-sync
+    group: land
     kind: git
     recipe: seams-git-merge-main       # LLM 충돌해결 포함
     max_visits: 2
@@ -159,6 +175,7 @@ nodes:
       outputs: [synced, conflicts]
 
   - node_id: regate
+    group: land
     kind: gate
     recipe: gate-baseline              # 충돌해결 «뒤» 재-gate
     max_visits: 2
@@ -170,6 +187,7 @@ nodes:
       outputs: [passed, gate-log]
 
   - node_id: open-pr
+    group: land
     kind: git
     recipe: seams-gh-open-pr
     # 📏 실측 2026-09-08 (원장 30일 · 전 우주 · 걸음 191개 소급 계산):
@@ -185,6 +203,7 @@ nodes:
       outputs: [pr-number, pr-url]
 
   - node_id: merge
+    group: land
     kind: git
     recipe: seams-gh-merge-squash
     # 📏 실측 2026-09-08 (원장 30일 · 전 우주 · 걸음 191개 소급 계산):
@@ -199,6 +218,176 @@ nodes:
       tools: gh-pr-merge
       outputs: [merged]
 
+  # ⛔ 여정 노드는 «목록 끝»에 둔다 — 오버레이가 JSON 포인터(/nodes/<번호>)로 노드를 가리킨다(rework-patient). 앞에 끼우면 번호가 밀린다.
+  # ───────── 여정 앞단: 입구 → 대기열 → 발사 관문 → 배치 ─────────
+  - node_id: intake
+    group: entry
+    kind: observe
+    recipe: harness-entrance            # src/harness/harness-cli-command.ts (say · ask · TUI /harness)
+    max_visits: 1
+    terminal_stages: []
+    contract:
+      inputs: [ask_text]
+      tools: none
+      outputs: [entrance, journey_key]
+
+  - node_id: queue
+    group: entry
+    kind: gate
+    recipe: harness-queue               # src/harness/harness-queue.ts (directSay 플래그 · 기본 끔 → 건너뜀)
+    max_visits: 1
+    terminal_stages: []
+    contract:
+      inputs: [entrance, seat]
+      tools: queue-write
+      outputs: [queue_item, queue_outcome]
+
+  - node_id: launch-gate
+    group: entry
+    kind: gate
+    recipe: pre-launch-gate             # harness-cli-command.ts preLaunchGate (예산 · 같은 골 활성 런)
+    max_visits: 1
+    terminal_stages: []
+    contract:
+      inputs: [goal_id, budget]
+      tools: read-only
+      outputs: [launch_decision]
+
+  - node_id: dispatch
+    group: dispatch
+    kind: judge
+    recipe: harness-substrate-select    # resolveLaunchSubstrate → substrate = local | pod
+    max_visits: 2
+    terminal_stages: []
+    contract:
+      inputs: [launch_decision]
+      tools: read-only
+      outputs: [substrate]
+
+  # ───────── Pod 배치 (substrate == pod 일 때만 — local 은 건너뛴다) ─────────
+  - node_id: pool-admit
+    group: dispatch-pod
+    kind: gate
+    recipe: pod-pool-admission          # src/task-orchestrator/surfaces/self-implement-pod.ts (입장 · 멤버 슬롯 · 메모리 등급)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [substrate, memory_tier]
+      tools: pod-lease
+      outputs: [pool_member]
+
+  - node_id: image-sync
+    group: dispatch-pod
+    kind: gate
+    recipe: pod-pool-image-sync         # src/task-orchestrator/surfaces/pod-pool.ts syncPoolImages (멤버별 · pack 한 번)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [pool_member]
+      tools: image-ship
+      outputs: [image_current]
+
+  - node_id: credential-refresh
+    group: dispatch-pod
+    kind: gate
+    recipe: pod-credential-prerefresh   # self-implement-pod.ts podCodexCredentialWithPrerefresh
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [pool_member]
+      tools: credential-refresh
+      outputs: [usable_accounts]
+
+  # ───────── 착지: 동결 검사 → (보류) → 병합 → 회수 ─────────
+  - node_id: freeze-check
+    group: land
+    kind: gate
+    recipe: landing-freeze-admission    # src/self-implement/frozen-merges.ts admitLandingMerge (병합 직전 한 곳)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [pr-number]
+      tools: read-only
+      outputs: [freeze]
+
+  - node_id: hold
+    group: land
+    kind: hitl
+    recipe: frozen-merge-queue          # frozen-merges.ts queueFrozenMerge → sweepFrozenMerges 가 해제 뒤 재개
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [pr-number, head-sha]
+      tools: queue-write
+      outputs: [held]
+
+  - node_id: cleanup
+    group: land
+    kind: git
+    recipe: post-merge-cleanup          # src/self-implement/orchestrator.ts (워크트리 ⊕ 브랜치 회수)
+    max_visits: 1
+    terminal_stages: []
+    contract:
+      inputs: [worktree, branch]
+      tools: git-write
+      outputs: [cleaned]
+
+  # ───────── 실패 쪽: 결과 해석 → 수확 → heal → 다음 한 수 ─────────
+  - node_id: result-parse
+    group: recover
+    kind: observe
+    recipe: pod-failure-reason          # src/task-orchestrator/surfaces/pod-failure-reason.ts
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [pod_log]
+      tools: read-only
+      outputs: [failure_reason]
+
+  - node_id: salvage
+    group: recover
+    kind: git
+    recipe: salvage-branch              # salvage/si-task-<job>/… (Pod Job 이 push · salvage-branches.ts 가 읽는다)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [worktree]
+      tools: git-write
+      outputs: [salvage_ref]
+
+  - node_id: heal
+    group: recover
+    kind: judge
+    recipe: heal-intake                 # src/self-implement/heal-intake.ts (호스트에서만)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [failure_reason, salvage_ref]
+      tools: read-only
+      outputs: [heal_signature]
+
+  - node_id: next-move
+    group: recover
+    kind: judge
+    recipe: task-agent-judge            # src/task-agent/judge.ts (판단부 → 실행부)
+    max_visits: 4
+    terminal_stages: []
+    contract:
+      inputs: [heal_signature]
+      tools: read-only
+      outputs: [next_action]
+
+  - node_id: stopped
+    group: end
+    kind: observe
+    recipe: journey-stopped             # 거절·포기 — 종결
+    max_visits: 1
+    terminal_stages: []
+    contract:
+      inputs: []
+      tools: none
+      outputs: []
+
 # ═══════════════════════════════════════════════════════════════════════
 # 엣지 — ⛔ 출처는 «코드 선언 ⊕ 원장 실측» 둘 다다. 어느 하나만 보면 틀린다.
 #   📏 2026-09-08 실측 (pipeline-traversal-shadow 182 걸음 · 판정 함수가 «실제로 본» 것):
@@ -207,14 +396,83 @@ nodes:
 #         gate→main-sync · gate→open-pr · review→open-pr
 #   🔑 그래서 엣지마다 `observed` 를 «값으로» 적는다 — 「선언했다」와 「돈다」를 가른다.
 edges:
+  # ───── 여정 앞단 — 분기는 «데이터»(on/map). 값은 코드가 낸다(RFC §4.3 ⑵) ─────
+  - from: intake
+    on: queue
+    map:
+      queued: queue                    # harness.queue.directSay 켬 ⊕ 자리 있음
+      direct: launch-gate              # 기본(플래그 끔) — 대기열을 건너뛴다
+
+  - from: queue
+    on: queue_outcome
+    map:
+      launched: launch-gate            # 대기열이 발사한 자식이 다시 intake 를 밟는다(queueLaunchId 로 잇는다)
+      waiting: stopped                 # 이 프로세스는 여기서 끝난다(발사는 대기열 tick 의 몫)
+      refused: stopped                 # 같은 요청이 이미 대기열에 있다
+
+  - from: launch-gate
+    on: outcome
+    map:
+      pass: dispatch
+      refuse: stopped
+
+  - from: dispatch
+    to: author
+
   - from: author
     to: plan
 
   - from: plan
     to: decompose
 
+  # ⭐ 실행 칸(substrate)이 «Pod 쪽 세 노드»를 켜고 끈다 — local 은 곧장 구현.
   - from: decompose
-    to: implement
+    on: substrate
+    map:
+      local: implement
+      pod: pool-admit
+
+  - from: pool-admit
+    on: outcome
+    map:
+      admitted: image-sync
+      refused: stopped
+
+  - from: image-sync
+    to: credential-refresh
+
+  - from: credential-refresh
+    on: outcome
+    map:
+      usable: implement
+      exhausted: stopped
+
+  # 실패 쪽 — Pod 구현이 rc≠0 이면 결과 해석으로.
+  - from: implement
+    on: pod_result
+    map:
+      failed: result-parse
+
+  - from: result-parse
+    to: salvage
+
+  # ⚠️ heal 은 실패 사건 «접수»다 — 호스트에서만(Pod 안에서는 시작 안 함 · POD-RESULT-PARSE).
+  - from: salvage
+    to: heal
+
+  - from: heal
+    to: next-move
+
+  # 출구 라벨 = task-agent 판단부의 수(TaskMove · src/task-agent/judge.ts). 관측 배선은 0.2.22(판단이 카드 단위라 런 조인 먼저).
+  - from: next-move
+    on: move
+    map:
+      narrow-relaunch: dispatch
+      salvage-relaunch: dispatch
+      alternative: dispatch
+      wait-retry: dispatch
+      decision-card: stopped
+      wait: stopped
 
   - from: implement
     to: gate
@@ -264,6 +522,20 @@ edges:
     to: open-pr
     observed: 80
 
+  # ⭐ HARNESS-FULL-GRAPH — 코드 간선 open-pr→merge 사이에 «동결 검사»가 늘 끼어 있었다(병합 직전 한 곳).
   - from: open-pr
-    to: merge
-    observed: 80
+    to: freeze-check
+    observed: 80                       # 옛 open-pr→merge 관측 — 그 사이에 동결 검사가 늘 있었다
+
+  - from: freeze-check
+    on: freeze
+    map:
+      open: merge
+      frozen: hold
+      taken: stopped                   # 다른 착지자(재개 sweep)가 그 PR 을 쥐었다
+
+  - from: hold
+    to: freeze-check                   # 해제 뒤 재검사
+
+  - from: merge
+    to: cleanup

package/graphs/retro/daily.yaml

@@ -0,0 +1,25 @@
+graph_id: retro-daily
+version: 1
+loop:
+  title: 매일 회고
+  description: 지난 24시간 사실(retro facts)을 묶어 반복·«초록 뒤 재발»을 먼저 올리고, 사실 id 를 단 인사이트와 조치 초안(≤3)을 낸다 — 기본 shadow(체크리스트·메시지 0)
+  trigger:
+    cron: '40 22 * * *'
+entry_node: collect
+terminal_nodes: [done, failed]
+nodes:
+  - { node_id: collect, kind: agent, recipe: 'cmd:collect', max_visits: 1 }
+  - { node_id: cluster, kind: agent, recipe: 'cmd:cluster', max_visits: 1 }
+  - { node_id: recur, kind: agent, recipe: 'cmd:recur', max_visits: 1 }
+  - { node_id: insight, kind: agent, recipe: 'cmd:insight', max_visits: 1 }
+  - { node_id: act, kind: agent, recipe: 'cmd:act', max_visits: 1 }
+  - { node_id: report, kind: agent, recipe: 'cmd:report', max_visits: 1 }
+  - { node_id: done, kind: gate, max_visits: 1 }
+  - { node_id: failed, kind: gate, max_visits: 1 }
+edges:
+  - { from: collect, on: outcome, map: { ok: cluster, fail: failed } }
+  - { from: cluster, on: outcome, map: { ok: recur, fail: failed } }
+  - { from: recur, on: outcome, map: { ok: insight, fail: failed } }
+  - { from: insight, on: outcome, map: { ok: act, fail: failed } }
+  - { from: act, on: outcome, map: { ok: report, fail: failed } }
+  - { from: report, on: outcome, map: { ok: done, fail: failed } }

package/graphs/retro/recipes.yaml

@@ -0,0 +1,24 @@
+collect:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" collect'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" collect'
+  timeout_ms: 600000
+cluster:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" cluster'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" cluster'
+  timeout_ms: 60000
+recur:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" recur'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" recur'
+  timeout_ms: 60000
+insight:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" insight'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" insight'
+  timeout_ms: 60000
+act:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" act'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" act'
+  timeout_ms: 60000
+report:
+  command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" report'
+  dry_run_command: 'bun "$ELANOUS_GRAPH_DIR/../../src/retro/daily.ts" report'
+  timeout_ms: 60000

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elanous",
   "mcpName": "io.github.ElanvitalAI/elanous",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "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/ask-marker-check.ts

@@ -1191,7 +1191,9 @@ export function formatAxisObservations(a: Axis): readonly string[] {
   ];
 }
 
-function main(files: string[]): number {
+/** CLI 본체. ⭐ 시험 심으로 export 한다(GATE-SPEED ③ · 2026-10-08) — 시험이 같은 출력 계약을
+ *  프로세스 하나 안에서 잴 수 있게. 실물 진입점(`import.meta.main`)은 아래 한 줄 그대로다. */
+export function main(files: string[]): number {
   if (files.length === 0) {
     console.error('쓰는 법: bun scripts/ask-marker-check.ts <ask 파일…>');
     return 2;

package/scripts/coord-channel-watch.sh

@@ -240,15 +240,42 @@ lsof_fd1() {
   return 0
 }
 
+# 🐧 lsof 가 없는 리눅스(게이트 Pod 이미지 · 0.2.20 컷 실측)에서는 /proc/<pid>/fd/1 을 읽어
+#   lsof -Ftn 과 «같은 모양»(t<type>\nn<name>)으로 낸다 — 아래 판정 표를 그대로 쓴다.
+#   ⛔ 못 읽으면(죽은 pid·권한) 1 을 돌려 「모름」으로 끝낸다.
+proc_fd1() {
+  local pid="$1" target
+  target=$(readlink "/proc/$pid/fd/1" 2>/dev/null) || return 1
+  [ -n "$target" ] || return 1
+  case "$target" in
+    pipe:*)   printf 'tPIPE\nn%s\n' "$target" ;;
+    socket:*) printf 'tunix\nn%s\n' "$target" ;;
+    *)
+      if [ -c "$target" ]; then printf 'tCHR\nn%s\n' "$target"
+      elif [ -f "$target" ]; then printf 'tREG\nn%s\n' "$target"
+      else printf 'tunknown\nn%s\n' "$target"
+      fi ;;
+  esac
+  return 0
+}
+
 delivery_of() {
   local pid="$1" out t n
   case "$pid" in
     ''|*[!0-9]*) printf '⚠️ «못 쟀다»(감시자 pid 를 «증명하지 못했다») — 「정상」이 아니라 «모름»이다'; return 0 ;;
   esac
-  command -v lsof >/dev/null 2>&1 || { printf '⚠️ «못 쟀다»(lsof 없음) — 「정상」이 아니라 «모름»이다'; return 0; }
-  if ! out=$(lsof_fd1 "$pid"); then
-    printf '⚠️ «못 쟀다»(lsof 가 %s틱 안에 안 끝나 죽였다) — 「정상」이 아니라 «모름»이다' "$LSOF_WAIT_TICKS"
-    return 0
+  if command -v lsof >/dev/null 2>&1; then
+    if ! out=$(lsof_fd1 "$pid"); then
+      printf '⚠️ «못 쟀다»(lsof 가 %s틱 안에 안 끝나 죽였다) — 「정상」이 아니라 «모름»이다' "$LSOF_WAIT_TICKS"
+      return 0
+    fi
+  elif command -v readlink >/dev/null 2>&1 && [ -d /proc/self/fd ]; then
+    if ! out=$(proc_fd1 "$pid"); then
+      printf '⚠️ «못 쟀다»(/proc/%s/fd/1 을 못 읽었다 · lsof 없음) — 「정상」이 아니라 «모름»이다' "$pid"
+      return 0
+    fi
+  else
+    printf '⚠️ «못 쟀다»(lsof 없음) — 「정상」이 아니라 «모름»이다'; return 0
   fi
   t=$(printf '%s\n' "$out" | sed -n 's/^t//p' | head -1)
   n=$(printf '%s\n' "$out" | sed -n 's/^n//p' | head -1)

package/scripts/docs-lint.ts

@@ -13,6 +13,7 @@ import {
 } from '../src/autopilot/discovery/doc-lint.js';
 import { parseIndexLinks } from '../src/autopilot/discovery/doc-inventory.js';
 import { execFileSync } from 'node:child_process';
+import { runGitCommand } from '../src/git-fs/runner.js';
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { basename, join, relative } from 'node:path';
 import { sourceIdentifierInventory, inlineCodeIdentifiers } from '../src/autopilot/discovery/source-identifiers.js';
@@ -80,7 +81,9 @@ const readText = (relPath: string): string | null => { try { return readFileSync
 //   전부 「못 읽음」이 되어 이 규칙이 통째로 잡음이 된다. 그래서 파일명 → repo 경로를 «한 번» 만든다.
 //   ⛔ 같은 파일명이 둘 이상이면 «해석하지 않는다** — 틀린 파일을 대면 「어긋남」이 거짓으로 난다.
 const sourcePathsByBasename = new Map<string, string | null>();
-for (const relPath of execFileSync('git', ['ls-files', '*.ts', '*.tsx'], { cwd: repoRoot, encoding: 'utf-8' }).split('\n')) {
+const lsFiles = runGitCommand(repoRoot, ['ls-files', '*.ts', '*.tsx'], { encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 });
+if (lsFiles.status !== 0) throw new Error(`git ls-files failed: ${lsFiles.stderr.trim() || `rc=${lsFiles.status}`}`);
+for (const relPath of lsFiles.stdout.split('\n')) {
   if (relPath === '') continue;
   const base = basename(relPath);
   sourcePathsByBasename.set(base, sourcePathsByBasename.has(base) ? null : relPath);

package/scripts/land-global-checks.ts

@@ -0,0 +1,89 @@
+#!/usr/bin/env bun
+// LAND-GLOBAL-CHECKS — 착지 게이트가 «전역 검사»를 바뀐 파일로 끌어온다.
+//
+// `pr land` 는 바뀐 파일만 본다. 그런데 저장소 전체를 훑는 정적 시험(전역 검사)은 «그 시험 파일»이
+// 안 바뀌면 착지에서 한 번도 안 돈다 — 0.2.19 회귀 9 중 넷이 이 꼴이었다
+// (hook-order-sweep #24719 · next.md B11 #24688 · machines 생성 Markdown #24729 · harness 하위 명령 목록 #24661).
+//
+// ⭐ 표는 «여기 한 곳»이다(경로 꼴 → 시험). 새 전역 검사를 붙이려면 이 표에 줄을 더한다.
+// 재는 명령: `bun scripts/land-global-checks.ts` (표) · `bun scripts/land-global-checks.ts <바뀐 파일…>` (끌려오는 시험)
+
+import { spawnSync } from 'node:child_process';
+
+type LandGlobalCheck = {
+  /** 바뀐 파일 경로(저장소 루트 기준 · `/` 구분)에 대는 꼴. */
+  pattern: RegExp;
+  /** 끌려오는 전역 시험 파일. */
+  test: string;
+  /** 왜 이 꼴이 이 시험을 부르나 — 회귀 근거. */
+  why: string;
+};
+
+export const LAND_GLOBAL_CHECKS: readonly LandGlobalCheck[] = [
+  { pattern: /^apps\/pwa\/.+\.tsx$/, test: 'test/hook-order-sweep.test.ts', why: 'PWA 컴포넌트 훅 순서(#24719)' },
+  { pattern: /^release\/next\.md$/, test: 'scripts/release-story/draft.test.ts', why: '판 노트 초안·브랜드 규칙(#24688)' },
+  { pattern: /^docs\/ops\/machines\.yaml$/, test: 'test/machines-ledger-data.test.ts', why: '기계 원장 데이터 ↔ 생성 Markdown(#24729)' },
+  // 새 CLI 하위 명령은 `src/index.ts` 또는 `src/cli/` 의 등록 모듈에서 생긴다 — 입구 목록 시험(#24661).
+  { pattern: /^src\/(?:index|cli\/(?:[^/]+\/)*[^/]+)(?<!\.test)\.ts$/, test: 'src/index.test.ts', why: 'CLI 입구·하위 명령 목록(#24661)' },
+];
+
+/** 바뀐 파일 → 끌려오는 전역 시험(표 순서 · 중복 없음). */
+export function landGlobalChecks(changedFiles: readonly string[], table: readonly LandGlobalCheck[] = LAND_GLOBAL_CHECKS): string[] {
+  const tests: string[] = [];
+  for (const { pattern, test } of table) {
+    if (!tests.includes(test) && changedFiles.some((file) => pattern.test(file.replace(/\\/g, '/')))) tests.push(test);
+  }
+  return tests;
+}
+
+export type LandGlobalChecksRun = { status: number | null; output: string; error?: string };
+
+type LandGlobalChecksGateIo = {
+  changedFiles: readonly string[];
+  cwd: string;
+  log: (message: string) => void;
+  error: (message: string) => void;
+  /** 시험 주입용 — 기본은 결정적 러너(`scripts/test-deterministic.ts`)로 끌려온 시험만 돌린다. */
+  runTests?: (tests: readonly string[], cwd: string) => LandGlobalChecksRun;
+};
+
+function runDeterministic(tests: readonly string[], cwd: string): LandGlobalChecksRun {
+  const r = spawnSync('bun', ['run', 'scripts/test-deterministic.ts', ...tests], {
+    cwd, encoding: 'utf8', maxBuffer: 256 * 1024 * 1024, timeout: 15 * 60_000,
+  });
+  return { status: r.status, output: `${r.stdout ?? ''}\n${r.stderr ?? ''}`, ...(r.error ? { error: r.error.message } : {}) };
+}
+
+/**
+ * 반환: true = 해당 없음 또는 끌려온 시험 통과 · false = 끌려온 시험이 실패했다(착지를 막는다).
+ * ⛔ 러너가 «못 돌았다»(spawn 실패·시간 초과)면 던진다 — 호출부(`gateVerdict`)가 「검사 못 함」으로 말한다.
+ */
+export function runLandGlobalChecksGate(io: LandGlobalChecksGateIo): boolean {
+  const tests = landGlobalChecks(io.changedFiles);
+  if (tests.length === 0) {
+    io.log(`[land-global-checks] 해당 없음 — 바뀐 파일 ${io.changedFiles.length}개가 전역 검사 표(${LAND_GLOBAL_CHECKS.length}줄)의 꼴에 안 걸린다.`);
+    return true;
+  }
+  io.log(`[land-global-checks] 전역 검사 ${tests.length}개를 끌어온다: ${tests.join(' · ')}`);
+  const result = (io.runTests ?? runDeterministic)(tests, io.cwd);
+  if (result.error !== undefined || result.status === null) {
+    throw new Error(`전역 검사 러너가 못 돌았다 — ${result.error ?? 'status=null'}`);
+  }
+  if (result.status !== 0) {
+    const tail = result.output.split('\n').filter((line) => /\(fail\)|^\s*\d+ (pass|fail)|^Ran /.test(line)).slice(-12);
+    for (const line of tail) io.error(`[land-global-checks] ${line.trim()}`);
+    return false;
+  }
+  return true;
+}
+
+if (import.meta.main) {
+  const changed = process.argv.slice(2);
+  if (changed.length === 0) {
+    console.log(`전역 검사 표 ${LAND_GLOBAL_CHECKS.length}줄`);
+    for (const row of LAND_GLOBAL_CHECKS) console.log(`${row.pattern.source} → ${row.test} · ${row.why}`);
+  } else {
+    const tests = landGlobalChecks(changed);
+    console.log(`끌려오는 전역 시험 ${tests.length}개${tests.length ? `: ${tests.join(' · ')}` : ''}`);
+  }
+}

package/scripts/lib/pch-regress-map.ts

@@ -15,7 +15,8 @@ export const PCH_REGRESS_MAP: Record<string, readonly string[]> = {
   'PCH-8': ['src/lib/chat-harness-ask.test.ts', 'src/components/chat/HarnessAskCard.test.tsx'],
   'PCH-9': ['src/components/chat/ChatPendingDecision.test.tsx', 'src/components/chat/ChatDecisionsChip.test.tsx'],
   'PCH-10': ['src/lib/chat-runtime.meta.test.ts'], // /rewind · /undo meta commands.
-  'PCH-11': ['src/lib/chat-fork.test.ts'],
+  // Full fork and turn-bearing rewind/undo branches; live PWA behavior still needs observation.
+  'PCH-11': ['src/lib/chat-fork.test.ts', 'src/lib/chat-branch.test.ts'],
   'PCH-12': ['src/lib/chat-runtime.run-skill.test.ts'],
   'PCH-13': ['src/components/chat/ChatConversationList.test.tsx'], // Chat search; export has no identified PWA test.
   'PCH-14': ['src/lib/compact-mode.test.ts'], // Compact; plan toggle has no identified PWA test.

package/scripts/marketing/generate-ax-brief.ts

@@ -1,10 +1,11 @@
 import { readFileSync, writeFileSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { basename, resolve } from 'node:path';
 import { FEATURE_MATURITY } from '../../src/maturity/feature-maturity.js';
 import type { ChecklistItem } from '../../src/release-loop/checklist.js';
 import type { ReleaseSchedule } from '../../src/release-loop/release-schedule.js';
 import type { MergedRunLedgerQuery } from '../../src/self-implement/run-ledger.js';
 import { generateFeatureMap } from './generate-feature-map.js';
+import { draftReleaseStory } from '../release-story/draft.js';
 
 const MAP = resolve(import.meta.dir, '../../docs/marketing/MAP-value-props-to-features.md');
 const AUTONOMY = new Set(['ORCH1', 'ORCH2', 'LOOP-LIVE1', 'AUTOQ-LOOP', 'AUTHOR-PAR', 'RUN-HELPER', 'FINISH-RATE']);
@@ -110,6 +111,22 @@ export function generateAxBrief(version: string, sources: AxBriefSources): strin
   ].join('\n');
 }
 
+/** Derive the next release's internal brief from its ledgers and the RELEASE-STORY version-note draft.
+ * The release loop supplies its version, ledger sources and isolated story paths; the standalone CLI stays unchanged. */
+export function generateNextVersionAxBrief(
+  nextVersion: string,
+  sources: AxBriefSources,
+  storyOptions: Omit<Parameters<typeof draftReleaseStory>[0], 'version'> = {},
+): string {
+  const brief = generateAxBrief(nextVersion, sources);
+  const story = draftReleaseStory({ ...storyOptions, version: nextVersion });
+  const announcementFile = story.files.find((file) => basename(file) === 'announcement.md');
+  const announcement = story.status === 'drafted' && announcementFile
+    ? readFileSync(announcementFile, 'utf8').replace(/^# [^\r\n]*\r?\n/, '').trim()
+    : '사용자 대상 변경 없음 — RELEASE-STORY 초안을 건너뜀';
+  return `${brief}\n## 5. 다음 판 변화·근거 (RELEASE-STORY 초안)\n\n> 공개 전 CMO 확인 필요 · 원천: release/next.md, 해당 판의 green 칸, 연결된 검증 소구점 원장\n\n${announcement}\n`;
+}
+
 if (import.meta.main) {
   const args = process.argv.slice(2);
   const option = (name: string) => {