sprag-cli 3.67.0 → 3.69.0

package/bin/cli.js

@@ -32,6 +32,7 @@ import { dirname, isAbsolute, join } from 'node:path';
 
 import {
   readStdinJson,
+  readStdinRaw,
   extractCaps,
   extractContextUsage,
   extractEffort,
@@ -58,6 +59,7 @@ import { chipForIssues } from '../src/advice.js';
 import { debug } from '../src/debug.js';
 import { createArgs } from '../src/cli-args.js';
 import { readUpdateChip } from '../src/update-notice.js';
+import { readStarChip } from '../src/star-note.js';
 import { selectAgent } from '../src/agent.js';
 
 const selection = (() => {
@@ -87,12 +89,78 @@ function tableColor() {
 }
 
 // Subcommands this build knows how to run. Used only by the guard below.
+/**
+ * `--segments a,b,c` as a list, or null for the default order. One parser for
+ * the demo, the populated line and the no-session line, so `--segments harness`
+ * means the same chip set on each of them.
+ */
+function segmentsFromArgs() {
+  const raw = getArg('--segments');
+  return raw ? raw.split(',').map((s) => s.trim()).filter(Boolean) : null;
+}
+
 const KNOWN_SUBCOMMANDS = new Set([
   'last', 'brief', 'history', 'handoff', 'install', 'uninstall', 'mode', 'korean', 'cohesion',
   'doc2md', 'delegate', 'harness', 'route-scan', 'compact-window', 'update-check', 'upgrade',
   'seed', 'litellm-budget', 'profile-map', 'feedback', 'saved', 'cowork',
 ]);
 
+// Flags each entry path reads, collected from the hasFlag/getArg/numArg calls in
+// this file, src/statusline-mode.js, src/hook.cjs and the install/uninstall
+// commands. `value` flags take an argument (`--days 3` or `--days=3`); `bool`
+// flags do not. --agent is not listed: selectAgent() removes it before `args`
+// exists. Only the default path (report, statusline, hook management) and
+// install/uninstall are checked; every other subcommand parses its own arguments.
+// Keep these in step with the code that reads the flag: a flag read but not
+// listed is rejected, and a flag listed but never read is silently ignored again.
+const FLAG_SPECS = {
+  report: {
+    value: ['--format', '-f', '--project', '-p', '--days', '-d', '--hours', '--demo',
+      '--demo-cycle-sec', '--segments', '--exclude-session', '--threshold'],
+    bool: ['--statusline', '--verbose', '--no-verbose', '--compact', '--no-color', '--icon',
+      '--no-icon', '--text', '--narrow', '--no-timer', '--single-line', '--demo-label',
+      '--version', '-v', '--help', '-h', '--hook', '--hook-run', '--install-hook', '--uninstall-hook'],
+  },
+  install: { value: [], bool: ['--force', '--manual', '--yes', '--no-input', '--help', '-h'] },
+  // --yes and --no-input are the explicit spelling of "do not ask", and
+  // uninstall never asks, so they are accepted as no-ops.
+  uninstall: { value: [], bool: ['--purge', '--yes', '--no-input', '--help', '-h'] },
+};
+
+/** Which spec applies to this invocation, or null for a subcommand that parses its own arguments. */
+function flagSpecFor(first) {
+  if (!first || first.startsWith('-')) return FLAG_SPECS.report;
+  return FLAG_SPECS[first] || null;
+}
+
+/**
+ * The flags in `argv` that `spec` does not list. A value flag swallows the next
+ * token the way getArg() does, so `--exclude-session --x` reads `--x` as a path,
+ * not as a flag, and both `--days 3` and `--days=3` are understood. A bool flag
+ * written `--no-color=1` is reported too: hasFlag() compares whole tokens, so
+ * that form was never honoured. Everything after a bare `--` is not a flag.
+ *
+ * @returns {string[]} the offending tokens as typed
+ */
+function findUnknownFlags(argv, spec) {
+  const value = new Set(spec.value);
+  const bool = new Set(spec.bool);
+  const unknown = [];
+  for (let i = 0; i < argv.length; i++) {
+    const tok = argv[i];
+    if (tok === '--') break;
+    if (tok.length < 2 || !tok.startsWith('-')) continue;
+    const eq = tok.indexOf('=');
+    const name = eq === -1 ? tok : tok.slice(0, eq);
+    if (value.has(name)) {
+      if (eq === -1) i++;
+    } else if (!bool.has(name) || eq !== -1) {
+      unknown.push(tok);
+    }
+  }
+  return unknown;
+}
+
 const USAGE = `sprag — Claude Code and Codex agent harness
 
 Usage:
@@ -171,6 +239,34 @@ async function main() {
     return;
   }
 
+  // Refuse what this build cannot honour, before anything is scanned or written.
+  // An unknown first word used to fall into the 30-day report, and an unknown
+  // flag was dropped without a word: `sprag install --dry-run` ran the real
+  // install and rewrote settings.json. Exit 2 is the usage-error code.
+  if (args[0] && !args[0].startsWith('-') && !KNOWN_SUBCOMMANDS.has(args[0])) {
+    console.error(`Unknown command: ${args[0]}`);
+    console.error('Run `sprag --help` for the list of commands.');
+    process.exitCode = 2;
+    return;
+  }
+  const flagSpec = flagSpecFor(args[0]);
+  const unknownFlags = flagSpec ? findUnknownFlags(args, flagSpec) : [];
+  if (unknownFlags.length > 0) {
+    // The statusline and the PostToolUse hook run from a fixed command in
+    // settings.json, and a typo or a flag from a newer release there must not
+    // blank the line or fail the hook. Warn and carry on; every other caller is
+    // a person at a prompt who is better told.
+    const lenient = hasFlag('--statusline') || getArg('--format') === 'statusline' || hasFlag('--hook-run');
+    if (lenient) {
+      for (const f of unknownFlags) console.error(`Warning: Unknown option: ${f} (ignored)`);
+    } else {
+      for (const f of unknownFlags) console.error(`Unknown option: ${f}`);
+      console.error('Run `sprag --help` for usage.');
+      process.exitCode = 2;
+      return;
+    }
+  }
+
   // Subcommand: last — print the most recent warning + how to handle it.
   // Designed for the auto-trigger skill so the user immediately sees
   // "what just fired and how to fix it" without having to read the whole
@@ -346,56 +442,9 @@ async function main() {
   }
 
   // Subcommand: litellm-budget · LiteLLM 게이트웨이 키의 max_budget/spend 조회.
-  //   sprag litellm-budget            # 캐시된 예산을 게이지·금액으로 출력
-  //   sprag litellm-budget --json     # 캐시 원본 JSON 출력
-  //   sprag litellm-budget --refresh  # 지금 프록시에 물어봄 (detached 자식이 사용)
+  //   sprag litellm-budget [--json | --refresh]
   if (args[0] === 'litellm-budget') {
-    const { gatewayBase, readBudgetState, refreshBudgetState, formatBudgetReport, resolveKey } =
-      await import('../src/litellm-budget.js');
-    const quiet = hasFlag('--quiet');
-    if (hasFlag('--refresh')) {
-      try {
-        // apiKeyHelper 가 토큰 수명(TTL)을 소유합니다. 헬퍼를 한 번만 불러 그
-        // 키를 예산 갱신과 게이트웨이 모델맵 갱신 양쪽에 재사용합니다. 갱신
-        // 경로마다 resolveKey() 를 다시 부르면 사본을 만드는 셈이 되고, 헬퍼
-        // 호출 횟수도 그만큼 늘어납니다.
-        const key = resolveKey();
-        let next = null;
-        if (key) {
-          next = await refreshBudgetState(process.env, fetch, key);
-          const { maybeRefreshGatewayModelMap } = await import('../src/litellm-models.js');
-          await maybeRefreshGatewayModelMap({ base: gatewayBase(), key });
-        }
-        if (!quiet) console.log(JSON.stringify(next, null, 2));
-      } catch (e) {
-        debug('litellm-budget:refresh', e);
-        if (!quiet) console.error(`litellm-budget refresh failed: ${e.message}`);
-        process.exitCode = 1;
-      }
-      return;
-    }
-    // 읽기 경로는 캐시만 보므로 키를 요구하지 않습니다 (apiKeyHelper 환경 배려).
-    const base = gatewayBase();
-    if (!base) {
-      console.log('게이트웨이가 감지되지 않았습니다 (ANTHROPIC_BASE_URL 필요).');
-      return;
-    }
-    const state = readBudgetState();
-    if (hasFlag('--json')) {
-      console.log(JSON.stringify(state, null, 2));
-      return;
-    }
-    if (state.base !== base || state.maxBudget === undefined) {
-      console.log('예산 캐시가 비어 있습니다. `sprag litellm-budget --refresh` 로 먼저 조회하십시오.');
-      return;
-    }
-    // Same resolver the statusline uses: this report draws a gauge too, and a
-    // glyph the terminal's font lacks garbles here exactly as it does there.
-    const { resolveLabelMode } = await import('../src/statusline-mode.js');
-    const { statuslineDefaults } = await import('../src/config.js');
-    const { mode: labelMode } = resolveLabelMode({ hasFlag, cfg: statuslineDefaults() });
-    for (const line of formatBudgetReport(state, new Date(), labelMode)) console.log(line);
-    return;
+    return (await import('../src/commands/litellm-budget.js')).run({ hasFlag });
   }
 
   // Subcommand: profile-map · LiteLLM 게이트웨이의 프로파일 ID → 모델 별칭
@@ -484,10 +533,7 @@ async function main() {
       : (hasFlag('--no-verbose') || hasFlag('--compact') ? false : cfg.verbose);
     const showTimer = hasFlag('--no-timer') ? false : cfg.timer;
     const colorOk = !hasFlag('--no-color') && !process.env.NO_COLOR && cfg.color;
-    const segmentsArg = getArg('--segments');
-    const segments = segmentsArg
-      ? segmentsArg.split(',').map((s) => s.trim()).filter(Boolean)
-      : null;
+    const segments = segmentsFromArgs();
     const out = formatReport(data, {
       color: colorOk,
       verbose: isVerbose,
@@ -591,8 +637,8 @@ async function main() {
       const { withBaseStatusline } = await import('../src/statusline-base.js');
       console.log(withBaseStatusline(formatNoSession(
         { caps, model, effort, windowLabel, version: PKG_VERSION, update: readUpdateChip(PKG_VERSION) },
-        { color: colorOk, mode: labelMode },
-      )));
+        { color: colorOk, mode: labelMode, segments: segmentsFromArgs() },
+      ), { input: readStdinRaw() }));
       return;
     }
     // JSON mode stays JSON. A caller that asked for machine-readable output
@@ -768,12 +814,13 @@ async function main() {
   // 이미 파싱한 세션을 재사용하고, 사용자가 창을 줄여 둔 경우(mode 1d 등)에만
   // 월초까지 다시 파싱한다. 파싱 결과는 세션 캐시가 받아 주므로 싸다.
   let monthSpendInfo = null;
+  let monthSessions = null;
   if (isStatusline) {
     try {
       const { monthSpend, monthStartMs } = await import('../src/month-spend.js');
       const since = monthStartMs();
       const daysNeeded = (Date.now() - since) / 86400000;
-      const monthSessions = days >= daysNeeded
+      monthSessions = days >= daysNeeded
         ? sessions
         : await parseAllSessions({ days: Math.max(1, Math.ceil(daysNeeded)), projectFilter, sinceMs: since });
       // 월 경계에 걸친 세션은 월초 이후 요청만 남긴다. 그러지 않으면 1일 자정을
@@ -784,6 +831,22 @@ async function main() {
     }
   }
 
+  // 모델별 사용 비중: `sprag saved` 와 같은 기간(라우팅 초기화 기록, 없으면 월초)의
+  // 비용 기준 분포. 이미 파싱한 월간 세션을 재사용한다. 실패하면 칩만 빠진다.
+  let modelShare = null;
+  if (isStatusline) {
+    try {
+      const { statuslineDefaults } = await import('../src/config.js');
+      if (statuslineDefaults().modelShare) {
+        const { loadModelShare } = await import('../src/model-share.js');
+        const { userDataDir } = await import('../src/paths.js');
+        modelShare = await loadModelShare({ dir: userDataDir(), env: process.env, projectFilter, monthSessions: monthSessions || undefined });
+      }
+    } catch (e) {
+      debug('model-share', e);
+    }
+  }
+
   // Rolling week/month/lifetime totals from the delegation ledger — the
   // statusline's headline line. Falls back to null (chip hidden) on any error.
   // A lookup, never a scan: the statusline re-renders every few seconds and a
@@ -878,8 +941,14 @@ async function main() {
     options: { days, windowHours, windowLabel, version: PKG_VERSION },
     // Cached-only; the background refresh it may trigger lands on a later render.
     update: format === 'statusline' ? readUpdateChip(PKG_VERSION) : null,
+    // The totals are already in hand above; passing them spares a second read of
+    // both ledgers on every render.
+    star: format === 'statusline'
+      ? readStarChip({ savedUsd: delegationSaved + (Number(doc2mdTotals?.total) || 0) })
+      : null,
     lastActivity,
     monthSpend: monthSpendInfo,
+    modelShare,
     spikeReport,
     contextWindow,
     ctxLive,
@@ -922,10 +991,7 @@ async function main() {
     const colorOk =
       !hasFlag('--no-color') && !process.env.NO_COLOR && cfg.color;
 
-    const segmentsArg = getArg('--segments');
-    const segments = segmentsArg
-      ? segmentsArg.split(',').map((s) => s.trim()).filter(Boolean)
-      : null;
+    const segments = segmentsFromArgs();
     output = formatReport(data, {
       color: colorOk,
       verbose: isVerbose,
@@ -938,13 +1004,35 @@ async function main() {
       singleLine: hasFlag('--single-line'),
     });
   } else {
+    // The first screen is the pitch: what share of recent work a cheaper model
+    // could take. The scan is local and writes only sprag's own cache file;
+    // --project skips it because the scan covers all projects, not one.
+    let routing = null;
+    if (!projectFilter && process.env.CTS_NO_ROUTE_SCAN !== '1') {
+      try {
+        const rs = await import('../src/route-scan.js');
+        let cache = rs.readRouteScan();
+        if (!cache) {
+          process.stderr.write('Scanning for delegation candidates (first run)...\n');
+          cache = await rs.runRouteScan({ days: 14 });
+        }
+        routing = {
+          days: cache.days,
+          total: cache.totalEpisodes,
+          easy: cache.easyEpisodes,
+          scannedAt: cache.scannedAt,
+          candidates: rs.openCandidates(cache).slice(0, 3),
+        };
+      } catch (e) { debug('report:routing', e); }
+    }
     const { formatReport } = await import('../src/formatters/table.js');
-    output = formatReport(data, { color: tableColor() });
+    output = formatReport({ ...data, routing }, { color: tableColor() });
   }
 
   if (format === 'statusline') {
     const { withBaseStatusline } = await import('../src/statusline-base.js');
-    output = withBaseStatusline(output);
+    // The payload was read above; the base gets the same text, not a second read.
+    output = withBaseStatusline(output, { input: readStdinRaw() });
   }
   console.log(output);
 }

package/docs/CODEX.ko.md

@@ -38,6 +38,38 @@ macOS zsh 환경에서는 설치가 tmux 설치 여부를 먼저 확인합니다
 `sprag panel auto off --agent codex`로 끈 설정은 재설치해도 유지합니다.
 패널 실행 여부는 `sprag panel doctor --agent codex`로 확인하십시오.
 
+## 명령 한눈에 보기
+
+명령의 기본 대상은 Claude Code입니다. `--agent codex`를 붙이면 Codex를 고릅니다.
+
+```sh
+npm i -g sprag-cli --ignore-scripts  # Claude Code를 건드리지 않는 Codex 전용 설치
+sprag install --agent codex
+sprag --agent codex --days 7
+sprag panel --agent codex  # 별도 터미널에서 실시간 패널 실행
+sprag --statusline --agent codex --text
+sprag doctor --agent codex  # 문제가 생겼을 때만
+sprag route-scan --agent codex
+sprag seed --agent codex
+```
+
+설치 후 Codex의 `/hooks`에서 새 훅을 검토하고 신뢰해야 실행됩니다. Codex가 요구하는
+절차입니다. Codex 기본 상태줄은 셸 명령을 실행하지 않으므로, Sprag는 터미널 상태줄과 패널을
+따로 제공합니다. 기능별 지원 여부는 `sprag capabilities --agent codex`로 확인하십시오.
+
+## Claude Code와 Codex 비교
+
+| 기능 | Claude Code | Codex |
+|---|---|---|
+| 세션 지침 | `CLAUDE.md`와 훅 | `AGENTS.md`와 기본 훅 |
+| 실시간 상태 | 기본 상태줄에 명령 등록 | 별도 패널 또는 tmux 구성 |
+| 규칙 후보 | Claude 기록과 모델 등급 프리셋 | Codex 기록과 호환 래칫 프리셋 |
+| 모델 위임 | Haiku·Sonnet 등급 규칙 | 공급자 모델 ID와 범위별 규칙 |
+| 위임 원장 | Claude 실행별 예상 차액 | LiteLLM 단가와 하위 실행별 예상 차액 |
+
+두 연동을 함께 설치할 수 있습니다. `--agent codex`를 붙이지 않으면 기존 Claude 동작을 유지합니다.
+README의 금액 수치는 Claude Code 세션 기록에서 나온 값이며 Codex 벤치마크가 아닙니다.
+
 ## 지원 기능
 
 | 기능 | Codex 동작 |

package/docs/CODEX.md

@@ -72,6 +72,40 @@ fails, the preference stays unchanged. Review new or changed definitions in
 `/hooks`; registration does not grant trust. Turning a feature off keeps the
 shared hooks needed by other features.
 
+## Command Quick Reference
+
+Commands default to Claude Code. Add `--agent codex` to select Codex.
+
+```sh
+npm i -g sprag-cli --ignore-scripts  # Codex-only install, leaves Claude Code alone
+sprag install --agent codex
+sprag --agent codex --days 7
+sprag panel --agent codex  # live companion in a separate terminal
+sprag --statusline --agent codex --text
+sprag doctor --agent codex  # troubleshooting only
+sprag route-scan --agent codex
+sprag seed --agent codex
+```
+
+Review and trust the new hooks in Codex's `/hooks` menu; Codex requires that
+step. The native Codex footer does not accept shell commands, so Sprag provides
+a terminal statusline and a panel instead. Run `sprag capabilities --agent codex`
+for the support matrix.
+
+## Claude Code And Codex Compared
+
+| Workflow | Claude Code | Codex |
+|---|---|---|
+| Session instructions | `CLAUDE.md` and hooks | `AGENTS.md` and native hooks |
+| Live telemetry | Native statusline command | Companion panel or tmux layout |
+| Rule candidates | Claude transcripts and tier presets | Codex rollouts and compatible ratchet presets |
+| Model routing | Haiku/Sonnet tier rules | Explicit provider model IDs and scoped rules |
+| Routing ledger | Claude run estimates | Attributed child estimates with LiteLLM prices |
+
+Both integrations coexist. Commands without `--agent codex` retain Claude behavior.
+The dollar figures in the README come from Claude Code sessions, not from a Codex
+benchmark.
+
 ## Supported Workflows
 
 | Feature | Codex behavior |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sprag-cli",
-  "version": "3.67.0",
-  "description": "Lower your Claude Code bill without changing how you work: simple tasks go to cheaper models, documents go in as compact Markdown, and the statusline shows spend and savings live. Works with Codex too.",
+  "version": "3.69.0",
+  "description": "Model-delegation router for Claude Code and Codex: lookups, checks and test runs go to cheaper models, documents go in as compact Markdown, and a live statusline shows spend and savings.",
   "type": "module",
   "bin": {
     "sprag": "bin/cli.js",
@@ -34,7 +34,7 @@
     "NOTICE"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "keywords": [
     "claude-code",
@@ -49,10 +49,21 @@
     "claude-code-statusline",
     "statusline",
     "model-routing",
+    "model-router",
+    "model-delegation",
+    "llm-router",
+    "claude-code-router",
     "subagent",
     "prompt-caching",
     "haiku",
-    "cli"
+    "cli",
+    "token",
+    "tokens",
+    "cost",
+    "llm-cost",
+    "cost-optimization",
+    "openai-codex",
+    "pptx-to-markdown"
   ],
   "license": "Apache-2.0",
   "repository": {

package/src/{codex-brief.js → codex/brief.js}

@@ -1,13 +1,13 @@
 import { createHash } from 'node:crypto';
 import { readFileSync, mkdirSync, readdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { codexUserDir } from './agent.js';
-import { userDataDir } from './paths.js';
-import { writeViaTmp } from './state-file.js';
-import { readCodexSnapshot } from './codex-parser.js';
-import { loadCodexModelRules } from './codex-delegation.js';
-import { loadCodexLedger } from './codex-ledger.js';
-import { codexRulesInReview, codexSharedRuleHealth } from './codex-rule-health.js';
+import { codexUserDir } from '../agent.js';
+import { userDataDir } from '../paths.js';
+import { writeViaTmp } from '../state-file.js';
+import { readCodexSnapshot } from './parser.js';
+import { loadCodexModelRules } from './delegation.js';
+import { loadCodexLedger } from './ledger.js';
+import { codexRulesInReview, codexSharedRuleHealth } from './rule-health.js';
 
 const RESET_TOLERANCE_S = 300;
 const hash = (value) => createHash('sha256').update(value).digest('hex');

package/src/{codex-budget.js → codex/budget.js}

@@ -3,8 +3,8 @@ import { join } from 'node:path';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { parse } from 'smol-toml';
-import { codexUserDir } from './agent.js';
-import { pickBudgetSource } from './litellm-budget.js';
+import { codexUserDir } from '../agent.js';
+import { pickBudgetSource } from '../litellm-budget.js';
 
 const run = promisify(execFile);
 

package/src/{codex-cache-policy.js → codex/cache-policy.js}

@@ -2,15 +2,15 @@ import { readFileSync, mkdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { createHash, randomUUID } from 'node:crypto';
 import { parse } from 'smol-toml';
-import { codexUserDir } from './agent.js';
-import { userDataDir } from './paths.js';
-import { writeViaTmp } from './state-file.js';
-import { codexBudgetProvider, codexProviderKey } from './codex-budget.js';
-import { codexCachePolicy } from './codex-cache.js';
-import { PRICE_MAX_AGE_MS, gatewayPrices } from './gateway-prices.js';
-import { OPENAI_LIST_PRICES, OPENAI_PRICES_CHECKED_AT } from './openai-prices.js';
-
-export { PRICE_MAX_AGE_MS, rate, deploymentPrice, gatewayPrices, codexRunCost } from './gateway-prices.js';
+import { codexUserDir } from '../agent.js';
+import { userDataDir } from '../paths.js';
+import { writeViaTmp } from '../state-file.js';
+import { codexBudgetProvider, codexProviderKey } from './budget.js';
+import { codexCachePolicy } from './cache.js';
+import { PRICE_MAX_AGE_MS, gatewayPrices } from '../gateway-prices.js';
+import { OPENAI_LIST_PRICES, OPENAI_PRICES_CHECKED_AT } from '../openai-prices.js';
+
+export { PRICE_MAX_AGE_MS, rate, deploymentPrice, gatewayPrices, codexRunCost } from '../gateway-prices.js';
 
 export const CACHE_POLICY_MAX_AGE_MS = 300000;
 const OPENAI_POLICY = 'https://developers.openai.com/api/docs/guides/prompt-caching#cache-lifetime';

package/src/{codex-delegation-diagnostics.js → codex/delegation-diagnostics.js}

@@ -2,8 +2,8 @@ import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { parse } from 'smol-toml';
-import { codexUserDir, codexModelName } from './agent.js';
-import { codexDelegationStatus } from './codex-ledger.js';
+import { codexUserDir, codexModelName } from '../agent.js';
+import { codexDelegationStatus } from './ledger.js';
 
 /** Local introspection only. A CLI feature flag cannot prove a model received a tool. */
 export function codexDelegationDiagnostics({ home = codexUserDir(), model = codexModelName({ home }), sessionId, dir,

package/src/{codex-delegation.js → codex/delegation.js}

@@ -2,17 +2,17 @@ import { readFileSync, readdirSync, mkdirSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { parse } from 'smol-toml';
-import { userDataDir } from './paths.js';
-import { writeViaTmp } from './state-file.js';
-import { codexUserDir, codexProviderName } from './agent.js';
-import { categorize, ESCALATE_RE, EDIT_RE } from './route-scan.js';
-import { looksPasted } from './route-inject.js';
-import { newRouteId, recordCodexDelegation } from './codex-ledger.js';
-import { readCodexTailLines } from './codex-parser.js';
-import { loadConfig } from './config.js';
-import { loadSharedModelRules, sharedModelRulesForProject, sharedRuleBounds, SHARED_RULE_TIERS } from './shared-model-rules.js';
-import { codexPriceBook, readCodexPrices } from './codex-cache-policy.js';
-import { codexRunCost } from './gateway-prices.js';
+import { userDataDir } from '../paths.js';
+import { writeViaTmp } from '../state-file.js';
+import { codexUserDir, codexProviderName } from '../agent.js';
+import { categorize, ESCALATE_RE, EDIT_RE } from '../route-scan.js';
+import { looksPasted } from '../route-inject.js';
+import { newRouteId, recordCodexDelegation } from './ledger.js';
+import { readCodexTailLines } from './parser.js';
+import { loadConfig } from '../config.js';
+import { loadSharedModelRules, sharedModelRulesForProject, sharedRuleBounds, SHARED_RULE_TIERS } from '../shared-model-rules.js';
+import { codexPriceBook, readCodexPrices } from './cache-policy.js';
+import { codexRunCost } from '../gateway-prices.js';
 
 export const CODEX_ROUTE_CATEGORIES = ['paste', 'translate', 'explore', 'read', 'check', 'run'];
 const MARKER = '<!-- sprag:codex:delegation -->';

package/src/{codex-doc2md-ledger.js → codex/doc2md-ledger.js}

@@ -1,11 +1,11 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { mkdirSync, readdirSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import { extname, join, resolve } from 'node:path';
-import { codexUserDir } from './agent.js';
-import { userDataDir } from './paths.js';
-import { writeViaTmp } from './state-file.js';
-import { readResetMarks, isBeforeReset } from './saved-reset.cjs';
-import { codexPriceBook, readCodexPrices } from './codex-cache-policy.js';
+import { codexUserDir } from '../agent.js';
+import { userDataDir } from '../paths.js';
+import { writeViaTmp } from '../state-file.js';
+import { readResetMarks, isBeforeReset } from '../saved-reset.cjs';
+import { codexPriceBook, readCodexPrices } from './cache-policy.js';
 
 const hash = (value) => createHash('sha256').update(value).digest('hex');
 const ledgerDir = ({ home = codexUserDir(), dir = userDataDir() } = {}) => join(dir, 'codex-doc2md', hash(resolve(home)));

package/src/{codex-doc2md.js → codex/doc2md.js}

@@ -2,12 +2,12 @@ import { createRequire } from 'node:module';
 import { realpathSync, readFileSync, writeFileSync, renameSync, rmSync, openSync, readSync, closeSync } from 'node:fs';
 import { basename, dirname, resolve } from 'node:path';
 import { randomUUID } from 'node:crypto';
-import { recordCodexDocument } from './codex-doc2md-ledger.js';
-import { readCodexSnapshot } from './codex-parser.js';
+import { recordCodexDocument } from './doc2md-ledger.js';
+import { readCodexSnapshot } from './parser.js';
 
 const require = createRequire(import.meta.url);
-const doc2md = require('./doc2md.cjs');
-const lint = require('./korean-lint.cjs');
+const doc2md = require('../doc2md.cjs');
+const lint = require('../korean-lint.cjs');
 const shellTools = new Set(['Bash', 'exec_command', 'shell_command', 'shell']);
 
 /** Hook identity, never the user's default model or another project's session. */

package/src/{codex-doctor.js → codex/doctor.js}

@@ -1,10 +1,10 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { parse } from 'smol-toml';
-import { codexUserDir } from './agent.js';
-import { codexHookStatus } from './codex-installer.js';
-import { createPanelReader } from './codex-panel.js';
-import { panelHealth } from './codex-panel-state.js';
+import { codexUserDir } from '../agent.js';
+import { codexHookStatus } from './installer.js';
+import { createPanelReader } from './panel.js';
+import { panelHealth } from './panel-state.js';
 
 export const CODEX_CAPABILITIES = [
   { feature: 'statusline', support: 'supported', command: 'sprag --statusline --agent codex', note: 'Local terminal output; native footer accepts only Codex item identifiers.' },

package/src/{codex-harness.js → codex/harness.js}

@@ -1,11 +1,11 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { homedir } from 'node:os';
-import { codexUserDir } from './agent.js';
-import { loadConfig } from './config.js';
-import { koreanStyleEnabled, koreanStyleInjection } from './korean-style.js';
-import { codexToolEvents, codexLegacyToolEvent, readCodexTailLines, forkedCopyFilter } from './codex-parser.js';
-import { implementationDelegationRule } from './implementation-delegation.js';
+import { codexUserDir } from '../agent.js';
+import { loadConfig } from '../config.js';
+import { koreanStyleEnabled, koreanStyleInjection } from '../korean-style.js';
+import { codexToolEvents, codexLegacyToolEvent, readCodexTailLines, forkedCopyFilter } from './parser.js';
+import { implementationDelegationRule } from '../implementation-delegation.js';
 
 export const CODEX_BEGIN = '<!-- sprag:codex:harness:begin -->';
 export const CODEX_END = '<!-- sprag:codex:harness:end -->';