tribunal-kit 4.3.1 → 4.4.0

package/.agent/skills/knowledge-graph/SKILL.md

@@ -1,36 +1,52 @@
----
-name: Knowledge Graph Analyzer
-description: Understands the architecture and dependencies of the codebase without token bloat.
-version: 1.0.0
----
-
-# /graph — Knowledge Graph Skill
-
-Use this skill when the user types `/graph` or when you need to deeply understand the architecture of an unfamiliar codebase without suffering from context-window bloat.
-
-## Pre-Flight Checklist
-Before answering architectural questions or making broad code changes, you must understand the environment.
-- [ ] Have I run the Macro Mapper to get the high-level architecture?
-- [ ] Have I used the Micro Zoomer on the specific files related to the user's request to see their exact signatures?
-
-## Execution Protocol
-
-1. **Step 1: The Macro Map (World View)**
-   Execute the graph builder to map module boundaries. This runs incrementally and respects `.gitignore`.
-   ```bash
-   node .agent/scripts/graph_builder.js
-   ```
-   Read the output file at `.agent/history/architecture-graph.yaml`. **Do NOT try to read every file in the project.** Use this map to identify which files export the functions or components you need.
-
-2. **Step 2: The Micro Zoom (Street View)**
-   Once you know which file to investigate, use the zoomer to get its structural skeleton. This strips out the internal logic and returns only imports, exports, class signatures, and function parameters.
-   ```bash
-   node .agent/scripts/graph_zoom.js --focus <path_to_file>
-   ```
-   *Example: `node .agent/scripts/graph_zoom.js --focus src/components/Button.tsx`*
-
-3. **Step 3: Analyze and Advise**
-   Present the user with your findings. Highlight hidden dependencies, circular imports, or structural insights based on what you discovered in the graphs.
-
-## VBC Protocol (Verification-Before-Completion)
-You are explicitly forbidden from guessing or "hallucinating" what functions, props, or variables exist inside a file. You MUST use the `graph_zoom.js` script to verify a component's exact signature before you attempt to call it, mock it, or rewrite it.
+---
+name: Knowledge Graph Analyzer
+description: Understands the architecture, risk blast radius, and dependencies of the codebase without token bloat. Now includes Context Snapshots for 27x token reduction.
+version: 3.0.0
+---
+
+# /graph — Knowledge Graph Skill v3.0
+
+Use this skill when the user types `/graph` or when you need to deeply understand the architecture of an unfamiliar codebase without suffering from context-window bloat.
+
+## The Token Reduction Protocol (Option C)
+
+**DO NOT READ RAW SOURCE FILES IF A SNAPSHOT EXISTS.**
+Reading raw project files wastes up to 50,000 tokens per edit. You must use the pre-computed Context Snapshots instead. These snapshots contain the file's content, resolved imports, dependent files, and risk scores all in one JSON blob.
+
+## Pre-Flight Checklist
+- [ ] Have I run the Macro Mapper to generate the latest Context Snapshots?
+- [ ] Am I reading from `.agent/history/snapshots/` instead of directly grepping the project?
+- [ ] Have I respected the `blastRadius` before modifying a file?
+
+## Execution Protocol
+
+1. **Step 1: The Macro Map (Blast Radius & Snapshot Engine)**
+   Execute the graph builder to map module boundaries and compute downstream risk scores. This also automatically generates a Context Snapshot for every file.
+   ```bash
+   node .agent/scripts/graph_builder.js
+   ```
+
+2. **Step 2: Read Context Snapshots (MANDATORY)**
+   Instead of using `cat` or `grep` to read a file, read its snapshot. Snapshots are stored in `.agent/history/snapshots/` with slashes replaced by `__`.
+   *Example:* To edit `src/middleware/auth.js`, read `.agent/history/snapshots/src__middleware__auth.js.json`.
+   
+   This gives you:
+   - The full source code of the target file.
+   - The exported symbols of every file it imports.
+   - The list of files that depend on it.
+   - Its exact `riskScore` and `blastRadius`.
+
+3. **Step 3: Interactive Visualization (For Humans)**
+   The user can view a sleek, zero-dependency visualizer of the codebase. You can prompt them to run:
+   ```bash
+   npx tribunal-kit graph
+   ```
+
+4. **Step 4: The Micro Zoom (Legacy Street View)**
+   If a snapshot is unavailable or too large, you can fall back to the zoomer to get its structural skeleton:
+   ```bash
+   node .agent/scripts/graph_zoom.js --focus <path_to_file>
+   ```
+
+## VBC Protocol (Verification-Before-Completion)
+You are explicitly forbidden from guessing or "hallucinating" what functions, props, or variables exist inside a file. You MUST read the Context Snapshot (or use `graph_zoom.js`) to verify a component's exact signature before you attempt to call it, mock it, or rewrite it. Always respect the Blast Radius Risk Score before deleting or mutating files.

package/.agent/skills/testing-patterns/SKILL.md

@@ -2,8 +2,8 @@
 name: testing-patterns
 description: Testing mastery across stacks. Unit testing with Jest/Vitest/pytest, integration testing, E2E with Playwright, mocking strategies, test architecture (AAA, Given-When-Then), code coverage, snapshot testing, API testing, component testing with Testing Library, and TDD workflow. Use when writing tests, designing test architecture, or improving test coverage.
 allowed-tools: Read, Write, Edit, Glob, Grep
-version: 2.0.0
-last-updated: 2026-04-01
+version: 2.1.0
+last-updated: 2026-04-26
 applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
 ---
 
@@ -471,6 +471,23 @@ describe("POST /api/users", () => {
 
 ---
 
+## Mutation Testing (Tribunal Engine)
+
+```bash
+# Run the Tribunal Mutation Engine
+npx tribunal-kit mutate src/math.js "npx jest src/math.test.js"
+```
+
+```
+Mutation Engine rules:
+- Code coverage only proves code was EXECUTED, not that it was TESTED.
+- The Mutation Engine swaps operators (=== to !==) and verifies the test suite FAILS.
+- If the test passes despite the mutation, the mutant "survives" (false positive test).
+- Use this engine on critical business logic to eradicate LLM "tautological" tests.
+```
+
+---
+
 ## Code Coverage
 
 ```jsonc