tribunal-kit 4.3.1 → 4.4.1

package/.agent/scripts/compress_skills.js

@@ -1,141 +1,141 @@
-#!/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();
-}
+#!/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 +1,149 @@
-#!/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();
-}
+#!/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();
+}