tribunal-kit 9.2.4 → 9.2.6

package/.agent/scripts/visual_audit.js

@@ -1,87 +1,87 @@
-#!/usr/bin/env node
-/**
- * visual_audit.js — Visual Design & UI Engineering Auditor
- *
- * Verifies OKLCH color compliance, surface depth layering (hairline borders, ambient shadows),
- * and interactive state polish on UI components and style definitions.
- *
- * Usage:
- *   node .agent/scripts/visual_audit.js .
- *   node .agent/scripts/visual_audit.js --file src/components/Button.tsx
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const { GREEN, YELLOW, BOLD, DIM, RESET, banner, timer, formatMs } = require('./_colors');
-
-const { walkDir, SOURCE_EXTENSIONS } = require('./_utils');
-
-function auditFile(filePath) {
-  let content;
-  try {
-    content = fs.readFileSync(filePath, 'utf8');
-  } catch {
-    return [];
-  }
-
-  const issues = [];
-  const lines = content.split('\n');
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // Check for hardcoded hex colors when oklch or CSS variables are expected
-    if (/#([0-9a-fA-F]{3}){1,2}\b/.test(line) && !line.includes('// ignore-color')) {
-      issues.push({
-        line: i + 1,
-        rule: 'oklch-color',
-        message: `Hardcoded hex color found: "${line.trim()}". Prefer OKLCH or design token CSS variables.`,
-      });
-    }
-  }
-
-  return issues;
-}
-
-function main() {
-  const cwd = process.cwd();
-  const elapsed = timer();
-
-  console.log(banner('visual_audit.js', { Target: cwd }));
-
-  const files = walkDir(cwd, { extensions: SOURCE_EXTENSIONS });
-  let totalIssues = 0;
-
-  for (const file of files) {
-    const issues = auditFile(file);
-    if (issues.length > 0) {
-      totalIssues += issues.length;
-      const rel = path.relative(cwd, file);
-      console.log(`\n  📄 ${BOLD}${rel}${RESET}`);
-      for (const iss of issues) {
-        console.log(`     ${YELLOW}⚠ line ${iss.line}:${RESET} ${iss.message}`);
-      }
-    }
-  }
-
-  console.log(`\n  ${DIM}Audited ${files.length} files in ${formatMs(elapsed())}${RESET}`);
-
-  if (totalIssues === 0) {
-    console.log(
-      `  ${GREEN}${BOLD}✔ Visual audit complete — zero design violations found.${RESET}\n`,
-    );
-  } else {
-    console.log(
-      `  ${YELLOW}${BOLD}⚠ Visual audit completed with ${totalIssues} advisory issue(s).${RESET}\n`,
-    );
-  }
-}
-
-module.exports = { auditFile };
-
-if (require.main === module) {
-  main();
-}
+#!/usr/bin/env node
+/**
+ * visual_audit.js — Visual Design & UI Engineering Auditor
+ *
+ * Verifies OKLCH color compliance, surface depth layering (hairline borders, ambient shadows),
+ * and interactive state polish on UI components and style definitions.
+ *
+ * Usage:
+ *   node .agent/scripts/visual_audit.js .
+ *   node .agent/scripts/visual_audit.js --file src/components/Button.tsx
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const { GREEN, YELLOW, BOLD, DIM, RESET, banner, timer, formatMs } = require('./_colors');
+
+const { walkDir, SOURCE_EXTENSIONS } = require('./_utils');
+
+function auditFile(filePath) {
+  let content;
+  try {
+    content = fs.readFileSync(filePath, 'utf8');
+  } catch {
+    return [];
+  }
+
+  const issues = [];
+  const lines = content.split('\n');
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    // Check for hardcoded hex colors when oklch or CSS variables are expected
+    if (/#([0-9a-fA-F]{3}){1,2}\b/.test(line) && !line.includes('// ignore-color')) {
+      issues.push({
+        line: i + 1,
+        rule: 'oklch-color',
+        message: `Hardcoded hex color found: "${line.trim()}". Prefer OKLCH or design token CSS variables.`,
+      });
+    }
+  }
+
+  return issues;
+}
+
+function main() {
+  const cwd = process.cwd();
+  const elapsed = timer();
+
+  console.log(banner('visual_audit.js', { Target: cwd }));
+
+  const files = walkDir(cwd, { extensions: SOURCE_EXTENSIONS });
+  let totalIssues = 0;
+
+  for (const file of files) {
+    const issues = auditFile(file);
+    if (issues.length > 0) {
+      totalIssues += issues.length;
+      const rel = path.relative(cwd, file);
+      console.log(`\n  📄 ${BOLD}${rel}${RESET}`);
+      for (const iss of issues) {
+        console.log(`     ${YELLOW}⚠ line ${iss.line}:${RESET} ${iss.message}`);
+      }
+    }
+  }
+
+  console.log(`\n  ${DIM}Audited ${files.length} files in ${formatMs(elapsed())}${RESET}`);
+
+  if (totalIssues === 0) {
+    console.log(
+      `  ${GREEN}${BOLD}✔ Visual audit complete — zero design violations found.${RESET}\n`,
+    );
+  } else {
+    console.log(
+      `  ${YELLOW}${BOLD}⚠ Visual audit completed with ${totalIssues} advisory issue(s).${RESET}\n`,
+    );
+  }
+}
+
+module.exports = { auditFile };
+
+if (require.main === module) {
+  main();
+}

package/.agent/skill_topic_map.json

@@ -1,56 +1,57 @@
 {
-  "version": "3.0.0",
-  "total_skills": 210,
+  "version": "6.0.0",
+  "total_skills": 234,
   "description": "Lightweight 2-tier domain routing map for Tribunal Agent Kit v3.0.0",
   "domain_routes": {
     "frontend": [
-      "react-specialist",
-      "nextjs-react-expert",
-      "vue-expert",
-      "frontend-design",
-      "better-ui",
+      "adapt",
+      "anti-slop-enforcement",
+      "appflow-wireframe",
+      "apple-design",
       "baseline-ui",
-      "impeccable",
-      "taste-skill",
-      "gpt-taste",
-      "product-aware-heuristics",
-      "swiss-design",
-      "typeset",
       "better-colors",
+      "better-typography",
+      "better-ui",
+      "bolder",
+      "build-primitive",
+      "building-native-ui",
+      "clarify",
       "colorize",
-      "delight",
-      "whimsy-injector",
       "compact-landing",
+      "company-logos",
+      "create-design-md",
+      "critique",
+      "delight",
+      "distill",
+      "extract-design-system",
+      "frontend-design",
+      "gpt-taste",
+      "harden",
+      "impeccable",
+      "improve-ui",
       "landing-page",
+      "nextjs-react-expert",
+      "polish",
       "pricing-page",
-      "company-logos",
+      "product-aware-heuristics",
+      "quieter",
+      "react-doctor",
+      "react-specialist",
+      "redesign-skill",
+      "shadcn-ui-expert",
+      "shape",
+      "soft-skill",
+      "swiss-design",
+      "tailwind-patterns",
+      "taste-skill",
+      "typeset",
       "ui-reasoning-engine",
       "ui-skill-packs",
       "ui-skills-root",
       "ui-ux-pro-max",
       "ui-ux-researcher",
-      "critique",
-      "bolder",
-      "quieter",
-      "polish",
-      "harden",
-      "distill",
-      "clarify",
-      "shape",
-      "redesign-skill",
-      "improve-ui",
-      "create-design-md",
-      "extract-design-system",
-      "appflow-wireframe",
-      "apple-design",
-      "shadcn-ui-expert",
-      "tailwind-patterns",
-      "building-native-ui",
-      "adapt",
-      "better-typography",
-      "soft-skill",
-      "build-primitive",
-      "react-doctor"
+      "vue-expert",
+      "whimsy-injector"
     ],
     "motion": [
       "12-principles-of-animation",
@@ -58,6 +59,7 @@
       "accessible-animation",
       "animation-on-scroll",
       "animation-systems",
+      "fixing-motion-performance",
       "framer-motion-expert",
       "gsap-core",
       "gsap-frameworks",
@@ -79,97 +81,126 @@
       "sounds-on-the-web",
       "svg-animation",
       "to-spring-or-not-to-spring",
-      "transitions-dev",
-      "fixing-motion-performance"
+      "transitions-dev"
     ],
     "backend": [
-      "backend-security-expert",
+      "advanced-rag-pipelines",
+      "agentic-workflows-2026",
       "api-patterns",
       "api-security-auditor",
-      "nodejs-best-practices",
-      "python-pro",
-      "python-patterns",
-      "rust-pro",
+      "backend-architecture-auditor",
+      "backend-performance-auditor",
+      "backend-redis",
+      "backend-security-expert",
+      "browser-native-ai",
+      "context-engineering-pro",
       "csharp-developer",
       "edge-computing",
-      "browser-native-ai",
-      "llm-engineering",
-      "advanced-rag-pipelines",
+      "error-resilience",
+      "fastapi-pro",
       "generative-ui-expert",
+      "llm-engineering",
+      "nodejs-best-practices",
+      "python-patterns",
+      "python-pro",
       "realtime-patterns",
-      "context-engineering-pro",
-      "agentic-workflows-2026",
-      "error-resilience"
+      "rust-pro"
     ],
     "database": [
+      "backend-alembic",
+      "backend-mongodb",
+      "backend-mysql",
+      "backend-postgresql",
+      "backend-sqlalchemy",
+      "backend-sqlite",
+      "data-validation-schemas",
       "database-design",
+      "domain-modeling",
+      "duckdb-analytical-sql",
       "sql-pro",
       "supabase-postgres-best-practices",
-      "domain-modeling",
-      "data-validation-schemas",
-      "vector-search-pgvector",
-      "duckdb-analytical-sql"
+      "vector-search-pgvector"
     ],
     "mobile": [
-      "mobile-design",
-      "swiftui-expert",
+      "edge-ai-mobile",
       "expo-router-v4",
-      "edge-ai-mobile"
+      "mobile-design",
+      "swiftui-expert"
     ],
     "devops": [
-      "devops-engineer",
-      "devops-incident-responder",
-      "platform-engineer",
-      "cloud-architect",
-      "containerization-pro",
-      "server-management",
       "bash-linux",
-      "powershell-windows",
       "cicd-pro",
+      "cloud-architect",
+      "config-validator",
+      "containerization-pro",
       "deployment-procedures",
-      "platform-engineering-opentofu",
+      "devops-engineer",
+      "devops-incident-responder",
       "opentelemetry-observability",
-      "config-validator"
+      "platform-engineer",
+      "platform-engineering-opentofu",
+      "powershell-windows",
+      "server-management"
     ],
     "security": [
+      "agentshield-security",
+      "ai-app-hardening",
       "ai-prompt-injection-defense",
+      "audit-and-fix",
+      "authentication-best-practices",
+      "clean-code",
+      "code-review-checklist",
+      "fixing-accessibility",
+      "fixing-metadata",
       "frontend-security-expert",
+      "lint-and-validate",
       "red-team-tactics",
+      "thermo-nuclear-code-quality-review",
       "vulnerability-scanner",
       "web-accessibility-auditor",
-      "fixing-accessibility",
-      "fixing-metadata",
       "web-design-guidelines",
       "web-quality-audit",
-      "audit-and-fix",
-      "lint-and-validate",
-      "clean-code",
-      "code-review-checklist",
-      "thermo-nuclear-code-quality-review",
-      "zero-trust-passkeys",
-      "ai-app-hardening",
-      "authentication-best-practices"
+      "zero-trust-passkeys"
     ],
     "testing": [
-      "testing-patterns",
-      "webapp-testing",
+      "backend-testing-auditor",
+      "browser-audit",
+      "playwright-ai-e2e",
       "playwright-best-practices",
+      "property-based-testing",
       "tdd-workflow",
       "test-result-analyzer",
-      "playwright-ai-e2e",
-      "property-based-testing",
-      "browser-audit"
+      "testing-patterns",
+      "webapp-testing"
     ],
     "meta": [
+      "adr-generation",
       "agent-organizer",
+      "agent-syscall-guidelines",
       "agentic-patterns",
+      "antfu-conventions",
       "app-builder",
       "architecture",
+      "architecture-drift",
+      "autonomous-execution",
       "behavioral-modes",
       "brainstorming",
+      "cobejs",
       "codebase-design",
+      "design-lab",
+      "diagnosing-bugs",
+      "documentation-templates",
+      "emil-design-eng",
       "fabel-protocol",
+      "failure-mode-analysis",
+      "game-design-expert",
+      "game-engineering-expert",
+      "geo-fundamentals",
+      "git-pro",
+      "github-operations",
+      "graph-engineering",
       "harness-protocol",
+      "human-gate-negotiation",
       "i18n-localization",
       "improve-codebase-architecture",
       "intelligent-routing",
@@ -184,27 +215,20 @@
       "plan-writing",
       "project-idioms",
       "readme-builder",
+      "semantic-filesystem-navigation",
       "seo-fundamentals",
+      "session-log-interrogation",
       "skill-creator",
+      "subagent-driven-development",
       "system-design-pro",
       "systematic-debugging",
       "thinking-protocol",
       "trend-researcher",
+      "tribunal-instincts-memory",
       "typescript-advanced",
+      "verification-before-completion",
       "webgpu-performance",
-      "workflow-optimizer",
-      "cobejs",
-      "diagnosing-bugs",
-      "antfu-conventions",
-      "documentation-templates",
-      "emil-design-eng",
-      "geo-fundamentals",
-      "git-pro",
-      "github-operations",
-      "design-lab",
-      "game-design-expert",
-      "game-engineering-expert",
-      "verification-before-completion"
+      "workflow-optimizer"
     ],
     "huggingface": [
       "hf-cli",
@@ -267,7 +291,10 @@
       "python-pro",
       "python-patterns",
       "duckdb-analytical-sql",
-      "property-based-testing"
+      "property-based-testing",
+      "fastapi-pro",
+      "backend-sqlalchemy",
+      "backend-alembic"
     ],
     ".rs": [
       "rust-pro"

package/.agent/skills/12-principles-of-animation/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: 12-principles-of-animation
-description: "Use when Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion."
-version: 5.0.0
-last-updated: 2026-09-13
+description: "Use when implementing, optimizing, and timing 60fps/120fps 12 principles of animation animations, transitions, gesture physics, and reduced-motion fallbacks."
+version: 6.0.0
+last-updated: 2026-09-29
 skills:
   - motion-engineering
   - 60fps-animation
@@ -15,37 +15,107 @@ scripts-binding:
 
 # 12 Principles of Animation — Web UI Motion Theory
 
----
+## Mandatory Pre-Flight Context Inspection
+Before reading, generating, or refactoring code in the `12-principles-of-animation` domain, inspect these 5 critical parameters:
+1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
+2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
+3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
+4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
+5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
 
-## 🛠️ Technical Architecture & Reference Recipes
 
----
+## Activation Boundaries
+- **Activate when:** Use when implementing, optimizing, and timing 60fps/120fps 12 principles of animation animations, transitions, gesture physics, and reduced-motion fallbacks.
+- **DO NOT activate when:** The task falls outside the `12-principles-of-animation` domain or is managed by a different dedicated specialist agent.
 
----
 
-## The 6 Essential Web Principles
+## 🔁 Multi-Pass Execution Protocol
+
+| Pass | Phase | Core Action | Adaptive Depth |
+|:---|:---|:---|:---|
+| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. | Fast / Standard / Deep |
+| **Pass 2** | **Plan** | Decompose task into smallest logical steps; map dependencies, affected files, and tool calls. | Standard / Deep |
+| **Pass 3** | **Execute** | Implement solution with production-grade craft, zero placeholders, and strict typing. | All Modes |
+| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. | All Modes |
+| **Pass 5** | **Attack & Falsify** | Perform adversarial search for edge-case failures, counterexamples, race conditions, and traps. | Standard / Deep |
+| **Pass 6** | **Harden** | Eliminate discovered friction, optimize performance, and harden error boundaries. | Standard / Deep |
+| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. | All Modes |
 
-### 1. Squash & Stretch (Scale Elasticity)
 
-- Compress elements slightly on impact (e.g. button press down `scale(0.97)`), then stretch slightly on release (`scale(1.02)` -> `scale(1)`).
-- **Rule**: Preserve overall volume. If height decreases by 5%, width must expand by 5%.
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
 
-### 2. Anticipation (Pre-Motion Cue)
+---
+
+## The 6 Essential Web Principles
+
+### 1. Squash & Stretch (Scale Elasticity)
+
+- Compress elements slightly on impact (e.g. button press down `scale(0.97)`), then stretch slightly on release (`scale(1.02)` -> `scale(1)`).
+- **Rule**: Preserve overall volume. If height decreases by 5%, width must expand by 5%.
+
+### 2. Anticipation (Pre-Motion Cue)
+
+- Before a major movement (e.g. modal sliding up), perform a micro-backwards movement (e.g. shift down `2px` for `40ms`) to prepare the user's eye.
+
+### 3. Staging (Focus & Spatial Hierarchy)
+
+- Direct user attention to one primary animation at a time. Never animate competing layout elements across different regions simultaneously.
+
+### 4. Slow In & Slow Out (Easing Curves)
+
+- Objects in nature start slow, accelerate, and decelerate gradually. Use strong ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`) for UI entrances.
+
+### 5. Arcs (Natural Curvilinear Trajectories)
+
+- Human arms and physical objects move in curved arcs rather than mechanical straight lines. When moving elements across 2D space, use parabolic bezier curves or `offset-path`.
+
+### 6. Follow Through & Overlapping Action
+
+- Secondary elements (e.g. badge text inside a sliding card) lag slightly behind the main container (stagger delay 30ms - 50ms), creating organic physical realism.
 
-- Before a major movement (e.g. modal sliding up), perform a micro-backwards movement (e.g. shift down `2px` for `40ms`) to prepare the user's eye.
+## 🚨 Edge-Case & Failure Mode Matrix
 
-### 3. Staging (Focus & Spatial Hierarchy)
+| Scenario | Risk | Production Mitigation |
+|:---|:---|:---|
+| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
+| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
+| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
+| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
+| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
 
-- Direct user attention to one primary animation at a time. Never animate competing layout elements across different regions simultaneously.
 
-### 4. Slow In & Slow Out (Easing Curves)
+## 🤖 LLM-Specific Traps Table
 
-- Objects in nature start slow, accelerate, and decelerate gradually. Use strong ease-out curves (`cubic-bezier(0.16, 1, 0.3, 1)`) for UI entrances.
+| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
+|:---|:---|:---|
+| **The Instant Pop Trap** | Conditionally unmounting elements without animated interpolation | Use AnimatePresence or coordinate morphs with continuous geometry |
+| **Layout Thrashing** | Animating width, height, top, or left inside animation loops | Animate composite-only transform (translate3d, scale) and opacity |
+| **Sluggish Duration** | Setting micro-interaction transitions to 600ms+ causing interface lag | Cap interactive feedback at 160ms–240ms with snappy ease-out curves |
 
-### 5. Arcs (Natural Curvilinear Trajectories)
 
-- Human arms and physical objects move in curved arcs rather than mechanical straight lines. When moving elements across 2D space, use parabolic bezier curves or `offset-path`.
+## 🏛️ Tribunal Verification & Guardrails
 
-### 6. Follow Through & Overlapping Action
+**Active Reviewers:** `frontend-reviewer` · `motion-reviewer` · `ui-ux-auditor`
+**Slash Command:** `/review` or `/tribunal-full`
 
-- Secondary elements (e.g. badge text inside a sliding card) lag slightly behind the main container (stagger delay 30ms - 50ms), creating organic physical realism.
+### 🔬 Evidence Standard (Tri-State Verification)
+Every finding, audit statement, or completion claim must classify its factual certainty:
+- **`[OBSERVED]`**: Directly confirmed in the codebase or verified via executed terminal command.
+- **`[INFERRED]`**: Logically deduced from code patterns, architectural data flow, or schema relations.
+- **`[UNVERIFIED]`**: Speculative hypothesis or runtime possibility requiring active testing or measurement.
+
+### ✅ Pre-Flight Self-Audit Checklist
+```
+✅ Does animation maintain 60fps/120fps using transform (translate3d, scale) and opacity?
+✅ Is optical mass conserved across state interpolations without volume collapse?
+✅ Is duration capped within micro-interaction budgets (150ms–280ms)?
+✅ Is prefers-reduced-motion respected with graceful instant fallbacks?
+✅ Did I prevent layout thrashing and continuous geometry mutations?
+```
+
+### 🛑 Verification-Before-Completion (VBC) Protocol
+**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
+- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.