tribunal-kit 4.2.0 → 4.3.0

package/.agent/scripts/checklist.py

@@ -1,209 +0,0 @@
-#!/usr/bin/env python3
-"""
-checklist.py — Priority-based project audit runner for the Tribunal Agent Kit.
-
-Runs a tiered audit sequence:
-  Priority 1: Security
-  Priority 2: Lint
-  Priority 3: Schema validation
-  Priority 4: Tests
-  Priority 5: UX / Accessibility
-  Priority 6: SEO
-  Priority 7: Lighthouse / E2E (requires --url)
-
-Usage:
-  python .agent/scripts/checklist.py .
-  python .agent/scripts/checklist.py . --url http://localhost:3000
-  python .agent/scripts/checklist.py . --skip security,seo
-"""
-
-import os
-import sys
-import subprocess
-import argparse
-from pathlib import Path
-
-# ━━━ ANSI color output ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-RED = "\033[91m"
-GREEN = "\033[92m"
-YELLOW = "\033[93m"
-BLUE = "\033[94m"
-RESET = "\033[0m"
-BOLD = "\033[1m"
-
-
-def print_header(title: str) -> None:
-    print(f"\n{BOLD}{BLUE}━━━ {title} ━━━{RESET}")
-
-
-def print_ok(msg: str) -> None:
-    print(f"  {GREEN}✅ {msg}{RESET}")
-
-
-def print_fail(msg: str) -> None:
-    print(f"  {RED}❌ {msg}{RESET}")
-
-
-def print_skip(msg: str) -> None:
-    print(f"  {YELLOW}⏭️  Skipped: {msg}{RESET}")
-
-
-def run_check(label: str, cmd: list[str], cwd: str) -> bool:
-    """Run a shell command and return True if it exits with code 0."""
-    try:
-        result = subprocess.run(
-            cmd,
-            cwd=cwd,
-            capture_output=True,
-            text=True,
-            timeout=60,
-        )
-        if result.returncode == 0:
-            print_ok(f"{label} passed")
-            return True
-        else:
-            print_fail(f"{label} failed")
-            if result.stdout.strip():
-                print(f"    {result.stdout.strip()[:500]}")
-            if result.stderr.strip():
-                print(f"    {result.stderr.strip()[:500]}")
-            return False
-    except FileNotFoundError:
-        print_skip(f"{label} — command not found (tool not installed)")
-        return True  # Don't block on tools that aren't installed
-    except subprocess.TimeoutExpired:
-        print_fail(f"{label} — timed out after 60s")
-        return False
-
-
-def check_secrets(project_root: str) -> bool:
-    """Scan for hardcoded secrets in source files."""
-    print_header("Security — Secret Scan")
-    dangerous_patterns = [
-        "password=",
-        "secret=",
-        "api_key=",
-        "apikey=",
-        "AUTH_TOKEN=",
-        "PRIVATE_KEY=",
-    ]
-    found_issues = False
-    source_extensions = {".ts", ".tsx", ".js", ".jsx", ".py", ".env"}
-
-    for root, dirs, files in os.walk(project_root):
-        # Skip known-safe directories
-        dirs[:] = [d for d in dirs if d not in {"node_modules", ".git", ".agent", "dist", "__pycache__"}]
-        for filename in files:
-            if not any(filename.endswith(ext) for ext in source_extensions):
-                continue
-            if filename.startswith(".env"):
-                continue  # .env files are allowed to have these
-            filepath = os.path.join(root, filename)
-            try:
-                with open(filepath, "r", encoding="utf-8", errors="ignore") as f:
-                    for line_num, line in enumerate(f, 1):
-                        line_lower = line.lower().strip()
-                        if any(pattern in line_lower for pattern in dangerous_patterns):
-                            # Only flag if it looks like an actual value (contains = and a non-empty value)
-                            if "=" in line and not line_lower.strip().startswith("#"):
-                                rel = os.path.relpath(filepath, project_root)
-                                print_fail(f"Possible secret: {rel}:{line_num} → {line.strip()[:80]}")
-                                found_issues = True
-            except (IOError, PermissionError):
-                pass
-
-    if not found_issues:
-        print_ok("No hardcoded secrets detected")
-    return not found_issues
-
-
-def run_all(project_root: str, url: str | None, skip: list[str]) -> int:
-    """Run all checklist tiers. Returns number of failures."""
-    failures = 0
-
-    # Priority 1 — Security
-    if "security" not in skip:
-        print_header("Priority 1 — Security")
-        if not check_secrets(project_root):
-            failures += 1
-    else:
-        print_skip("Security tier")
-
-    # Priority 2 — Lint
-    if "lint" not in skip:
-        print_header("Priority 2 — Lint")
-        if not run_check("ESLint", ["npx", "eslint", ".", "--max-warnings=0"], project_root):
-            failures += 1
-        if not run_check("TypeScript", ["npx", "tsc", "--noEmit"], project_root):
-            failures += 1
-    else:
-        print_skip("Lint tier")
-
-    # Priority 3 — Schema
-    if "schema" not in skip:
-        print_header("Priority 3 — Schema")
-        print_skip("Schema check — run manually if you have DB migrations")
-    else:
-        print_skip("Schema tier")
-
-    # Priority 4 — Tests
-    if "tests" not in skip:
-        print_header("Priority 4 — Tests")
-        if not run_check("Test suite", ["npm", "test", "--", "--passWithNoTests"], project_root):
-            failures += 1
-    else:
-        print_skip("Tests tier")
-
-    # Priority 5 — UX
-    if "ux" not in skip:
-        print_header("Priority 5 — UX / Accessibility")
-        print_skip("UX audit — run /preview start then check manually or with Lighthouse")
-    else:
-        print_skip("UX tier")
-
-    # Priority 6 — SEO
-    if "seo" not in skip:
-        print_header("Priority 6 — SEO")
-        print_skip("SEO check — use /ui-ux-pro-max for SEO-sensitive pages")
-    else:
-        print_skip("SEO tier")
-
-    # Priority 7 — Lighthouse / E2E
-    if url and "e2e" not in skip:
-        print_header("Priority 7 — Lighthouse / E2E")
-        if not run_check("Playwright E2E", ["npx", "playwright", "test"], project_root):
-            failures += 1
-    elif not url:
-        print_skip("E2E / Lighthouse — pass --url to enable")
-
-    # ━━━ Summary ━━━
-    print(f"\n{BOLD}━━━ Checklist Summary ━━━{RESET}")
-    if failures == 0:
-        print_ok(f"All checks passed — ready to proceed")
-    else:
-        print_fail(f"{failures} tier(s) failed — fix Critical issues before proceeding")
-
-    return failures
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="Tribunal project checklist runner")
-    parser.add_argument("path", help="Project root directory")
-    parser.add_argument("--url", help="Local server URL for Lighthouse/E2E checks", default=None)
-    parser.add_argument("--skip", help="Comma-separated tiers to skip (security,lint,schema,tests,ux,seo,e2e)", default="")
-    args = parser.parse_args()
-
-    project_root = os.path.abspath(args.path)
-    if not os.path.isdir(project_root):
-        print_fail(f"Directory not found: {project_root}")
-        sys.exit(1)
-
-    skip = [s.strip().lower() for s in args.skip.split(",") if s.strip()]
-
-    print(f"{BOLD}Tribunal Checklist — {project_root}{RESET}")
-    failures = run_all(project_root, args.url, skip)
-    sys.exit(1 if failures > 0 else 0)
-
-
-if __name__ == "__main__":
-    main()

package/.agent/scripts/compress_skills.py

@@ -1,167 +0,0 @@
-#!/usr/bin/env python3
-"""
-compress_skills.py - Aggressive token reduction for .agent/skills/**/*.md files
-WHAT IT DOES:
-  1. Strips ## 🏛️ Tribunal Integration sections (in GEMINI.md globally)
-  2. Strips ## ✅ Pre-Flight Self-Audit sections (duplication)
-  3. Strips ## Cross-Workflow Navigation sections
-  4. Strips ## Output Format sections
-  5. Strips inline comment blocks inside code (// Description of obvious stuff)
-  6. Collapses 3+ empty lines → 1
-  7. Removes chatty intro paragraphs (patterns like "X is Y. If you Z, you're Z.")
-"""
-
-import os, re, sys
-
-# ─── Section strippers ──────────────────────────────────────────────────────
-
-SECTION_PATTERNS = [
-    # Tribunal / pre-flight boilerplate (global in GEMINI.md)
-    r'(?m)^## 🏛️ Tribunal Integration[\s\S]*?(?=\n## |\n# |\Z)',
-    r'(?m)^## Tribunal Integration[\s\S]*?(?=\n## |\n# |\Z)',
-    r'(?m)^### ✅ Pre-Flight Self-Audit[\s\S]*?(?=\n## |\n### |\n# |\Z)',
-    r'(?m)^## Pre-Flight Self-Audit[\s\S]*?(?=\n## |\n# |\Z)',
-    r'(?m)^## Cross-Workflow Navigation[\s\S]*?(?=\n## |\n# |\Z)',
-    r'(?m)^## Output Format\s*\n```[\s\S]*?```\s*\n',
-    r'(?m)^## VBC Protocol[\s\S]*?(?=\n## |\n# |\Z)',
-    r'(?m)^## LLM Traps[\s\S]*?(?=\n## |\n# |\Z)',
-]
-
-# ─── Chatty intro line patterns ───────────────────────────────────────────
-# e.g. "React 19 is a paradigm shift. Server Components are the default."
-# These are after the frontmatter H1 title — motivational filler.
-CHATTY_INTRO = re.compile(
-    r'(?m)^(# .+\n)\n[A-Z][^#\n]{60,}\n[A-Z][^#\n]{40,}\n\n---',
-)
-
-def strip_chatty_intro(content):
-    def replace(m):
-        return m.group(1) + '\n---'
-    return CHATTY_INTRO.sub(replace, content)
-
-# ─── Trim verbose inline comments in code blocks ─────────────────────────
-# Removes "// comment that just restates the surrounding code name"
-OBVIOUS_COMMENT = re.compile(
-    r'(?m)^(\s*)(// (default for most properties|shorthand|number of repeats|default: \d+|spring tension|resistance|weight|approximate duration|deceleration rate)[^\n]*)\n'
-)
-
-def strip_obvious_comments(content):
-    return OBVIOUS_COMMENT.sub('', content)
-
-# ─── Long repetitive ✅/❌ rule blocks that repeat main section ────────────
-# These are usually "Performance Rules" text blocks restating code above
-PERF_TEXT_BLOCK = re.compile(
-    r'(?m)^```\n(✅ Use \w[^\n]*\n   → [^\n]*\n\n?){3,}```\n'
-)
-def compress_perf_blocks(content):
-    def to_bullets(m):
-        text = m.group(0)
-        lines = text.strip('`\n').splitlines()
-        bullets = []
-        for line in lines:
-            stripped = line.strip()
-            if stripped.startswith('✅') or stripped.startswith('❌'):
-                bullets.append(f'- {stripped}')
-            elif stripped.startswith('→'):
-                bullets[-1] += f' ({stripped[1:].strip()})'
-        return '\n'.join(bullets) + '\n'
-    return PERF_TEXT_BLOCK.sub(to_bullets, content)
-
-# ─── Collapse empty lines ────────────────────────────────────────────────
-def collapse_blanks(content):
-    return re.sub(r'\n{3,}', '\n\n', content)
-
-# ─── Remove "This is X — not Y" filler sentences before the first ## ─────
-FILLER_BEFORE_SECTION = re.compile(
-    r'(?m)(^# .+\n\n)([A-Z][^\n]+\n){1,4}(\n---\n)',
-    re.MULTILINE
-)
-def remove_filler_between_title_and_hr(content):
-    def replacement(m):
-        return m.group(1) + m.group(3)
-    return FILLER_BEFORE_SECTION.sub(replacement, content)
-
-# ─── Strip redundant version comment banners ────────────────────────────
-# e.g. "// motion.div, motion.span, motion.button, motion.svg, motion.path, etc."
-# "// Any HTML or SVG element can be prefixed with `motion.`" - obvious
-REDUNDANT_NOTE = re.compile(r'(?m)^// (motion\.\w+|Any HTML|Note:|Variant names propagate|// )[^\n]*\n')
-
-def strip_redundant_notes(content):
-    return REDUNDANT_NOTE.sub('', content)
-
-# ─── Main pipeline ────────────────────────────────────────────────────────
-
-def compress_file(path):
-    with open(path, 'r', encoding='utf-8', errors='ignore') as f:
-        original = f.read()
-
-    content = original
-
-    # 1. Strip global boilerplate sections
-    for pattern in SECTION_PATTERNS:
-        content = re.sub(pattern, '', content)
-
-    # 2. Remove chatty intro paragraphs
-    content = strip_chatty_intro(content)
-
-    # 3. Remove filler between title and first ---
-    content = remove_filler_between_title_and_hr(content)
-
-    # 4. Strip obvious inline comments from code
-    content = strip_obvious_comments(content)
-
-    # 5. Strip redundant notes
-    content = strip_redundant_notes(content)
-
-    # 6. Compress verbose perf rule text blocks to bullet lists
-    content = compress_perf_blocks(content)
-
-    # 7. Collapse 3+ blank lines
-    content = collapse_blanks(content)
-
-    # Write back
-    with open(path, 'w', encoding='utf-8') as f:
-        f.write(content.strip() + '\n')
-
-    saved = len(original) - len(content)
-    return len(original), len(content), saved
-
-def main():
-    base = '.agent/skills'
-    if not os.path.exists(base):
-        print(f"ERROR: '{base}' not found. Run from tribunal-kit root.", file=sys.stderr)
-        sys.exit(1)
-
-    total_orig = 0
-    total_new = 0
-    results = []
-
-    for root, _, files in os.walk(base):
-        for fname in files:
-            if fname.endswith('.md'):
-                path = os.path.join(root, fname)
-                orig, new, saved = compress_file(path)
-                total_orig += orig
-                total_new += new
-                if saved > 0:
-                    results.append((saved, path))
-
-    results.sort(reverse=True)
-
-    print(f"\n{'='*55}")
-    print(f"  Skill Compression Complete")
-    print(f"{'='*55}")
-    print(f"  Original : {total_orig:,} bytes ({total_orig//1024}KB)")
-    print(f"  After    : {total_new:,} bytes ({total_new//1024}KB)")
-    saved_total = total_orig - total_new
-    pct = saved_total / total_orig * 100 if total_orig else 0
-    print(f"  Saved    : {saved_total:,} bytes ({saved_total//1024}KB) — {pct:.1f}%")
-    print(f"\n  Top savings:")
-    for saved, path in results[:15]:
-        skill = os.path.basename(os.path.dirname(path))
-        fname = os.path.basename(path)
-        print(f"    -{saved//1024:2}KB  {skill}/{fname}")
-    print()
-
-if __name__ == '__main__':
-    main()

package/.agent/scripts/consolidate_skills.py

@@ -1,173 +0,0 @@
-#!/usr/bin/env python3
-"""
-consolidate_skills.py
-Merges all sub-files in skill directories into the main SKILL.md.
-Strips: verbose intros, output format blocks, run scripts tables,
-        mandatory read tables, empty headers, redundant boilerplate.
-Keeps:  all code blocks, hallucination traps, checklist items.
-
-Usage:
-  python .agent/scripts/consolidate_skills.py [skill_name]
-  python .agent/scripts/consolidate_skills.py               # all skills
-"""
-
-import os, re, sys
-
-BASE = '.agent/skills'
-
-# These patterns are global (GEMINI.md) — strip from sub-files before merge
-STRIP_PATTERNS = [
-    r'(?ms)^## 🏛️ Tribunal Integration.*?(?=^## |\Z)',
-    r'(?ms)^## Tribunal Integration.*?(?=^## |\Z)',
-    r'(?ms)^### ✅ Pre-Flight Self-Audit.*?(?=^###|^## |\Z)',
-    r'(?ms)^## Pre-Flight Self-Audit.*?(?=^## |\Z)',
-    r'(?ms)^## Output Format\b.*?(?=^## |\Z)',
-    r'(?ms)^## 🔧 Runtime Scripts.*?(?=^## |\Z)',
-    r'(?ms)^## 🔴 MANDATORY.*?(?=^## |\Z)',
-    r'(?ms)^## ⚠️ CRITICAL: ASK BEFORE ASSUMING.*?(?=^## |\Z)',
-    r'(?ms)^## 📝 CHECKPOINT \(MANDATORY.*?(?=^## |\Z)',
-    r'(?ms)^## Output Format.*?```\n[^`]*```\n?(?=^## |\Z)',
-    r'(?ms)^\*\*Execute these for validation.*?---\n',
-    r'(?ms)^\*\*VBC \(Verification-Before-Completion\).*?\n',
-    # MANDATORY read tables
-    r'(?ms)^\*\*⛔ DO NOT start.*?---\n?',
-    r'(?ms)^> 🧠 \*\*mobile-design.*?\n',
-    r'(?ms)^> \*\*STOP.*?\n',
-]
-
-# Heading level adjustment (sub-files use H1 — convert to H2 in merged output)
-def adjust_headings(content, offset=1):
-    """Promote headings by adding # chars"""
-    lines = content.split('\n')
-    out = []
-    for line in lines:
-        m = re.match(r'^(#{1,5}) ', line)
-        if m:
-            level = len(m.group(1))
-            new_level = min(level + offset, 6)
-            line = '#' * new_level + line[level:]
-        out.append(line)
-    return '\n'.join(out)
-
-def clean_content(content):
-    """Apply strip patterns"""
-    for p in STRIP_PATTERNS:
-        content = re.sub(p, '', content)
-    content = re.sub(r'\n{3,}', '\n\n', content)
-    return content.strip()
-
-def extract_frontmatter(content):
-    """Return (frontmatter_dict_str, body)"""
-    m = re.match(r'^---\n(.*?)\n---\n', content, re.DOTALL)
-    if m:
-        return m.group(1), content[m.end():]
-    return '', content
-
-def get_sub_title(content):
-    """Get first H1 from a sub-file"""
-    m = re.search(r'^# (.+)', content, re.MULTILINE)
-    return m.group(1) if m else None
-
-def consolidate(skill_dir):
-    skill_name = os.path.basename(skill_dir)
-    main_path = os.path.join(skill_dir, 'SKILL.md')
-    if not os.path.exists(main_path):
-        return False
-
-    # Find sub-files (non-SKILL.md markdown files)
-    sub_files = sorted([
-        f for f in os.listdir(skill_dir)
-        if f.endswith('.md') and f != 'SKILL.md'
-    ])
-
-    if not sub_files:
-        return False
-
-    print(f'\n  → Consolidating: {skill_name} ({len(sub_files)} sub-files)')
-
-    # Read main SKILL.md
-    main_content = open(main_path, 'r', encoding='utf-8', errors='ignore').read()
-    frontmatter, main_body = extract_frontmatter(main_content)
-
-    # Clean & update frontmatter version
-    fm_lines = frontmatter.split('\n')
-    new_fm = []
-    for line in fm_lines:
-        if line.startswith('version:'):
-            new_fm.append('version: 3.1.0')
-        elif line.startswith('last-updated:'):
-            new_fm.append('last-updated: 2026-04-06')
-        else:
-            new_fm.append(line)
-    frontmatter = '\n'.join(new_fm)
-
-    # Clean main body
-    main_body = clean_content(main_body)
-
-    # Remove MANDATORY read table from main body
-    # (links like [file.md](file.md) in tables)
-    main_body = re.sub(r'\|.*?\.md.*?\|.*?\|.*?\|\n', '', main_body)
-    main_body = re.sub(r'^\|[-| ]+\|\n', '', main_body, flags=re.MULTILINE)
-    main_body = re.sub(r'\n{3,}', '\n\n', main_body)
-
-    # Merge sub-files
-    merged_sections = []
-    for fname in sub_files:
-        fpath = os.path.join(skill_dir, fname)
-        raw = open(fpath, 'r', encoding='utf-8', errors='ignore').read()
-        _, body = extract_frontmatter(raw)
-        body = clean_content(body)
-        # Adjust headings: H1→H2, H2→H3, etc.
-        body = adjust_headings(body, offset=1)
-        if body.strip():
-            merged_sections.append(body.strip())
-
-    # Build final output
-    combined = f'---\n{frontmatter}\n---\n\n{main_body}'
-    if merged_sections:
-        combined += '\n\n---\n\n' + '\n\n---\n\n'.join(merged_sections)
-
-    # Final cleanup
-    combined = re.sub(r'\n{3,}', '\n\n', combined)
-    combined = combined.strip() + '\n'
-
-    # Measure savings
-    total_sub_bytes = sum(os.path.getsize(os.path.join(skill_dir, f)) for f in sub_files)
-    print(f'     Sub-files total: {total_sub_bytes//1024}KB')
-
-    # Write consolidated SKILL.md
-    with open(main_path, 'w', encoding='utf-8') as f:
-        f.write(combined)
-
-    new_size = os.path.getsize(main_path)
-    print(f'     New SKILL.md:    {new_size//1024}KB  (from {len(main_content)//1024}KB main + {total_sub_bytes//1024}KB subs → {new_size//1024}KB)')
-
-    # Delete sub-files
-    for fname in sub_files:
-        os.remove(os.path.join(skill_dir, fname))
-        print(f'     Deleted: {fname}')
-
-    return True
-
-def main():
-    target = sys.argv[1] if len(sys.argv) > 1 else None
-
-    total_saved = 0
-    processed = 0
-
-    for skill_name in os.listdir(BASE):
-        skill_dir = os.path.join(BASE, skill_name)
-        if not os.path.isdir(skill_dir):
-            continue
-        if target and skill_name != target:
-            continue
-        if consolidate(skill_dir):
-            processed += 1
-
-    if processed == 0:
-        print('No skills with sub-files found (or target not matched).')
-    else:
-        print(f'\n✅ Consolidated {processed} skills.')
-
-if __name__ == '__main__':
-    main()