tribunal-kit 4.4.2 → 4.4.4

package/bin/tribunal-kit.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * tribunal-kit CLI (alias: tk)
  * 
@@ -743,6 +743,9 @@ async function runWithUpdateCheck(command, flags) {
         case 'context':
             cmdContext(flags);
             break;
+        case 'marathon':
+            cmdMarathon(flags);
+            break;
         case 'uninstall':
             cmdUninstall(flags);
             break;
@@ -956,6 +959,7 @@ function cmdHelp() {
     log(cmd('graph',    'Build and visualize the architecture graph'));
     log(cmd('mutate',   'Run the Mutation Engine to test test-suite reliability'));
     log(cmd('context',  'Retrieve a highly-optimized Context Snapshot for a file'));
+    log(cmd('marathon', 'Long-running agent harness (init, status, next, mark)'));
     log(cmd('hook',     'Install pre-push git hook for auto-learning'));
     log(cmd('uninstall','Remove .agent/ folder from project'));
     console.log();
@@ -994,12 +998,54 @@ function cmdHelp() {
     log(ex('tk case overrule --id 1'));
     log(ex('tk graph'));
     log(ex('tk mutate src/utils.js "npm test"'));
+    log(ex('tk marathon init "Build a todo app"'));
+    log(ex('tk marathon status'));
+    log(ex('tk marathon next'));
+    log(ex('tk marathon mark 5 pass'));
     log(ex('tk hook'));
     log(ex('tk uninstall'));
     console.log();
 }
 
 
+function cmdMarathon(flags) {
+    const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
+    const agentDest = path.join(targetDir, '.agent');
+
+    if (!fs.existsSync(agentDest)) {
+        err('.agent/ not found. Run: npx tribunal-kit init');
+        process.exit(1);
+    }
+
+    const args = process.argv.slice(3);
+    const argsStr = args.join(' ');
+    if (args.length === 0 || args[0] === 'help' || args[0] === '--help' || args[0] === '-h') {
+        banner();
+        log(`  ${c('cyan', '╔' + '═'.repeat(60) + '╗')}`);
+        log(`  ${c('cyan', '║')}${c('bold', c('white', '  Marathon — Long-Running Agent Harness                  '))}${c('cyan', '║')}`);
+        log(`  ${c('cyan', '╚' + '═'.repeat(60) + '╝')}`);
+        console.log();
+        log(`  ${c('cyan', 'init'.padEnd(16))}  ${c('gray', 'Start a new marathon (init "spec")')}`);
+        log(`  ${c('cyan', 'status'.padEnd(16))}  ${c('gray', 'Show progress dashboard')}`);
+        log(`  ${c('cyan', 'next'.padEnd(16))}  ${c('gray', 'Show next unfinished feature')}`);
+        log(`  ${c('cyan', 'mark'.padEnd(16))}  ${c('gray', 'Mark feature pass/fail (mark <id> pass)')}`);
+        log(`  ${c('cyan', 'log'.padEnd(16))}  ${c('gray', 'Add a progress note')}`);
+        log(`  ${c('cyan', 'session-start'.padEnd(16))}  ${c('gray', 'Begin a new work session')}`);
+        log(`  ${c('cyan', 'session-end'.padEnd(16))}  ${c('gray', 'End session with summary')}`);
+        log(`  ${c('cyan', 'add-feature'.padEnd(16))}  ${c('gray', 'Add feature: "category" "desc" "step1" ...')}`);
+        log(`  ${c('cyan', 'reset'.padEnd(16))}  ${c('gray', 'Archive and start fresh')}`);
+        console.log();
+        return;
+    }
+
+    const marathonScript = path.join(agentDest, 'scripts', 'marathon_harness.js');
+    try {
+        execSync(`node "${marathonScript}" ${argsStr}`, { stdio: 'inherit', cwd: targetDir });
+    } catch {
+        process.exit(1);
+    }
+}
+
 function cmdContext(flags) {
     const targetDir = flags.path ? path.resolve(flags.path) : process.cwd();
     const agentDest = path.join(targetDir, '.agent');
@@ -1071,5 +1117,5 @@ runWithUpdateCheck(command, flags);
 
 // -- Exports (for testing) -- do not remove
 if (require.main !== module) {
-  module.exports = { parseArgs, compareSemver, copyDir, countDir, isSelfInstall, CORE_AGENTS, CORE_SKILLS, generateIDEBridges };
-}
+  module.exports = { parseArgs, compareSemver, copyDir, countDir, isSelfInstall, CORE_AGENTS, CORE_SKILLS, generateIDEBridges, cmdMarathon };
+}

package/package.json

@@ -1,10 +1,11 @@
 {
     "name": "tribunal-kit",
-    "version": "4.4.2",
-    "description": "Anti-Hallucination AI Agent Kit — 40 specialist agents, 31 slash commands, 16 parallel Tribunal reviewers, Performance Swarm engine, and Supreme Court case law pipeline.",
+    "version": "4.4.4",
+    "description": "Anti-Hallucination AI Agent Kit — 40 specialist agents, 32 slash commands, 16 parallel Tribunal reviewers, Performance Swarm engine, Supreme Court case law pipeline, and long-running agent harness.",
     "keywords": [
         "ai",
         "ai-agent",
+        "long-running-agents",
         "agent",
         "agents",
         "multi-agent",

package/.agent/scripts/append_flow.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-// append_flow.js — append Supreme Court section to AGENT_FLOW.md
-const fs = require('fs');
-const f  = 'AGENT_FLOW.md';
-
-const appendix = [
-  '',
-  '---',
-  '',
-  '## Supreme Court Edition — Self-Learning Engine',
-  '',
-  'Tribunal Kit v4.0+ ships two industry-first features that transform the',
-  'agent kit from a reactive reviewer into a **persistent engineering authority**.',
-  '',
-  '### 1 — Case Law Engine',
-  '',
-  'Every rejected pattern becomes binding legal precedent.',
-  '',
-  '| Step | What Happens |',
-  '|:-----|:-------------|',
-  '| 1 | Developer rejects AI proposal |',
-  '| 2 | Runs `case_law_manager.py add-case` |',
-  '| 3 | diff + tags + reason stored in `.agent/history/case-law/` |',
-  '| 4 | `precedence-reviewer` queries index on every future `/generate` or `/review` |',
-  '| 5 | Jaccard tag match score >= 0.4 → PRECEDENCE HOLD |',
-  '',
-  '### 2 — Skill Evolution Forge',
-  '',
-  'The agent kit writes its own skills by learning from your commits.',
-  '',
-  '| Step | What Happens |',
-  '|:-----|:-------------|',
-  '| 1 | Developer commits code different from AI proposal |',
-  '| 2 | `tribunal-kit learn` (or `skill_evolution.py digest`) |',
-  '| 3 | Semantic Delta Filter strips trivial noise (70-90% token reduction) |',
-  '| 4 | Minimal LLM Reflection Prompt (< 500 tokens) |',
-  '| 5 | YAML idioms merged into `.agent/skills/project-idioms/SKILL.md` |',
-  '| 6 | All agents inherit these idioms on next activation |',
-  '',
-  '### CLI Commands (Supreme Court)',
-  '',
-  '| Command | Action |',
-  '|:--------|:-------|',
-  '| `tribunal-kit learn` | Run Skill Evolution + Case Law prompt |',
-  '| `tribunal-kit learn --dry-run` | Preview delta without writing |',
-  '| `tribunal-kit learn --head` | Diff last commit instead of staged |',
-  '| `python .agent/scripts/case_law_manager.py add-case` | Record a rejection |',
-  '| `python .agent/scripts/case_law_manager.py search-cases --query "..."` | Find precedents |',
-  '| `python .agent/scripts/skill_evolution.py digest` | Run evolution cycle |',
-  '| `python .agent/scripts/skill_evolution.py status` | Token savings report |',
-  '',
-  '### Review Order (Updated)',
-  '',
-  '```',
-  '1. precedence-reviewer   <- FIRST (Case Law check, zero LLM tokens)',
-  '2. logic-reviewer',
-  '3. security-auditor',
-  '4. domain-specific reviewers',
-  '5. Human Gate',
-  '```',
-  '',
-  '### New Reviewer',
-  '',
-  '| Reviewer | Activates for | Catches |',
-  '|:---------|:-------------|:--------|',
-  '| `precedence-reviewer` | All domains | Violations of previously rejected patterns |',
-  '',
-].join('\n');
-
-let existing = fs.readFileSync(f, 'utf8').trimEnd();
-fs.writeFileSync(f, existing + appendix + '\n', 'utf8');
-console.log('AGENT_FLOW.md updated.');

package/.agent/scripts/colors.js

@@ -1,11 +0,0 @@
-/**
- * colors.js — Backward-compatible re-export of _colors.js
- * ════════════════════════════════════════════════════════
- * All color constants and helpers are defined in _colors.js.
- * This file re-exports them for scripts that import from './colors.js'.
- *
- * New scripts should import from './_colors' directly.
- */
-'use strict';
-
-module.exports = require('./_colors');

package/.agent/scripts/compress_skills.js

@@ -1,141 +0,0 @@
-#!/usr/bin/env node
-// compress_skills.js - Aggressive token reduction for .agent/skills/**/*.md files
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const SECTION_PATTERNS = [
-    /^## 🏛️ Tribunal Integration[\s\S]*?(?=\n## |\n# |$)/gm,
-    /^## Tribunal Integration[\s\S]*?(?=\n## |\n# |$)/gm,
-    /^### ✅ Pre-Flight Self-Audit[\s\S]*?(?=\n## |\n### |\n# |$)/gm,
-    /^## Pre-Flight Self-Audit[\s\S]*?(?=\n## |\n# |$)/gm,
-    /^## Cross-Workflow Navigation[\s\S]*?(?=\n## |\n# |$)/gm,
-    /^## Output Format\s*\n```[\s\S]*?```\s*\n/gm,
-    /^## VBC Protocol[\s\S]*?(?=\n## |\n# |$)/gm,
-    /^## LLM Traps[\s\S]*?(?=\n## |\n# |$)/gm,
-];
-
-const CHATTY_INTRO = /(^# .+\n)\n[A-Z][^#\n]{60,}\n[A-Z][^#\n]{40,}\n\n---/gm;
-
-function stripChattyIntro(content) {
-    return content.replace(CHATTY_INTRO, '$1\n---');
-}
-
-const OBVIOUS_COMMENT = /^(\s*)(\/\/ (default for most properties|shorthand|number of repeats|default: \d+|spring tension|resistance|weight|approximate duration|deceleration rate)[^\n]*)\n/gm;
-
-function stripObviousComments(content) {
-    return content.replace(OBVIOUS_COMMENT, '');
-}
-
-const PERF_TEXT_BLOCK = /^```\n(✅ Use \w[^\n]*\n   → [^\n]*\n\n?){3,}```\n/gm;
-
-function compressPerfBlocks(content) {
-    return content.replace(PERF_TEXT_BLOCK, (match) => {
-        const lines = match.replace(/`|\n$/g, '').split('\n');
-        const bullets = [];
-        for (const line of lines) {
-            const stripped = line.trim();
-            if (stripped.startsWith('✅') || stripped.startsWith('❌')) {
-                bullets.push(`- ${stripped}`);
-            } else if (stripped.startsWith('→')) {
-                bullets[bullets.length - 1] += ` (${stripped.substring(1).trim()})`;
-            }
-        }
-        return bullets.join('\n') + '\n';
-    });
-}
-
-function collapseBlanks(content) {
-    return content.replace(/\n{3,}/g, '\n\n');
-}
-
-const FILLER_BEFORE_SECTION = /(^# .+\n\n)([A-Z][^\n]+\n){1,4}(\n---\n)/gm;
-
-function removeFillerBetweenTitleAndHr(content) {
-    return content.replace(FILLER_BEFORE_SECTION, '$1$3');
-}
-
-const REDUNDANT_NOTE = /^\/\/ (motion\.\w+|Any HTML|Note:|Variant names propagate|\/\/ )[^\n]*\n/gm;
-
-function stripRedundantNotes(content) {
-    return content.replace(REDUNDANT_NOTE, '');
-}
-
-function compressFile(filePath) {
-    const original = fs.readFileSync(filePath, 'utf8');
-    let content = original;
-
-    for (const pattern of SECTION_PATTERNS) {
-        content = content.replace(pattern, '');
-    }
-
-    content = stripChattyIntro(content);
-    content = removeFillerBetweenTitleAndHr(content);
-    content = stripObviousComments(content);
-    content = stripRedundantNotes(content);
-    content = compressPerfBlocks(content);
-    content = collapseBlanks(content);
-
-    const originalLen = Buffer.byteLength(original, 'utf8');
-    const newLen = Buffer.byteLength(content.trim() + '\n', 'utf8');
-
-    fs.writeFileSync(filePath, content.trim() + '\n', 'utf8');
-    return [originalLen, newLen, originalLen - newLen];
-}
-
-function main() {
-    const base = '.agent/skills';
-    if (!fs.existsSync(base)) {
-        console.error(`ERROR: '${base}' not found. Run from tribunal-kit root.`);
-        process.exit(1);
-    }
-
-    let totalOrig = 0;
-    let totalNew = 0;
-    const results = [];
-
-    function walkDir(dir) {
-        const items = fs.readdirSync(dir, { withFileTypes: true });
-        for (const item of items) {
-            const fpath = path.join(dir, item.name);
-            if (item.isDirectory()) {
-                walkDir(fpath);
-            } else if (item.name.endsWith('.md')) {
-                const [orig, newL, saved] = compressFile(fpath);
-                totalOrig += orig;
-                totalNew += newL;
-                if (saved > 0) {
-                    results.push([saved, fpath]);
-                }
-            }
-        }
-    }
-
-    walkDir(base);
-    results.sort((a, b) => b[0] - a[0]);
-
-    console.log(`\n${'='.repeat(55)}`);
-    console.log(`  Skill Compression Complete`);
-    console.log(`${'='.repeat(55)}`);
-    console.log(`  Original : ${totalOrig} bytes (${Math.floor(totalOrig / 1024)}KB)`);
-    console.log(`  After    : ${totalNew} bytes (${Math.floor(totalNew / 1024)}KB)`);
-    
-    const savedTotal = totalOrig - totalNew;
-    const pct = totalOrig ? (savedTotal / totalOrig * 100) : 0;
-    console.log(`  Saved    : ${savedTotal} bytes (${Math.floor(savedTotal / 1024)}KB) — ${pct.toFixed(1)}%`);
-    console.log(`\n  Top savings:`);
-    
-    for (const [saved, filePath] of results.slice(0, 15)) {
-        const parts = filePath.split(path.sep);
-        const skill = parts[parts.length - 2];
-        const fname = parts[parts.length - 1];
-        console.log(`    -${Math.floor(saved / 1024).toString().padStart(2, ' ')}KB  ${skill}/${fname}`);
-    }
-    console.log();
-}
-
-if (require.main === module) {
-    main();
-}

package/.agent/scripts/consolidate_skills.js

@@ -1,149 +0,0 @@
-#!/usr/bin/env node
-/**
- * consolidate_skills.js
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const BASE = '.agent/skills';
-
-const STRIP_PATTERNS = [
-    /^## 🏛️ Tribunal Integration.*?(?=\n## |$)/gms,
-    /^## Tribunal Integration.*?(?=\n## |$)/gms,
-    /^### ✅ Pre-Flight Self-Audit.*?(?=\n###|\n## |$)/gms,
-    /^## Pre-Flight Self-Audit.*?(?=\n## |$)/gms,
-    /^## Output Format\b.*?(?=\n## |$)/gms,
-    /^## 🔧 Runtime Scripts.*?(?=\n## |$)/gms,
-    /^## 🔴 MANDATORY.*?(?=\n## |$)/gms,
-    /^## ⚠️ CRITICAL: ASK BEFORE ASSUMING.*?(?=\n## |$)/gms,
-    /^## 📝 CHECKPOINT \(MANDATORY.*?(?=\n## |$)/gms,
-    /^## Output Format.*?```\n[^`]*```\n?(?=\n## |$)/gms,
-    /^\*\*Execute these for validation.*?---\n/gms,
-    /^\*\*VBC \(Verification-Before-Completion\).*?\n/gms,
-    /^\*\*⛔ DO NOT start.*?---\n?/gms,
-    /^> 🧠 \*\*mobile-design.*?\n/gms,
-    /^> \*\*STOP.*?\n/gms,
-];
-
-function adjustHeadings(content, offset = 1) {
-    const lines = content.split('\n');
-    const out = [];
-    for (let line of lines) {
-        const m = line.match(/^(#{1,5}) /);
-        if (m) {
-            const level = m[1].length;
-            const newLevel = Math.min(level + offset, 6);
-            line = '#'.repeat(newLevel) + line.substring(level);
-        }
-        out.push(line);
-    }
-    return out.join('\n');
-}
-
-function cleanContent(content) {
-    for (const p of STRIP_PATTERNS) {
-        content = content.replace(p, '');
-    }
-    content = content.replace(/\n{3,}/g, '\n\n');
-    return content.trim();
-}
-
-function extractFrontmatter(content) {
-    const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
-    if (m) {
-        return [m[1], content.substring(m[0].length)];
-    }
-    return ['', content];
-}
-
-function consolidate(skillDir) {
-    const skillName = path.basename(skillDir);
-    const mainPath = path.join(skillDir, 'SKILL.md');
-    if (!fs.existsSync(mainPath)) return false;
-
-    const files = fs.readdirSync(skillDir);
-    const subFiles = files.filter(f => f.endsWith('.md') && f !== 'SKILL.md').sort();
-
-    if (subFiles.length === 0) return false;
-
-    console.log(`\n  → Consolidating: ${skillName} (${subFiles.length} sub-files)`);
-
-    const mainContent = fs.readFileSync(mainPath, 'utf8');
-    let [frontmatter, mainBody] = extractFrontmatter(mainContent);
-
-    const fmLines = frontmatter.split('\n');
-    const newFm = [];
-    for (const line of fmLines) {
-        if (line.startsWith('version:')) newFm.push('version: 3.1.0');
-        else if (line.startsWith('last-updated:')) newFm.push('last-updated: 2026-04-06');
-        else newFm.push(line);
-    }
-    frontmatter = newFm.join('\n');
-
-    mainBody = cleanContent(mainBody);
-    mainBody = mainBody.replace(/\|.*?\.md.*?\|.*?\|.*?\|\n/g, '');
-    mainBody = mainBody.replace(/^\|[-| ]+\|\n/gm, '');
-    mainBody = mainBody.replace(/\n{3,}/g, '\n\n');
-
-    const mergedSections = [];
-    for (const fname of subFiles) {
-        const fpath = path.join(skillDir, fname);
-        const raw = fs.readFileSync(fpath, 'utf8');
-        let [, body] = extractFrontmatter(raw);
-        body = cleanContent(body);
-        body = adjustHeadings(body, 1);
-        if (body.trim()) {
-            mergedSections.push(body.trim());
-        }
-    }
-
-    let combined = `---\n${frontmatter}\n---\n\n${mainBody}`;
-    if (mergedSections.length > 0) {
-        combined += '\n\n---\n\n' + mergedSections.join('\n\n---\n\n');
-    }
-
-    combined = combined.replace(/\n{3,}/g, '\n\n');
-    combined = combined.trim() + '\n';
-
-    let totalSubBytes = 0;
-    for (const f of subFiles) totalSubBytes += fs.statSync(path.join(skillDir, f)).size;
-    console.log(`     Sub-files total: ${Math.floor(totalSubBytes / 1024)}KB`);
-
-    fs.writeFileSync(mainPath, combined, 'utf8');
-    const newSize = fs.statSync(mainPath).size;
-    console.log(`     New SKILL.md:    ${Math.floor(newSize / 1024)}KB  (from ${Math.floor(Buffer.byteLength(mainContent, 'utf8') / 1024)}KB main + ${Math.floor(totalSubBytes / 1024)}KB subs → ${Math.floor(newSize / 1024)}KB)`);
-
-    for (const fname of subFiles) {
-        fs.unlinkSync(path.join(skillDir, fname));
-        console.log(`     Deleted: ${fname}`);
-    }
-
-    return true;
-}
-
-function main() {
-    const target = process.argv.length > 2 ? process.argv[2] : null;
-
-    let processed = 0;
-    if (!fs.existsSync(BASE)) return;
-
-    for (const skillName of fs.readdirSync(BASE)) {
-        const skillDir = path.join(BASE, skillName);
-        if (!fs.statSync(skillDir).isDirectory()) continue;
-        if (target && skillName !== target) continue;
-        if (consolidate(skillDir)) processed++;
-    }
-
-    if (processed === 0) {
-        console.log('No skills with sub-files found (or target not matched).');
-    } else {
-        console.log(`\n✅ Consolidated ${processed} skills.`);
-    }
-}
-
-if (require.main === module) {
-    main();
-}

package/.agent/scripts/deep_compress.js

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-/**
- * deep_compress.js - Deep surgical compression for .agent/ markdown files (skills, agents, workflows).
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const BASE_DIRS = ['.agent/skills', '.agent/agents', '.agent/workflows'];
-
-const REMOVE_SECTIONS = [
-    /^## 🏛️ Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
-    /^## Tribunal Integration[\s\S]*?(?=\n## |$)/gm,
-    /^### ✅ Pre-Flight Self-Audit[\s\S]*?(?=\n### |\n## |$)/gm,
-    /^## Pre-Flight Self-Audit[\s\S]*?(?=\n## |$)/gm,
-    /^## Cross-Workflow Navigation[\s\S]*?(?=\n## |$)/gm,
-    /^## LLM Traps[\s\S]*?(?=\n## |$)/gm,
-    /^## VBC Protocol[\s\S]*?(?=\n## |$)/gm,
-    /^## Output Format\n```[\s\S]*?```\n/gm,
-    /^## 🤖 LLM-Specific Traps[\s\S]*?(?=\n## |$)/gm,
-];
-
-const VERBOSE_COMMENT_PATTERNS = [
-    /^(\s*)\/\/\s*(?:Any HTML or SVG element|motion\.div, motion\.span|The MAGIC of|This is the key performance|The pattern that|Compound components share|Note that children|The action receives|Children inherit the|Import first|Parent controls when|It's always motion)\b[^\n]*\n/gm,
-    /^(\s*)#\s*(?:TypedDict gives you|Usage:|Note:|Return user|Return None|Automatically)\b[^\n]*\n/gm,
-    /^\s*\/\/\s*Usage:\s*\n(?=\s*[<{])/gm,
-    /^\s*#\s*Usage:\s*\n(?=\s*[{])/gm,
-    /^\s*\/\/\s*When (?:server responds|a component|React can interrupt|the React Compiler)[^\n]*\n/gm,
-];
-
-function stripChattyOpeners(content) {
-    return content.replace(/(^# .+\n)\n.{60,}\n.{30,}\n(?:\n---)/gm, '$1\n---');
-}
-
-function compressLegacyModernBlocks(content) {
-    const pattern = /```(\w+)\n((?:.*\n)*?.*(?:\/\/|#) ❌ LEGACY[^\n]*\n(?:.*\n)*?)```\n\n```\w+\n((?:.*\n)*?.*(?:\/\/|#) ✅ MODERN[^\n]*\n(?:.*\n)*?)```/gm;
-    return content.replace(pattern, (match, lang, legacy, modern) => {
-        const totalLines = (legacy.match(/\n/g) || []).length + (modern.match(/\n/g) || []).length;
-        if (totalLines > 28) return match;
-        return `\`\`\`${lang}\n// ❌ LEGACY\n${legacy.trim()}\n\n// ✅ MODERN\n${modern.trim()}\n\`\`\``;
-    });
-}
-
-function stripEmptyComments(content) {
-    content = content.replace(/^\s*\/\/\s*$\n/gm, '');
-    content = content.replace(/^\s*#\s*$\n/gm, '');
-    return content;
-}
-
-function dedupBulletPoints(content) {
-    const lines = content.split('\n');
-    const seenBullets = {};
-    const output = [];
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const stripped = line.trim();
-        if (/^(✅|❌|- ✅|- ❌)/.test(stripped)) {
-            if (seenBullets[stripped] !== undefined && (i - seenBullets[stripped]) < 80) {
-                continue;
-            }
-            seenBullets[stripped] = i;
-        }
-        output.push(line);
-    }
-    return output.join('\n');
-}
-
-function collapseBlanks(content) {
-    return content.replace(/\n{3,}/g, '\n\n');
-}
-
-function compressFile(filePath) {
-    const original = fs.readFileSync(filePath, 'utf8');
-    let content = original;
-
-    for (const pattern of REMOVE_SECTIONS) {
-        content = content.replace(pattern, '');
-    }
-
-    content = stripChattyOpeners(content);
-    content = compressLegacyModernBlocks(content);
-
-    for (const pattern of VERBOSE_COMMENT_PATTERNS) {
-        content = content.replace(pattern, '');
-    }
-
-    content = stripEmptyComments(content);
-    content = dedupBulletPoints(content);
-    content = collapseBlanks(content);
-
-    if (content.trim() !== original.trim()) {
-        fs.writeFileSync(filePath, content.trim() + '\n', 'utf8');
-    }
-
-    return [Buffer.byteLength(original, 'utf8'), Buffer.byteLength(content, 'utf8')];
-}
-
-function main() {
-    let totalOrig = 0;
-    let totalNew = 0;
-    const fileResults = [];
-
-    function walkDir(dir) {
-        let items;
-        try { items = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
-        for (const item of items) {
-            const fpath = path.join(dir, item.name);
-            if (item.isDirectory()) walkDir(fpath);
-            else if (item.name.endsWith('.md')) {
-                const [orig, newL] = compressFile(fpath);
-                totalOrig += orig;
-                totalNew += newL;
-                const saved = orig - newL;
-                if (saved > 200) {
-                    fileResults.push([saved, fpath]);
-                }
-            }
-        }
-    }
-
-    for (const base of BASE_DIRS) {
-        if (fs.existsSync(base)) walkDir(base);
-    }
-
-    fileResults.sort((a, b) => b[0] - a[0]);
-
-    const savedTotal = totalOrig - totalNew;
-    const pct = totalOrig ? (savedTotal / totalOrig * 100) : 0;
-
-    console.log(`\n${'='.repeat(58)}`);
-    console.log(`  Deep Compression Complete`);
-    console.log(`${'='.repeat(58)}`);
-    console.log(`  Original : ${totalOrig} bytes (${Math.floor(totalOrig / 1024)}KB)`);
-    console.log(`  After    : ${totalNew} bytes (${Math.floor(totalNew / 1024)}KB)`);
-    console.log(`  Saved    : ${savedTotal} bytes (${Math.floor(savedTotal / 1024)}KB) — ${pct.toFixed(1)}%`);
-    console.log(`\n  Top savings:`);
-    
-    for (const [saved, filePath] of fileResults.slice(0, 20)) {
-        const parts = filePath.split(path.sep);
-        const skill = parts.length >= 2 ? `${parts[parts.length - 2]}/${parts[parts.length - 1]}` : filePath;
-        console.log(`    -${Math.floor(saved / 1024).toString().padStart(2, ' ')}KB  ${skill}`);
-    }
-    console.log();
-}
-
-if (require.main === module) {
-    main();
-}