@event4u/agent-config 1.22.0 → 1.23.0

package/scripts/check_council_references.py

@@ -34,6 +34,8 @@ import sys
 from pathlib import Path
 from typing import Iterable
 
+QUIET = "--quiet" in sys.argv
+
 ROOT = Path(".")
 
 # A specific file inside a council dir: must end with .md or .json,
@@ -124,7 +126,8 @@ def main() -> int:
             violations.append((path, ln, ref))
 
     if not violations:
-        print("✅  No forbidden council references in durable artefacts.")
+        if not QUIET:
+            print("✅  No forbidden council references in durable artefacts.")
         return 0
 
     print(f"❌  {len(violations)} forbidden council reference(s):\n")

package/scripts/check_iron_law_prominence.py

@@ -111,6 +111,7 @@ def main() -> int:
         help="Files or directories to scan (default: .agent-src.uncompressed/rules)",
     )
     parser.add_argument("--format", choices=["text", "json"], default="text")
+    parser.add_argument("--quiet", action="store_true", help="Only print on failure")
     args = parser.parse_args()
 
     targets = _resolve_targets(args.paths)
@@ -125,7 +126,8 @@ def main() -> int:
         print(json.dumps([asdict(v) for v in all_violations], indent=2, ensure_ascii=False))
     else:
         if not all_violations:
-            print(f"✅  Iron Law prominence clean ({len(targets)} file(s) scanned).")
+            if not args.quiet:
+                print(f"✅  Iron Law prominence clean ({len(targets)} file(s) scanned).")
         else:
             print(f"❌  {len(all_violations)} Iron-Law prominence violation(s):\n")
             for v in all_violations:

package/scripts/check_md_language.py

@@ -124,6 +124,7 @@ def main() -> int:
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument("paths", nargs="+", help="One or more .md files to scan")
     parser.add_argument("--format", choices=["text", "json"], default="text")
+    parser.add_argument("--quiet", action="store_true", help="Only print on failure")
     args = parser.parse_args()
 
     all_violations: list[Violation] = []
@@ -141,7 +142,8 @@ def main() -> int:
         print(json.dumps([asdict(v) for v in all_violations], indent=2, ensure_ascii=False))
     else:
         if not all_violations:
-            print("✅  No German content detected.")
+            if not args.quiet:
+                print("✅  No German content detected.")
         else:
             print(f"❌  {len(all_violations)} violation(s) found:\n")
             for v in all_violations:

package/scripts/check_memory_proposal.py

@@ -152,6 +152,7 @@ def main() -> int:
     grp.add_argument("--intake-id", help="Promote an intake record by id")
     grp.add_argument("--proposal", help="Promote a proposal YAML file")
     ap.add_argument("--format", choices=["text", "json"], default="text")
+    ap.add_argument("--quiet", action="store_true", help="Only print on failure")
     args = ap.parse_args()
     if args.intake_id:
         record = _find_intake(args.intake_id)
@@ -172,7 +173,8 @@ def main() -> int:
             for f in failures:
                 print(f"  🔴 {f}")
         else:
-            print(f"✅  {source} — gate passed")
+            if not args.quiet:
+                print(f"✅  {source} — gate passed")
     return 1 if failures else 0
 
 

package/scripts/check_public_catalog_links.py

@@ -27,6 +27,8 @@ import re
 import sys
 from pathlib import Path
 
+QUIET = "--quiet" in sys.argv
+
 ROOT = Path(__file__).resolve().parent.parent
 CATALOG = ROOT / "docs" / "catalog.md"
 PACKAGE_JSON = ROOT / "package.json"
@@ -95,7 +97,8 @@ def main() -> int:
 
     total_violations = len(forbidden) + len(missing) + len(unshipped)
     if not total_violations:
-        print(f"✅  docs/catalog.md — all links resolve to shipped surfaces.")
+        if not QUIET:
+            print(f"✅  docs/catalog.md — all links resolve to shipped surfaces.")
         return 0
 
     print(f"❌  docs/catalog.md — {total_violations} violation(s):")

package/scripts/check_reply_consistency.py

@@ -21,6 +21,8 @@ import re
 import sys
 from pathlib import Path
 
+QUIET = "--quiet" in sys.argv
+
 OPTION_LINE_RE = re.compile(r"^\s*>?\s*(\d+)\.\s+\S")
 REC_LINE_RE = re.compile(
     r"(?:Recommendation|Empfehlung)\s*:\s*(\d+)\b", re.IGNORECASE
@@ -108,7 +110,8 @@ def cmd_scan_dir(root: Path) -> int:
             print(f"  🔴 {path}:{line} — inline-tag — {snippet}", file=sys.stderr)
         print(f"\n❌  {len(violations)} legacy-pattern violation(s)", file=sys.stderr)
         return 6
-    print(f"✅  No legacy (recommended) tags found under {root}")
+    if not QUIET:
+        print(f"✅  No legacy (recommended) tags found under {root}")
     return 0
 
 
@@ -121,6 +124,8 @@ def main(argv: list[str] | None = None) -> int:
     p.add_argument("--strict", action="store_true",
                    help="numbered options REQUIRE recommendation line (rule 5)")
     p.add_argument("-v", "--verbose", action="store_true")
+    p.add_argument("--quiet", action="store_true",
+                   help="suppress success messages (P10.5)")
     args = p.parse_args(argv)
 
     if args.scan_dir:
@@ -130,7 +135,8 @@ def main(argv: list[str] | None = None) -> int:
     code, msg = validate(text, strict=args.strict)
     if code == 0:
         if args.verbose:
-            print(f"✅  {msg}")
+            if not QUIET:
+                print(f"✅  {msg}")
         return 0
     print(f"❌  [exit {code}] {msg}", file=sys.stderr)
     return code

package/scripts/check_roadmap_trackable.py

@@ -43,6 +43,8 @@ from update_roadmap_progress import (  # noqa: E402
     parse_frontmatter,
 )
 
+QUIET = "--quiet" in sys.argv
+
 ROADMAP_ROOT = Path("agents/roadmaps")
 
 
@@ -103,7 +105,8 @@ def main() -> int:
         )
         return 1
     count = len(find_active_roadmaps(ROADMAP_ROOT))
-    print(f"✅  {count} active roadmap(s) — all parseable, all phases have checkboxes.")
+    if not QUIET:
+        print(f"✅  {count} active roadmap(s) — all parseable, all phases have checkboxes.")
     return 0
 
 

package/scripts/compile_router.py

@@ -17,8 +17,18 @@ from pathlib import Path
 ROOT = Path(__file__).resolve().parent.parent
 RULES_DIR = ROOT / ".agent-src.uncompressed" / "rules"
 OUT_PATH = ROOT / "router.json"
+SETTINGS_PATH = ROOT / ".agent-settings.yml"
 SCHEMA_VERSION = 1
 
+# Compile-time rule toggles. Maps rule-id → settings predicate.
+# Rule omitted from router.json when predicate returns False.
+# Per road-to-token-frugality § Phase 8.2 — caveman.speak compile-time toggle.
+COMPILE_TIME_TOGGLES = {
+    "caveman-speak": lambda s: bool(
+        s.get("caveman", {}).get("enabled", True)
+    ) and bool(s.get("caveman", {}).get("speak", True)),
+}
+
 # Maps legacy tier values to the router-canonical names. See
 # docs/contracts/rule-router.md § Backward compatibility.
 LEGACY_TIER_MAP = {
@@ -89,7 +99,21 @@ def _normalize_trigger(item) -> dict | None:
     return {keys[0]: str(item[keys[0]])}
 
 
+def _load_settings() -> dict:
+    """Read .agent-settings.yml for compile-time toggles. Stdlib-only fallback."""
+    if not SETTINGS_PATH.exists():
+        return {}
+    text = SETTINGS_PATH.read_text(encoding="utf-8")
+    try:
+        import yaml  # type: ignore
+        data = yaml.safe_load(text) or {}
+        return data if isinstance(data, dict) else {}
+    except ImportError:
+        return {}
+
+
 def _collect(rules_dir: Path) -> dict:
+    settings = _load_settings()
     kernel: list[str] = []
     tiered: dict[str, list[dict]] = {"tier-1": [], "tier-2": []}
     for path in sorted(rules_dir.glob("*.md")):
@@ -97,6 +121,9 @@ def _collect(rules_dir: Path) -> dict:
         if not fm:
             continue
         rule_id = path.stem
+        if rule_id in COMPILE_TIME_TOGGLES:
+            if not COMPILE_TIME_TOGGLES[rule_id](settings):
+                continue
         rule_type = str(fm.get("type", "auto"))
         tier = _resolve_tier(rule_type, fm.get("tier", ""))
         if tier not in ALLOWED_TIERS:

package/scripts/compress.py

@@ -26,6 +26,9 @@ import shutil
 import sys
 from pathlib import Path
 
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from _lib.script_output import info, success, flush_summary, resolve_level  # noqa: E402
+
 PROJECT_ROOT = Path(__file__).resolve().parent.parent
 SOURCE_DIR = PROJECT_ROOT / ".agent-src.uncompressed"
 TARGET_DIR = PROJECT_ROOT / ".agent-src"
@@ -479,11 +482,11 @@ def generate_rule_symlinks() -> int:
         if tool_count != source_count:
             print(f"  ⚠️  {tool_dir}: {tool_count} rules (expected {source_count})")
 
-    print(f"  ✅  Created {total} rule symlinks across {len(TOOL_DIRS)} tool directories ({source_count} rules each)")
+    info(f"  ✅  Created {total} rule symlinks across {len(TOOL_DIRS)} tool directories ({source_count} rules each)")
     return total
 
 
-def generate_windsurfrules() -> None:
+def generate_windsurfrules() -> int:
     """Generate .windsurfrules by concatenating all rules (no frontmatter).
     """
     rules = sorted([f.name for f in RULES_SOURCE.glob("*.md")])
@@ -496,7 +499,8 @@ def generate_windsurfrules() -> None:
 
     output = PROJECT_ROOT / ".windsurfrules"
     output.write_text("\n".join(parts) + "\n")
-    print(f"  ✅  Generated .windsurfrules ({len(rules)} rules)")
+    info(f"  ✅  Generated .windsurfrules ({len(rules)} rules)")
+    return len(rules)
 
 
 def generate_gemini_md() -> None:
@@ -505,7 +509,7 @@ def generate_gemini_md() -> None:
     if link.exists() or link.is_symlink():
         link.unlink()
     link.symlink_to("AGENTS.md")
-    print("  ✅  Created GEMINI.md → AGENTS.md symlink")
+    info("  ✅  Created GEMINI.md → AGENTS.md symlink")
 
 
 def _command_slug(source_file: Path) -> str:
@@ -531,12 +535,12 @@ def _iter_commands():
         yield source_file, _command_slug(source_file)
 
 
-def generate_claude_skills() -> None:
+def generate_claude_skills() -> int:
     """Create .claude/skills/ symlinks for ALL skills in .agent-src/skills/.
     """
     if not SKILLS_SOURCE.exists():
-        print("  ⚠️  .agent-src/skills/ not found — skipping skills")
-        return
+        print("  ⚠️  .agent-src/skills/ not found — skipping skills", file=sys.stderr)
+        return 0
 
     # All skill directories in .agent-src/skills/
     skills = sorted([d.name for d in SKILLS_SOURCE.iterdir() if d.is_dir()])
@@ -559,7 +563,8 @@ def generate_claude_skills() -> None:
         link.symlink_to(rel_target)
         count += 1
 
-    print(f"  ✅  Created {count} skill symlinks in .claude/skills/")
+    info(f"  ✅  Created {count} skill symlinks in .claude/skills/")
+    return count
 
 
 def extract_description_from_md(content: str) -> str:
@@ -573,7 +578,7 @@ def extract_description_from_md(content: str) -> str:
     return ""
 
 
-def generate_claude_commands() -> None:
+def generate_claude_commands() -> int:
     """Create .claude/skills/{slug}/SKILL.md symlinks for ALL Augment commands.
 
     Commands in .agent-src/commands/ are the single source of truth.
@@ -585,8 +590,8 @@ def generate_claude_commands() -> None:
     to `council-default` so directories never collide in `.claude/skills/`.
     """
     if not COMMANDS_SOURCE.exists():
-        print("  ⚠️  .agent-src/commands/ not found — skipping commands")
-        return
+        print("  ⚠️  .agent-src/commands/ not found — skipping commands", file=sys.stderr)
+        return 0
 
     CLAUDE_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
 
@@ -642,7 +647,8 @@ def generate_claude_commands() -> None:
         msg += f" ({skipped} skipped — same-name skill exists)"
     if removed_dirs:
         msg += f" ({removed_dirs} stale dirs removed)"
-    print(msg)
+    info(msg)
+    return count
 
 
 def generate_persona_symlinks() -> int:
@@ -676,20 +682,28 @@ def generate_persona_symlinks() -> int:
             link.symlink_to(target)
             total += 1
 
-    print(f"  ✅  Created {total} persona symlinks across {len(PERSONA_TOOL_DIRS)} tool directories ({len(personas)} personas each)")
+    info(f"  ✅  Created {total} persona symlinks across {len(PERSONA_TOOL_DIRS)} tool directories ({len(personas)} personas each)")
     return total
 
 
 def generate_tools() -> None:
     """Generate all tool-specific directories and files."""
-    print("🔧  Generating multi-agent tool directories...\n")
-    generate_rule_symlinks()
+    info("🔧  Generating multi-agent tool directories...\n")
+    rules = generate_rule_symlinks()
     generate_windsurfrules()
     generate_gemini_md()
-    generate_claude_skills()
-    generate_claude_commands()
-    generate_persona_symlinks()
-    print("\n✅  All tool directories generated")
+    skills = generate_claude_skills()
+    commands = generate_claude_commands()
+    personas = generate_persona_symlinks()
+    summary = (
+        f"✅  generate-tools — rules={rules} skills={skills} "
+        f"commands={commands} personas={personas}"
+    )
+    if resolve_level() == "verbose":
+        print(f"\n{summary}")
+    else:
+        success(summary)
+        flush_summary()
 
 
 # ── .augment/ projection ──────────────────────────────────────────────

package/scripts/cost/budget.mjs

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+// cost-budget — set / get / check the project's cost budget against
+// accumulated session spend in agents/cost-tracking/sessions.jsonl.
+//
+// Forked from ruvnet/ruflo plugins/ruflo-cost-tracker/scripts/budget.mjs.
+// Local-JSONL swap replaces the upstream `mcp__claude-flow__memory_store`
+// dependency. Budget config lives next to the sessions store as budget.json.
+//
+// Usage: node scripts/cost/budget.mjs {set <usd>|get|check}
+// Env: BUDGET_STORE, BUDGET_CONFIG, BUDGET_PERIOD={today|week|month|all}, BUDGET_QUIET=1
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+const STORE = process.env.BUDGET_STORE || 'agents/cost-tracking/sessions.jsonl';
+const CONFIG = process.env.BUDGET_CONFIG || 'agents/cost-tracking/budget.json';
+
+function loadConfig() {
+  if (!existsSync(CONFIG)) return null;
+  try { return JSON.parse(readFileSync(CONFIG, 'utf-8')); } catch { return null; }
+}
+
+function saveConfig(cfg) {
+  mkdirSync(dirname(CONFIG), { recursive: true });
+  writeFileSync(CONFIG, JSON.stringify(cfg, null, 2));
+}
+
+function loadSessions() {
+  if (!existsSync(STORE)) return [];
+  const out = [];
+  for (const line of readFileSync(STORE, 'utf-8').split('\n')) {
+    if (!line.trim()) continue;
+    try { out.push(JSON.parse(line)); } catch { /* skip malformed line */ }
+  }
+  return out;
+}
+
+function periodFilter(period) {
+  const now = Date.now();
+  const day = 24 * 3600 * 1000;
+  if (period === 'today') return (ts) => ts && new Date(ts).toDateString() === new Date().toDateString();
+  if (period === 'week')  return (ts) => ts && (now - new Date(ts).getTime()) < 7 * day;
+  if (period === 'month') return (ts) => ts && (now - new Date(ts).getTime()) < 30 * day;
+  return () => true;
+}
+
+function alertLevel(u) {
+  if (u >= 1.00) return { level: 'HARD_STOP', emoji: '🛑', threshold: 100 };
+  if (u >= 0.90) return { level: 'CRITICAL',  emoji: '🔴', threshold: 90 };
+  if (u >= 0.75) return { level: 'WARNING',   emoji: '🟠', threshold: 75 };
+  if (u >= 0.50) return { level: 'INFO',      emoji: '🟡', threshold: 50 };
+  return { level: 'OK', emoji: '🟢', threshold: 0 };
+}
+
+function recommendedAction(level) {
+  return ({
+    OK: 'within budget — no action.',
+    INFO: '50% consumed — log notification, no UX disruption.',
+    WARNING: '75% consumed — suggest /set-cost-profile balanced→minimal.',
+    CRITICAL: '90% consumed — recommend model downgrades, consider /set-cost-profile minimal.',
+    HARD_STOP: '100% consumed — halt non-essential work; review /cost:report before continuing.',
+  }[level]);
+}
+
+function cmdSet(args) {
+  const amount = parseFloat(args[0]);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    console.error('usage: budget.mjs set <usd-amount>  (positive number)');
+    process.exit(2);
+  }
+  const config = {
+    budget_usd: amount,
+    setAt: new Date().toISOString(),
+    thresholds: { info: 0.50, warning: 0.75, critical: 0.90, hard_stop: 1.00 },
+  };
+  saveConfig(config);
+  if (process.env.BUDGET_QUIET === '1') {
+    console.log(JSON.stringify(config));
+  } else {
+    console.log(`✓ Budget set: $${amount.toFixed(2)} (config: ${CONFIG})`);
+    console.log('  Alerts: 50% INFO · 75% WARNING · 90% CRITICAL · 100% HARD_STOP');
+  }
+}
+
+function cmdGet() {
+  const cfg = loadConfig();
+  if (process.env.BUDGET_QUIET === '1') {
+    console.log(JSON.stringify(cfg || { error: 'no budget configured' }));
+    return;
+  }
+  if (!cfg) {
+    console.log(`No budget configured (config: ${CONFIG}).`);
+    console.log('Set one with: node scripts/cost/budget.mjs set <usd>');
+    return;
+  }
+  console.log(`Budget: $${cfg.budget_usd?.toFixed(2)}  (set ${cfg.setAt})`);
+  console.log('Thresholds: 50/75/90/100%');
+}
+
+function cmdCheck() {
+  const cfg = loadConfig();
+  const period = process.env.BUDGET_PERIOD || 'all';
+  const filt = periodFilter(period);
+  const filtered = loadSessions().filter((r) => filt(r.capturedAt || r.endedAt));
+  const totalSpend = filtered.reduce((s, r) => s + (r.total_cost_usd || 0), 0);
+  if (!cfg || !Number.isFinite(cfg.budget_usd)) {
+    const out = { period, totalSpend, recordCount: filtered.length, error: 'no budget configured' };
+    if (process.env.BUDGET_QUIET === '1') return console.log(JSON.stringify(out));
+    console.log(`Period: ${period}`);
+    console.log(`Spent so far: $${totalSpend.toFixed(2)} across ${filtered.length} sessions`);
+    console.log('No budget set — run `node scripts/cost/budget.mjs set <usd>` to enable alerts.');
+    return;
+  }
+  const utilization = totalSpend / cfg.budget_usd;
+  const alert = alertLevel(utilization);
+  const out = {
+    period,
+    budget_usd: cfg.budget_usd,
+    spent_usd: totalSpend,
+    remaining_usd: Math.max(0, cfg.budget_usd - totalSpend),
+    utilization_pct: utilization * 100,
+    level: alert.level,
+    threshold: alert.threshold,
+    recommended_action: recommendedAction(alert.level),
+    sessionCount: filtered.length,
+  };
+  if (process.env.BUDGET_QUIET === '1') return console.log(JSON.stringify(out));
+  console.log(`# Budget check (period: ${period})\n`);
+  console.log('| Metric | Value |\n|---|---:|');
+  console.log(`| Budget | $${cfg.budget_usd.toFixed(2)} |`);
+  console.log(`| Spent | $${totalSpend.toFixed(2)} |`);
+  console.log(`| Remaining | $${out.remaining_usd.toFixed(2)} |`);
+  console.log(`| Utilization | ${out.utilization_pct.toFixed(1)}% |`);
+  console.log(`| Sessions counted | ${filtered.length} |`);
+  console.log(`| **Alert** | **${alert.emoji} ${alert.level}** |`);
+  console.log(`\nAction: ${out.recommended_action}`);
+  if (alert.level === 'HARD_STOP') process.exit(1);
+}
+
+function main() {
+  const [cmd, ...rest] = process.argv.slice(2);
+  switch (cmd) {
+    case 'set':   return cmdSet(rest);
+    case 'get':   return cmdGet();
+    case 'check': return cmdCheck();
+    default:
+      console.error('usage: budget.mjs {set <usd>|get|check}');
+      process.exit(2);
+  }
+}
+
+main();

package/scripts/cost/track.mjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+// cost-track — auto-capture token usage from a Claude Code session jsonl
+// and append a structured record to agents/cost-tracking/sessions.jsonl.
+//
+// Forked from ruvnet/ruflo plugins/ruflo-cost-tracker/scripts/track.mjs.
+// Local-JSONL swap replaces the upstream `mcp__claude-flow__memory_store`
+// dependency. Pricing constants are kept in sync with REFERENCE.md.
+//
+// Env:
+//   TRACK_CWD=<path>          override which project's sessions to scan
+//   TRACK_SESSION=<file>      pin to a specific session jsonl
+//   TRACK_OUT=<path>          also write the JSON summary to this path
+//   TRACK_DRY_RUN=1           skip the JSONL append
+//   TRACK_QUIET=1             suppress markdown summary
+//   TRACK_STORE=<path>        override (default: agents/cost-tracking/sessions.jsonl)
+
+import { readFileSync, writeFileSync, readdirSync, statSync, existsSync, mkdirSync, appendFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+
+const PROJECTS_DIR = join(homedir(), '.claude', 'projects');
+const DEFAULT_STORE = 'agents/cost-tracking/sessions.jsonl';
+
+// USD per 1M tokens.
+const PRICING = {
+  haiku:  { input: 0.25,  output: 1.25,  cache_write: 0.30,  cache_read: 0.03 },
+  sonnet: { input: 3.00,  output: 15.00, cache_write: 3.75,  cache_read: 0.30 },
+  opus:   { input: 15.00, output: 75.00, cache_write: 18.75, cache_read: 1.50 },
+};
+
+function modelTier(model) {
+  if (!model) return 'unknown';
+  const m = String(model).toLowerCase();
+  if (m.includes('haiku')) return 'haiku';
+  if (m.includes('sonnet')) return 'sonnet';
+  if (m.includes('opus')) return 'opus';
+  return 'unknown';
+}
+
+function costForUsage(tier, u) {
+  const p = PRICING[tier];
+  if (!p || !u) return 0;
+  return (u.input_tokens || 0) / 1e6 * p.input
+       + (u.output_tokens || 0) / 1e6 * p.output
+       + (u.cache_creation_input_tokens || 0) / 1e6 * p.cache_write
+       + (u.cache_read_input_tokens || 0) / 1e6 * p.cache_read;
+}
+
+function encodeProjectPath(cwd) { return cwd.replace(/\//g, '-'); }
+
+function findProjectDir(cwd) {
+  const c = join(PROJECTS_DIR, encodeProjectPath(cwd));
+  return existsSync(c) ? c : null;
+}
+
+function findActiveSession(dir) {
+  const e = readdirSync(dir).filter((f) => f.endsWith('.jsonl'))
+    .map((f) => ({ f, mtime: statSync(join(dir, f)).mtimeMs }))
+    .sort((a, b) => b.mtime - a.mtime);
+  return e[0] ? join(dir, e[0].f) : null;
+}
+
+function summarizeSession(jsonlPath) {
+  const lines = readFileSync(jsonlPath, 'utf-8').split('\n').filter(Boolean);
+  const byModel = {};
+  const byTier = { haiku: 0, sonnet: 0, opus: 0, unknown: 0 };
+  let messageCount = 0, totalCost = 0, firstTs = null, lastTs = null;
+  let sessionId = null, cwd = null;
+  for (const line of lines) {
+    let m; try { m = JSON.parse(line); } catch { continue; }
+    if (!sessionId && m.sessionId) sessionId = m.sessionId;
+    if (!cwd && m.cwd) cwd = m.cwd;
+    if (m.timestamp) {
+      if (!firstTs || m.timestamp < firstTs) firstTs = m.timestamp;
+      if (!lastTs || m.timestamp > lastTs) lastTs = m.timestamp;
+    }
+    if (m.type !== 'assistant' || !m.message?.usage) continue;
+    messageCount++;
+    const model = m.message.model || 'unknown';
+    const tier = modelTier(model);
+    const u = m.message.usage;
+    const cost = costForUsage(tier, u);
+    const slot = byModel[model] || { tier, input_tokens: 0, output_tokens: 0,
+      cache_creation_input_tokens: 0, cache_read_input_tokens: 0, messages: 0, cost_usd: 0 };
+    slot.input_tokens += u.input_tokens || 0;
+    slot.output_tokens += u.output_tokens || 0;
+    slot.cache_creation_input_tokens += u.cache_creation_input_tokens || 0;
+    slot.cache_read_input_tokens += u.cache_read_input_tokens || 0;
+    slot.messages++; slot.cost_usd += cost;
+    byModel[model] = slot; byTier[tier] += cost; totalCost += cost;
+  }
+  return { sessionId, cwd, startedAt: firstTs, endedAt: lastTs, messageCount,
+    byModel, byTier, total_cost_usd: totalCost, capturedAt: new Date().toISOString() };
+}
+
+function persistJsonl(summary, store) {
+  mkdirSync(dirname(store), { recursive: true });
+  appendFileSync(store, JSON.stringify(summary) + '\n');
+  return { ok: true, path: store };
+}
+
+function main() {
+  const targetCwd = process.env.TRACK_CWD || process.cwd();
+  const projectDir = findProjectDir(targetCwd);
+  if (!projectDir) {
+    console.error(`cost-track: no Claude Code project dir for cwd=${targetCwd}`);
+    console.error(`looked under ${PROJECTS_DIR}/${encodeProjectPath(targetCwd)}`);
+    process.exit(2);
+  }
+  const sessionPath = process.env.TRACK_SESSION || findActiveSession(projectDir);
+  if (!sessionPath || !existsSync(sessionPath)) {
+    console.error(`cost-track: no session jsonl in ${projectDir}`); process.exit(2);
+  }
+  const summary = summarizeSession(sessionPath);
+  if (process.env.TRACK_OUT) writeFileSync(process.env.TRACK_OUT, JSON.stringify(summary, null, 2));
+  const store = process.env.TRACK_STORE || DEFAULT_STORE;
+  let res = { ok: false, reason: 'dry-run' };
+  if (process.env.TRACK_DRY_RUN !== '1') res = persistJsonl(summary, store);
+  if (process.env.TRACK_QUIET === '1') return;
+
+  console.log(`# cost-track — session ${(summary.sessionId || '').slice(0, 8) || 'unknown'}`);
+  console.log('');
+  console.log('| Metric | Value |\n|---|---:|');
+  console.log(`| Session ID | \`${summary.sessionId}\` |`);
+  console.log(`| Project | \`${summary.cwd}\` |`);
+  console.log(`| First message | ${summary.startedAt} |`);
+  console.log(`| Last message | ${summary.endedAt} |`);
+  console.log(`| Assistant messages | ${summary.messageCount} |`);
+  console.log(`| **Total cost** | **$${summary.total_cost_usd.toFixed(6)}** |`);
+  console.log(`| Persisted | ${res.ok ? `\`${res.path}\`` : `**FAILED** (${res.reason})`} |`);
+  console.log('\n## Per-model breakdown\n');
+  console.log('| Model | Tier | Messages | Input | Output | Cache write | Cache read | Cost |');
+  console.log('|---|---|---:|---:|---:|---:|---:|---:|');
+  for (const [m, s] of Object.entries(summary.byModel).sort((a, b) => b[1].cost_usd - a[1].cost_usd)) {
+    console.log(`| \`${m}\` | ${s.tier} | ${s.messages} | ${s.input_tokens} | ${s.output_tokens} | ${s.cache_creation_input_tokens} | ${s.cache_read_input_tokens} | $${s.cost_usd.toFixed(6)} |`);
+  }
+  console.log('\n## Per-tier breakdown\n');
+  console.log('| Tier | Cost |\n|---|---:|');
+  for (const [t, c] of Object.entries(summary.byTier).sort((a, b) => b[1] - a[1])) {
+    if (c > 0) console.log(`| ${t} | $${c.toFixed(6)} |`);
+  }
+}
+
+main();

package/scripts/first-run.sh

@@ -5,9 +5,7 @@ SETTINGS_FILE=".agent-settings.yml"
 LEGACY_SETTINGS_FILE=".agent-settings"
 
 echo ""
-echo "========================================"
-echo "  Agent Config — First Run"
-echo "========================================"
+echo "Agent Config — First Run"
 echo ""
 
 # --- Profile detection ---
@@ -63,9 +61,7 @@ echo "  ✅  Zero token overhead in minimal mode"
 echo ""
 
 # --- 3 test prompts ---
-echo "========================================" 
-echo "  Try these 3 prompts now"
-echo "========================================"
+echo "Try these 3 prompts now:"
 echo ""
 
 echo "1️⃣  Refactoring check"
@@ -94,9 +90,7 @@ echo "   → Agent challenges weak requirements"
 echo ""
 
 # --- Next steps ---
-echo "========================================"
-echo "  Next steps"
-echo "========================================"
+echo "Next steps:"
 echo ""
 echo "Cost profiles:"
 echo "  minimal   rules, skills, commands only"