@event4u/agent-config 1.22.0 → 1.24.0

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"

package/scripts/install-hooks.sh

@@ -39,7 +39,9 @@ echo "✅  Pre-push hook installed."
 cat > "$HOOKS_DIR/pre-commit" << 'EOF'
 #!/usr/bin/env bash
 # Pre-commit hook: verify .claude-plugin/marketplace.json lists every skill
-# that exists on disk under .claude/skills/.
+# that exists on disk under .claude/skills/, AND verify
+# agents/roadmaps-progress.md is in sync with the current state of
+# agents/roadmaps/ (roadmap-progress-sync Iron Law).
 
 python3 scripts/lint_marketplace.py
 status=$?
@@ -52,6 +54,22 @@ if [ $status -ne 0 ]; then
     echo "       git commit --no-verify"
     exit 1
 fi
+
+# Roadmap dashboard sync — only fires when staged changes touch a roadmap
+# file or the dashboard itself, so unrelated commits stay fast.
+if git diff --cached --name-only | grep -qE '^agents/roadmaps(-progress\.md|/)'; then
+    python3 .augment/scripts/update_roadmap_progress.py --check
+    rstatus=$?
+    if [ $rstatus -ne 0 ]; then
+        echo ""
+        echo "❌  Commit blocked — agents/roadmaps-progress.md is stale."
+        echo "   Run './agent-config roadmap:progress' (or"
+        echo "   'python3 .augment/scripts/update_roadmap_progress.py'),"
+        echo "   stage agents/roadmaps-progress.md, then re-commit."
+        echo "   To bypass for an unrelated WIP commit: git commit --no-verify"
+        exit 1
+    fi
+fi
 EOF
 
 chmod +x "$HOOKS_DIR/pre-commit"

package/scripts/install.py

@@ -1280,6 +1280,7 @@ def main(argv: list[str]) -> int:
         fail(f"Unsupported profile: {opts.profile}. Supported: {', '.join(SUPPORTED_PROFILES)}")
 
     project_root = Path(opts.project or os.environ.get("PROJECT_ROOT") or os.getcwd()).resolve()
+    is_first_run = not (project_root / SETTINGS_FILE).exists()
 
     if opts.package:
         package_root = Path(opts.package).resolve()
@@ -1335,18 +1336,22 @@ def main(argv: list[str]) -> int:
     if not QUIET:
         print()
         success("Done.")
-        print()
-        print("  Try these 3 prompts with your agent:")
-        print('    1. "Refactor this function"   → agent analyzes first')
-        print('    2. "Add caching to this"      → agent asks instead of guessing')
-        print('    3. "Implement this feature"   → agent respects your codebase')
-        print()
-        print("  Next steps:")
-        print("    • Commit .agent-settings.yml and bridge files to your repo")
-        print("    • New team members just run composer install / npm install — done")
-        print("    • Inspect hook coverage: ./agent-config hooks:status")
-        print("    • Full walkthrough: https://github.com/event4u-app/agent-config/blob/main/docs/getting-started.md")
-        print()
+        if is_first_run:
+            print()
+            print("  Try these 3 prompts with your agent:")
+            print('    1. "Refactor this function"   → agent analyzes first')
+            print('    2. "Add caching to this"      → agent asks instead of guessing')
+            print('    3. "Implement this feature"   → agent respects your codebase')
+            print()
+            print("  Next steps:")
+            print("    • Commit .agent-settings.yml and bridge files to your repo")
+            print("    • New team members just run composer install / npm install — done")
+            print("    • Inspect hook coverage: ./agent-config hooks:status")
+            print("    • Full walkthrough: https://github.com/event4u-app/agent-config/blob/main/docs/getting-started.md")
+            print()
+        else:
+            print("  Re-run complete. Walkthrough: https://github.com/event4u-app/agent-config/blob/main/docs/getting-started.md")
+            print()
     return 0
 
 

package/scripts/install.sh

@@ -693,11 +693,18 @@ install_cli_wrapper() {
 main() {
     parse_args "$@"
 
-    $QUIET || echo "🔧  Syncing agent-config payload..."
-    $QUIET || echo "    Source: $SOURCE_DIR"
-    $QUIET || echo "    Target: $TARGET_DIR"
-    $DRY_RUN && ! $QUIET && echo "    Mode: DRY RUN"
-    echo ""
+    # First-run detection: gate the verbose source/target banner behind the
+    # absence of .agent-settings.yml. Re-runs print a single status line.
+    local is_first_run=false
+    [[ ! -f "$TARGET_DIR/.agent-settings.yml" ]] && is_first_run=true
+
+    if $is_first_run && ! $QUIET; then
+        echo "🔧  Syncing agent-config payload..."
+        echo "    Source: $SOURCE_DIR"
+        echo "    Target: $TARGET_DIR"
+        $DRY_RUN && echo "    Mode: DRY RUN"
+        echo ""
+    fi
 
     # 0. Migrate legacy infra files (root → agents/) before any content sync.
     migrate_legacy_root_infra "$TARGET_DIR"
@@ -737,9 +744,13 @@ main() {
     # 6. Manage .gitignore
     ensure_gitignore "$TARGET_DIR"
 
-    echo ""
-    $QUIET || echo "✅  agent-config payload synced."
-    $QUIET || echo "    Run scripts/install (or python3 scripts/install.py) to render .agent-settings.yml and bridges."
+    if $is_first_run && ! $QUIET; then
+        echo ""
+        echo "✅  agent-config payload synced."
+        echo "    Run scripts/install (or python3 scripts/install.py) to render .agent-settings.yml and bridges."
+    elif ! $QUIET; then
+        echo "✅  agent-config payload synced."
+    fi
 }
 
 main "$@"

package/scripts/lint_examples.py

@@ -15,6 +15,8 @@ import re
 import sys
 from pathlib import Path
 
+QUIET = "--quiet" in sys.argv
+
 REPO_ROOT = Path(__file__).resolve().parent.parent
 DEMO_GLOB = "docs/guidelines/agent-infra/*-demos.md"
 REQUIRED_FM_KEYS = ("demo_for:", "layer: pattern-memory", "prose_delta:")
@@ -86,11 +88,13 @@ def main() -> int:
             for p in problems:
                 print(f"    - {p}", file=sys.stderr)
         else:
-            print(f"✅  {rel}")
+            if not QUIET:
+                print(f"✅  {rel}")
     if failed:
         print(f"\n❌  {failed} demo file(s) failed shape lint", file=sys.stderr)
         return 1
-    print(f"\n✅  {len(demos)} demo file(s) shape-clean")
+    if not QUIET:
+        print(f"\n✅  {len(demos)} demo file(s) shape-clean")
     return 0
 
 

package/scripts/lint_handoffs.py

@@ -24,6 +24,8 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Iterable
 
+QUIET = "--quiet" in sys.argv
+
 REPO = Path(__file__).resolve().parents[1]
 SKILLS_DIR = REPO / ".agent-src.uncompressed" / "skills"
 
@@ -202,7 +204,8 @@ def main(argv: list[str] | None = None) -> int:
         skills_dir = Path(argv[0]).resolve()
     violations = lint(skills_dir)
     if not violations:
-        print(f"✅  lint_handoffs: no violations under {skills_dir.relative_to(REPO)}")
+        if not QUIET:
+            print(f"✅  lint_handoffs: no violations under {skills_dir.relative_to(REPO)}")
         return 0
     for v in violations:
         print(v.render(REPO))

package/scripts/lint_load_context.py

@@ -19,6 +19,8 @@ from typing import Iterable
 
 import yaml
 
+QUIET = "--quiet" in sys.argv
+
 ROOT = Path(__file__).resolve().parent.parent
 
 SCAN_DIRS = [
@@ -185,7 +187,8 @@ def main() -> int:
         print(f"❌  {e}")
     if errors:
         return 1
-    print(f"✅  load_context schema clean ({len(graph)} declarer(s))")
+    if not QUIET:
+        print(f"✅  load_context schema clean ({len(graph)} declarer(s))")
     return 0
 
 

package/scripts/lint_roadmap_complexity.py

@@ -21,6 +21,8 @@ import re
 import sys
 from pathlib import Path
 
+QUIET = "--quiet" in sys.argv
+
 REPO_ROOT = Path(__file__).resolve().parent.parent
 ROADMAP_GLOB = "agents/roadmaps/*.md"
 LIGHTWEIGHT_LINE_CAP = 600
@@ -107,7 +109,8 @@ def main() -> int:
             for p in problems:
                 print(f"    - {p}", file=sys.stderr)
         else:
-            print(f"✅  {rel}  [{complexity}]")
+            if not QUIET:
+                print(f"✅  {rel}  [{complexity}]")
     print()
     light = sum(1 for _, c in summary if c == "lightweight")
     structural = sum(1 for _, c in summary if c == "structural")
@@ -119,7 +122,8 @@ def main() -> int:
     if failed:
         print(f"\n❌  {failed} roadmap(s) failed complexity lint", file=sys.stderr)
         return 1
-    print(f"\n✅  {len(roadmaps)} roadmap(s) complexity-clean")
+    if not QUIET:
+        print(f"\n✅  {len(roadmaps)} roadmap(s) complexity-clean")
     return 0
 
 

package/scripts/lint_rule_interactions.py

@@ -22,6 +22,8 @@ from pathlib import Path
 
 import yaml
 
+QUIET = "--quiet" in sys.argv
+
 ROOT = Path(__file__).resolve().parent.parent
 MATRIX = ROOT / "docs" / "contracts" / "rule-interactions.yml"
 RULES_DIR = ROOT / ".agent-src.uncompressed" / "rules"
@@ -141,7 +143,8 @@ def main() -> int:
     if errors:
         fail(errors)
 
-    print(f"✅  rule-interactions.yml clean — {len(declared_rules)} rules, {len(pairs)} pairs.")
+    if not QUIET:
+        print(f"✅  rule-interactions.yml clean — {len(declared_rules)} rules, {len(pairs)} pairs.")
     return 0
 
 

package/scripts/lint_rule_tiers.py

@@ -17,6 +17,8 @@ from __future__ import annotations
 import sys
 from pathlib import Path
 
+QUIET = "--quiet" in sys.argv
+
 REPO = Path(__file__).resolve().parents[1]
 RULES_DIR = REPO / ".agent-src.uncompressed" / "rules"
 
@@ -70,7 +72,8 @@ def main() -> int:
         )
         return 1
 
-    print(f"✅  lint_rule_tiers: {len(rules)} rules, all tier values valid")
+    if not QUIET:
+        print(f"✅  lint_rule_tiers: {len(rules)} rules, all tier values valid")
     return 0