elanous 0.2.0 → 0.2.5

package/scripts/cli-json-exit-scan.ts

@@ -0,0 +1,126 @@
+#!/usr/bin/env bun
+/** Report CLI JSON handlers that can exit after an unawaited stdout write. */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import ts from 'typescript';
+
+export interface JsonExitFinding { file: string; line: number; exitLine: number }
+
+function namedCall(node: ts.Node, object: string, method: string): node is ts.CallExpression {
+  return ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)
+    && ts.isIdentifier(node.expression.expression) && node.expression.expression.text === object
+    && node.expression.name.text === method;
+}
+
+function isOutput(node: ts.Node): boolean {
+  return namedCall(node, 'console', 'log') || (ts.isCallExpression(node)
+    && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === 'write'
+    && ts.isPropertyAccessExpression(node.expression.expression)
+    && node.expression.expression.name.text === 'stdout'
+    && ts.isIdentifier(node.expression.expression.expression)
+    && node.expression.expression.expression.text === 'process');
+}
+
+function isExit(node: ts.Node): boolean { return namedCall(node, 'process', 'exit'); }
+function isJsonRead(node: ts.Node): boolean {
+  return ts.isPropertyAccessExpression(node) && node.name.text === 'json'
+    && ts.isIdentifier(node.expression) && (node.expression.text === 'opts' || node.expression.text === 'options');
+}
+function isFunction(node: ts.Node): node is ts.FunctionLikeDeclaration {
+  return ts.isArrowFunction(node) || ts.isFunctionExpression(node) || ts.isFunctionDeclaration(node)
+    || ts.isMethodDeclaration(node) || ts.isGetAccessorDeclaration(node) || ts.isSetAccessorDeclaration(node);
+}
+
+/** Positions are lines of the raw write; exits are recorded separately for auditing. */
+export function scanJsonExitSource(source: string, file: string): JsonExitFinding[] {
+  const tree = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true);
+  const findings: JsonExitFinding[] = [];
+  const line = (node: ts.Node) => tree.getLineAndCharacterOfPosition(node.getStart(tree)).line + 1;
+  const visit = (node: ts.Node): void => {
+    if (isFunction(node)) {
+      const outputs: ts.Node[] = [];
+      const exits: ts.Node[] = [];
+      const body = node.body;
+      const collect = (child: ts.Node): void => {
+        if (child !== node && isFunction(child)) return;
+        if (isOutput(child)) outputs.push(child);
+        if (isExit(child)) exits.push(child);
+        ts.forEachChild(child, collect);
+      };
+      if (body) collect(body);
+      const readsJson = (expression: ts.Node): boolean => {
+        let found = false;
+        const inspect = (child: ts.Node): void => {
+          if (child !== expression && isFunction(child)) return;
+          if (isJsonRead(child)) found = true;
+          ts.forEachChild(child, inspect);
+        };
+        inspect(expression);
+        return found;
+      };
+      if (!body || !readsJson(body)) { ts.forEachChild(node, visit); return; }
+      // Exclude human-only arms even when the handler also has a JSON path.
+      const jsonArm = (output: ts.Node): ts.Statement | undefined => {
+        for (let parent = output.parent; parent && parent !== node; parent = parent.parent) {
+          if (ts.isIfStatement(parent) && output.getStart(tree) >= parent.thenStatement.getStart(tree)
+            && output.getEnd() <= parent.thenStatement.getEnd() && readsJson(parent.expression)
+            && !parent.expression.getText(tree).trimStart().startsWith('!')) return parent.thenStatement;
+        }
+        return undefined;
+      };
+      for (const output of outputs) {
+        const arm = jsonArm(output);
+        let jsonConditionalOutput = false;
+        if (ts.isCallExpression(output)) {
+          const inspect = (child: ts.Node): void => {
+            if (ts.isConditionalExpression(child) && readsJson(child.condition)) jsonConditionalOutput = true;
+            ts.forEachChild(child, inspect);
+          };
+          for (const arg of output.arguments) inspect(arg);
+        }
+        if (!arm && !jsonConditionalOutput) continue;
+        const armReturns = arm && (() => {
+          let returns = false;
+          const inspect = (child: ts.Node): void => {
+            if (isFunction(child)) return;
+            if (ts.isReturnStatement(child)) returns = true;
+            ts.forEachChild(child, inspect);
+          };
+          inspect(arm);
+          return returns;
+        })();
+        const exit = exits.find(candidate => candidate.getStart(tree) > output.getStart(tree)
+          && (!arm || candidate.getStart(tree) <= arm.getEnd() || !armReturns));
+        if (exit) findings.push({ file, line: line(output), exitLine: line(exit) });
+      }
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(tree);
+  return findings;
+}
+
+function cliFiles(root: string): string[] {
+  const files = [join(root, 'src/index.ts')];
+  const walk = (dir: string): void => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isDirectory()) walk(join(dir, entry.name));
+      else if (entry.isFile() && entry.name.endsWith('.ts') && !entry.name.endsWith('.test.ts')) files.push(join(dir, entry.name));
+    }
+  };
+  walk(join(root, 'src/cli'));
+  return files.sort();
+}
+
+export function scanCliJsonExits(root = join(import.meta.dir, '..')): JsonExitFinding[] {
+  return cliFiles(root).flatMap(path => scanJsonExitSource(readFileSync(path, 'utf8'), relative(root, path)));
+}
+
+if (import.meta.main) {
+  const findings = scanCliJsonExits();
+  if (process.argv.includes('--json')) console.log(JSON.stringify(findings, null, 2));
+  else {
+    console.log(`JSON 출력 → process.exit 후보 ${findings.length}곳 (file:writeLine → exitLine)`);
+    for (const finding of findings) console.log(`${finding.file}:${finding.line} → ${finding.exitLine}`);
+  }
+}

package/scripts/codex-quota-alert-format.ts

@@ -0,0 +1,52 @@
+export interface CreditsRow {
+  name: string;
+  balance?: number;
+  perHour?: number;
+  resetInHours?: number;
+}
+
+export interface CreditsSummary {
+  totalBalance: number;
+  totalPerHour: number | null;
+  etaHours: number | null;
+  earliestResetHours: number | null;
+  beforeReset: boolean | null;
+  unknownSpeedCount: number;
+  unknownBalanceCount: number;
+}
+
+export function creditsSummary(rows: CreditsRow[]): CreditsSummary {
+  const balances = rows.map(row => row.balance).filter((balance): balance is number =>
+    typeof balance === 'number' && Number.isFinite(balance));
+  const unknownBalanceCount = rows.length - balances.length;
+  const totalBalance = balances.reduce((sum, balance) => sum + balance, 0);
+  const measuredSpeeds = rows.map(row => row.perHour).filter((speed): speed is number =>
+    typeof speed === 'number' && Number.isFinite(speed));
+  const totalPerHour = measuredSpeeds.length
+    ? measuredSpeeds.reduce((sum, speed) => sum + speed, 0) : null;
+  const unknownSpeedCount = rows.length - measuredSpeeds.length;
+  const resets = rows.map(row => row.resetInHours).filter((hours): hours is number =>
+    typeof hours === 'number' && Number.isFinite(hours) && hours > 0);
+  const earliestResetHours = rows.length > 0 && resets.length === rows.length ? Math.min(...resets) : null;
+  const etaHours = unknownBalanceCount === 0 && totalPerHour !== null && totalPerHour < 0
+    ? Math.max(0, totalBalance / -totalPerHour) : null;
+  const beforeReset = etaHours === null || earliestResetHours === null
+    ? null : etaHours < earliestResetHours;
+  return { totalBalance, totalPerHour, etaHours, earliestResetHours, beforeReset, unknownSpeedCount, unknownBalanceCount };
+}
+
+export function formatCreditsSummary(summary: CreditsSummary): string {
+  const balance = Math.round(summary.totalBalance).toLocaleString('en-US');
+  const rate = summary.totalPerHour === null ? '미상'
+    : `${summary.totalPerHour < 0 ? '−' : summary.totalPerHour > 0 ? '+' : ''}${Math.abs(summary.totalPerHour).toLocaleString('en-US', { maximumFractionDigits: 1 })}`;
+  const speed = summary.unknownSpeedCount ? ` · 속도 모름 ${summary.unknownSpeedCount}개` : '';
+  const eta = summary.etaHours === null ? ' · 고갈 시각 미상' : ` · 약 ${Math.round(summary.etaHours)}시간 뒤 0`;
+  const reset = summary.earliestResetHours === null
+    ? ' — 가장 이른 리셋 시각 미상'
+    : summary.beforeReset === null ? ` — 가장 이른 리셋(${summary.earliestResetHours}시간)과 비교 불가`
+      : summary.beforeReset
+        ? ` — 가장 이른 리셋(${summary.earliestResetHours}시간)«보다 먼저»`
+        : ` — 가장 이른 리셋(${summary.earliestResetHours}시간)이 먼저 옵니다`;
+  const balanceLabel = summary.unknownBalanceCount ? `확인된 계정 합계 ${balance} · 잔액 모름 ${summary.unknownBalanceCount}개` : `크레딧 합계 ${balance}`;
+  return `💳 ${balanceLabel} · 시간당 ${rate}${speed}${eta}${reset}`;
+}

package/scripts/codex-quota-alert.ts

@@ -29,12 +29,21 @@ import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { ensureCronNodePath } from '../src/domains/cron-path.js';
 import { registerStandaloneLogSink } from '../src/domains/standalone-log-sink.js';
+import { getUserConfig } from '../src/user-config.js';
+import { creditsSummary, formatCreditsSummary } from './codex-quota-alert-format.js';
+import {
+  CODEX_QUOTA_POLICY_LABEL, codexPolicyAllowsCredits, codexPolicyAllowsFallback, resolveCodexQuotaPolicy,
+} from '../src/oauth/codex-quota-policy.js';
 
 const STATE = join(homedir(), '.elanous/conatus/codex_quota_alert_state.json');
 /** 잔여가 이 % 이하로 내려간 계정을 «임박»으로 본다. */
 const LOW_REMAINING_PERCENT = 10;
 /** 리셋권 만료가 이 일수 안이면 알린다. */
 const RESET_CREDIT_EXPIRY_DAYS = 7;
+/** 정책 `credits`(크레딧 사용이 «허가된» 상태)에서 잔액 보고의 발송 단위 — 이만큼 줄 때마다 한 번.
+ *  ⛔ 허가된 지출을 매시 경보로 보내면 진짜 경보(리셋 전 고갈 · 정책 위반)가 묻힌다(대표 2026-09-28 «정책과 안 맞는다»).
+ *  허가 «밖»(within-quota·fallback)에서는 종전대로 줄 때마다 보낸다 — 그때는 줄어드는 것 자체가 사고다. */
+const CREDITS_REPORT_STEP = 5000;
 
 interface AccountRow {
   provider: string; accountName: string;
@@ -105,6 +114,12 @@ if ('error' in usage) {
   process.exit(0);
 }
 
+// 대표 2026-09-28 한도 정책(`llm.codexQuotaPolicy`) — 알림 문구·발송 기준이 «설정된 정책»을 따른다.
+let quota = resolveCodexQuotaPolicy(undefined);
+try { quota = resolveCodexQuotaPolicy(getUserConfig().llm); } catch { /* 못 읽으면 기본(fallback) */ }
+const creditsAllowed = codexPolicyAllowsCredits(quota.policy);
+const fallbackAllowed = codexPolicyAllowsFallback(quota.policy);
+
 const codex = usage.rows.filter((r) => r.provider === 'codex');
 const others = usage.rows.filter((r) => r.provider !== 'codex');
 
@@ -178,7 +193,20 @@ function drainOf(r: AccountRow): { state: 'draining' | 'flat' | 'unknown'; delta
     ...(hours > 0 ? { perHour: delta / hours, windowMin: Math.round(hours * 60) } : {}),
   };
 }
-const drain = new Map(burning.map((r) => [r.accountName, drainOf(r)] as const));
+const drain = new Map((quota.policy === 'credits' ? codex : burning)
+  .map((r) => [r.accountName, drainOf(r)] as const));
+// 🩸 2026-09-28: 머리줄이 «찬 ⊕ 크레딧 있음» 계정 수(3)를 «나가는 중» 으로 셌다 — 실제로 줄던 것은 default 하나.
+//   ⇒ «줄고 있다»(draining)와 «크레딧은 있지만 안 쓰는 중»을 가른다.
+const draining = burning.filter((r) => drain.get(r.accountName)?.state === 'draining');
+const creditHolders = quota.policy === 'credits'
+  ? codex.filter((r) => r.credits?.hasCredits === true)
+  : [];
+const combinedCredits = creditHolders.length >= 2 ? creditsSummary(creditHolders.map((r) => ({
+  name: r.accountName,
+  balance: r.credits?.balance,
+  perHour: drain.get(r.accountName)?.state === 'flat' ? 0 : drain.get(r.accountName)?.perHour,
+  resetInHours: hoursUntil(r.subscription?.resetsAt) ?? undefined,
+}))) : null;
 
 // ⭐ 상태를 «문자열 하나»로 접어 두고, 바뀔 때만 보낸다(같은 경고 반복 금지).
 const signature = JSON.stringify({
@@ -187,12 +215,20 @@ const signature = JSON.stringify({
   exp: expiring.map((r) => r.accountName).sort(),
   // ⛔ 「못 읽음」이 서명에 없으면, 자가 눈먼 상태가 「상태 동일」로 조용해진다.
   unread: unreadable.map((r) => r.accountName).sort(),
+  policy: quota.policy,
+  ...(combinedCredits ? { beforeReset: combinedCredits.beforeReset } : {}),
   // ⛔ 「줄고 있는 중」은 «매 틱» 서명이 달라야 한다 — 돈이 계속 나가는데 한 번만 알리면
   //   두 번째 시간부터는 「상태 동일」로 조용해진다. 그래서 draining 이면 원값을 넣는다.
   //   ⛔ 반대로 멎었으면(flat) 원값을 넣지 «않는다» — 그래야 반복 발송이 멎는다.
   burn: burning.map((r) => {
     const d = drain.get(r.accountName);
-    return `${r.accountName}:${d?.state === 'draining' ? String(r.credits?.balance) : (d?.state ?? 'unknown')}`;
+    if (d?.state !== 'draining') return `${r.accountName}:${d?.state ?? 'unknown'}`;
+    const b = r.credits?.balance;
+    // 허가된 크레딧 지출은 «단위»로 접는다 — 단 «리셋 전에 바닥난다»로 바뀌면 단위와 무관하게 서명이 바뀐다.
+    const resetH = hoursUntil(r.subscription?.resetsAt);
+    const etaH = d.perHour && d.perHour < 0 && typeof b === 'number' ? b / -d.perHour : null;
+    const risk = !combinedCredits && etaH !== null && (resetH === null || etaH < resetH) ? ':before-reset' : '';
+    return `${r.accountName}:${creditsAllowed ? b === undefined ? 'balance-unknown' : `step${Math.floor(b / CREDITS_REPORT_STEP)}${risk}` : String(b ?? 0)}`;
   }).sort(),
 });
 const prev = prevState;
@@ -214,13 +250,15 @@ if (prev.signature === signature) {
 }
 
 if (exhausted.length === 0 && low.length === 0 && expiring.length === 0 && burning.length === 0
-    && unreadable.length === 0) {
+    && unreadable.length === 0 && !combinedCredits) {
   console.log('[codex-quota-alert] 경고 조건 없음');
   saveState({ ...prev, ...balances, signature });
   process.exit(0);
 }
 
 const lines: string[] = [];
+lines.push(`🧭 정책: **${CODEX_QUOTA_POLICY_LABEL[quota.policy]}** (\`llm.codexQuotaPolicy=${quota.policy}\`${quota.source === 'legacy-credits' ? ' · 옛 codexCreditsAllowed 에서' : quota.source === 'default' ? ' · 기본값' : quota.source === 'invalid' ? ' · ⚠️ 모르는 값이라 기본값' : ''})`);
+lines.push('');
 // ⛔ 「못 읽음」을 맨 위에 둔다 — 아래 판정들이 «그만큼 눈이 먼» 상태임을 먼저 말해야 한다.
 if (unreadable.length > 0) {
   lines.push(`⚠️ **계정 ${unreadable.length}개를 «못 읽었습니다»** — 아래 판정은 그만큼 눈이 멉니다.`);
@@ -229,16 +267,26 @@ if (unreadable.length > 0) {
   lines.push('');
 }
 // 🔥 돈이 나가는 축을 «맨 위»에 둔다 — 소진은 멈춘 것이고 이것은 안 멈춘 것이다.
-if (burning.length > 0) {
-  lines.push(`🔥 **한도를 넘겼는데 요청이 «안 죽고» 있습니다 (${burning.length}개 계정)**`);
-  lines.push('레이트리밋 오류가 안 나므로 ⛔ **회전도 폴백도 안 열립니다** — 잔액에서 그대로 나갑니다.');
+if (burning.length > 0 || combinedCredits) {
+  if (creditsAllowed) {
+    lines.push(burning.length > 0
+      ? `💳 **크레딧으로 진행 중 — 줄고 있는 계정 ${draining.length}개** (크레딧 보유 ${burning.length}개 · 정책상 허가된 지출)`
+      : '💳 **크레딧 보유 계정**');
+    if (combinedCredits) lines.push(formatCreditsSummary(combinedCredits));
+    if (burning.length > 0) lines.push(combinedCredits
+      ? `잔액이 ${CREDITS_REPORT_STEP} 단위로 줄 때마다 한 번 알립니다. 리셋 전 고갈은 합계로 판정합니다.`
+      : `잔액이 ${CREDITS_REPORT_STEP} 단위로 줄 때마다 한 번 알립니다. 🚨 표시가 있으면 리셋 전에 바닥납니다.`);
+  } else {
+    lines.push(`🚨 **정책 밖 지출 — 한도를 넘겼는데 크레딧에서 나가고 있습니다 (줄고 있는 계정 ${draining.length}개 · 크레딧 보유 ${burning.length}개)**`);
+    lines.push(`정책이 «${CODEX_QUOTA_POLICY_LABEL[quota.policy]}» 인데 레이트리밋 오류가 안 나 회전·폴백이 안 열립니다. 크레딧을 허가하려면 \`elanous config set llm.codexQuotaPolicy credits\`.`);
+  }
   for (const r of burning) {
     const now = r.credits?.balance;
     const nowText = typeof now === 'number' ? now.toFixed(2) : '미상';
     const d = drain.get(r.accountName);
     let tail: string;
     if (!d || d.state === 'unknown') tail = ' (직전 관측 없음 — 이번이 첫 표본입니다)';
-    else if (d.state === 'flat') tail = ' · 직전 관측 이후 «안 줄었습니다»';
+    else if (d.state === 'flat') tail = ' · 크레딧 보유 · 직전 관측 이후 «안 썼습니다»';
     else {
       // ⛔ 남은 시간은 «속도를 실제로 쟀을 때만» 말한다 — 지어내면 사람이 그 수로 계획을 세운다.
       const rate = d.perHour;
@@ -249,7 +297,7 @@ if (burning.length > 0) {
       const etaH = rate && rate < 0 && typeof now === 'number' ? now / -rate : null;
       const resetH = hoursUntil(r.subscription?.resetsAt);
       let eta = '';
-      if (etaH !== null) {
+      if (etaH !== null && !combinedCredits) {
         const h = Math.max(0, Math.round(etaH));
         if (resetH !== null && resetH > 0 && resetH < etaH) {
           // 리셋이 먼저 온다 — 이 창에서 탈 양까지 «수»로 말한다.
@@ -271,10 +319,12 @@ if (burning.length > 0) {
   lines.push('');
 }
 if (exhausted.length === codex.length && codex.length > 0) {
-  lines.push(`🚨 **codex 계정이 «전부» 소진됐습니다 (${codex.length}/${codex.length})**`);
-  lines.push('폴백이 grok 으로 갑니다. grok 도 한도가 있으니 같이 보십시오.');
+  lines.push(`${creditsAllowed ? '💳' : '🚨'} **codex 구독 한도가 «전부» 찼습니다 (${codex.length}/${codex.length})**`);
+  if (creditsAllowed) lines.push('정책 «크레딧까지» — codex 를 크레딧으로 계속 씁니다. 크레딧까지 떨어지면 폴백 체인으로 갑니다.');
+  else if (fallbackAllowed) lines.push(`정책 «자동 폴백» — 폴백 체인(\`llm.fallbackChain\`)으로 갑니다. 폴백 대상의 한도도 같이 보십시오.`);
+  else lines.push('정책 «한도 안에서만» — codex 작업은 리셋까지 «멈춥니다»(폴백·크레딧 없음).');
 } else if (exhausted.length > 0) {
-  lines.push(`⚠️ **codex 계정 ${exhausted.length}/${codex.length} 소진**`);
+  lines.push(`⚠️ **codex 계정 ${exhausted.length}/${codex.length} 한도 참** — 남은 계정으로 회전합니다`);
 }
 for (const r of exhausted) {
   const h = hoursUntil(r.subscription?.resetsAt);
@@ -289,9 +339,9 @@ if (expiring.length > 0) {
   lines.push(`💳 **리셋권 만료 임박 (${RESET_CREDIT_EXPIRY_DAYS}일 이내)**`);
   for (const r of expiring) lines.push(`  • \`${r.accountName}\` — ${daysUntil(r.resetCredits?.expiresAt)}일 뒤`);
 }
-if (others.length > 0) {
+if (others.length > 0 && fallbackAllowed) {
   lines.push('');
-  lines.push('폴백 대상:');
+  lines.push(creditsAllowed ? '폴백 대상(크레딧까지 떨어진 뒤):' : '폴백 대상:');
   for (const r of others) {
     const rem = r.subscription?.remainingPercent;
     const used = r.credits?.usedPercent;

package/scripts/continuation-dogfood.ts

@@ -24,13 +24,14 @@ import { ContinuationScheduler } from '../src/dispatch/continuation-scheduler.js
 import type { ContinuationStepResult } from '../src/dispatch/continuation-driver.js';
 import { makeContinuationRunTurn } from '../src/dispatch/continuation-turn-runner.js';
 import { getUserConfig } from '../src/user-config.js';
+import { envLiteral } from '../src/platform/env-literal.js';
 
 const SLUG = 'continuation-demo';
 const MAX_TICKS = 5;
 
 resetAutoModeForTest();
 const home = mkdtempSync(join(tmpdir(), 'cont-dogfood-'));
-const vault = discoverObsidianVault({ env: { ELANOUS_OBSIDIAN_VAULT: join(home, 'vault') }, cwd: home });
+const vault = discoverObsidianVault({ env: envLiteral({ ELANOUS_OBSIDIAN_VAULT: join(home, 'vault') }), cwd: home });
 const paths = resolveGoalPaths(vault, SLUG);
 const summaryPath = join(paths.goalRoot, 'executive-summary.md');
 

package/scripts/coord-channel-watch.sh

@@ -3,7 +3,7 @@
 #
 # ⭐ 채널 번호는 «인자»다 — 기본값은 아래 `PR_NUM`, 정본은 `MANUAL-multi-agent-coordination-channel` 머리말이다.
 #   ⛔ 채널이 바뀌면 이 파일의 기본값 «한 줄»과 그 매뉴얼 머리말 «둘»만 고친다(이름은 안 바꾼다).
-#    (2026-08-12 #5730→#8328 · 08-25 #8328→#12577 · 09-10 #12577→#16815).
+#    (2026-08-12 #5730→#8328 · 08-25 #8328→#12577 · 09-10 #12577→#16815 · 09-27 #16815→#20798).
 #    ⛔ 채널은 «막힐 수 있다» — GitHub 은 코멘트 2500 을 넘기면 댓글을 차단한다. 그때의 절차 =
 #    `내부 문서 `COORDINATION-CHANNEL`` 「채널이 막히면 — 순서」.
 #
@@ -48,11 +48,11 @@
 
 set -u
 
-PR_NUM="${CH_PR:-16815}"  # ⛔ 2026-09-10: #12577 이 2,376/2,500 에 닿아 채널 «4» 로 옮김(벽 «전»에 미리)
-#   📏 이력: #5730(07-28~08-12) → #8328(08-11~08-25) → #12577(08-25~09-10) → #16815.
+PR_NUM="${CH_PR:-20798}"  # ⛔ 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.
 #   ***수명이 «2주 안팎»이다 — 세 판이 전부 그랬다.*** 다음 벽은 09-24 언저리.
-#   🩹 발신이 rc=1 이면 먼저 세라: gh api repos/ElanvitalAI/monad/issues/<n> --jq .comments
-REPO="${CH_REPO:-ElanvitalAI/monad}"
+#   🩹 발신이 rc=1 이면 먼저 세라: gh api repos/ElanvitalAI/elanous/issues/<n> --jq .comments
+REPO="${CH_REPO:-ElanvitalAI/elanous}"
 INTERVAL="${CH_INTERVAL:-60}"
 BODY_CHARS="${CH_BODY_CHARS:-1500}"
 # ⛔⭐⭐⭐ PR «본문» 감시 (2026-08-08 [T] 60차) — 종전엔 «대화 코멘트»만 봤다.
@@ -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,9 +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": "🅢" },
-    { "id": "T", "mark": "🅣" },
-    { "id": "F", "mark": "🅕" },
-    { "id": "O", "mark": "🅞" }
+    { "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": [] }
   ]
 }