elanous 0.2.4 → 0.2.5

package/plugins/job-coach/skills/enterprise-needs/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: enterprise-needs
+description: Extract evidence-backed organizational learning needs from a fictional enterprise interview without claiming that a requested course is the solution.
+---
+
+Use after `interview-to-profile` in enterprise mode (`intake` → `needs`). Read the enterprise interview headings `## 기업 개요`, `## 교육 대상`, `## 현업 과제`, `## 교육 목표`, `## 현재 역량`, `## 교육 제약`. Distinguish what the organization requested from what its workflow evidence supports. For each need, record the affected learner group, task or bottleneck, desired observable outcome, evidence section and missing information. Keep unsupported causes and target levels `미확인`; ask for missing evidence rather than invent a baseline or learner count. A request for AI training is not proof that AI is the best intervention.
+
+Use only fictional employer and learner details in examples. Summarize or cite interview sections instead of reproducing interview paragraphs; if an excerpt is essential, quote only a short relevant fragment without names or identifiers. Never print the raw interview or credentials into graph stdout. Company approval and data-use policy, NCS mappings, named courses and course URLs remain `미확인` until independently verified. Hand needs and unresolved questions to `task`, not a prematurely selected course.

package/plugins/job-coach/skills/enterprise-roadmap/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: enterprise-roadmap
+description: Sequence evidence-backed enterprise learning and assessment into a conditional roadmap, not an approved company policy.
+---
+
+Use after `enterprise-competency` at the `roadmap` stage. Order learning activities by prerequisite and task: baseline check, guided practice, task-based pilot with human review, then observable assessment. For each phase, show the learner group, supported task or verified NCS requirement, expected work artifact, success measure, responsible reviewer if known and prerequisites. If time, budget, data access, approval or baseline are absent from `## 교육 제약`, mark them `미확인` and describe the recommendation as conditional; do not invent durations, headcounts, policy approvals or guaranteed outcomes. Pass the ordered phases to `spec` for training specification and `routing` for delivery options. A course recommendation needs an inspected publisher page describing an actual course, direct URL and relevance to the cited unit; otherwise record course and URL as `미확인`, not a plausible link.
+
+All examples must be fictional. Cite interview headings instead of copying raw interview text; any essential quote must be short, relevant and de-identified. NCS codes, course details and organization policy not independently confirmed remain `미확인`. Do not label this proposed roadmap an adopted company plan.

package/plugins/job-coach/skills/enterprise-task-analysis/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: enterprise-task-analysis
+description: Turn enterprise learning needs into traceable tasks and evidence requirements for NCS matching.
+---
+
+Use at the enterprise `task` stage after `enterprise-needs`. For each interview-backed work task, capture the learner role, input, action, output, observable performance criterion and interview section that supports it. Separate a concrete work description from a hypothesized task; mark absent frequency, tools, access permissions and proficiency `미확인`. Return job candidate keywords and bounded task descriptions for the existing `ncs-match` stage. A job title is a search candidate, not a confirmed NCS classification. Let `ncs-match` verify a code, name, level and source from the NCS service; never manufacture a code or promote a loose search hit to a confirmed unit.
+
+In examples use fictional roles and organizations. Do not pass raw interview paragraphs into graph stdout: cite the heading or use a brief de-identified excerpt only where necessary. Do not invent internal company policy, course names or course URLs; write `미확인` if absent. If no concrete task is documented, state that the task basis is `미확인` and request clarification instead of drawing an unsupported NCS match.

package/plugins/job-coach/skills/interview-to-profile/SKILL.md

@@ -3,4 +3,21 @@ name: interview-to-profile
 description: Extract career candidates, experience and self-reported skills from a Korean interview.
 ---
 
-Read the interview Markdown. Extract, without invention, `jobs` (target job candidates), `skills` (self-reported capabilities) and `experienceCount` (number of concrete work or project descriptions). Do not persist the raw descriptions in graph stdout. Record unknowns as missing rather than extrapolating. Never print or log the original interview. For the packaged graph, prepare headings `## 희망 직무`, `## 경험`, `## 보유 역량`; list items for experience and comma-separated skills. A job is a candidate, not a confirmed NCS code.
+Read the interview Markdown without inventing evidence. Never print or log the original interview; keep quotations out of graph stdout and persistent run context. Where a report needs a quotation, use only a short, relevant excerpt necessary to support the claim, without identifying details; otherwise paraphrase and cite the interview section. Mark unknown NCS codes or units, course names or URLs, and company policy details `미확인` rather than guessing.
+
+## Personal mode (existing contract)
+
+Extract `jobs` (target job candidates), `skills` (self-reported capabilities) and `experienceCount` (number of concrete work or project descriptions). Do not persist the raw descriptions in graph stdout. Record unknowns as missing rather than extrapolating. For the personal graph, prepare headings `## 희망 직무`, `## 경험`, `## 보유 역량`; list items for experience and comma-separated skills. A job is a candidate, not a confirmed NCS code.
+
+## Enterprise mode (interview-to-profile input)
+
+Use a fictional organization in packaged examples. Prepare the interview under these headings, separating statements made by the organization from independently confirmed facts:
+
+- `## 기업 개요`: fictional organization, sector and team; omit real employer and employee identifiers.
+- `## 교육 대상`: roles, learner group and scope; do not infer headcount or proficiency.
+- `## 현업 과제`: concrete tasks and workflow bottlenecks, not a presumed diagnosis.
+- `## 교육 목표`: requested outcomes and observable success measures, if stated.
+- `## 현재 역량`: self-reported capabilities and evidence; not a verified competency rating.
+- `## 교육 제약`: time, budget, data access and approvals only when actually supplied; otherwise `미확인`.
+
+For the enterprise graph, summarize only the minimum necessary organization context, job candidates, tasks, goals, current skills and constraints for downstream steps. Do not copy interview paragraphs or identifying quotations into run outputs. Keep a stated need distinct from an observed task and from a recommended intervention. An interview alone does not verify NCS classifications, course existence or URLs, applicability of AI to confidential data, or internal policy approval: mark each unknown `미확인` until independently verified. Do not present a suggested training plan as an approved company policy.

package/scripts/backup/elanous-backup.sh

@@ -505,7 +505,10 @@ BACKUP_OK=1
 if [ "${ELANOUS_BACKUP_NO_HEARTBEAT:-0}" = "1" ]; then
   echo "  (심박 끔 — ELANOUS_BACKUP_NO_HEARTBEAT=1 · 시험 전용)" >&2
 elif [ -n "$HB_REPO" ] && [ -f "$HB_REPO/scripts/botlab/heartbeat-emit.sh" ]; then
-  bash "$HB_REPO/scripts/botlab/heartbeat-emit.sh" backup "$BACKUP_OK" "$HB_REPO" "$BACKUP_SOURCE"
+  # 심박은 «운영» 우주로 — 백업이 뜨는 것이 운영 ~/.elanous 이다. 크론은 환경변수가 없고 소스 트리는
+  # 트리 파생 시험 우주로 풀려(`where` layer=tree-derived) 심박이 «격리라 안 밀었다»로 3일 멎었다(09-30).
+  ELANOUS_STATE_DIR="${ELANOUS_STATE_DIR:-$HOME/.elanous}" ELANOUS_CONFIG_DIR="${ELANOUS_CONFIG_DIR:-$HOME/.elanous}" \
+    bash "$HB_REPO/scripts/botlab/heartbeat-emit.sh" backup "$BACKUP_OK" "$HB_REPO" "$BACKUP_SOURCE"
 else
   echo "  ⚠️ 심박을 «못 보냈다» — 저장소 자리를 못 찾았다(HB_REPO=${HB_REPO:-없음})" >&2
 fi

package/scripts/build-docs-site.ts

@@ -60,11 +60,12 @@ export const TRACK_SCRUBS: { pattern: RegExp; replace: string; why: string }[] =
 /** 잔여 표식 — 하나라도 남으면 rc=1 */
 const TRACK_REGISTRY = JSON.parse(
   readFileSync(join(import.meta.dir, 'coord-tracks.json'), 'utf8'),
-) as { tracks: { id: string; mark: string }[] };
+) as { tracks: { id: string; mark: string; alias?: string }[] };
 const TRACK_MARKS = TRACK_REGISTRY.tracks.map((t) => t.mark).join('');
-const TRACK_IDS = TRACK_REGISTRY.tracks.map((t) => t.id).join('');
+/** 2글자 신원(OP·MK·TC·UX) ⊕ 옛 한 글자 별칭(S·T·O·F) — 둘 다 공개 문서에 남으면 안 된다. */
+const TRACK_NAMES = [...new Set(TRACK_REGISTRY.tracks.flatMap((t) => [t.id, t.alias ?? '']).filter(Boolean))].join('|');
 /** 잔여 표식 — 트랙 정본(`coord-tracks.json`)에서 파생한다. 트랙을 더해도 여기는 고치지 않는다. */
-export const TRACK_RESIDUE = new RegExp(`[${TRACK_MARKS}]|(?<![\\w\\]])\\[[${TRACK_IDS}]\\](?!\\()`, 'gu');
+export const TRACK_RESIDUE = new RegExp(`[${TRACK_MARKS}]|(?<![\\w\\]])\\[(?:${TRACK_NAMES})\\](?!\\()`, 'gu');
 
 export function scrubTrackMarks(md: string): { text: string; applied: string[] } {
   let text = md;

package/scripts/coord-channel-watch.sh

@@ -107,13 +107,20 @@ fi
 # 🆕 2026-09-24 (🅞 보고): 「나에게 온 «요청»」 표지가 🅢 로 고정돼 있었다 — `--track O` 감시에서 🅢·🅣 앞 요청이
 #   «🅞 에게 온 요청»으로 뜨고, 🅞 앞 요청은 일반어(부탁드립니다)가 없으면 안 떴다.
 #   ⇒ 표지를 트랙 정본(scripts/coord-tracks.json)에서 $TRACK 으로 찾아 식을 짓는다. 일반어는 «내 표지와 함께»일 때만.
-MARK=$(grep -o "\"id\": *\"$TRACK\", *\"mark\": *\"[^\"]*\"" "$(dirname "$0")/coord-tracks.json" 2>/dev/null | sed 's/.*"mark": *"//; s/"$//')
+#   🆕 09-30 역할 재편: 신원이 2글자 id(TC) ⊕ 직함(CTO) ⊕ 옛 alias(O) 셋이다 — --track 은 id·alias 어느 쪽도 받고,
+#   «내 글» 거르기와 «나에게 온 요청» 표지는 셋을 다 본다(전환기엔 옛 접두로 쓴 글도 내 글이다).
+ENTRY=$(jq -c --arg t "$TRACK" '[.tracks[] | select(.id == $t or .alias == $t)][0] // empty' "$(dirname "$0")/coord-tracks.json" 2>/dev/null)
+MARK=$(printf '%s' "$ENTRY" | jq -r '.mark // empty' 2>/dev/null)
+SELF_ID=$(printf '%s' "$ENTRY" | jq -r '.id // empty' 2>/dev/null); SELF_ID=${SELF_ID:-$TRACK}
+SELF_ALIAS=$(printf '%s' "$ENTRY" | jq -r '.alias // empty' 2>/dev/null); SELF_ALIAS=${SELF_ALIAS:-$SELF_ID}
+SELF_TITLE=$(printf '%s' "$ENTRY" | jq -r '.title // empty' 2>/dev/null)
+NAMES_ADDR="\\\\[$SELF_ID\\\\] 님|\\\\[$SELF_ALIAS\\\\] 님|$SELF_ID 님|$SELF_ID 께${SELF_TITLE:+|$SELF_TITLE 님|$SELF_TITLE 께}"
 if [ -n "$MARK" ]; then
-  REQ_ADDR="$MARK 께|$MARK 에게|$MARK 께서|$MARK 에 요청|$MARK 님|\\\\[$TRACK\\\\] 님"
+  REQ_ADDR="$MARK 께|$MARK 에게|$MARK 께서|$MARK 에 요청|$MARK 님|$NAMES_ADDR"
   REQ_MARK="$MARK"
 else
   echo "⚠️ 트랙 정본에서 $TRACK 의 표지를 못 찾았다 — 요청 표지는 [$TRACK] 님 만 본다" >&2
-  REQ_ADDR="\\\\[$TRACK\\\\] 님"
+  REQ_ADDR="$NAMES_ADDR"
   REQ_MARK="\\\\[$TRACK\\\\]"
 fi
 
@@ -123,6 +130,9 @@ LOCKDIR="$TMP/ch${PR_NUM}-$TRACK.lock"
 # 본문 기준선 — ⭐ 프로세스가 아니라 «파일»에 둔다. 그래서 감시가 죽어 있던 구간의 본문 변경도
 # 부활 «첫 주기»에 뜬다(매뉴얼 §「부활 구간은 못 본다」의 **본문 축만** 닫힌다 — 코멘트 축은 그대로).
 BODYFILE="$TMP/ch${PR_NUM}-$TRACK.body"
+# 코멘트 기준선(since)도 «파일»에 둔다(RFC-coordination-cost §7a · C1 · 09-30) — 재기동·30분 만기 재무장 뒤에도
+# 끊긴 자리부터 이어 읽는다. 24시간보다 오래된 기준선은 버리고 지금부터(한 번에 쏟아지는 것 방지).
+SINCEFILE="$TMP/ch${PR_NUM}-$TRACK.since"
 
 # 기동시각 — 소유 판정의 유일한 근거(PID 는 재사용된다). 공백은 정규화해서 비교한다.
 proc_started() {
@@ -416,7 +426,7 @@ fetch_comments() {   # $1=since(ISO8601) → stdout=포맷된 신규 행 · rc=0
   #     그 글은 필터를 «통과»했고 창에도 떴다 — 그런데 다른 글 사이에 섞여 «요청»으로 안 보였다.
   #   🔑 그러므로 결손은 「고르기」가 아니라 ***「고른 뒤 «구분»하지 않은 것」***이다.
   #   ⛔ 표지를 «본문 앞»에 둔다 — 뒤에 두면 BODY_CHARS 절단에 잘려 사라진다.
-  fmt="select(((.body | sub(\"^[[:space:]#]+\"; \"\")) | (startswith(\"**[$TRACK]\") or startswith(\"[$TRACK]\"))) | not)
+  fmt="select(((.body | sub(\"^[[:space:]#]+\"; \"\")) | (startswith(\"**[$SELF_ID]\") or startswith(\"[$SELF_ID]\") or startswith(\"**[$SELF_ALIAS]\") or startswith(\"[$SELF_ALIAS]\"))) | not)
        | \"[#$PR_NUM 신규 id=\" + (.id|tostring) + \" \" + .created_at + \" @\" + .login + \"]\"
          + (if ((.body | test(\"$REQ_ADDR\")) or ((.body | test(\"$REQ_MARK\")) and (.body | test(\"부탁드립니다|부탁합니다\")))) then \" 🙋‼️ 나에게 온 «요청»\" else \"\" end)
          + \" \" + (.body[:$BODY_CHARS] | gsub(\"\n\"; \" ⏎ \"))"
@@ -501,6 +511,14 @@ watch_loop() {
     echo "  📄 «본문» 감시 ON · 기준선 «없음» ⇒ 첫 주기를 기준선으로 삼고 이벤트를 안 낸다"
   fi
   last=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  if [ -s "$SINCEFILE" ]; then
+    local saved; saved=$(head -1 "$SINCEFILE" 2>/dev/null)
+    if [[ "$saved" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$ ]] \
+       && [ -z "$(find "$SINCEFILE" -mmin +1440 2>/dev/null)" ]; then
+      last="$saved"
+      echo "  🔁 코멘트 기준선 이어 읽기 since=$last (파일 $SINCEFILE) — 죽어 있던 구간도 첫 주기에 뜬다"
+    fi
+  fi
   while true; do
     sleep "$INTERVAL"
     now=$(date -u +%Y-%m-%dT%H:%M:%SZ)
@@ -530,6 +548,7 @@ watch_loop() {
       fi
       [ -n "$out" ] && printf '%s\n' "$out"
       last="$now"
+      printf '%s\n' "$last" > "$SINCEFILE" 2>/dev/null || true
       # ⭐ 실패하다 «돌아왔으면» 한 줄로 말한다 — 조용히 복구되면 아무도 «공백 구간»이 있었음을 모른다.
       if [ "$WATCH_FAILS" -gt 0 ]; then
         printf '✅ [#%s 조회 «회복» %s] 연속 실패 %s회 뒤 성공 — 그 사이도 since=%s 로 «이어 붙였다»(놓친 것 없음)\n' \

package/scripts/coord-post.sh

@@ -41,25 +41,44 @@ grep -q '{{TS}}' "$BODY" || echo "⚠️ 본문에 {{TS}} 자리표시가 «없
 
 # 트랙 신원은 «정본 한 곳»에서 읽는다 — scripts/coord-tracks.json. 못 읽으면 추측하지 않고 선다.
 TRACKS_FILE="$(dirname "$0")/coord-tracks.json"
-TRACKS=$(grep -o '"id": *"[A-Z]"' "$TRACKS_FILE" 2>/dev/null | grep -o '[A-Z]"$' | tr -d '"\n')
-[ -n "$TRACKS" ] || { echo "⛔ 트랙 정본을 읽지 못했다: $TRACKS_FILE — 발신하지 않는다" >&2; exit 4; }
+# 신원 = 2글자 id(OP·MK·TC·UX…) ⊕ 옛 한 글자 alias(S·T·O·F — 전환기엔 받되 경고). 목록은 정본에서만.
+IDS=$(grep -o '"id": *"[A-Z][A-Z]*"' "$TRACKS_FILE" 2>/dev/null | sed 's/.*"\([A-Z]*\)"$/\1/' | tr '\n' ' ')
+ALIASES=$(grep -o '"alias": *"[A-Z][A-Z]*"' "$TRACKS_FILE" 2>/dev/null | sed 's/.*"\([A-Z]*\)"$/\1/' | tr '\n' ' ')
+[ -n "$IDS" ] || { echo "⛔ 트랙 정본을 읽지 못했다: $TRACKS_FILE — 발신하지 않는다" >&2; exit 4; }
 ID="${COORD_ID:-S}"
-if [ "${#ID}" -ne 1 ] || [ "${TRACKS#*"$ID"}" = "$TRACKS" ]; then
-  echo "⛔ COORD_ID 는 트랙 정본($TRACKS_FILE)의 신원 [$TRACKS] 중 하나여야 한다(받은 값: $ID)" >&2; exit 4
-fi
+case " $IDS " in
+  *" $ID "*) ;;
+  *) case " $ALIASES " in
+       *" $ID "*) NEW=$(grep -o "\"id\": *\"[A-Z]*\", *\"title\": *\"[A-Z]*\", *\"alias\": *\"$ID\"" "$TRACKS_FILE" | sed 's/^"id": *"\([A-Z]*\)".*/\1/')
+                  echo "⚠️ 옛 한 글자 신원 [$ID] — 새 신원은 [${NEW:-?}] 다(전환기라 받는다)" >&2 ;;
+       *) echo "⛔ COORD_ID 는 트랙 정본($TRACKS_FILE)의 신원 [$IDS] (옛 [$ALIASES]) 중 하나여야 한다(받은 값: $ID)" >&2; exit 4 ;;
+     esac ;;
+esac
 FIRST=$(head -1 "$BODY")
+OTHER=""
+for T in $IDS $ALIASES; do
+  [ "$T" = "$ID" ] && continue
+  case "$FIRST" in "**[$T]**"*) OTHER="$T" ;; esac
+done
 case "$FIRST" in
   "**[$ID]**"*) ;;
-  \*\*\[[$TRACKS]\]\*\**)
-    echo "⛔ 신원 접두가 «내 것이 아니다» — 첫 줄이 ${FIRST%%\*\* *}** 로 시작한다(내 신원 = [$ID])." >&2
-    echo "   ⛔ 감시자는 startswith 로 고른다 ⇒ 상대는 이 글을 «자기 글»로 보고 건너뛴다. 발신하지 않는다." >&2
-    echo "   ✅ 수신자는 본문에 적어라: **[$ID]** … [T] 님께 …" >&2
-    exit 5 ;;
   *)
+    if [ -n "$OTHER" ]; then
+      echo "⛔ 신원 접두가 «내 것이 아니다» — 첫 줄이 **[$OTHER]** 로 시작한다(내 신원 = [$ID])." >&2
+      echo "   ⛔ 감시자는 startswith 로 고른다 ⇒ 상대는 이 글을 «자기 글»로 보고 건너뛴다. 발신하지 않는다." >&2
+      echo "   ✅ 수신자는 본문에 적어라: **[$ID]** … MK 님께 …" >&2
+      exit 5
+    fi
     echo "⛔ 첫 줄이 «**[$ID]**» 신원 접두로 시작하지 않는다 — 상대 감시자가 이 글을 못 고른다. 발신하지 않는다." >&2
     exit 5 ;;
 esac
 
+# 봉투 v2(RFC-coordination-cost §2 · C1 · 09-30): 첫 줄에 종류 다섯 중 하나 — 막지 않고 «알린다».
+case "$FIRST" in
+  *요청*|*결정*|*사고*|*보고*|*정정*) ;;
+  *) echo "⚠️ 첫 줄에 글 종류(요청·결정·사고·보고·정정)가 없다 — 받는 쪽 감시자가 즉시/모아 읽기를 못 가른다(발신은 한다)" >&2 ;;
+esac
+
 TS=$(TZ=Asia/Seoul date '+%Y-%m-%d %H:%M KST')
 TMP=$(mktemp "${TMPDIR:-/tmp}/coord-post.XXXXXX") || { echo "⛔ mktemp 실패 — 발신하지 않는다" >&2; exit 7; }
 DATA=$(mktemp "${TMPDIR:-/tmp}/coord-post-data.XXXXXX") || { rm -f "$TMP"; echo "⛔ mktemp 실패 — 발신하지 않는다" >&2; exit 7; }
@@ -125,8 +144,26 @@ fi
 POST_OUTPUT=$(bun bin/elanous.mjs gh pr comment "$PR" --body-file "$TMP" 2>&1)
 RC=$?
 printf '%s\n' "$POST_OUTPUT" | tail -2
+VIA=""
+# `gh pr comment` goes through GraphQL; its secondary rate limit can block while REST still answers (GIT-S83).
+# 09-30: 채널 코멘트 1,500 뒤 GraphQL 이 «Something went wrong» 으로 연속 실패하고 REST 는 201 — 이 내부 오류도 REST 로 물러선다.
+#   ⛔ 다른 실패(PR 못 찾음 등)는 물러서지 않는다. 물러서기 전에 같은 첫 줄이 이미 올라갔는지 본다(부분 성공 → 이중 발신 방지).
+if [ "$RC" -ne 0 ] && printf '%s' "$POST_OUTPUT" | grep -qiE 'rate limit|Something went wrong'; then
+  echo "⚠️ GraphQL 실패(한도·내부 오류) — REST 로 한 번 물러선다(GIT-S83)" >&2
+  FIRSTOUT=$(head -1 "$TMP")
+  # issues 코멘트 목록은 오래된 순이고 정렬 인자를 안 받는다 ⇒ 최근 10분만 since 로 자른다.
+  SINCE10=$(date -u -v-10M +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '-10 min' +%Y-%m-%dT%H:%M:%SZ)
+  if bun bin/elanous.mjs gh api "repos/{owner}/{repo}/issues/$PR/comments?since=$SINCE10&per_page=100" --jq '.[].body | split("\n")[0]' 2>/dev/null | grep -qxF -- "$FIRSTOUT"; then
+    echo "[coord-post] 같은 첫 줄이 이미 채널에 있다 — GraphQL 이 실제로는 올렸다(이중 발신 안 함)" >&2
+    exit 0
+  fi
+  POST_OUTPUT=$(bun bin/elanous.mjs gh api -X POST "repos/{owner}/{repo}/issues/$PR/comments" -F "body=@$TMP" -q .html_url 2>&1)
+  RC=$?
+  printf '%s\n' "$POST_OUTPUT" | tail -2
+  VIA=" · REST 폴백"
+fi
 if [ "$RC" -ne 0 ]; then
-  echo "⛔ 발신 실패 rc=$RC — «보냈다고 읽지 마라»" >&2
+  echo "⛔ 발신 실패 rc=$RC$VIA — «보냈다고 읽지 마라»" >&2
   exit "$RC"
 fi
-echo "[coord-post] 발신 성공 · 채널 #$PR · 신원 [$ID] · 시각 $TS" >&2
+echo "[coord-post] 발신 성공$VIA · 채널 #$PR · 신원 [$ID] · 시각 $TS" >&2

package/scripts/coord-tracks.json

@@ -1,10 +1,10 @@
 {
-  "_comment": "조율 채널 트랙 신원의 정본. 트랙을 더하려면 여기 한 줄만 더한다 — scripts/coord-post.sh 와 scripts/build-docs-site.ts 가 이 파일을 읽는다.",
+  "_comment": "조율 채널 세션 신원의 정본(09-30 역할 재편). id = 2글자 신원(발신 접두 **[TC]**) · title = 직함 · alias = 옛 한 글자(기록 읽기·전환기 발신용) · mark = 옛 표지. 세션을 더하려면 여기 한 줄만 더한다 — coord-post.sh · coord-channel-watch.sh · build-docs-site.ts · mission-phase-track.ts 가 이 파일을 읽는다.",
   "tracks": [
-    { "id": "S", "mark": "🅢", "owns": ["기획", "총괄", "전략", "소구점", "로드맵", "plan", "strategy"] },
-    { "id": "T", "mark": "🅣", "owns": ["영상", "비디오", "티저", "하이퍼프레임", "HyperFrames", "렌더", "video", "teaser", "render", "B-roll"] },
-    { "id": "F", "mark": "🅕", "owns": ["PWA", "웹", "웹사이트", "elanous.ai", "탭", "화면", "UI", "프론트엔드", "frontend", "web", "tab"] },
-    { "id": "O", "mark": "🅞", "owns": ["블로그", "매뉴얼", "문서", "흡수", "Obsidian", "승인", "blog", "manual", "docs"] },
+    { "id": "OP", "title": "COO", "alias": "S", "mark": "🅢", "owns": ["판올림", "컷", "체크리스트", "분배", "통합", "로드맵", "기획", "총괄", "전략", "인계", "release cut", "roadmap", "plan", "strategy"] },
+    { "id": "MK", "title": "CMO", "alias": "T", "mark": "🅣", "owns": ["블로그", "콘텐츠", "발행", "광고", "프로모션", "소구점", "마케팅", "영상", "비디오", "티저", "하이퍼프레임", "렌더", "blog", "content", "marketing", "ads", "video", "teaser", "render", "B-roll", "상표", "변리사", "브랜드", "trademark", "brand"] },
+    { "id": "TC", "title": "CTO", "alias": "O", "mark": "🅞", "owns": ["하니스", "게이트", "원장", "리뷰", "관측", "릴리스 루프", "흡수", "Obsidian", "매뉴얼", "문서", "기술", "harness", "gate", "ledger", "review", "observability", "intake", "manual", "docs"] },
+    { "id": "UX", "title": "CXO", "alias": "F", "mark": "🅕", "owns": ["PWA", "웹", "웹사이트", "elanous.ai", "탭", "화면", "UI", "프론트엔드", "안드로이드", "아이폰", "데스크톱", "텔레그램", "디스코드", "메신저", "봇", "frontend", "web", "tab", "android", "ios", "desktop", "telegram", "discord", "bot"] },
     { "id": "E", "mark": "🅔", "owns": [] }
   ]
 }

package/scripts/eval-bot-vs-grok.ts

@@ -0,0 +1,79 @@
+// 봇 UX «그록봇 수준» 판별 — 같은 질문 묶음을 elanous chat(글자) · elanous agent(도구) · xAI Grok 에 던지고 원문·시간을 남긴다.
+// 사용: bun scripts/eval-bot-vs-grok.ts <outDir> <repoCwd> · Grok 모델 = 사다리 `budget` 칸(tierModel)   (키 값은 출력하지 않는다)
+import { spawnSync } from 'node:child_process';
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { tierModel } from '../src/llm/model-defaults.js';
+
+const [,, outDir, repoCwd] = process.argv;
+mkdirSync(outDir, { recursive: true });
+
+type Q = { id: string; axis: string; text: string; session?: string; needsTools?: boolean };
+const QUESTIONS: Q[] = [
+  { id: 'q01', axis: 'smalltalk', text: '안녕, 오늘 뭐 도와줄 수 있어? 세 줄 안으로.' },
+  { id: 'q02', axis: 'smalltalk', text: '요즘 좀 지쳤어. 짧게 한마디 해줘.' },
+  { id: 'q03', axis: 'fact', text: '서울에서 부산까지 KTX 로 대략 몇 시간 걸려? 한 줄로.' },
+  { id: 'q04', axis: 'fact', text: 'HWPX 파일 형식이 뭐야? 두 줄로.' },
+  { id: 'q05', axis: 'context', session: 'ctx', text: '내 프로젝트 이름은 elanous 야. 기억해 둬. «알겠다» 한 마디만.' },
+  { id: 'q06', axis: 'context', session: 'ctx', text: '우리 팀은 네 세션으로 나뉘어 있어: OP, MK, TC, UX. 이것도 기억해. 한 마디만.' },
+  { id: 'q07', axis: 'context', session: 'ctx', text: '내 프로젝트 이름이랑 팀 세션 약자 넷을 한 줄로 말해 봐.' },
+  { id: 'q08', axis: 'tools', needsTools: true, text: '지금 작업 폴더(git 저장소)에서 가장 최근 커밋 제목 세 개를 알려줘.' },
+  { id: 'q09', axis: 'tools', needsTools: true, text: 'apps/pwa 폴더에 파일이 대략 몇 개야? 숫자 하나로.' },
+  { id: 'q10', axis: 'tools', needsTools: true, text: '오늘 날짜를 한국 시간으로 알려줘.' },
+  { id: 'q11', axis: 'recovery', needsTools: true, text: 'docs/NOPE-does-not-exist-xyz.md 파일을 요약해줘.' },
+  { id: 'q12', axis: 'recovery', text: '내가 어제 너한테 부탁한 일 결과 알려줘.' },
+];
+
+type Row = { id: string; axis: string; target: string; ms: number; ok: boolean; reply: string; meta?: Record<string, unknown> };
+const rows: Row[] = [];
+
+function runElanous(mode: 'chat' | 'agent', q: Q, session?: string): Row {
+  const args = [mode, '--json', ...(session ? ['--session', session] : ['--new']), q.text];
+  const t0 = Date.now();
+  const r = spawnSync('elanous', args, { cwd: repoCwd, encoding: 'utf8', timeout: 240_000, maxBuffer: 64 << 20 });
+  const ms = Date.now() - t0;
+  const line = (r.stdout ?? '').trim().split('\n').reverse().find((l) => l.startsWith('{')) ?? '';
+  let parsed: Record<string, unknown> = {};
+  try { parsed = JSON.parse(line); } catch { /* keep empty */ }
+  const reply = typeof parsed.reply === 'string' ? parsed.reply : ((r.stderr ?? '').slice(-400) || '(no reply)');
+  return { id: q.id, axis: q.axis, target: `elanous-${mode}`, ms, ok: r.status === 0 && typeof parsed.reply === 'string', reply, meta: { sessionId: parsed.sessionId, provider: parsed.provider, model: parsed.model, status: r.status } };
+}
+
+function xaiKey(): string {
+  const env = readFileSync(join(process.env.HOME!, '.claude/skills/omni-crawl/.env'), 'utf8');
+  return /^XAI_API_KEY=(.*)$/m.exec(env)?.[1]?.trim().replace(/^['"]|['"]$/g, '') ?? '';
+}
+const grokHistory = new Map<string, Array<{ role: string; content: string }>>();
+async function runGrok(q: Q): Promise<Row> {
+  if (q.needsTools) return { id: q.id, axis: q.axis, target: 'grok', ms: 0, ok: false, reply: 'n/a — 작업 폴더·도구 없음(대조 제외)' };
+  const history = q.session ? (grokHistory.get(q.session) ?? []) : [];
+  const messages = [...history, { role: 'user', content: q.text }];
+  const t0 = Date.now();
+  const res = await fetch('https://api.x.ai/v1/chat/completions', {
+    method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${xaiKey()}` },
+    body: JSON.stringify({ model: tierModel('budget', 'grok'), messages }),
+  });
+  const ms = Date.now() - t0;
+  const body = await res.json().catch(() => ({})) as { choices?: Array<{ message?: { content?: string } }> };
+  const reply = body.choices?.[0]?.message?.content ?? `(http ${res.status})`;
+  if (q.session) grokHistory.set(q.session, [...messages, { role: 'assistant', content: reply }]);
+  return { id: q.id, axis: q.axis, target: 'grok', ms, ok: res.ok, reply };
+}
+
+for (const mode of ['chat', 'agent'] as const) {
+  const sessions = new Map<string, string>();
+  for (const q of QUESTIONS) {
+    const row = runElanous(mode, q, q.session ? sessions.get(q.session) : undefined);
+    if (q.session && !sessions.has(q.session) && typeof row.meta?.sessionId === 'string') sessions.set(q.session, row.meta.sessionId as string);
+    rows.push(row);
+    console.log(`${mode} ${q.id} ${row.ok ? 'ok' : 'FAIL'} ${(row.ms / 1000).toFixed(1)}s`);
+    writeFileSync(join(outDir, 'rows.json'), JSON.stringify(rows, null, 2));
+  }
+}
+for (const q of QUESTIONS) {
+  const row = await runGrok(q);
+  rows.push(row);
+  console.log(`grok ${q.id} ${row.ok ? 'ok' : 'skip/FAIL'} ${(row.ms / 1000).toFixed(1)}s`);
+}
+writeFileSync(join(outDir, 'rows.json'), JSON.stringify(rows, null, 2));
+console.log('done', rows.length);

package/scripts/eval-grok-live-baseline.ts

@@ -0,0 +1,36 @@
+// 대조군 v2 — xAI Responses API · 추론 모델(저장소 GROK_SEARCH_MODEL) · web_search ⊕ x_search 켬. 그록봇 «제품» 은 아니다.
+// 사용: bun eval-grok-live.ts <repo-checkout> <outDir>   (키 값은 출력하지 않는다)
+import { mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const [,, repo, outDir] = process.argv;
+mkdirSync(outDir, { recursive: true });
+const { grokAgentSearch, GROK_SEARCH_MODEL } = await import(join(repo, 'src/grok/agent-search.js'));
+const env = readFileSync(join(process.env.HOME!, '.claude/skills/omni-crawl/.env'), 'utf8');
+const apiKey = /^XAI_API_KEY=(.*)$/m.exec(env)?.[1]?.trim().replace(/^['"]|['"]$/g, '') ?? '';
+
+type Q = { id: string; text: string; session?: string };
+const QS: Q[] = [
+  { id: 'q01', text: '안녕, 오늘 뭐 도와줄 수 있어? 세 줄 안으로.' },
+  { id: 'q02', text: '요즘 좀 지쳤어. 짧게 한마디 해줘.' },
+  { id: 'q03', text: '서울에서 부산까지 KTX 로 대략 몇 시간 걸려? 한 줄로.' },
+  { id: 'q04', text: 'HWPX 파일 형식이 뭐야? 두 줄로.' },
+  { id: 'q05', session: 'ctx', text: '내 프로젝트 이름은 elanous 야. 기억해 둬. «알겠다» 한 마디만.' },
+  { id: 'q06', session: 'ctx', text: '우리 팀은 네 세션으로 나뉘어 있어: OP, MK, TC, UX. 이것도 기억해. 한 마디만.' },
+  { id: 'q07', session: 'ctx', text: '내 프로젝트 이름이랑 팀 세션 약자 넷을 한 줄로 말해 봐.' },
+  { id: 'q10', text: '오늘 날짜를 한국 시간으로 알려줘.' },
+  { id: 'q12', text: '내가 어제 너한테 부탁한 일 결과 알려줘.' },
+];
+const history: string[] = [];
+const rows: unknown[] = [];
+for (const q of QS) {
+  const systemPrompt = q.session && history.length ? `이전 대화:\n${history.join('\n')}` : undefined;
+  const t0 = Date.now();
+  const r = await grokAgentSearch(q.text, { apiKey, tools: ['web_search', 'x_search'], ...(systemPrompt ? { systemPrompt } : {}), timeoutMs: 90_000 });
+  const ms = Date.now() - t0;
+  if (q.session) history.push(`사용자: ${q.text}`, `어시스턴트: ${r.text}`);
+  rows.push({ id: q.id, target: 'grok-live', model: GROK_SEARCH_MODEL, ms, ok: r.ok, reply: r.text, citations: (r.citations ?? []).length, error: r.error });
+  console.log(`grok-live ${q.id} ${r.ok ? 'ok' : 'FAIL'} ${(ms / 1000).toFixed(1)}s cites=${(r.citations ?? []).length}`);
+}
+writeFileSync(join(outDir, 'grok-live.rows.json'), JSON.stringify(rows, null, 2));
+console.log('done', rows.length);

package/scripts/fixtures/front-route-corpus.sample.json

@@ -0,0 +1,17 @@
+{
+  "description": "손으로 쓴 개인정보 없는 앞 분류기 예시 — 규칙 미판정 문장",
+  "items": [
+    { "id": "absorb-1", "text": "이 기술 발표에서 핵심 논점이 뭔지 알고 싶어.", "expected": "absorb" },
+    { "id": "absorb-2", "text": "긴 글의 주요 주장만 파악하고 싶어.", "expected": "absorb" },
+    { "id": "absorb-3", "text": "이 자료는 어떤 배경에서 나왔는지 살펴봐.", "expected": "absorb" },
+    { "id": "tasks-1", "text": "문서 제목 확인하고 표 오타 검토한 다음 회의실 예약도 챙겨야 해.", "expected": "tasks" },
+    { "id": "tasks-2", "text": "청구서 확인, 일정 변경, 메일 답장 각각 챙기자.", "expected": "tasks" },
+    { "id": "tasks-3", "text": "오늘은 재고 파악하고 전등 교체 일정도 따로 잡아야겠어.", "expected": "tasks" },
+    { "id": "graph-1", "text": "이 입력부터 결과까지 이어지는 처리 과정을 자동화하고 싶어.", "expected": "graph" },
+    { "id": "graph-2", "text": "데이터가 들어오면 검사 후 분류해서 다음 단계로 넘기는 흐름이 필요해.", "expected": "graph" },
+    { "id": "graph-3", "text": "요청 접수부터 승인과 배포까지 한 흐름으로 묶자.", "expected": "graph" },
+    { "id": "ask-human-1", "text": "이거 어떻게 할까?", "expected": "ask-human" },
+    { "id": "ask-human-2", "text": "지금은 어느 방향이 좋을지 모르겠어.", "expected": "ask-human" },
+    { "id": "ask-human-3", "text": "그건 상황을 보고 결정하자.", "expected": "ask-human" }
+  ]
+}

package/scripts/fleet/node-setup.sh

@@ -71,11 +71,21 @@ else R "k3d registry create $REGISTRY --port 127.0.0.1:$REG_PORT >/tmp/fleet-reg
 #   `bridge` 에만 붙어 kubelet 이 `lookup k3d-elanous-registry: no such host` → Pod `ImagePullBackOff`(🅕 첫 Pod 사용에서 발견). 멱등.
 [ $CHECK = 1 ] || R "docker network inspect k3d-$CLUSTER >/dev/null 2>&1 && (docker network connect k3d-$CLUSTER k3d-$REGISTRY 2>/dev/null || true)" >/dev/null 2>&1
 fi
-# 클러스터가 그 레지스트리를 쓰나 — 안 쓰면(옛 클러스터) 돌고 있는 Job 이 없을 때만 다시 만든다.
+# 🪞 호스트 git 미러(대표 09-29) — Pod 는 GitHub 대신 이 미러에서 clone 한다(`ELANOUS_POD_HOST_MIRROR` · #21929).
+#   bare 미러 = 원격 ~/mirror/elanous-agent.git(없으면 만든다 · 갱신은 이 맥의 크론이 push). 클러스터 노드에 읽기 전용으로 붙인다.
+MIRROR_DIR='$HOME/mirror'; MIRROR_MOUNT=/mirror-host
+if R "test -d ~/mirror/elanous-agent.git"; then ok "호스트 git 미러 ~/mirror/elanous-agent.git"
+elif [ $CHECK = 1 ]; then todo "호스트 git 미러 ~/mirror/elanous-agent.git 생성(git init --bare) ⊕ 이 맥에서 첫 push"
+else R "mkdir -p ~/mirror && git init -q --bare ~/mirror/elanous-agent.git" && ok "호스트 git 미러 (생성 · 첫 push 는 이 맥 크론)" || { bad "미러 생성 실패"; exit 1; }; fi
+# 클러스터가 그 레지스트리를 쓰나 ⊕ 미러가 붙어 있나 — 둘 중 하나라도 아니면(옛 클러스터) 돌고 있는 Job 이 없을 때만 다시 만든다.
+#   ⛔ k3d 는 볼륨을 «클러스터 생성 때만» 붙인다 — 붙이려면 다시 만들 수밖에 없다.
 REG_WIRED=0; R "docker exec k3d-$CLUSTER-server-0 cat /etc/rancher/k3s/registries.yaml 2>/dev/null | grep -q k3d-$REGISTRY" && REG_WIRED=1
+MIRROR_WIRED=0; R "docker exec k3d-$CLUSTER-server-0 test -d $MIRROR_MOUNT/elanous-agent.git" && MIRROR_WIRED=1
+[ $MIRROR_WIRED = 1 ] || { [ $REG_WIRED = 1 ] && REG_WIRED=0 && MIRROR_ONLY=1; }
 if R "k3d cluster list $CLUSTER" >/dev/null 2>&1 && [ $REG_WIRED = 0 ]; then
-  RUNNING="$(R "KUBECONFIG=\$(k3d kubeconfig write $CLUSTER) kubectl get jobs -A --no-headers 2>/dev/null | grep -vc Complete || true" 2>/dev/null | tail -1)"; RUNNING="${RUNNING:-0}"
-  if [ $CHECK = 1 ]; then todo "클러스터 $CLUSTER 가 레지스트리를 안 쓴다 — 다시 만든다(도는 Job ${RUNNING:-?}개)"
+  # «실행 중»만 센다 — 실패로 끝난 Job 은 Complete 가 아니어도 도는 것이 아니다(09-29: `grep -vc Complete` 는 Failed 까지 세서 영원히 0 이 안 됐다).
+  RUNNING="$(R "KUBECONFIG=\$(k3d kubeconfig write $CLUSTER) kubectl get jobs -A -o jsonpath='{range .items[*]}{.status.active}{\"\\n\"}{end}' 2>/dev/null | awk '\$1>0' | wc -l | tr -d ' '" 2>/dev/null | tail -1)"; RUNNING="${RUNNING:-0}"
+  if [ $CHECK = 1 ]; then todo "클러스터 $CLUSTER 가 $([ "${MIRROR_ONLY:-0}" = 1 ] && echo "미러($MIRROR_MOUNT)를 안 붙였다" || echo "레지스트리를 안 쓴다") — 다시 만든다(도는 Job ${RUNNING:-?}개)"
   elif [ "${RUNNING:-0}" != "0" ]; then bad "클러스터 $CLUSTER 를 다시 만들어야 하는데 도는 Job 이 ${RUNNING}개 — 끝난 뒤 다시"; exit 1
   else R "k3d cluster delete $CLUSTER >/dev/null 2>&1" && ok "클러스터 $CLUSTER (레지스트리 연결 위해 지움)"; fi
 fi
@@ -83,7 +93,7 @@ if R "k3d cluster list $CLUSTER" >/dev/null 2>&1; then ok "클러스터 $CLUSTER
 elif [ $CHECK = 1 ]; then todo "클러스터 $CLUSTER 생성($K3S_IMAGE · API :$API_PORT · SAN $HOST ${TSNAME:-} · 레지스트리 k3d-$REGISTRY:$REG_PORT)"
 else
   SAN="--k3s-arg --tls-san=$HOST@server:0"; [ -n "$TSNAME" ] && SAN="$SAN --k3s-arg --tls-san=$TSNAME@server:0"
-  R "k3d cluster create $CLUSTER --image $K3S_IMAGE --no-lb --api-port 0.0.0.0:$API_PORT $SAN --registry-use k3d-$REGISTRY:$REG_PORT --wait --timeout 300s >/tmp/fleet-k3d-create.log 2>&1" && ok "클러스터 $CLUSTER (생성 · 레지스트리 k3d-$REGISTRY)" || { bad "클러스터 생성 실패 — 원격 /tmp/fleet-k3d-create.log"; exit 1; }
+  R "k3d cluster create $CLUSTER --image $K3S_IMAGE --no-lb --api-port 0.0.0.0:$API_PORT $SAN --registry-use k3d-$REGISTRY:$REG_PORT --volume $MIRROR_DIR:$MIRROR_MOUNT:ro@server:0 --wait --timeout 300s >/tmp/fleet-k3d-create.log 2>&1" && ok "클러스터 $CLUSTER (생성 · 레지스트리 k3d-$REGISTRY)" || { bad "클러스터 생성 실패 — 원격 /tmp/fleet-k3d-create.log"; exit 1; }
 fi
 # 7. 이 맥 kubeconfig 에 컨텍스트 pool-<호스트>
 # ⛔ «있다»로 끝내지 않는다 — 클러스터를 다시 만들면 인증서가 바뀌어 옛 컨텍스트가 x509 로 죽는다(2026-09-26 node-b:
@@ -114,9 +124,38 @@ PY
   KUBECONFIG=~/.kube/config:"$TMP/kc.yaml" kubectl config view --flatten > "$TMP/merged.yaml" && chmod 600 "$TMP/merged.yaml" && mv "$TMP/merged.yaml" ~/.kube/config && ok "kubeconfig 컨텍스트 $CTX (추가 · 현재 컨텍스트는 그대로)" || bad "kubeconfig 병합 실패"
 fi
 # 8. 네임스페이스 ⊕ 격리 정책
-if kubectl --context "$CTX" --request-timeout=10s get ns elanous-test >/dev/null 2>&1; then ok "elanous-test 네임스페이스"
-elif [ $CHECK = 1 ]; then todo "base.yaml ⊕ policy-internet.yaml 적용"
-else kubectl --context "$CTX" apply -f "$ROOT/docker/h1/base.yaml" -f "$ROOT/docker/h1/policy-internet.yaml" >/dev/null && ok "elanous-test 네임스페이스 ⊕ 정책 (적용)" || bad "적용 실패"; fi
+apply_base() {
+  if [ "$CHECK" = 1 ]; then
+    if ! kubectl --context "$CTX" --request-timeout=10s get ns elanous-test >/dev/null 2>&1; then
+      todo "base.yaml ⊕ policy-internet.yaml 적용"
+    elif kubectl --context "$CTX" diff -f "$ROOT/docker/h1/base.yaml" -f "$ROOT/docker/h1/policy-internet.yaml" >/dev/null 2>&1; then
+      ok "elanous-test 네임스페이스 ⊕ 정책"
+    else
+      local diff_status=$?
+      if [ "$diff_status" = 1 ]; then todo "base.yaml ⊕ policy-internet.yaml 적용"
+      else todo "base.yaml ⊕ policy-internet.yaml 적용 (못 쟀다)"; fi
+    fi
+    return
+  fi
+
+  local attempts=0 output retries
+  while [ "$attempts" -lt 6 ]; do
+    attempts=$((attempts+1))
+    if output=$(kubectl --context "$CTX" apply -f "$ROOT/docker/h1/base.yaml" -f "$ROOT/docker/h1/policy-internet.yaml" 2>&1); then
+      retries=$((attempts-1))
+      if [ "$retries" -eq 0 ]; then ok "elanous-test 네임스페이스 ⊕ 정책 (적용)"
+      else ok "elanous-test 네임스페이스 ⊕ 정책 (적용 · 재시도 $retries)"; fi
+      return
+    fi
+    if [[ "$output" != *'serviceaccount "default" not found'* ]] || [ "$attempts" -eq 6 ]; then
+      [ -z "$output" ] || printf '%s\n' "$output" >&2
+      bad "적용 실패 (재시도 $((attempts-1)))"
+      return
+    fi
+    sleep "${FLEET_APPLY_RETRY_SLEEP:-5}"
+  done
+}
+apply_base
 # 9. 판 대조 — k3s · 노드 준비
 v="$(kubectl --context "$CTX" --request-timeout=10s get nodes -o jsonpath='{.items[0].status.nodeInfo.kubeletVersion}' 2>/dev/null)"
 want="${K3S_IMAGE##*:}"; want="${want/-k3s/+k3s}"

package/scripts/landing-heal/must-fix-match.ts

@@ -1,4 +1,30 @@
+import { parse } from '../../src/agent-substrate/pr-comment-meta.js';
+
 export type MustFixVerdict = 'resolved' | 'unresolved' | 'unknown';
+export interface ReviewRoundMatch {
+  text: string;
+  verdict: 'rereviewed' | 'open';
+  run: string;
+  round: number;
+}
+
+/** A later reviewer round in the same run is evidence of rereview, not proof of repair. */
+const MUST_FIX_ROUND = /^Round \d+: reviewer requested \d+ must-fix change\(s\)\.$/m;
+
+export function classifyReviewRounds(comments: Array<{ body?: string }>): ReviewRoundMatch[] {
+  const reviews = comments.flatMap(({ body }) => {
+    if (!body) return [];
+    const meta = parse(body);
+    return meta?.role === 'reviewer' && meta.run && meta.round !== undefined
+      ? [{ body, run: meta.run, round: meta.round }] : [];
+  });
+  // 항목은 «must-fix 요청» 라운드에서만 센다 — «review completed (warn)» 의 요약 본문에도 «- » 글머리가 들어 있다(#21983 실물).
+  return reviews.flatMap(({ body, run, round }) => !MUST_FIX_ROUND.test(body) ? [] :
+    [...body.matchAll(/^- (.+)$/gm)].map((item) => ({
+      text: item[1]!, run, round,
+      verdict: reviews.some((review) => review.run === run && review.round > round) ? 'rereviewed' as const : 'open' as const,
+    })));
+}
 
 /** Match only named evidence in a PR's final patch, never an earlier review round. */
 export function matchMustFix(mustFix: string, finalDiff: string): MustFixVerdict {