tribunal-kit 4.2.0 → 4.3.0

package/.agent/scripts/minify_context.py

@@ -1,80 +0,0 @@
-import os
-import re
-
-def minify_markdown(file_path):
-    with open(file_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-
-    original_len = len(content)
-
-    # 1. Strip repetitive Output Format templates (These are huge and the LLM already knows how to output the Tribunal format from GEMINI.md)
-    content = re.sub(r'## Output Format\n\n```[\s\S]*?```\n', '', content)
-
-    # 2. Convert bloated Cross-Workflow Navigation tables to dense YAML lists
-    # Find tables under Cross-Workflow Navigation
-    def replace_table_with_list(match):
-        table_text = match.group(0)
-        lines = table_text.strip().split('\n')
-        out = []
-        for line in lines:
-            if line.startswith('|') and not line.startswith('|:') and not line.startswith('| After'):
-                parts = [p.strip() for p in line.split('|') if p.strip()]
-                if len(parts) >= 2:
-                    out.append(f"- {parts[0]} -> {parts[1]}")
-        return "\n".join(out) + "\n"
-
-    content = re.sub(r'## Cross-Workflow Navigation\n\n\|.*?\|[\s\S]*?(?=\n## |\Z)', lambda m: '## Cross-Workflow Navigation\n' + replace_table_with_list(m), content)
-
-    # 3. Collapse multiple empty lines into a single one
-    content = re.sub(r'\n{3,}', '\n\n', content)
-
-    # 4. Remove padding from remaining tables to save space tokens
-    def unpad_table(match):
-        line = match.group(0)
-        # remove spaces around |
-        line = re.sub(r'\s+\|\s+', '|', line)
-        line = re.sub(r'\|\s+', '|', line)
-        line = re.sub(r'\s+\|', '|', line)
-        return line
-    content = re.sub(r'^\|.+|$', unpad_table, content, flags=re.MULTILINE)
-
-    # 5. Remove conversational blockquotes > if they don't contain WARNING/NOTE/IMPORTANT
-    def remove_conversational_quotes(match):
-        text = match.group(0)
-        if '⚠️' in text or 'WARNING' in text or 'CRITICAL' in text or '!' in text:
-            return text
-        # Otherwise just return the text without quote
-        return text.replace('> ', '').replace('>', '')
-    content = re.sub(r'^>.*$', remove_conversational_quotes, content, flags=re.MULTILINE)
-
-    # 6. Dense Examples (convert ❌ Bad: and ✅ Good: blocks to single lines)
-    content = content.replace('\n❌ Bad:', ' ❌')
-    content = content.replace('\n✅ Good:', ' ✅')
-
-    with open(file_path, 'w', encoding='utf-8') as f:
-        f.write(content)
-
-    return original_len, len(content)
-
-def main():
-    agent_dir = os.path.join('.agent')
-    total_original = 0
-    total_new = 0
-
-    for root, _, files in os.walk(agent_dir):
-        for file in files:
-            if file.endswith('.md'):
-                file_path = os.path.join(root, file)
-                orig, new = minify_markdown(file_path)
-                total_original += orig
-                total_new += new
-
-    saved = total_original - total_new
-    percent = (saved / total_original * 100) if total_original > 0 else 0
-    print(f"Minification Complete.")
-    print(f"Original size: {total_original} bytes")
-    print(f"New size: {total_new} bytes")
-    print(f"Saved: {saved} bytes ({percent:.1f}%)")
-
-if __name__ == '__main__':
-    main()

package/.agent/scripts/patch_skills_meta.py

@@ -1,177 +0,0 @@
-#!/usr/bin/env python3
-"""
-patch_skills_meta.py — Injects version/freshness metadata into SKILL.md frontmatter.
-
-Adds the following fields to YAML frontmatter if missing:
-  version: 1.0.0
-  last-updated: 2026-03-12
-  applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
-
-Usage:
-  python .agent/scripts/patch_skills_meta.py .
-  python .agent/scripts/patch_skills_meta.py . --dry-run
-  python .agent/scripts/patch_skills_meta.py . --skill python-pro
-"""
-
-import os
-import sys
-import argparse
-import re
-from pathlib import Path
-
-RED    = "\033[91m"
-GREEN  = "\033[92m"
-YELLOW = "\033[93m"
-BLUE   = "\033[94m"
-BOLD   = "\033[1m"
-RESET  = "\033[0m"
-
-META_FIELDS = {
-    "version":           "1.0.0",
-    "last-updated":      "2026-03-12",
-    "applies-to-model":  "gemini-2.5-pro, claude-3-7-sonnet",
-}
-
-
-def header(title: str) -> None:
-    print(f"\n{BOLD}{BLUE}━━━ {title} ━━━{RESET}")
-
-
-def ok(msg: str) -> None:
-    print(f"  {GREEN}✅ {msg}{RESET}")
-
-
-def skip(msg: str) -> None:
-    print(f"  {YELLOW}⏭️  {msg}{RESET}")
-
-
-def warn(msg: str) -> None:
-    print(f"  {YELLOW}⚠️  {msg}{RESET}")
-
-
-def fail(msg: str) -> None:
-    print(f"  {RED}❌ {msg}{RESET}")
-
-
-def patch_frontmatter(content: str) -> tuple[str, list[str]]:
-    """
-    Parse the YAML frontmatter block and inject missing meta fields.
-    Returns (patched_content, list_of_added_fields).
-    If no frontmatter is found, injects a minimal one.
-    """
-    added: list[str] = []
-
-    # Match frontmatter block: starts and ends with ---
-    fm_pattern = re.compile(r"^---\r?\n(.*?)\r?\n---", re.DOTALL)
-    match = fm_pattern.match(content)
-
-    if not match:
-        # No frontmatter — prepend a minimal block
-        new_fm_lines = ["---"]
-        for key, value in META_FIELDS.items():
-            new_fm_lines.append(f"{key}: {value}")
-            added.append(key)
-        new_fm_lines.append("---")
-        new_fm = "\n".join(new_fm_lines)
-        return new_fm + "\n\n" + content, added
-
-    fm_text = match.group(1)
-    fm_end = match.end()
-
-    # Parse existing lines preserving order
-    existing_keys = set()
-    for line in fm_text.splitlines():
-        m = re.match(r"^([a-zA-Z0-9_-]+)\s*:", line)
-        if m:
-            existing_keys.add(m.group(1))
-
-    # Build new frontmatter
-    new_fm_lines = fm_text.rstrip().splitlines()
-    for key, value in META_FIELDS.items():
-        if key not in existing_keys:
-            new_fm_lines.append(f"{key}: {value}")
-            added.append(key)
-
-    if not added:
-        return content, []
-
-    new_fm_block = "---\n" + "\n".join(new_fm_lines) + "\n---"
-    patched = new_fm_block + content[fm_end:]
-    return patched, added
-
-
-def process_skill(skill_path: Path, dry_run: bool) -> str:
-    """Process a single SKILL.md. Returns 'updated', 'skipped', or 'error'."""
-    try:
-        content = skill_path.read_text(encoding="utf-8")
-        patched, added = patch_frontmatter(content)
-
-        skill_name = skill_path.parent.name
-
-        if not added:
-            skip(f"{skill_name} — all meta fields present")
-            return "skipped"
-
-        field_list = ", ".join(added)
-        if dry_run:
-            warn(f"[DRY RUN] {skill_name} — would add: {field_list}")
-            return "updated"
-
-        skill_path.write_text(patched, encoding="utf-8")
-        ok(f"{skill_name} — added: {field_list}")
-        return "updated"
-
-    except Exception as e:
-        fail(f"{skill_path.parent.name} — {e}")
-        return "error"
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Injects version/freshness metadata into SKILL.md frontmatter"
-    )
-    parser.add_argument("path", help="Project root directory")
-    parser.add_argument("--dry-run", action="store_true", help="Show changes without writing")
-    parser.add_argument("--skill", help="Only patch a specific skill by name")
-    args = parser.parse_args()
-
-    project_root = Path(args.path).resolve()
-    skills_dir = project_root / ".agent" / "skills"
-
-    if not skills_dir.is_dir():
-        fail(f"Skills directory not found: {skills_dir}")
-        sys.exit(1)
-
-    print(f"{BOLD}Tribunal — patch_skills_meta.py{RESET}")
-    if args.dry_run:
-        print(f"  {YELLOW}DRY RUN — no files will be written{RESET}")
-    print(f"Skills dir: {skills_dir}\n")
-
-    counts = {"updated": 0, "skipped": 0, "error": 0}
-
-    header("Patching Frontmatter")
-    for skill_dir in sorted(skills_dir.iterdir()):
-        if not skill_dir.is_dir():
-            continue
-        if args.skill and skill_dir.name != args.skill:
-            continue
-        skill_md = skill_dir / "SKILL.md"
-        if not skill_md.exists():
-            warn(f"{skill_dir.name} — no SKILL.md found")
-            continue
-        result = process_skill(skill_md, args.dry_run)
-        counts[result] += 1
-
-    print(f"\n{BOLD}━━━ Summary ━━━{RESET}")
-    print(f"  {GREEN}✅ Updated:  {counts['updated']}{RESET}")
-    print(f"  {YELLOW}⏭️  Skipped:  {counts['skipped']}{RESET}")
-    if counts["error"]:
-        print(f"  {RED}❌ Errors:   {counts['error']}{RESET}")
-    if args.dry_run:
-        print(f"  {YELLOW}(dry-run — nothing written){RESET}")
-
-    sys.exit(1 if counts["error"] > 0 else 0)
-
-
-if __name__ == "__main__":
-    main()

package/.agent/scripts/patch_skills_output.py

@@ -1,285 +0,0 @@
-#!/usr/bin/env python3
-"""
-patch_skills_output.py — Adds structured Output Format sections to SKILL.md files.
-
-Inserts a domain-tailored '## Output Format' block before the Tribunal Integration
-section (or appends to the end if no Tribunal section is present).
-
-Skills already containing '## Output Format', '## Output', or '## Report Format'
-are skipped automatically.
-
-Usage:
-  python .agent/scripts/patch_skills_output.py .
-  python .agent/scripts/patch_skills_output.py . --dry-run
-  python .agent/scripts/patch_skills_output.py . --skill python-pro
-"""
-
-import os
-import sys
-import re
-import argparse
-from pathlib import Path
-
-RED    = "\033[91m"
-GREEN  = "\033[92m"
-YELLOW = "\033[93m"
-BLUE   = "\033[94m"
-BOLD   = "\033[1m"
-RESET  = "\033[0m"
-
-# ─── Templates ───────────────────────────────────────────────────────────────
-
-CODE_QUALITY_TEMPLATE = """\
-## Output Format
-
-When this skill produces or reviews code, structure your output as follows:
-
-```
-━━━ {skill_name} Report ━━━━━━━━━━━━━━━━━━━━━━━━
-Skill:       {skill_name}
-Language:    [detected language / framework]
-Scope:       [N files · N functions]
-─────────────────────────────────────────────────
-✅ Passed:   [checks that passed, or "All clean"]
-⚠️  Warnings: [non-blocking issues, or "None"]
-❌ Blocked:  [blocking issues requiring fix, or "None"]
-─────────────────────────────────────────────────
-VBC status:  PENDING → VERIFIED
-Evidence:    [test output / lint pass / compile success]
-```
-
-**VBC (Verification-Before-Completion) is mandatory.**
-Do not mark status as VERIFIED until concrete terminal evidence is provided.
-
-"""
-
-DECISION_CARD_TEMPLATE = """\
-## Output Format
-
-When this skill produces a recommendation or design decision, structure your output as:
-
-```
-━━━ {skill_name} Recommendation ━━━━━━━━━━━━━━━━
-Decision:    [what was chosen / proposed]
-Rationale:   [why — one concise line]
-Trade-offs:  [what is consciously accepted]
-Next action: [concrete next step for the user]
-─────────────────────────────────────────────────
-Pre-Flight:  ✅ All checks passed
-             or ❌ [blocking item that must be resolved first]
-```
-
-"""
-
-GENERIC_TEMPLATE = """\
-## Output Format
-
-When this skill completes a task, structure your output as:
-
-```
-━━━ {skill_name} Output ━━━━━━━━━━━━━━━━━━━━━━━━
-Task:        [what was performed]
-Result:      [outcome summary — one line]
-─────────────────────────────────────────────────
-Checks:      ✅ [N passed] · ⚠️  [N warnings] · ❌ [N blocked]
-VBC status:  PENDING → VERIFIED
-Evidence:    [link to terminal output, test result, or file diff]
-```
-
-"""
-
-# ─── Skill → template routing ────────────────────────────────────────────────
-
-CODE_GEN_SKILLS = {
-    "python-pro", "clean-code", "dotnet-core-expert", "rust-pro",
-    "nextjs-react-expert", "vue-expert", "react-specialist",
-    "csharp-developer", "nodejs-best-practices", "python-patterns",
-    "tailwind-patterns", "bash-linux", "powershell-windows",
-    "llm-engineering", "mcp-builder", "game-development",
-    "edge-computing", "local-first", "realtime-patterns",
-    "tdd-workflow", "testing-patterns", "lint-and-validate",
-}
-
-DECISION_SKILLS = {
-    "api-patterns", "database-design", "architecture", "observability",
-    "devops-engineer", "platform-engineer", "deployment-procedures",
-    "server-management", "security-auditor", "vulnerability-scanner",
-    "red-team-tactics", "performance-profiling", "i18n-localization",
-    "geo-fundamentals", "seo-fundamentals", "sql-pro",
-    "brainstorming", "plan-writing", "behavioral-modes",
-    "app-builder", "intelligent-routing", "mobile-design",
-    "frontend-design", "ui-ux-pro-max", "ui-ux-researcher",
-    "web-design-guidelines", "trend-researcher",
-}
-
-# Skills that already have output format sections — SKIP
-ALREADY_HAVE_OUTPUT = {
-    "whimsy-injector", "workflow-optimizer",
-}
-
-# Markers indicating an existing output section
-EXISTING_OUTPUT_MARKERS = [
-    "## Output Format",
-    "## Output\n",
-    "## Report Format",
-    "## Output Card",
-    "Whimsy Injection Report",
-    "Workflow Optimization Report",
-]
-
-# ─── Logic ───────────────────────────────────────────────────────────────────
-
-def get_template(skill_name: str) -> str:
-    if skill_name in CODE_GEN_SKILLS:
-        return CODE_QUALITY_TEMPLATE
-    if skill_name in DECISION_SKILLS:
-        return DECISION_CARD_TEMPLATE
-    return GENERIC_TEMPLATE
-
-
-def has_output_section(content: str) -> bool:
-    for marker in EXISTING_OUTPUT_MARKERS:
-        if marker in content:
-            return True
-    return False
-
-
-def get_skill_name_from_frontmatter(content: str) -> str | None:
-    """Extract the 'name:' field from YAML frontmatter."""
-    match = re.search(r"^name:\s*(.+)$", content, re.MULTILINE)
-    return match.group(1).strip() if match else None
-
-
-def build_block(template: str, skill_name: str) -> str:
-    # Capitalise display name
-    display = skill_name.replace("-", " ").title()
-    return template.replace("{skill_name}", display)
-
-
-def inject_output_block(content: str, block: str) -> str:
-    """
-    Insert block before '## 🏛️ Tribunal Integration' if present,
-    otherwise append to end of file.
-    """
-    tribunal_markers = [
-        "## 🏛️ Tribunal Integration",
-        "## Tribunal Integration",
-    ]
-    for marker in tribunal_markers:
-        idx = content.find(marker)
-        if idx != -1:
-            return content[:idx] + block + "\n---\n\n" + content[idx:]
-
-    # Append to end with a separator
-    return content.rstrip() + "\n\n---\n\n" + block
-
-
-def process_skill(skill_dir: Path, dry_run: bool) -> str:
-    """Returns 'updated', 'skipped', or 'error'."""
-    skill_name = skill_dir.name
-    skill_md = skill_dir / "SKILL.md"
-
-    if not skill_md.exists():
-        return "skipped"
-
-    try:
-        content = skill_md.read_text(encoding="utf-8")
-
-        if skill_name in ALREADY_HAVE_OUTPUT or has_output_section(content):
-            skip(f"{skill_name} — output format already present")
-            return "skipped"
-
-        # Determine display name
-        display_name = get_skill_name_from_frontmatter(content) or skill_name
-        template = get_template(skill_name)
-        block = build_block(template, display_name)
-        patched = inject_output_block(content, block)
-
-        if dry_run:
-            template_type = (
-                "Code Quality" if skill_name in CODE_GEN_SKILLS
-                else "Decision Card" if skill_name in DECISION_SKILLS
-                else "Generic"
-            )
-            warn(f"[DRY RUN] {skill_name} — would add Output Format ({template_type})")
-            return "updated"
-
-        skill_md.write_text(patched, encoding="utf-8")
-        template_type = (
-            "Code Quality" if skill_name in CODE_GEN_SKILLS
-            else "Decision Card" if skill_name in DECISION_SKILLS
-            else "Generic"
-        )
-        ok(f"{skill_name} — added Output Format ({template_type})")
-        return "updated"
-
-    except Exception as e:
-        fail(f"{skill_name} — {e}")
-        return "error"
-
-
-def header(title: str) -> None:
-    print(f"\n{BOLD}{BLUE}━━━ {title} ━━━{RESET}")
-
-
-def ok(msg: str) -> None:
-    print(f"  {GREEN}✅ {msg}{RESET}")
-
-
-def skip(msg: str) -> None:
-    print(f"  {YELLOW}⏭️  {msg}{RESET}")
-
-
-def warn(msg: str) -> None:
-    print(f"  {YELLOW}⚠️  {msg}{RESET}")
-
-
-def fail(msg: str) -> None:
-    print(f"  {RED}❌ {msg}{RESET}")
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Adds Output Format sections to SKILL.md files that are missing them"
-    )
-    parser.add_argument("path", help="Project root directory")
-    parser.add_argument("--dry-run", action="store_true", help="Show changes without writing")
-    parser.add_argument("--skill", help="Only patch a specific skill by name")
-    args = parser.parse_args()
-
-    project_root = Path(args.path).resolve()
-    skills_dir = project_root / ".agent" / "skills"
-
-    if not skills_dir.is_dir():
-        fail(f"Skills directory not found: {skills_dir}")
-        sys.exit(1)
-
-    print(f"{BOLD}Tribunal — patch_skills_output.py{RESET}")
-    if args.dry_run:
-        print(f"  {YELLOW}DRY RUN — no files will be written{RESET}")
-    print(f"Skills dir: {skills_dir}\n")
-
-    counts: dict[str, int] = {"updated": 0, "skipped": 0, "error": 0}
-
-    header("Patching Output Format Sections")
-    for skill_dir in sorted(skills_dir.iterdir()):
-        if not skill_dir.is_dir():
-            continue
-        if args.skill and skill_dir.name != args.skill:
-            continue
-        result = process_skill(skill_dir, args.dry_run)
-        counts[result] += 1
-
-    print(f"\n{BOLD}━━━ Summary ━━━{RESET}")
-    print(f"  {GREEN}✅ Updated:  {counts['updated']}{RESET}")
-    print(f"  {YELLOW}⏭️  Skipped:  {counts['skipped']}{RESET}")
-    if counts["error"]:
-        print(f"  {RED}❌ Errors:   {counts['error']}{RESET}")
-    if args.dry_run:
-        print(f"  {YELLOW}(dry-run — nothing written){RESET}")
-
-    sys.exit(1 if counts["error"] > 0 else 0)
-
-
-if __name__ == "__main__":
-    main()