elanous 0.2.20 → 0.2.22

package/src/plugins/maker/market-bundle.ts

@@ -4,6 +4,7 @@ import { spawnSync } from 'node:child_process';
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve, sep } from 'node:path';
 import { userConfigPath } from '../../user-config.js';
+import { scanKnowledgePackDlp } from '../../mss/logging/redaction.js';
 import { loadPluginManifestFromDir } from '../core/manifest.js';
 import { LEAK_MARKERS, loadPrivateRedactions, privateIdentifierMarkers, scanLeaks } from '../../../scripts/public-export.js';
 
@@ -56,6 +57,14 @@ export function bundleInstalledWizardPlugin(installedPath: string, outputDir: st
   if (!redactions) throw new Error('private export redaction list unavailable; market bundle refused');
   const hits = scanLeaks(source, files, [...LEAK_MARKERS, ...privateIdentifierMarkers(redactions)]);
   if (hits.length) throw new Error(`market bundle leak: ${hits.map(hit => `${hit.file}:${hit.line} ${hit.marker}`).join(', ')}`);
+  const dlpHits: string[] = [];
+  for (const file of files) {
+    const text = readFileSync(join(source, file), 'utf8');
+    const reasons = scanKnowledgePackDlp(text);
+    if (text.includes('\u0000')) reasons.push('unscannable-content');
+    if (reasons.length) dlpHits.push(`${file}: ${reasons.join(', ')}`);
+  }
+  if (dlpHits.length) throw new Error(`market bundle DLP: ${dlpHits.join('; ')}`);
   const config: unknown = existsSync(configPath) ? JSON.parse(readFileSync(configPath, 'utf8')) : {};
   if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('invalid market signing config');
   const signing = (config as { market?: { signing?: { keyId?: unknown; privateKey?: unknown } } }).market?.signing;

package/src/plugins/maker/plugin-maker.ts

@@ -146,7 +146,10 @@ export async function validatePluginDir(dir: string): Promise<string[]> {
   catch (error) { errors.push(`recipes.yaml 파싱 실패: ${String(error)}`); }
   if (!isRecord(recipes)) errors.push('recipes.yaml 은 맵이어야 한다');
   else for (const [id, recipe] of Object.entries(recipes)) {
-    if (!isRecord(recipe) || typeof recipe.command !== 'string' || !recipe.command.trim() ||
+    if (!isRecord(recipe) ||
+      (!(typeof recipe.command === 'string' && recipe.command.trim()) && !(typeof recipe.approval === 'string' && recipe.approval.trim())) ||
+      (recipe.command !== undefined && (typeof recipe.command !== 'string' || !recipe.command.trim())) ||
+      (recipe.approval !== undefined && (typeof recipe.approval !== 'string' || !recipe.approval.trim())) ||
       (recipe.timeout_ms !== undefined && (!Number.isSafeInteger(recipe.timeout_ms) || Number(recipe.timeout_ms) <= 0))) errors.push(`잘못된 recipe: ${id}`);
   }
   for (const graph of Array.isArray(graphs) ? graphs : []) {
@@ -162,11 +165,14 @@ export async function validatePluginDir(dir: string): Promise<string[]> {
       if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(template.graphId)) errors.push(`잘못된 graph_id: ${template.graphId}`);
       if (template.terminalNodes.length !== 2 || !template.terminalNodes.includes('done') || !template.terminalNodes.includes('failed')) errors.push('terminal_nodes 는 done, failed 이어야 한다');
       const executionNodes = template.nodes.filter(node => !template.terminalNodes.includes(node.nodeId));
-      if (executionNodes.length < 2 || executionNodes.length > 6) errors.push(`실행 노드는 2~6개여야 한다: ${executionNodes.length}개`);
+      if (executionNodes.length < 2) errors.push(`실행 노드는 2개 이상이어야 한다: ${executionNodes.length}개`);
       for (const node of template.nodes) {
         if (node.recipe.startsWith('cmd:')) {
           const id = node.recipe.slice(4);
-          if (!isRecord(recipes) || !isRecord(recipes[id]) || typeof recipes[id].command !== 'string' || !recipes[id].command) errors.push(`recipe ${id} 없음`);
+          if (!isRecord(recipes) || !isRecord(recipes[id]) || recipes[id].approval !== undefined || typeof recipes[id].command !== 'string' || !recipes[id].command.trim()) errors.push(`recipe ${id} 없음`);
+        } else if (node.recipe.startsWith('approval:')) {
+          const id = node.recipe.slice(9);
+          if (!isRecord(recipes) || !isRecord(recipes[id]) || typeof recipes[id].approval !== 'string' || !recipes[id].approval.trim()) errors.push(`approval recipe ${id} 없음`);
         } else if (node.recipe !== 'none') errors.push(`지원하지 않는 recipe: ${node.recipe}`);
       }
     } catch (error) { errors.push(`${graph} 파싱 실패: ${String(error)}`); }

package/src/plugins/maker/wizard-generate.ts

@@ -1,5 +1,5 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, writeFileSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 
 /** Research is descriptive. Credential values are never an input to the generator. */
@@ -16,7 +16,7 @@ const SLUG = /^[a-z0-9][a-z0-9-]{1,31}$/;
 const FIELD = /^[A-Za-z_][A-Za-z0-9_-]*$/;
 
 /** Materialize a research draft; its graph steps fail until the requested processing is implemented. */
-export function generateWizardFiles(dir: string, slug: string, draft: WizardResearchDraft): string[] {
+export function generateWizardFiles(dir: string, slug: string, draft: WizardResearchDraft, options: { regenerate?: boolean } = {}): string[] {
   if (!SLUG.test(slug)) throw new Error(`invalid wizard plugin name: ${slug}`);
   if (!draft || typeof draft.description !== 'string' || !draft.description.trim()) throw new Error('wizard description is required');
   if (draft.connectors !== undefined && !Array.isArray(draft.connectors)) throw new Error('invalid wizard connectors');
@@ -48,21 +48,30 @@ export function generateWizardFiles(dir: string, slug: string, draft: WizardRese
   }
   const manifestPath = join(dir, 'plugin.json');
   const existing = existsSync(manifestPath) ? JSON.parse(readFileSync(manifestPath, 'utf8')) as {
-    name: string; extensions: { 'ai.elanous': { connectors?: unknown[]; graphs?: string[]; researchDraft?: boolean } };
+    name: string; description?: string; extensions: { 'ai.elanous': { connectors?: unknown[]; graphs?: string[]; researchDraft?: boolean } };
   } : undefined;
   if (existing && (existing.name !== slug || !existing.extensions?.['ai.elanous'])) {
     throw new Error('wizard scaffold name or extension mismatch');
   }
-  if (existsSync(join(dir, `skills/${slug}/SKILL.md`))) {
+  const skillPath = join(dir, `skills/${slug}/SKILL.md`);
+  const readmePath = join(dir, 'README.md');
+  const wizardReadme = options.regenerate && existsSync(readmePath) &&
+    readFileSync(readmePath, 'utf8').includes('Research draft only. Connector declarations contain credential names, not values.');
+  if (options.regenerate) {
+    if (!existing || existing.extensions['ai.elanous'].researchDraft !== true || !existsSync(skillPath)) {
+      throw new Error('wizard regeneration requires an existing research draft');
+    }
+  } else if (existsSync(skillPath)) {
     throw new Error(`wizard file already exists: skills/${slug}/SKILL.md`);
   }
   const scaffoldConnectors = existing?.extensions['ai.elanous'].connectors;
-  if (scaffoldConnectors !== undefined && (!Array.isArray(scaffoldConnectors) || scaffoldConnectors.length > 0)) {
+  if (!options.regenerate && scaffoldConnectors !== undefined && (!Array.isArray(scaffoldConnectors) || scaffoldConnectors.length > 0)) {
     throw new Error('wizard cannot replace existing scaffold connectors');
   }
   const manifest = existing ?? { name: slug, version: '0.1.0', description: draft.description,
     extensions: { 'ai.elanous': { graphs: [`./graphs/${slug}.yaml`],
       capabilities: ['fs:workdir', 'proc:bun', 'proc:elanous'], connectors: [] as unknown[], researchDraft: true } } };
+  if (options.regenerate) manifest.description = draft.description;
   manifest.extensions['ai.elanous'].connectors = connectors;
   manifest.extensions['ai.elanous'].researchDraft = true;
 
@@ -90,14 +99,69 @@ process.exitCode = 1;
     ['README.md', `# ${slug}\n\n${draft.description}\n\nResearch draft only. Connector declarations contain credential names, not values. The graph cannot perform the requested processing yet: implement and validate its steps, then remove extensions["ai.elanous"].researchDraft from plugin.json before installing or running it. No messages are sent.\n`],
     [`skills/${slug}/SKILL.md`, `---\n${stringifyYaml({ name: slug, description: draft.skill?.description ?? draft.description, requires: [...new Set(requires)] })}---\n\n${draft.skill?.instructions ?? draft.description}\n`],
   ];
-  const generated = existing ? files.filter(([path]) => path === 'plugin.json' || path.startsWith('skills/')) : files;
+  const generated = existing ? files.filter(([path]) => path === 'plugin.json' || path.startsWith('skills/') ||
+    (options.regenerate && wizardReadme && path === 'README.md')) : files;
   for (const [path] of generated) {
-    if (path !== 'plugin.json' && existsSync(join(dir, path))) throw new Error(`wizard file already exists: ${path}`);
+    if (path !== 'plugin.json' && !(options.regenerate && (path === 'README.md' || path.startsWith('skills/'))) && existsSync(join(dir, path))) {
+      throw new Error(`wizard file already exists: ${path}`);
+    }
   }
   for (const [path, content] of generated) {
     const target = join(dir, path);
     mkdirSync(join(target, '..'), { recursive: true });
-    writeFileSync(target, content, { flag: path === 'plugin.json' && existing ? 'w' : 'wx' });
+    writeFileSync(target, content, { flag: existing && (path === 'plugin.json' || options.regenerate) ? 'w' : 'wx' });
   }
   return generated.map(([path]) => path);
 }
+
+/** Browser wizard drafts are stored outside the install ledger. Only wizard-owned directories are listed. */
+export function listWizardDrafts(parent: string): Array<{ name: string; description: string; draft: WizardResearchDraft }> {
+  if (!existsSync(parent)) return [];
+  return readdirSync(parent, { withFileTypes: true }).filter(entry => entry.isDirectory() && SLUG.test(entry.name)).flatMap(entry => {
+    const dir = join(parent, entry.name);
+    try {
+      const manifestPath = join(dir, 'plugin.json');
+      const skillDir = join(dir, 'skills', entry.name);
+      const skillPath = join(skillDir, 'SKILL.md');
+      if (lstatSync(manifestPath).isSymbolicLink() || lstatSync(skillDir).isSymbolicLink() || lstatSync(skillPath).isSymbolicLink()) return [];
+      const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as {
+        name?: string; description?: string; extensions?: { 'ai.elanous'?: { researchDraft?: boolean; connectors?: Array<{ id: string; fields: Array<{ name: string }> }> } } };
+      if (manifest.name !== entry.name || manifest.extensions?.['ai.elanous']?.researchDraft !== true) return [];
+      const skill = readFileSync(skillPath, 'utf8');
+      const parts = /^---\n([\s\S]*?)---\n\n([\s\S]*)$/.exec(skill);
+      if (!parts || typeof manifest.description !== 'string') return [];
+      const meta = parseYaml(parts[1]!) as { description?: string; requires?: string[] };
+      return [{ name: entry.name, description: manifest.description, draft: {
+        description: manifest.description,
+        connectors: manifest.extensions['ai.elanous'].connectors?.map(connector => ({ id: connector.id, credentials: connector.fields.map(field => ({ name: field.name })) })) ?? [],
+        skill: { description: meta.description ?? manifest.description, instructions: parts[2]!.trimEnd(), requires: meta.requires ?? [] },
+      } }];
+    } catch { return []; }
+  }).sort((a, b) => a.name.localeCompare(b.name));
+}
+
+export function saveWizardDraft(parent: string, slug: string, draft: WizardResearchDraft, regenerate = false): string[] {
+  if (!SLUG.test(slug)) throw new Error(`invalid wizard plugin name: ${slug}`);
+  const requested = resolve(parent);
+  if (existsSync(requested) && lstatSync(requested).isSymbolicLink()) throw new Error('wizard parent cannot be a symlink');
+  // Ancestors may be symlinks (macOS /var -> /private/var); compare the draft directory against the real parent.
+  const base = existsSync(requested) ? realpathSync(requested) : requested;
+  const dir = resolve(base, slug);
+  if (!dir.startsWith(`${base}${sep}`)) throw new Error('invalid wizard directory');
+  if (existsSync(dir) && (lstatSync(dir).isSymbolicLink() || !lstatSync(dir).isDirectory() || realpathSync(dir) !== dir)) {
+    throw new Error('wizard directory must be a local directory');
+  }
+  if (regenerate && existsSync(join(dir, 'skills')) && lstatSync(join(dir, 'skills')).isSymbolicLink()) {
+    throw new Error('wizard skills cannot be a symlink');
+  }
+  if (!regenerate && existsSync(dir)) throw new Error('wizard directory already exists');
+  if (regenerate && existsSync(join(dir, 'skills', slug)) && lstatSync(join(dir, 'skills', slug)).isSymbolicLink()) {
+    throw new Error('wizard skills cannot be a symlink');
+  }
+  if (regenerate && ['plugin.json', 'README.md', `skills/${slug}/SKILL.md`].some(file => {
+    const path = join(dir, file);
+    return existsSync(path) && lstatSync(path).isSymbolicLink();
+  })) throw new Error('wizard regeneration cannot follow symlinks');
+  if (!existsSync(base) && !regenerate) mkdirSync(base, { recursive: true });
+  return generateWizardFiles(dir, slug, draft, { regenerate });
+}

package/src/policy/llm-policy.ts

@@ -4,7 +4,7 @@ import { isScalar, parseDocument } from 'yaml';
 import { getElanousConfigDir } from '../elanous-config-dir.js';
 import { DEFAULT_FALLBACK_CHAIN, isFallbackStep, type FallbackStep } from '../oauth/fallback-chain.js';
 import { isCodexQuotaPolicy } from '../oauth/codex-quota-policy.js';
-import { DEFAULT_BUDGET_GATE_MAX_USED_PERCENT, MODEL_ROLES, RUNTIME_LLM_PROVIDER_NAMES, parseRoleLlmEntry, type RoleLlmConfig } from '../user-config.js';
+import { DEFAULT_BUDGET_GATE_MAX_USED_PERCENT, MODEL_ROLES, RUNTIME_LLM_PROVIDER_NAMES, parseRoleLlmEntry, parseSubscriptionReviewerSpec, type RoleLlmConfig } from '../user-config.js';
 
 export interface LlmPolicy {
   version: 1;
@@ -22,7 +22,7 @@ export interface LlmPolicy {
     grants: Array<{ account: string; amount: number; expires: string; source: string }>;
     pace?: { targetPerDay: number; until: string; why?: string };
   };
-  caps: { codex: { harness: number; pod: number; tox: number; intake: number; headroom: number }; grok: { weekly: number; tox: number; intake: number } };
+  caps: { codex: { harness: number; pod: number; tox: number; intake: number; headroom: number }; grok: { weekly: number; tox: number; intake: number }; claude: { harness: number } };
   resetCredits: { redeem: 'human' };
   alerts: { lowRemainingPercent: number; resetCreditExpiryDays: number; creditsStep: number };
 }
@@ -71,6 +71,7 @@ export function defaultLlmPolicy(): LlmPolicy {
     caps: {
       codex: { harness: DEFAULT_BUDGET_GATE_MAX_USED_PERCENT['openai-codex']!, pod: 95, tox: 60, intake: 80, headroom: 15 },
       grok: { weekly: DEFAULT_BUDGET_GATE_MAX_USED_PERCENT.grok!, tox: 50, intake: 48 },
+      claude: { harness: 60 },
     },
     resetCredits: { redeem: 'human' },
     alerts: { lowRemainingPercent: 10, resetCreditExpiryDays: 7, creditsStep: 5000 },
@@ -103,8 +104,10 @@ export function validateLlmPolicy(input: unknown): LlmPolicyValidation {
   const grants = (v: unknown) => Array.isArray(v) && v.every(g => object(g)
     && Object.keys(g).every(k => ['account', 'amount', 'expires', 'source'].includes(k))
     && nonempty(g.account) && positive(g.amount) && date(g.expires) && nonempty(g.source));
-  const roles = (v: unknown) => object(v) && Object.entries(v).every(([role, spec]) => MODEL_ROLES.some(r => r === role)
-    && object(spec) && Object.keys(spec).every(k => ['provider', 'tier', 'model'].includes(k)) && parseRoleLlmEntry(spec).ok);
+  const roles = (v: unknown) => object(v) && Object.entries(v).every(([role, spec]) => role === 'reviewer'
+    ? !!parseSubscriptionReviewerSpec(spec)
+    : MODEL_ROLES.some(r => r === role) && object(spec)
+      && Object.keys(spec).every(k => ['provider', 'tier', 'model'].includes(k)) && parseRoleLlmEntry(spec).ok);
   check(input, 'policy', {
     version: (v: unknown) => v === 1,
     default: { provider: (v: unknown) => nonempty(v) && RUNTIME_LLM_PROVIDER_NAMES.some(p => p === v), model: nonempty },
@@ -122,7 +125,7 @@ export function validateLlmPolicy(input: unknown): LlmPolicyValidation {
         && Object.keys(v).every(k => ['targetPerDay', 'until', 'why'].includes(k)),
     },
     caps: { codex: { harness: percent, pod: percent, tox: percent, intake: percent, headroom: percent },
-      grok: { weekly: percent, tox: percent, intake: percent } },
+      grok: { weekly: percent, tox: percent, intake: percent }, claude: { harness: percent } },
     resetCredits: { redeem: (v: unknown) => v === 'human' },
     alerts: { lowRemainingPercent: percent, resetCreditExpiryDays: positive, creditsStep: positive },
   });
@@ -191,7 +194,9 @@ export function loadLlmPolicy(opts: LoadLlmPolicyOptions = {}): LoadedLlmPolicy
     add('llm.provider', llm.provider, base, 'provider', v => nonempty(v) && RUNTIME_LLM_PROVIDER_NAMES.some(p => p === v));
     add('llm.model', llm.model, base, 'model', nonempty);
     if (Object.keys(base).length) overlay.default = base;
-    add('roleLlm', legacy.roleLlm, overlay, 'roles', v => object(v) && Object.entries(v).every(([r, spec]) => MODEL_ROLES.some(k => k === r) && parseRoleLlmEntry(spec).ok));
+    add('roleLlm', legacy.roleLlm, overlay, 'roles', v => object(v) && Object.entries(v).every(([r, spec]) => r === 'reviewer'
+      ? !!parseSubscriptionReviewerSpec(spec)
+      : MODEL_ROLES.some(k => k === r) && parseRoleLlmEntry(spec).ok));
     add('llm.fallbackChain', llm.fallbackChain, overlay, 'fallback', v => Array.isArray(v) && v.length > 0 && v.every(isFallbackStep) && new Set(v).size === v.length);
     const codex: Obj = {};
     add('llm.codexAccountOrder', llm.codexAccountOrder, codex, 'order', v => Array.isArray(v) && v.every(nonempty));

package/src/release-loop/checklist-board.ts

@@ -0,0 +1,27 @@
+import { debug } from '../debug/log.js';
+import { checklistDevVersion, listChecklist, summarizeChecklist, type Checklist } from './checklist.js';
+
+/** One text board shared by the Telegram and TUI slash surfaces. */
+export function renderChecklistBoard(checklist: Checklist): string {
+  const { green, yellow, red, done, blocked } = summarizeChecklist(checklist);
+  const { bySeat } = summarizeChecklist({
+    ...checklist,
+    items: checklist.items.filter((item) => item.status === 'yellow'),
+  });
+  return [
+    `판 ${checklist.version} · 초록 ${green} · 노랑 ${yellow} · 빨강 ${red} · 끝 ${done}`,
+    `빨강 칸: ${blocked.join(', ') || '-'}`,
+    `자리별 노랑: ${Object.entries(bySeat).sort(([a], [b]) => a.localeCompare(b)).map(([seat, count]) => `${seat} ${count}`).join(' · ') || '-'}`,
+  ].join('\n');
+}
+
+/** Read and render the selected board without turning failures into zero counts. */
+export function checklistBoardSlash(args: readonly string[], read: (version: string) => Checklist = listChecklist): string {
+  if (args.length > 1) return '사용법: /board [판]';
+  try {
+    return renderChecklistBoard(read(args[0] ?? checklistDevVersion()));
+  } catch (error) {
+    debug.log('release.checklist', 'board-read-failed', { version: args[0] ?? null, error: error instanceof Error ? error.message : String(error) });
+    return '판 체크리스트를 못 읽었다 — 「없다」가 아니다';
+  }
+}

package/src/release-loop/checklist.ts

@@ -175,6 +175,44 @@ export function cellsReferencingDoc(doc: string, checklists: readonly Checklist[
   return rows;
 }
 
+/** 문서 절과 판 칸의 `#절` 인용을 양방향으로 대조한다. 원장은 전달받은 스냅샷만 읽는다. */
+export function lintDocRefs(docPath: string, docText: string, checklists: readonly Checklist[]): {
+  sections: string[];
+  uncoveredSections: string[];
+  danglingRefs: Array<{ version: string; id: string; ref: string }>;
+} {
+  const path = splitRef(docPath.trim()).path;
+  const sections: string[] = [];
+  let fence: { marker: string; length: number } | null = null;
+  for (const line of docText.split(/\r?\n/)) {
+    const marker = /^ {0,3}(`{3,}|~{3,})/.exec(line)?.[1];
+    if (fence) {
+      if (marker?.[0] === fence.marker && marker.length >= fence.length && /^\s*$/.test(line.slice(line.indexOf(marker) + marker.length))) fence = null;
+      continue;
+    }
+    if (marker) { fence = { marker: marker[0]!, length: marker.length }; continue; }
+    const heading = /^ {0,3}#{2,4}[ \t]+(\S+)/.exec(line);
+    if (heading) {
+      const section = heading[1]!.replace(/[.:]$/, '');
+      if (!sections.includes(section)) sections.push(section);
+    }
+  }
+  const known = new Set(sections);
+  const cited = new Set<string>();
+  const danglingRefs: Array<{ version: string; id: string; ref: string }> = [];
+  for (const data of checklists) {
+    for (const item of data.items) {
+      for (const ref of item.refs ?? []) {
+        const got = splitRef(ref);
+        if (got.path !== path || !got.section) continue;
+        if (known.has(got.section)) cited.add(got.section);
+        else danglingRefs.push({ version: data.version, id: item.id, ref });
+      }
+    }
+  }
+  return { sections, uncoveredSections: sections.filter((section) => !cited.has(section)), danglingRefs };
+}
+
 /** `| 판 | 칸 | 상태 | 절 | 제목 |` 마크다운 표 — 행이 없으면 머리줄 둘만. */
 export function renderRefsStatus(rows: readonly DocRefRow[]): string {
   const cell = (value: string) => value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');

package/src/release-loop/gate-shards.ts

@@ -86,6 +86,9 @@ export interface GateShardsSummary {
   waitReasons: Array<{ reason: string; count: number }>;
   /** 남은 분 추정 — 계획 분이 모자라면 null(«추정 불가»). */
   etaMin: number | null;
+  /** 끝났지만 rc≠0 인 조각 수 — 쓰는 쪽의 `done` 은 «조각 끝»일 뿐 «통과»가 아니다(판정은 게이트 노드가 기존/새로 가른다).
+   *  0.2.20 컷 실측: 끝난 넷이 모두 rc 1 인데 화면이 «통과»로 읽었다. */
+  doneWithFailures: number;
   /** 도는 조각 중 계획 분을 가장 많이 넘긴 분(없으면 0). 넘겼으면 etaMin 은 «하한»일 뿐이라 화면이 그렇게 말한다
    *  — canary 10-07 실측: 계획 0.1분 · 실제 22분 → 넘김을 안 보이면 내내 «남은 약 0분». */
   overrunMin: number;
@@ -130,6 +133,7 @@ export function summarizeShards(file: GateShardsFile, now: number = Date.now()):
     total: file.shards.length,
     counts,
     waitReasons: [...reasons].map(([reason, count]) => ({ reason, count })).sort((a, b) => b.count - a.count),
+    doneWithFailures: file.shards.filter((s) => s.state === 'done' && s.rc !== undefined && s.rc !== 0).length,
     etaMin: estimate(file.shards, now),
     overrunMin: Math.floor(overrun),
     staleMin: stale === null ? null : Math.floor(stale),
@@ -137,7 +141,7 @@ export function summarizeShards(file: GateShardsFile, now: number = Date.now()):
 }
 
 export const SHARD_WORD: Record<ShardState, string> = {
-  pending: '대기', running: '돌기', done: '통과', retry: '재시도', timeout: '잘림', failed: '실패',
+  pending: '대기', running: '돌기', done: '끝', retry: '재시도', timeout: '잘림', failed: '실패',
 };
 
 /** 외출 알림·/release 한 줄 — «조각 24 · 돌기 5 · 대기 8(CPU 부족 8) · 잘림 2 · 통과 9 · 남은 약 40분». */
@@ -149,7 +153,8 @@ export function shardsLine(summary: GateShardsSummary): string {
     if (!n) continue;
     const why = state === 'pending' && summary.waitReasons.length
       ? `(${summary.waitReasons.slice(0, 2).map((w) => `${w.reason} ${w.count}`).join(' · ')})` : '';
-    parts.push(`${SHARD_WORD[state]} ${n}${why}`);
+    const reported = state === 'done' && summary.doneWithFailures ? `(실패 보고 ${summary.doneWithFailures})` : '';
+    parts.push(`${SHARD_WORD[state]} ${n}${why}${reported}`);
   }
   if (summary.overrunMin >= 1) parts.push(`계획보다 ${summary.overrunMin}분 넘게 도는 중 — 남은 시간 추정 불가`);
   else parts.push(summary.etaMin === null ? '남은 시간 추정 불가(계획 분 없음)' : `남은 약 ${summary.etaMin}분`);

package/src/seat-address/seat-address.ts

@@ -9,6 +9,7 @@ export type SeatEntry = {
 export type SeatAddress = { seats: string[]; body: string };
 
 const registry: readonly SeatEntry[] = trackData.tracks.filter((entry) => 'title' in entry);
+export function registeredSeats(): readonly SeatEntry[] { return registry; }
 const addressLine = /^@([A-Za-z][A-Za-z0-9_-]*(?:,[A-Za-z][A-Za-z0-9_-]*)*)(?:[ \t]+|\r?\n|(?![\s\S]))/gm;
 
 /** Parse an address only when its @ begins a line; leave the instruction text intact. */