tribunal-kit 4.2.0 → 4.3.0

package/.agent/skills/workflow-optimizer/SKILL.md

@@ -181,7 +181,7 @@ Before analyzing, check for these common quick wins:
 
 ---
 
-## 🤖 LLM-Specific Traps
+
 
 AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
 
@@ -193,7 +193,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
 
 ---
 
-## 🏛️ Tribunal Integration (Anti-Hallucination)
+
 
 **Slash command: `/review` or `/tribunal-full`**
 **Active reviewers: `logic-reviewer` · `security-auditor`**
@@ -204,7 +204,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
 
-### ✅ Pre-Flight Self-Audit
+
 
 Review these questions before confirming output:
 ```

package/.agent/workflows/audit.md

@@ -26,25 +26,25 @@ Security failures early in the pipeline halt subsequent steps. Lint/test failure
 
 ```
 Priority 1 — Security (HALT if critical finding)
-  python .agent/scripts/security_scan.py .
+  node .agent/scripts/security_scan.js .
 
 Priority 2 — Dependencies (HALT if exploitable CVE found)
-  python .agent/scripts/dependency_analyzer.py . --audit
+  node .agent/scripts/dependency_analyzer.js . --audit
 
 Priority 3 — Type Checking (CONTINUE but flag)
   npx tsc --noEmit
 
 Priority 4 — Lint (CONTINUE but flag as deployment blocker)
-  python .agent/scripts/lint_runner.py .
+  node .agent/scripts/lint_runner.js .
 
 Priority 5 — Schema Validation (CONTINUE but flag)
-  python .agent/scripts/schema_validator.py .
+  node .agent/scripts/schema_validator.js .
 
 Priority 6 — Tests (CONTINUE but mark incomplete)
-  python .agent/scripts/test_runner.py . --coverage
+  node .agent/scripts/test_runner.js . --coverage
 
 Priority 7 — Bundle Analysis (INFORM only)
-  python .agent/scripts/bundle_analyzer.py . --build
+  node .agent/scripts/bundle_analyzer.js . --build
 ```
 
 ### Cascade Failure Rules

package/.agent/workflows/deploy.md

@@ -34,7 +34,7 @@ Every step is logged. Every step has a rollback path. No surprises.
 # T-minus safety sequence (in exact order)
 
 # 1. Security: halt on critical
-python .agent/scripts/security_scan.py . --level=critical
+node .agent/scripts/security_scan.js . --level=critical
 
 # 2. Dependencies: no exploitable CVEs
 npm audit --audit-level=high

package/.agent/workflows/generate.md

@@ -25,6 +25,14 @@ $ARGUMENTS
 Your request
     │
     ▼
+[Phase 6] Context Broker — Skill Selection
+├── Scores all 90+ skills against your task keywords
+├── Level 0 (Essential): top skills — full content, injected first
+├── Level 1 (Supplementary): medium relevance — key rules only
+├── Level 2 (Available): listed for reference only
+└── Large models: Essential + Supplementary | Small models: Essential only
+    │
+    ▼
 Context scan (MANDATORY before first line of code)
 ├── Read package.json → verify all imports exist
 ├── Read tsconfig.json → understand strictness, paths aliases
@@ -39,7 +47,17 @@ Maker generates at temperature 0.1
 └── No full application generation — modules only
     │
     ▼
-Reviewers run in parallel (auto-selected by keyword)
+[Phase 6] Inner-Loop Validator (AUTO — runs before you see the code)
+├── Scans generated snippet for OWASP patterns (critical/high/medium/low)
+├── Runs structural heuristics (empty catch, throw strings, env without fallback)
+├── Verdict: APPROVED / WARNING / REJECTED
+│   ├── APPROVED → continues to Tribunal Review
+│   ├── WARNING  → noted, continues with flag
+│   └── REJECTED → Maker auto-corrects (up to 2 inner-loop attempts)
+└── Only clean code reaches the Tribunal reviewers
+    │
+    ▼
+Tribunal Reviewers run in parallel (auto-selected by keyword)
     │
     ▼
 Human Gate — verdicts shown + unified diff
@@ -84,13 +102,14 @@ security-auditor   → OWASP vulnerabilities, hardcoded secrets, injection
 |:---|:---|
 | `api`, `route`, `endpoint`, `handler`, `server action` | `dependency-reviewer` + `type-safety-reviewer` |
 | `sql`, `query`, `database`, `prisma`, `drizzle`, `orm` | `sql-reviewer` |
-| `component`, `hook`, `react`, `vue`, `jsx`, `tsx` | `frontend-reviewer` + `type-safety-reviewer` |
-| `animation`, `gsap`, `framer`, `motion`, `scroll` | `frontend-reviewer` + `performance-reviewer` |
+| `component`, `hook`, `react`, `vue`, `jsx`, `tsx` | `frontend-reviewer` + `type-safety-reviewer` + `ui-ux-auditor` |
+| `ui`, `design`, `landing`, `page`, `layout`, `style`, `css` | `ui-ux-auditor` + `accessibility-reviewer` |
+| `animation`, `gsap`, `framer`, `motion`, `scroll` | `frontend-reviewer` + `performance-reviewer` + `ui-ux-auditor` |
 | `test`, `spec`, `vitest`, `jest`, `playwright` | `test-coverage-reviewer` |
 | `slow`, `optimize`, `cache`, `performance`, `bundle` | `performance-reviewer` |
 | `mobile`, `react native`, `expo` | `mobile-reviewer` |
 | `llm`, `openai`, `anthropic`, `gemini`, `embedding`, `ai` | `ai-code-reviewer` |
-| `aria`, `wcag`, `a11y`, `accessibility` | `accessibility-reviewer` |
+| `aria`, `wcag`, `a11y`, `accessibility` | `accessibility-reviewer` + `ui-ux-auditor` |
 | `import`, `package`, `npm`, `require` | `dependency-reviewer` |
 
 > For maximum safety on critical code: use `/tribunal-full` for all 11 reviewers simultaneously.
@@ -136,8 +155,6 @@ Write to disk?  Y = approve | N = discard | R = revise with feedback
 
 ---
 
-## Cross-Workflow Navigation
-
 | After /generate shows... | Go to |
 |:---|:---|
 | Multiple files need changing | `/enhance` for impact-zone analysis |

package/.agent/workflows/session.md

@@ -23,11 +23,11 @@ $ARGUMENTS
 ## Execution
 
 ```bash
-python .agent/scripts/session_manager.py save
-python .agent/scripts/session_manager.py restore
-python .agent/scripts/session_manager.py status
-python .agent/scripts/session_manager.py new
-python .agent/scripts/session_manager.py list
+node .agent/scripts/session_manager.js save
+node .agent/scripts/session_manager.js restore
+node .agent/scripts/session_manager.js status
+node .agent/scripts/session_manager.js new
+node .agent/scripts/session_manager.js list
 ```
 
 ---

package/.agent/workflows/swarm.md

@@ -1,5 +1,5 @@
 ---
-description: Multi-Agent Swarm Orchestration. Supervisor decomposes a complex goal into sub-tasks, dispatches to specialist Workers via structured JSON contracts, collects results via allSettled fan-in, and synthesizes a unified deliverable. Validates payloads via swarm_dispatcher.py before dispatch.
+description: Multi-Agent Swarm Orchestration. Supervisor decomposes a complex goal into sub-tasks, dispatches to specialist Workers via structured JSON contracts, collects results via allSettled fan-in, and synthesizes a unified deliverable. Validates payloads via swarm_dispatcher.js before dispatch.
 ---
 
 # /swarm — Multi-Agent Swarm Execution
@@ -69,7 +69,7 @@ Every worker receives a structured JSON contract (not natural language):
 Before dispatching, validate all worker contracts:
 
 ```bash
-python .agent/scripts/swarm_dispatcher.py --file payload.json
+node .agent/scripts/swarm_dispatcher.js --file payload.json
 ```
 
 If validation passes → dispatch workers in parallel.

package/README.md

@@ -7,14 +7,14 @@
 
   [![NPM](https://img.shields.io/npm/v/tribunal-kit?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/tribunal-kit)
   [![License](https://img.shields.io/badge/License-MIT-8b5cf6?style=for-the-badge)](LICENSE)
-  [![Version](https://img.shields.io/badge/Version-4.0.0_Supreme_Court-black?style=for-the-badge)](CHANGELOG.md)
+  [![Version](https://img.shields.io/badge/Version-4.2.0_Supreme_Court-black?style=for-the-badge)](CHANGELOG.md)
 </div>
 
 
 <br><br>
 
 > 🚨 **AI GENERATES CODE. TRIBUNAL ENSURES IT WORKS.**  
-> A plug-in `.agent/` intelligence payload that upgrades your IDE with **32 specialist agents**, **25 slash commands**, **8 parallel Tribunal reviewers**, and a core **Swarm/Supervisor** engine.
+> A plug-in `.agent/` intelligence payload that upgrades your IDE with **41 specialist agents**, **31 slash commands**, **16 parallel Tribunal reviewers**, and a core **Swarm/Supervisor** engine.
 
 ---
 
@@ -30,7 +30,63 @@ npx tribunal-kit init
 ```
 *(Installs the `.agent/` architecture directly. No bloat. Pure capability.)*
 
-> ⚠️ **CRITICAL PATH WARNING:** Do **not** let your IDE ignore the agents. If using Cursor or Windsurf, keep `.agent/` **out** of `.gitignore` so the IDE can index the commands. Use `.git/info/exclude` instead.
+<details>
+<summary><b>📺 Quick Demo — What happens when you run it</b></summary>
+<br>
+
+```
+$ npx tribunal-kit init
+
+  ████████╗██████╗ ██╗██████╗ ██╗   ██╗███╗   ██╗ █████╗ ██╗
+  ╚══██╔══╝██╔══██╗██║██╔══██╗██║   ██║████╗  ██║██╔══██╗██║
+     ██║   ██████╔╝██║██████╔╝██║   ██║██╔██╗ ██║███████║██║
+     ██║   ██╔══██╗██║██╔══██╗██║   ██║██║╚██╗██║██╔══██║██║
+     ██║   ██║  ██║██║██████╔╝╚██████╔╝██║ ╚████║██║  ██║███████╗
+     ╚═╝   ╚═╝  ╚═╝╚═╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝
+
+  ╔══════════════════════════════════════════════════════════════╗
+  ║              Anti-Hallucination Agent System                ║
+  ╚══════════════════════════════════════════════════════════════╝
+
+  ✔ Installed → .agent/
+
+  ╔══════════════════════════════════════════════════════════════╗
+  ║  🤖  Agents         40 installed                            ║
+  ║  ⚡  Workflows       31 installed                            ║
+  ║  🧠  Skills          90 installed                            ║
+  ║  🔧  Scripts         27 installed                            ║
+  ╚══════════════════════════════════════════════════════════════╝
+
+  ✔ 700+ files installed. 16 parallel Tribunal reviewers armed.
+
+$ npx tribunal-kit status
+
+  ✔ Installed at .agent/
+  🤖  agents         40 files
+  ⚡  workflows      31 files
+  🧠  skills         90 files
+  🔧  scripts        27 files
+```
+
+> 💡 **Lighter install?** Use `npx tribunal-kit init --minimal` for just 13 core agents + 15 essential skills.
+
+</details>
+
+> ✅ **IDE Auto-Detection:** `init` automatically generates bridge files for every major AI coding IDE:
+>
+> | IDE | Bridge File Generated |
+> | :--- | :--- |
+> | **Cursor** | `.cursorrules` |
+> | **Windsurf** | `.windsurfrules` |
+> | **Gemini / Antigravity** | `.gemini/settings.json` + `.gemini/GEMINI.md` |
+> | **GitHub Copilot** | `.github/copilot-instructions.md` |
+> | **Claude** | `.claude/CLAUDE.md` |
+>
+> Bridge files are never overwritten on re-init — your customizations are safe.
+
+**Prerequisites:** Node.js ≥ 18 • Python ≥ 3.10 *(optional — required for utility scripts like `checklist.py`, `security_scan.py`)*
+
+> 💡 **Shorthand alias:** You can use `tk` instead of `tribunal-kit` for all commands (e.g., `tk init`, `tk status`).
 
 <br>
 
@@ -79,10 +135,10 @@ You no longer need to write manual rules. The system reads your Git commits, str
 
 | System Asset | Count | Operational Scope |
 | :--- | :---: | :--- |
-| 🤖 **Agents** | `33` | Specialist personas (Security, DB Architect, DevOps Responder, QA Engineer) |
-| 🧠 **Skills** | `77` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion) |
-| ⚡ **Workflows** | `30` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
-| 🛠️ **Scripts** | `16` | CI/CD, linting, payload dispatching, security scanning, test suite runners |
+| 🤖 **Agents** | `40` | Specialist personas — 16 reviewers + 24 domain specialists |
+| 🧠 **Skills** | `90` | Domain modules (Edge Computing, Red Team Tactics, GSAP, Framer Motion, TypeScript Advanced) |
+| ⚡ **Workflows** | `31` | Slash command procedures including `/swarm`, `/tribunal-full`, `/ui-ux-pro-max` |
+| 🛠️ **Scripts** | `25` | CI/CD, linting, payload dispatching, security scanning, case law, skill evolution |
 
 
 <br>
@@ -112,7 +168,7 @@ Unleash parallel reviewers on existing code.
 | Command | Action |
 | :--- | :--- |
 | <code>/review</code> | Audit code for silent degradation and logic holes. |
-| <code>/tribunal-full</code> | Unleash **ALL 11** reviewers simultaneously. Maximum scrutiny. |
+| <code>/tribunal-full</code> | Unleash **ALL 16** reviewers simultaneously. Maximum scrutiny. |
 | <code>/tribunal-backend</code> | Summons <code>[ Logic + Security + Dependency + Types ]</code> |
 | <code>/tribunal-frontend</code> | Summons <code>[ Logic + Security + Frontend + Types ]</code> |
 | <code>/tribunal-database</code> | Summons <code>[ Logic + Security + SQL ]</code> |