tribunal-kit 5.8.4 → 6.0.0

package/.agent/history/README.md

@@ -0,0 +1,53 @@
+# 📜 Tribunal History Subsystem v3.0.0 — Architecture & Retention Guide
+
+The `.agent/history/` directory maintains persistent memory, case law precedents, code backups, and context graphs for the Tribunal Anti-Hallucination Kit.
+
+---
+
+## 🏛️ The 4 History Pillars
+
+```mermaid
+flowchart TD
+    H[".agent/history/"] --> M["1. memory/ (MEMORY.md + .memory.idx)"]
+    H --> C["2. case-law/ (index.json + cases/)"]
+    H --> S["3. snapshots/ (*.json backups)"]
+    H --> G["4. architecture-graph.yaml (Context Snapshots)"]
+
+    M --> M1["Semantic & Procedural Facts"]
+    C --> C1["Rejected Code Diffs & Precedents"]
+    S --> S1["Pre-edit Safety Reversion Backups"]
+    G --> G1["27x Context Reduction Graph"]
+```
+
+---
+
+## 1. Memory Subsystem (`history/memory/`)
+
+* **`MEMORY.md`**: Permanent, deduplicated Markdown index storing Semantic (facts/idioms) and Procedural (build/test recipes) rules.
+* **`.memory.idx`**: Binary index for rapid key-value lookup.
+* **Retention Policy**: Memory entries are permanent unless explicitly updated by `/session` or `tribunal-kit memory prune`. Redundant entries are auto-deduplicated.
+
+---
+
+## 2. Case Law Subsystem (`history/case-law/`)
+
+* **`index.json`**: Master index of historical review rejections and architectural verdicts.
+* **`cases/`**: Detailed case records detailing fingerprint, rejected code diff, root cause, and remediation guidance.
+* **Activation**: The `precedence-reviewer` agent queries `case-law/index.json` before code generation to ensure previous mistakes are never repeated.
+
+---
+
+## 3. Code Snapshots Subsystem (`history/snapshots/`)
+
+* **`*.json`**: AST and content snapshots of target files created automatically prior to major structural edits.
+* **Rotation Policy**:
+  - Maximum 10 latest snapshots retained per component.
+  - Snapshots older than 30 days are automatically eligible for purge.
+  - Enables instant rollback via `/session restore` or `/fix --rollback`.
+
+---
+
+## 4. Architecture Graph Subsystem (`history/`)
+
+* **`architecture-graph.yaml` & `graph-cache.json`**: Compressed dependency topology graphs for 27x context window token reduction (used by `Knowledge Graph Analyzer` skill).
+* **`integrity_manifest.json`**: SHA-256 cryptographic signatures ensuring snapshot integrity across AI sessions.

package/.agent/history/case-law/cases/template-case.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CaseLawRecord",
+  "version": "3.0.0",
+  "description": "Standard Case Law record schema for Tribunal Anti-Hallucination Kit precedence checks.",
+  "type": "object",
+  "required": ["id", "fingerprint", "domain", "verdict", "tags", "timestamp", "reason_summary", "remediation"],
+  "properties": {
+    "id": { "type": "integer", "description": "Unique Case Law ID" },
+    "fingerprint": { "type": "string", "description": "8-character hex SHA hash of the rejected pattern" },
+    "domain": { "type": "string", "enum": ["security", "performance", "architecture", "database", "frontend", "mobile", "ai-llm"] },
+    "verdict": { "type": "string", "enum": ["REJECTED", "APPROVED_WITH_CAVEAT"] },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "reason_summary": { "type": "string", "description": "High-level summary of why the code diff was rejected" },
+    "rejected_diff": { "type": "string", "description": "The exact code snippet or diff that triggered rejection" },
+    "remediation": { "type": "string", "description": "The required pattern or solution to comply with kit standards" }
+  }
+}

package/.agent/history/integrity_manifest.json

@@ -1,8 +1,8 @@
 {
-  "version": "5.8.4",
-  "generated_at": "2026-07-21T06:58:53.533Z",
+  "version": "6.0.0",
+  "generated_at": "2026-07-29T09:08:25.726Z",
   "agents": {
-    "total": 44,
+    "total": 45,
     "reviewers": [
       "accessibility-reviewer",
       "ai-code-reviewer",
@@ -20,8 +20,10 @@
       "security-auditor",
       "sql-reviewer",
       "test-coverage-reviewer",
+      "throughput-optimizer",
       "type-safety-reviewer",
       "ui-ux-auditor",
+      "ui-visual-auditor",
       "vitals-reviewer"
     ],
     "specialists": [
@@ -48,10 +50,9 @@
       "swarm-worker-contracts",
       "swarm-worker-registry",
       "system-architect",
-      "test-engineer",
-      "throughput-optimizer"
+      "test-engineer"
     ],
-    "reviewer_count": 19,
+    "reviewer_count": 21,
     "all": [
       "accessibility-reviewer",
       "ai-code-reviewer",
@@ -96,47 +97,79 @@
       "throughput-optimizer",
       "type-safety-reviewer",
       "ui-ux-auditor",
+      "ui-visual-auditor",
       "vitals-reviewer"
     ]
   },
   "skills": {
-    "total": 106,
+    "total": 169,
     "names": [
+      "12-principles-of-animation",
+      "60fps-animation",
       "Knowledge Graph Analyzer",
+      "accessible-animation",
+      "adapt",
       "advanced-rag-pipelines",
       "agent-organizer",
       "agentic-patterns",
       "ai-prompt-injection-defense",
+      "animation-on-scroll",
+      "animation-systems",
+      "antfu-conventions",
       "api-patterns",
       "api-security-auditor",
       "app-builder",
       "appflow-wireframe",
+      "apple-design",
       "architecture",
+      "audit-and-fix",
       "authentication-best-practices",
       "backend-security-expert",
+      "baseline-ui",
       "bash-linux",
       "behavioral-modes",
+      "better-colors",
+      "better-typography",
+      "better-ui",
+      "bolder",
       "brainstorming",
       "browser-native-ai",
+      "build-primitive",
       "building-native-ui",
       "cicd-pro",
+      "clarify",
       "clean-code",
       "cloud-architect",
+      "cobejs",
       "code-review-checklist",
+      "codebase-design",
+      "colorize",
+      "compact-landing",
+      "company-logos",
       "config-validator",
       "containerization-pro",
+      "create-design-md",
+      "critique",
       "csharp-developer",
       "data-validation-schemas",
       "database-design",
+      "delight",
       "deployment-procedures",
+      "design-lab",
       "devops-engineer",
       "devops-incident-responder",
+      "diagnosing-bugs",
+      "distill",
       "documentation-templates",
+      "domain-modeling",
       "edge-computing",
       "emil-design-eng",
       "error-resilience",
       "extract-design-system",
       "fabel-protocol",
+      "fixing-accessibility",
+      "fixing-metadata",
+      "fixing-motion-performance",
       "framer-motion-expert",
       "frontend-design",
       "frontend-security-expert",
@@ -146,6 +179,7 @@
       "geo-fundamentals",
       "git-pro",
       "github-operations",
+      "gpt-taste",
       "gsap-core",
       "gsap-frameworks",
       "gsap-performance",
@@ -154,56 +188,87 @@
       "gsap-scrolltrigger",
       "gsap-timeline",
       "gsap-utils",
+      "harden",
       "harness-protocol",
       "i18n-localization",
+      "impeccable",
+      "improve-codebase-architecture",
+      "improve-ui",
       "intelligent-routing",
+      "landing-page",
       "lint-and-validate",
       "llm-engineering",
       "local-first",
+      "local-first-architecture",
+      "lottie-animation",
+      "marquee-loop",
+      "masked-reveal",
       "mcp-builder",
+      "micro-interaction",
       "mobile-design",
       "monorepo-management",
+      "morphing-icons",
       "motion-engineering",
       "nextjs-react-expert",
       "nodejs-best-practices",
       "observability",
+      "page-transition-animation",
       "parallel-agents",
       "performance-profiling",
       "plan-writing",
       "platform-engineer",
       "playwright-best-practices",
+      "polish",
       "powershell-windows",
+      "pricing-page",
+      "progressive-blur",
       "project-idioms",
       "python-patterns",
       "python-pro",
+      "quieter",
+      "react-doctor",
       "react-specialist",
       "readme-builder",
       "realtime-patterns",
       "red-team-tactics",
+      "redesign-skill",
       "review-animations",
       "rust-pro",
       "seo-fundamentals",
       "server-management",
       "shadcn-ui-expert",
+      "shape",
       "skill-creator",
+      "soft-skill",
+      "sounds-on-the-web",
       "sql-pro",
       "supabase-postgres-best-practices",
+      "svg-animation",
       "swiftui-expert",
+      "swiss-design",
       "system-design-pro",
       "systematic-debugging",
       "tailwind-patterns",
+      "taste-skill",
       "tdd-workflow",
       "test-result-analyzer",
       "testing-patterns",
+      "thermo-nuclear-code-quality-review",
       "thinking-protocol",
+      "to-spring-or-not-to-spring",
+      "transitions-dev",
       "trend-researcher",
       "typescript-advanced",
+      "typeset",
+      "ui-skill-packs",
+      "ui-skills-root",
       "ui-ux-pro-max",
       "ui-ux-researcher",
       "vue-expert",
       "vulnerability-scanner",
       "web-accessibility-auditor",
       "web-design-guidelines",
+      "web-quality-audit",
       "webapp-testing",
       "webgpu-performance",
       "whimsy-injector",
@@ -211,7 +276,7 @@
     ]
   },
   "scripts": {
-    "total": 31,
+    "total": 33,
     "files": {
       "auto_preview.js": ".agent/scripts/auto_preview.js",
       "bundle_analyzer.js": ".agent/scripts/bundle_analyzer.js",
@@ -231,6 +296,7 @@
       "migrate_skills_frontmatter.py": ".agent/scripts/migrate_skills_frontmatter.py",
       "minify_context.js": ".agent/scripts/minify_context.js",
       "mutation_runner.js": ".agent/scripts/mutation_runner.js",
+      "pipeline_engine.js": ".agent/scripts/pipeline_engine.js",
       "prompt_compiler.js": ".agent/scripts/prompt_compiler.js",
       "schema_validator.js": ".agent/scripts/schema_validator.js",
       "security_scan.js": ".agent/scripts/security_scan.js",
@@ -242,12 +308,13 @@
       "swarm_dispatcher.js": ".agent/scripts/swarm_dispatcher.js",
       "test_runner.js": ".agent/scripts/test_runner.js",
       "verify_all.js": ".agent/scripts/verify_all.js",
+      "visual_audit.js": ".agent/scripts/visual_audit.js",
       "_colors.js": ".agent/scripts/_colors.js",
       "_utils.js": ".agent/scripts/_utils.js"
     }
   },
   "workflows": {
-    "total": 34,
+    "total": 35,
     "names": [
       "acf",
       "api-tester",
@@ -264,6 +331,7 @@
       "migrate",
       "orchestrate",
       "performance-benchmarker",
+      "pipeline",
       "plan",
       "preview",
       "refactor",
@@ -442,6 +510,12 @@
       "exists": true,
       "type": "script"
     },
+    {
+      "source": "ARCHITECTURE.md",
+      "ref": "scripts/pipeline_engine.js",
+      "exists": true,
+      "type": "script"
+    },
     {
       "source": "ARCHITECTURE.md",
       "ref": "scripts/checklist.js",
@@ -682,6 +756,12 @@
       "exists": true,
       "type": "workflow"
     },
+    {
+      "source": "ARCHITECTURE.md",
+      "ref": "workflows/pipeline.md",
+      "exists": true,
+      "type": "workflow"
+    },
     {
       "source": "rules/GEMINI.md",
       "ref": "agents/frontend-specialist.md",
@@ -850,6 +930,12 @@
       "exists": true,
       "type": "script"
     },
+    {
+      "source": "workflows/pipeline.md",
+      "ref": "scripts/pipeline_engine.js",
+      "exists": true,
+      "type": "script"
+    },
     {
       "source": "workflows/preview.md",
       "ref": "scripts/auto_preview.js",
@@ -880,6 +966,12 @@
       "exists": true,
       "type": "script"
     },
+    {
+      "source": "workflows/tribunal-frontend.md",
+      "ref": "scripts/visual_audit.js",
+      "exists": true,
+      "type": "script"
+    },
     {
       "source": "workflows/ui-ux-pro-max.md",
       "ref": "scripts/swarm_dispatcher.js",
@@ -890,69 +982,75 @@
   "numeric_claims": [
     {
       "source": "ARCHITECTURE.md:L45",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
+      "valid": true
+    },
+    {
+      "source": "ARCHITECTURE.md:L74",
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
-      "source": "ARCHITECTURE.md:L270",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "source": "ARCHITECTURE.md:L319",
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
-      "source": "ARCHITECTURE.md:L276",
-      "claim": "106 skills",
-      "actual": 106,
+      "source": "rules/GEMINI.md:L225",
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/generate.md:L131",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-full.md:L2",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-full.md:L6",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-full.md:L35",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-full.md:L71",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-full.md:L127",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     },
     {
       "source": "workflows/tribunal-speed.md:L184",
-      "claim": "19 reviewers",
-      "actual": 19,
+      "claim": "21 reviewers",
+      "actual": 21,
       "valid": true
     }
   ],
   "integrity": {
     "phantom_references": 0,
     "invalid_claims": 0,
-    "total_references": 100,
-    "total_claims": 10
+    "total_references": 104,
+    "total_claims": 11
   }
 }