tribunal-kit 5.8.2 → 5.8.4

package/.agent/ARCHITECTURE.md

@@ -71,7 +71,7 @@ Type any of these in your AI IDE chat:
 
 ---
 
-## The 19 Tribunal Agents
+## The 20 Tribunal Reviewers
 
 | Agent                    | File                               | Activates When                                                                      |
 | ------------------------ | ---------------------------------- | ----------------------------------------------------------------------------------- |
@@ -150,7 +150,7 @@ The Swarm system decomposes complex multi-domain goals into independent sub-task
 | `agent-organizer`           | Specialist agent operations                     |
 | `project-planner`           | 4-phase structured planning                     |
 | `backend-specialist`        | API, server, auth                               |
-| `dotnet-core-expert`        | C# / .NET architecture                          |
+| `csharp-developer`          | C# / .NET architecture                          |
 | `python-pro`                | Python backend development                      |
 | `frontend-specialist`       | Web UI / Components                             |
 | `react-specialist`          | React / Next.js architecture                    |
@@ -228,17 +228,17 @@ All scripts live in `.agent/scripts/`:
 | -------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------- |
 | `checklist.js`             | Priority-ordered project audit                                                    | `node .agent/scripts/checklist.js .`                          |
 | `verify_all.js`            | Full pre-deploy validation                                                        | `node .agent/scripts/verify_all.js`                           |
-| `auto_preview.py`          | Local dev server management                                                       | `python .agent/scripts/auto_preview.py start`                 |
+| `auto_preview.js`          | Local dev server management                                                       | `node .agent/scripts/auto_preview.js start`                   |
 | `session_manager.js`       | Multi-session state tracking                                                      | `node .agent/scripts/session_manager.js status`               |
-| `lint_runner.py`           | Standalone lint runner                                                            | `python .agent/scripts/lint_runner.py . --fix`                |
-| `test_runner.py`           | Auto-detecting test runner                                                        | `python .agent/scripts/test_runner.py . --coverage`           |
+| `lint_runner.js`           | Standalone lint runner                                                            | `node .agent/scripts/lint_runner.js . --fix`                  |
+| `test_runner.js`           | Auto-detecting test runner                                                        | `node .agent/scripts/test_runner.js . --coverage`             |
 | `security_scan.js`         | OWASP-aware source code scanner                                                   | `node .agent/scripts/security_scan.js .`                      |
-| `dependency_analyzer.py`   | Unused/phantom dep checker                                                        | `python .agent/scripts/dependency_analyzer.py . --audit`      |
-| `schema_validator.py`      | DB schema validator                                                               | `python .agent/scripts/schema_validator.py .`                 |
-| `bundle_analyzer.py`       | JS/TS bundle size analyzer                                                        | `python .agent/scripts/bundle_analyzer.py . --build`          |
-| `strengthen_skills.py`     | Appends Tribunal guardrails (LLM Traps + Pre-Flight + VBC) to skills missing them | `python .agent/scripts/strengthen_skills.py . --dry-run`      |
+| `dependency_analyzer.js`   | Unused/phantom dep checker                                                        | `node .agent/scripts/dependency_analyzer.js . --audit`        |
+| `schema_validator.js`      | DB schema validator                                                               | `node .agent/scripts/schema_validator.js .`                   |
+| `bundle_analyzer.js`       | JS/TS bundle size analyzer                                                        | `node .agent/scripts/bundle_analyzer.js . --build`            |
+| `strengthen_skills.js`     | Appends Tribunal guardrails (LLM Traps + Pre-Flight + VBC) to skills missing them | `node .agent/scripts/strengthen_skills.js . --dry-run`        |
 | `swarm_dispatcher.js`      | Validate Orchestrator micro-worker JSON payloads                                  | `node .agent/scripts/swarm_dispatcher.js --file payload.json` |
-| `skill_integrator.py`      | Map active skills to executable scripts                                           | `python .agent/scripts/skill_integrator.py`                   |
+| `skill_integrator.js`      | Map active skills to executable scripts                                           | `node .agent/scripts/skill_integrator.js`                     |
 | `test_swarm_dispatcher.js` | Unit tests for swarm_dispatcher                                                   | `npx jest test/integration/swarm_dispatcher.test.js`          |
 
 ---
@@ -267,12 +267,12 @@ Script failures follow cascade rules:
 .agent/
 ├── ARCHITECTURE.md          ← This file
 ├── GEMINI.md                ← Root behavior config (includes /swarm routing)
-├── agents/                  ← 43 specialist + reviewer agents (19 reviewers + 24 domain)
+├── agents/                  ← 44 specialist + reviewer agents (19 reviewers + 25 domain)
 │   ├── supervisor-agent.md  ← Swarm triage, dispatch, synthesis
 │   ├── swarm-worker-contracts.md  ← WorkerRequest/WorkerResult schemas
 │   └── swarm-worker-registry.md   ← Task type → agent routing map
 ├── rules/GEMINI.md          ← Master rules (P0 priority)
-├── scripts/                 ← 28 Python/JS automation scripts
+├── scripts/                 ← 29 JS automation scripts
 ├── skills/                  ← 106 modular skill packages (all hardened)
 ├── patterns/                ← 5 ADK skill base patterns
 ├── history/                 ← Case Law + Skill Evolution data (user-generated, preserved on update)

package/.agent/agents/complexity-reviewer.md

@@ -0,0 +1,53 @@
+---
+name: complexity-reviewer
+description: Enforces the Dependency Ladder to prevent over-engineering. Audits every generated code snippet for redundant dependencies, unnecessary abstractions, premature optimization, and custom implementations of standard library or native platform features. Activates automatically on all /generate, /review, and /tribunal-* commands.
+version: 1.0.0
+last-updated: 2026-07-18
+---
+
+# Complexity Reviewer — The Pragmatist
+
+---
+
+## Core Mandate
+
+You have one job: enforce the **Dependency Ladder** and prevent over-engineering. Audit code changes to ensure that the developer has chosen the simplest possible implementation and avoided unnecessary dependencies.
+
+**Your burden of proof:** Every custom utility or imported package must justify its existence. If a feature can be implemented using native platform elements, standard library functions, or packages already present in `package.json`, you must reject the proposal and guide the developer back down the ladder.
+
+---
+
+## The 6 Rungs of the Dependency Ladder
+
+Before code is accepted, you must verify that the implementation sits at the lowest successful rung:
+
+1. **Existence**: Does the feature actually need to exist?
+2. **Stdlib**: Can this be done with the language standard library?
+3. **Platform**: Can the native platform (HTML5, CSS, Web APIs, standard browser features) handle it?
+4. **Installed Dep**: Can an already-installed dependency solve it?
+5. **One Line**: Can this be solved in a single line of custom code?
+6. **Minimum**: Write the absolute minimum custom code that works (no premature abstractions).
+
+---
+
+## Section 1: Common Over-Engineering Patterns to Reject
+
+| Anti-Pattern | Why It's Rejected | Real Alternative (Lower Rung) |
+| :--- | :--- | :--- |
+| Importing `lodash` or similar utility library | Standard library handles most collections/strings | Use native `Array.prototype` methods or modern JS features |
+| Custom React/Vue slider/carousel component | Heavy, complex, prone to accessibility bugs | Native CSS Scroll Snap or standard platform elements |
+| Hand-rolling custom cryptographic / hashing utils | Prone to security vulnerabilities and bugs | Use standard Node.js `crypto` or Web Crypto API |
+| Elaborate helper/wrapper layers for simple APIs | Wastes context, adds cognitive overhead | Direct API consumption (Keep It Simple) |
+| Adding new NPM packages for simple tasks | Bloats bundle, introduces supply-chain risk | Write a simple pure function locally |
+
+---
+
+## Section 2: Review Verdict Guidelines
+
+Your review should output one of two verdicts:
+
+### 1. `✅ APPROVED`
+The code is simple, uses native platform capabilities, does not introduce unnecessary dependencies, and follows the Dependency Ladder.
+
+### 2. `❌ REJECTED`
+The code is over-engineered, introduces a redundant dependency, or implements custom logic where a standard library/platform API exists. Provide a clear alternative showing how to rewrite the code at a lower rung.

package/.agent/agents/precedence-reviewer.md

@@ -59,7 +59,7 @@ Keywords to flag:
 Run the following command to search for relevant precedents:
 
 ```bash
-python .agent/scripts/case_law_manager.py search-cases --query "<extracted keywords>"
+node .agent/scripts/case_law_manager.js search-cases --query "<extracted keywords>"
 ```
 
 This uses **TF-IDF weighted cosine similarity**. No LLM is called. No tokens consumed.
@@ -95,7 +95,7 @@ reviewer delivers a verdict.
   □ Developer explicitly overrides this precedent (requires human approval)
 
   To override, run:
-    python .agent/scripts/case_law_manager.py add-case
+    node .agent/scripts/case_law_manager.js add-case
   And record a new case with verdict: APPROVED_WITH_CONDITIONS
 ```
 
@@ -109,7 +109,7 @@ reviewer delivers a verdict.
   Summary        : [REASON_SUMMARY]
 
   The proposed code may be related to a past decision. Review before approving.
-  Run: python .agent/scripts/case_law_manager.py show --id [ID]
+  Run: node .agent/scripts/case_law_manager.js show --id [ID]
 ```
 
 ### If similarity score < 0.2 → CLEAR
@@ -131,7 +131,7 @@ Case Law, prompt the developer:
   The [reviewer-name] just rejected code for a new reason not in Case Law.
   Record this decision to prevent future repetition:
 
-    python .agent/scripts/case_law_manager.py add-case
+    node .agent/scripts/case_law_manager.js add-case
 
   This takes < 60 seconds and permanently strengthens your Tribunal.
 ```
@@ -148,7 +148,7 @@ rejection as a new case. This is NOT optional — the Supreme Court depends on i
 **Action:** Run the following command (non-interactive, no human input needed):
 
 ```bash
-python .agent/scripts/case_law_manager.py auto-record \
+node .agent/scripts/case_law_manager.js auto-record \
   --diff "<the rejected code snippet>" \
   --reason "<the reviewer's rejection reason>" \
   --domain <domain> \
@@ -229,23 +229,23 @@ Human Gate receives your hold as a hard blocker alongside their verdicts.
 
 ```bash
 # Search Case Law (TF-IDF cosine — zero tokens)
-python .agent/scripts/case_law_manager.py search-cases --query "useEffect dependency"
+node .agent/scripts/case_law_manager.js search-cases --query "useEffect dependency"
 
 # Record a new rejection (interactive)
-python .agent/scripts/case_law_manager.py add-case
+node .agent/scripts/case_law_manager.js add-case
 
 # Auto-record a rejection (non-interactive — for AI agents)
-python .agent/scripts/case_law_manager.py auto-record --diff "code" --reason "why" --domain security
+node .agent/scripts/case_law_manager.js auto-record --diff "code" --reason "why" --domain security
 
 # View full case
-python .agent/scripts/case_law_manager.py show --id 7
+node .agent/scripts/case_law_manager.js show --id 7
 
 # Overrule a past precedent
-python .agent/scripts/case_law_manager.py overrule --id 7 --reason "no longer applicable"
+node .agent/scripts/case_law_manager.js overrule --id 7 --reason "no longer applicable"
 
 # See all cases
-python .agent/scripts/case_law_manager.py list
+node .agent/scripts/case_law_manager.js list
 
 # Export full history
-python .agent/scripts/case_law_manager.py export
+node .agent/scripts/case_law_manager.js export
 ```

package/.agent/agents/swarm-worker-registry.md

@@ -16,7 +16,7 @@ All agents listed here MUST exist as `.md` files in `.agent/agents/`.
 | `research`       | performance, profiling, optimization             | `performance-optimizer` |
 | `generate_code`  | api, route, endpoint, server, express, auth, jwt | `backend-specialist`    |
 | `generate_code`  | python, fastapi, django, flask                   | `python-pro`            |
-| `generate_code`  | c#, .net, blazor, aspnet                         | `dotnet-core-expert`    |
+| `generate_code`  | c#, .net, blazor, aspnet                         | `csharp-developer`      |
 | `generate_code`  | component, hook, react, next, ui, css            | `frontend-specialist`   |
 | `generate_code`  | mobile, react native, flutter, ios, android      | `mobile-developer`      |
 | `generate_code`  | docker, ci, cd, deploy, github actions, cloud    | `devops-engineer`       |
@@ -54,7 +54,7 @@ Quick reference for Supervisor triage. Full instructions are in each agent's `.m
 | -------------------------- | ------------------------------------------------ | ----------------------- |
 | `backend-specialist.md`    | REST APIs, auth flows, server logic              | React components        |
 | `python-pro.md`            | FastAPI, Django, data scripts                    | Node/TypeScript code    |
-| `dotnet-core-expert.md`    | .NET 8+, C#, Blazor, AOT                         | Python or Node backends |
+| `csharp-developer`         | .NET 8+, C#, Blazor, AOT                         | Python or Node backends |
 | `frontend-specialist.md`   | Web UI, CSS, components                          | Server code             |
 | `react-specialist.md`      | Advanced React patterns, Next.js architecture    | Vue or mobile           |
 | `vue-expert.md`            | Vue 3, Nuxt 3, Pinia                             | React or Angular        |
@@ -89,4 +89,4 @@ When a new specialist agent is added to `.agent/agents/`, update this registry:
 
 1. Add a row to the **Primary Routing Table** for each `type` and keyword combination it handles
 2. Add a row to the **Agent Capability Summary** with "Best For" and "Do NOT Use For" guidance
-3. Run `python .agent/scripts/config-validator.py` to verify consistency
+3. Run `node .agent/scripts/verify_all.js` to verify consistency