tribunal-kit 9.2.1 โ†’ 9.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (637) hide show
  1. package/.agent/agents/orchestrator.md +2 -0
  2. package/.agent/config/claude.json +1 -1
  3. package/.agent/config/plugin.json +1 -1
  4. package/.agent/history/architecture-explorer.html +352 -0
  5. package/.agent/history/architecture-graph.yaml +181 -1
  6. package/.agent/history/graph-cache.json +323 -13
  7. package/.agent/history/integrity_manifest.json +3937 -299
  8. package/.agent/history/memory/.memory.idx +50 -50
  9. package/.agent/history/snapshots/.opencode__plugins__tribunal.js.json +12 -0
  10. package/.agent/history/snapshots/.pi__extensions__tribunal.ts.json +12 -0
  11. package/.agent/history/snapshots/bin__adapter-install.js.json +1 -1
  12. package/.agent/history/snapshots/bin__mcp-server.js.json +4 -2
  13. package/.agent/history/snapshots/bin__proxy-server.js.json +1 -1
  14. package/.agent/history/snapshots/bin__spawn-agent.js.json +1 -1
  15. package/.agent/history/snapshots/bin__wrapper.js.json +1 -1
  16. package/.agent/history/snapshots/eslint.config.js.json +1 -1
  17. package/.agent/history/snapshots/hooks__session-start.js.json +11 -0
  18. package/.agent/history/snapshots/scripts__apply-version.js.json +11 -0
  19. package/.agent/history/snapshots/scripts__audit_skill_sdo.js.json +11 -0
  20. package/.agent/history/snapshots/scripts__clean-pycache.js.json +11 -0
  21. package/.agent/history/snapshots/scripts__context_compiler.js.json +17 -0
  22. package/.agent/history/snapshots/scripts__modernize_skills.js.json +11 -0
  23. package/.agent/history/snapshots/scripts__package-cores.js.json +12 -0
  24. package/.agent/history/snapshots/scripts__skill_enhancement_engine.js.json +11 -0
  25. package/.agent/history/snapshots/scripts__sync-skills.js.json +11 -0
  26. package/.agent/history/snapshots/scripts__telemetry_gc.js.json +11 -0
  27. package/.agent/history/snapshots/scripts__validate-payload.js.json +1 -1
  28. package/.agent/history/snapshots/test__integration__browser_cli.test.js.json +12 -0
  29. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +1 -1
  30. package/.agent/history/snapshots/test__unit__ast_context_loader.test.js.json +12 -0
  31. package/.agent/history/snapshots/test__unit__browser_case_bridge.test.js.json +11 -0
  32. package/.agent/history/snapshots/test__unit__browser_discovery.test.js.json +10 -0
  33. package/.agent/history/snapshots/test__unit__browser_idpi.test.js.json +10 -0
  34. package/.agent/history/snapshots/test__unit__browser_sentinel.test.js.json +11 -0
  35. package/.agent/history/snapshots/test__unit__browser_synapse.test.js.json +10 -0
  36. package/.agent/history/snapshots/test__unit__browser_trimmer.test.js.json +10 -0
  37. package/.agent/history/snapshots/test__unit__context_compiler.test.js.json +26 -0
  38. package/.agent/history/snapshots/test__unit__init.test.js.json +1 -1
  39. package/.agent/history/snapshots/test__unit__learn.test.js.json +1 -1
  40. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +1 -1
  41. package/.agent/history/snapshots/test__unit__platform_download_audit.test.js.json +11 -0
  42. package/.agent/history/snapshots/test__unit__prompt_compiler.test.js.json +10 -0
  43. package/.agent/history/snapshots/test__unit__sdd_integration.test.js.json +12 -0
  44. package/.agent/history/snapshots/test__unit__stress.test.js.json +1 -1
  45. package/.agent/history/snapshots/test__unit__token_budget_broker.test.js.json +10 -0
  46. package/.agent/history/snapshots/test__unit__tui.test.js.json +10 -0
  47. package/.agent/routing_index.json +1 -1
  48. package/.agent/rules/kernel.md +86 -0
  49. package/.agent/scripts/_utils.js +78 -0
  50. package/.agent/scripts/context_broker.js +0 -8
  51. package/.agent/scripts/context_compiler.js +1106 -3
  52. package/.agent/scripts/guardrail_engine.js +48 -11
  53. package/.agent/scripts/memory_engine.js +490 -329
  54. package/.agent/scripts/pipeline_engine.js +29 -106
  55. package/.agent/scripts/swarm_dispatcher.js +123 -48
  56. package/.agent/skill_topic_map.json +71 -22
  57. package/.agent/skills/12-principles-of-animation/SKILL.md +1 -76
  58. package/.agent/skills/60fps-animation/SKILL.md +1 -76
  59. package/.agent/skills/accessible-animation/SKILL.md +1 -76
  60. package/.agent/skills/adapt/SKILL.md +1 -76
  61. package/.agent/skills/advanced-rag-pipelines/SKILL.md +1 -76
  62. package/.agent/skills/agent-organizer/SKILL.md +1 -76
  63. package/.agent/skills/agentic-patterns/SKILL.md +1 -76
  64. package/.agent/skills/agentic-workflows-2026/SKILL.md +1 -76
  65. package/.agent/skills/ai-app-hardening/SKILL.md +1 -76
  66. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +1 -76
  67. package/.agent/skills/animation-on-scroll/SKILL.md +1 -76
  68. package/.agent/skills/animation-systems/SKILL.md +1 -76
  69. package/.agent/skills/antfu-conventions/SKILL.md +0 -75
  70. package/.agent/skills/api-patterns/SKILL.md +1 -76
  71. package/.agent/skills/api-security-auditor/SKILL.md +1 -76
  72. package/.agent/skills/app-builder/SKILL.md +1 -76
  73. package/.agent/skills/appflow-wireframe/SKILL.md +1 -76
  74. package/.agent/skills/apple-design/SKILL.md +1 -76
  75. package/.agent/skills/architecture/SKILL.md +1 -76
  76. package/.agent/skills/audit-and-fix/SKILL.md +41 -77
  77. package/.agent/skills/authentication-best-practices/SKILL.md +1 -76
  78. package/.agent/skills/backend-security-expert/SKILL.md +1 -76
  79. package/.agent/skills/baseline-ui/SKILL.md +1 -76
  80. package/.agent/skills/bash-linux/SKILL.md +1 -76
  81. package/.agent/skills/behavioral-modes/SKILL.md +1 -76
  82. package/.agent/skills/better-colors/SKILL.md +1 -76
  83. package/.agent/skills/better-typography/SKILL.md +1 -76
  84. package/.agent/skills/better-ui/SKILL.md +1 -76
  85. package/.agent/skills/bolder/SKILL.md +1 -76
  86. package/.agent/skills/brainstorming/SKILL.md +1 -76
  87. package/.agent/skills/browser-audit/SKILL.md +1 -76
  88. package/.agent/skills/browser-native-ai/SKILL.md +1 -76
  89. package/.agent/skills/build-primitive/SKILL.md +1 -76
  90. package/.agent/skills/building-native-ui/SKILL.md +1 -76
  91. package/.agent/skills/cicd-pro/SKILL.md +1 -76
  92. package/.agent/skills/clarify/SKILL.md +1 -76
  93. package/.agent/skills/clean-code/SKILL.md +1 -76
  94. package/.agent/skills/cloud-architect/SKILL.md +1 -76
  95. package/.agent/skills/cobejs/SKILL.md +1 -76
  96. package/.agent/skills/code-review-checklist/SKILL.md +1 -76
  97. package/.agent/skills/codebase-design/SKILL.md +1 -76
  98. package/.agent/skills/colorize/SKILL.md +1 -76
  99. package/.agent/skills/compact-landing/SKILL.md +1 -76
  100. package/.agent/skills/company-logos/SKILL.md +1 -76
  101. package/.agent/skills/config-validator/SKILL.md +1 -76
  102. package/.agent/skills/containerization-pro/SKILL.md +1 -76
  103. package/.agent/skills/context-engineering-pro/SKILL.md +1 -76
  104. package/.agent/skills/create-design-md/SKILL.md +1 -76
  105. package/.agent/skills/critique/SKILL.md +1 -76
  106. package/.agent/skills/csharp-developer/SKILL.md +1 -76
  107. package/.agent/skills/data-validation-schemas/SKILL.md +1 -76
  108. package/.agent/skills/database-design/SKILL.md +1 -76
  109. package/.agent/skills/delight/SKILL.md +1 -76
  110. package/.agent/skills/deployment-procedures/SKILL.md +1 -76
  111. package/.agent/skills/design-lab/SKILL.md +1 -76
  112. package/.agent/skills/devops-engineer/SKILL.md +1 -76
  113. package/.agent/skills/devops-incident-responder/SKILL.md +1 -76
  114. package/.agent/skills/diagnosing-bugs/SKILL.md +1 -76
  115. package/.agent/skills/distill/SKILL.md +1 -76
  116. package/.agent/skills/documentation-templates/SKILL.md +1 -76
  117. package/.agent/skills/domain-modeling/SKILL.md +1 -76
  118. package/.agent/skills/duckdb-analytical-sql/SKILL.md +1 -76
  119. package/.agent/skills/edge-ai-mobile/SKILL.md +1 -76
  120. package/.agent/skills/edge-computing/SKILL.md +1 -76
  121. package/.agent/skills/emil-design-eng/SKILL.md +1 -76
  122. package/.agent/skills/error-resilience/SKILL.md +1 -76
  123. package/.agent/skills/expo-router-v4/SKILL.md +1 -76
  124. package/.agent/skills/extract-design-system/SKILL.md +1 -76
  125. package/.agent/skills/fabel-protocol/SKILL.md +1 -76
  126. package/.agent/skills/fixing-accessibility/SKILL.md +1 -76
  127. package/.agent/skills/fixing-metadata/SKILL.md +1 -76
  128. package/.agent/skills/fixing-motion-performance/SKILL.md +1 -76
  129. package/.agent/skills/framer-motion-expert/SKILL.md +1 -76
  130. package/.agent/skills/frontend-design/SKILL.md +1 -76
  131. package/.agent/skills/frontend-security-expert/SKILL.md +1 -76
  132. package/.agent/skills/game-design-expert/SKILL.md +1 -76
  133. package/.agent/skills/game-engineering-expert/SKILL.md +1 -76
  134. package/.agent/skills/generative-ui-expert/SKILL.md +1 -76
  135. package/.agent/skills/geo-fundamentals/SKILL.md +1 -76
  136. package/.agent/skills/git-pro/SKILL.md +1 -76
  137. package/.agent/skills/github-operations/SKILL.md +1 -76
  138. package/.agent/skills/gpt-taste/SKILL.md +1 -76
  139. package/.agent/skills/gsap-core/SKILL.md +1 -76
  140. package/.agent/skills/gsap-frameworks/SKILL.md +1 -76
  141. package/.agent/skills/gsap-performance/SKILL.md +1 -76
  142. package/.agent/skills/gsap-plugins/SKILL.md +1 -76
  143. package/.agent/skills/gsap-react/SKILL.md +1 -76
  144. package/.agent/skills/gsap-scrolltrigger/SKILL.md +1 -76
  145. package/.agent/skills/gsap-timeline/SKILL.md +1 -76
  146. package/.agent/skills/gsap-utils/SKILL.md +1 -76
  147. package/.agent/skills/harden/SKILL.md +1 -76
  148. package/.agent/skills/harness-protocol/SKILL.md +1 -76
  149. package/.agent/skills/i18n-localization/SKILL.md +1 -76
  150. package/.agent/skills/impeccable/SKILL.md +1 -76
  151. package/.agent/skills/improve-codebase-architecture/SKILL.md +1 -76
  152. package/.agent/skills/improve-ui/SKILL.md +1 -76
  153. package/.agent/skills/intelligent-routing/SKILL.md +2 -88
  154. package/.agent/skills/knowledge-graph/SKILL.md +1 -76
  155. package/.agent/skills/landing-page/SKILL.md +1 -76
  156. package/.agent/skills/lint-and-validate/SKILL.md +1 -76
  157. package/.agent/skills/llm-engineering/SKILL.md +1 -76
  158. package/.agent/skills/local-first/SKILL.md +1 -76
  159. package/.agent/skills/local-first-architecture/SKILL.md +1 -76
  160. package/.agent/skills/lottie-animation/SKILL.md +1 -76
  161. package/.agent/skills/marquee-loop/SKILL.md +1 -76
  162. package/.agent/skills/masked-reveal/SKILL.md +1 -76
  163. package/.agent/skills/mcp-builder/SKILL.md +1 -76
  164. package/.agent/skills/micro-interaction/SKILL.md +1 -76
  165. package/.agent/skills/mobile-design/SKILL.md +1 -76
  166. package/.agent/skills/monorepo-management/SKILL.md +1 -76
  167. package/.agent/skills/morphing-icons/SKILL.md +1 -76
  168. package/.agent/skills/motion-engineering/SKILL.md +1 -76
  169. package/.agent/skills/nextjs-react-expert/SKILL.md +1 -76
  170. package/.agent/skills/nodejs-best-practices/SKILL.md +1 -76
  171. package/.agent/skills/observability/SKILL.md +1 -76
  172. package/.agent/skills/opentelemetry-observability/SKILL.md +1 -76
  173. package/.agent/skills/page-transition-animation/SKILL.md +1 -76
  174. package/.agent/skills/parallel-agents/SKILL.md +1 -76
  175. package/.agent/skills/performance-profiling/SKILL.md +1 -76
  176. package/.agent/skills/plan-writing/SKILL.md +1 -76
  177. package/.agent/skills/platform-engineer/SKILL.md +1 -76
  178. package/.agent/skills/platform-engineering-opentofu/SKILL.md +1 -76
  179. package/.agent/skills/playwright-ai-e2e/SKILL.md +1 -76
  180. package/.agent/skills/playwright-best-practices/SKILL.md +1 -76
  181. package/.agent/skills/polish/SKILL.md +1 -76
  182. package/.agent/skills/powershell-windows/SKILL.md +1 -76
  183. package/.agent/skills/pricing-page/SKILL.md +1 -76
  184. package/.agent/skills/product-aware-heuristics/SKILL.md +1 -76
  185. package/.agent/skills/progressive-blur/SKILL.md +1 -76
  186. package/.agent/skills/project-idioms/SKILL.md +1 -76
  187. package/.agent/skills/property-based-testing/SKILL.md +1 -76
  188. package/.agent/skills/python-patterns/SKILL.md +1 -76
  189. package/.agent/skills/python-pro/SKILL.md +1 -76
  190. package/.agent/skills/quieter/SKILL.md +1 -76
  191. package/.agent/skills/react-doctor/SKILL.md +1 -76
  192. package/.agent/skills/react-specialist/SKILL.md +1 -76
  193. package/.agent/skills/readme-builder/SKILL.md +1 -76
  194. package/.agent/skills/realtime-patterns/SKILL.md +1 -76
  195. package/.agent/skills/red-team-tactics/SKILL.md +1 -76
  196. package/.agent/skills/redesign-skill/SKILL.md +1 -76
  197. package/.agent/skills/review-animations/SKILL.md +1 -76
  198. package/.agent/skills/rust-pro/SKILL.md +1 -76
  199. package/.agent/skills/seo-fundamentals/SKILL.md +1 -76
  200. package/.agent/skills/server-management/SKILL.md +1 -76
  201. package/.agent/skills/shadcn-ui-expert/SKILL.md +1 -76
  202. package/.agent/skills/shape/SKILL.md +1 -76
  203. package/.agent/skills/skill-creator/SKILL.md +124 -90
  204. package/.agent/skills/soft-skill/SKILL.md +1 -76
  205. package/.agent/skills/sounds-on-the-web/SKILL.md +1 -76
  206. package/.agent/skills/sql-pro/SKILL.md +1 -76
  207. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +1 -76
  208. package/.agent/skills/svg-animation/SKILL.md +1 -76
  209. package/.agent/skills/swiftui-expert/SKILL.md +1 -76
  210. package/.agent/skills/swiss-design/SKILL.md +1 -76
  211. package/.agent/skills/system-design-pro/SKILL.md +1 -76
  212. package/.agent/skills/systematic-debugging/SKILL.md +1 -76
  213. package/.agent/skills/tailwind-patterns/SKILL.md +1 -76
  214. package/.agent/skills/taste-skill/SKILL.md +1 -76
  215. package/.agent/skills/tdd-workflow/SKILL.md +1 -76
  216. package/.agent/skills/test-result-analyzer/SKILL.md +1 -76
  217. package/.agent/skills/testing-patterns/SKILL.md +1 -76
  218. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +1 -76
  219. package/.agent/skills/thinking-protocol/SKILL.md +1 -78
  220. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +1 -76
  221. package/.agent/skills/transitions-dev/SKILL.md +1 -76
  222. package/.agent/skills/trend-researcher/SKILL.md +1 -76
  223. package/.agent/skills/typescript-advanced/SKILL.md +1 -76
  224. package/.agent/skills/typeset/SKILL.md +1 -76
  225. package/.agent/skills/ui-reasoning-engine/SKILL.md +1 -76
  226. package/.agent/skills/ui-skill-packs/SKILL.md +1 -76
  227. package/.agent/skills/ui-skills-root/SKILL.md +1 -76
  228. package/.agent/skills/ui-ux-pro-max/SKILL.md +1 -76
  229. package/.agent/skills/ui-ux-researcher/SKILL.md +1 -76
  230. package/.agent/skills/vector-search-pgvector/SKILL.md +1 -76
  231. package/.agent/skills/verification-before-completion/SKILL.md +1 -76
  232. package/.agent/skills/vue-expert/SKILL.md +1 -76
  233. package/.agent/skills/vulnerability-scanner/SKILL.md +1 -76
  234. package/.agent/skills/web-accessibility-auditor/SKILL.md +1 -76
  235. package/.agent/skills/web-design-guidelines/SKILL.md +1 -76
  236. package/.agent/skills/web-quality-audit/SKILL.md +1 -76
  237. package/.agent/skills/webapp-testing/SKILL.md +1 -76
  238. package/.agent/skills/webgpu-performance/SKILL.md +1 -76
  239. package/.agent/skills/whimsy-injector/SKILL.md +1 -76
  240. package/.agent/skills/workflow-optimizer/SKILL.md +1 -76
  241. package/.agent/skills/zero-trust-passkeys/SKILL.md +1 -76
  242. package/.agent/workflows/generate.md +1 -1
  243. package/.agent/workflows/orchestrate.md +1 -1
  244. package/.agent/workflows/review-ai.md +1 -1
  245. package/.agent/workflows/skill-enhancement-engine.md +6 -10
  246. package/.agent/workflows/swarm.md +1 -1
  247. package/.agent/workflows/tribunal-backend.md +1 -1
  248. package/.agent/workflows/tribunal-cicd.md +1 -1
  249. package/.agent/workflows/tribunal-database.md +1 -1
  250. package/.agent/workflows/tribunal-frontend.md +1 -1
  251. package/.agent/workflows/tribunal-full.md +9 -9
  252. package/.agent/workflows/tribunal-mobile.md +1 -1
  253. package/.agent/workflows/tribunal-speed.md +1 -1
  254. package/.agent/workflows/tribunal-ui.md +1 -1
  255. package/.agents/skills/12-principles-of-animation/SKILL.md +1 -76
  256. package/.agents/skills/60fps-animation/SKILL.md +1 -76
  257. package/.agents/skills/accessible-animation/SKILL.md +1 -76
  258. package/.agents/skills/adapt/SKILL.md +1 -76
  259. package/.agents/skills/advanced-rag-pipelines/SKILL.md +1 -76
  260. package/.agents/skills/agent-organizer/SKILL.md +1 -76
  261. package/.agents/skills/agentic-patterns/SKILL.md +1 -76
  262. package/.agents/skills/agentic-workflows-2026/SKILL.md +1 -76
  263. package/.agents/skills/ai-app-hardening/SKILL.md +1 -76
  264. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +1 -76
  265. package/.agents/skills/animation-on-scroll/SKILL.md +1 -76
  266. package/.agents/skills/animation-systems/SKILL.md +1 -76
  267. package/.agents/skills/antfu-conventions/SKILL.md +0 -75
  268. package/.agents/skills/api-patterns/SKILL.md +1 -76
  269. package/.agents/skills/api-security-auditor/SKILL.md +1 -76
  270. package/.agents/skills/app-builder/SKILL.md +1 -76
  271. package/.agents/skills/appflow-wireframe/SKILL.md +1 -76
  272. package/.agents/skills/apple-design/SKILL.md +1 -76
  273. package/.agents/skills/architecture/SKILL.md +1 -76
  274. package/.agents/skills/audit-and-fix/SKILL.md +41 -77
  275. package/.agents/skills/authentication-best-practices/SKILL.md +1 -76
  276. package/.agents/skills/backend-security-expert/SKILL.md +1 -76
  277. package/.agents/skills/baseline-ui/SKILL.md +1 -76
  278. package/.agents/skills/bash-linux/SKILL.md +1 -76
  279. package/.agents/skills/behavioral-modes/SKILL.md +1 -76
  280. package/.agents/skills/better-colors/SKILL.md +1 -76
  281. package/.agents/skills/better-typography/SKILL.md +1 -76
  282. package/.agents/skills/better-ui/SKILL.md +1 -76
  283. package/.agents/skills/bolder/SKILL.md +1 -76
  284. package/.agents/skills/brainstorming/SKILL.md +1 -76
  285. package/.agents/skills/browser-audit/SKILL.md +1 -76
  286. package/.agents/skills/browser-native-ai/SKILL.md +1 -76
  287. package/.agents/skills/build-primitive/SKILL.md +1 -76
  288. package/.agents/skills/building-native-ui/SKILL.md +1 -76
  289. package/.agents/skills/cicd-pro/SKILL.md +1 -76
  290. package/.agents/skills/clarify/SKILL.md +1 -76
  291. package/.agents/skills/clean-code/SKILL.md +1 -76
  292. package/.agents/skills/cloud-architect/SKILL.md +1 -76
  293. package/.agents/skills/cobejs/SKILL.md +1 -76
  294. package/.agents/skills/code-review-checklist/SKILL.md +1 -76
  295. package/.agents/skills/codebase-design/SKILL.md +1 -76
  296. package/.agents/skills/colorize/SKILL.md +1 -76
  297. package/.agents/skills/compact-landing/SKILL.md +1 -76
  298. package/.agents/skills/company-logos/SKILL.md +1 -76
  299. package/.agents/skills/config-validator/SKILL.md +1 -76
  300. package/.agents/skills/containerization-pro/SKILL.md +1 -76
  301. package/.agents/skills/context-engineering-pro/SKILL.md +1 -76
  302. package/.agents/skills/create-design-md/SKILL.md +1 -76
  303. package/.agents/skills/critique/SKILL.md +1 -76
  304. package/.agents/skills/csharp-developer/SKILL.md +1 -76
  305. package/.agents/skills/data-validation-schemas/SKILL.md +1 -76
  306. package/.agents/skills/database-design/SKILL.md +1 -76
  307. package/.agents/skills/delight/SKILL.md +1 -76
  308. package/.agents/skills/deployment-procedures/SKILL.md +1 -76
  309. package/.agents/skills/design-lab/SKILL.md +1 -76
  310. package/.agents/skills/devops-engineer/SKILL.md +1 -76
  311. package/.agents/skills/devops-incident-responder/SKILL.md +1 -76
  312. package/.agents/skills/diagnosing-bugs/SKILL.md +1 -76
  313. package/.agents/skills/distill/SKILL.md +1 -76
  314. package/.agents/skills/documentation-templates/SKILL.md +1 -76
  315. package/.agents/skills/domain-modeling/SKILL.md +1 -76
  316. package/.agents/skills/duckdb-analytical-sql/SKILL.md +1 -76
  317. package/.agents/skills/edge-ai-mobile/SKILL.md +1 -76
  318. package/.agents/skills/edge-computing/SKILL.md +1 -76
  319. package/.agents/skills/emil-design-eng/SKILL.md +1 -76
  320. package/.agents/skills/error-resilience/SKILL.md +1 -76
  321. package/.agents/skills/expo-router-v4/SKILL.md +1 -76
  322. package/.agents/skills/extract-design-system/SKILL.md +1 -76
  323. package/.agents/skills/fabel-protocol/SKILL.md +1 -76
  324. package/.agents/skills/fixing-accessibility/SKILL.md +1 -76
  325. package/.agents/skills/fixing-metadata/SKILL.md +1 -76
  326. package/.agents/skills/fixing-motion-performance/SKILL.md +1 -76
  327. package/.agents/skills/framer-motion-expert/SKILL.md +1 -76
  328. package/.agents/skills/frontend-design/SKILL.md +1 -76
  329. package/.agents/skills/frontend-security-expert/SKILL.md +1 -76
  330. package/.agents/skills/game-design-expert/SKILL.md +1 -76
  331. package/.agents/skills/game-engineering-expert/SKILL.md +1 -76
  332. package/.agents/skills/generative-ui-expert/SKILL.md +1 -76
  333. package/.agents/skills/geo-fundamentals/SKILL.md +1 -76
  334. package/.agents/skills/git-pro/SKILL.md +1 -76
  335. package/.agents/skills/github-operations/SKILL.md +1 -76
  336. package/.agents/skills/gpt-taste/SKILL.md +1 -76
  337. package/.agents/skills/gsap-core/SKILL.md +1 -76
  338. package/.agents/skills/gsap-frameworks/SKILL.md +1 -76
  339. package/.agents/skills/gsap-performance/SKILL.md +1 -76
  340. package/.agents/skills/gsap-plugins/SKILL.md +1 -76
  341. package/.agents/skills/gsap-react/SKILL.md +1 -76
  342. package/.agents/skills/gsap-scrolltrigger/SKILL.md +1 -76
  343. package/.agents/skills/gsap-timeline/SKILL.md +1 -76
  344. package/.agents/skills/gsap-utils/SKILL.md +1 -76
  345. package/.agents/skills/harden/SKILL.md +1 -76
  346. package/.agents/skills/harness-protocol/SKILL.md +1 -76
  347. package/.agents/skills/i18n-localization/SKILL.md +1 -76
  348. package/.agents/skills/impeccable/SKILL.md +1 -76
  349. package/.agents/skills/improve-codebase-architecture/SKILL.md +1 -76
  350. package/.agents/skills/improve-ui/SKILL.md +1 -76
  351. package/.agents/skills/intelligent-routing/SKILL.md +2 -88
  352. package/.agents/skills/knowledge-graph/SKILL.md +1 -76
  353. package/.agents/skills/landing-page/SKILL.md +1 -76
  354. package/.agents/skills/lint-and-validate/SKILL.md +1 -76
  355. package/.agents/skills/llm-engineering/SKILL.md +1 -76
  356. package/.agents/skills/local-first/SKILL.md +1 -76
  357. package/.agents/skills/local-first-architecture/SKILL.md +1 -76
  358. package/.agents/skills/lottie-animation/SKILL.md +1 -76
  359. package/.agents/skills/marquee-loop/SKILL.md +1 -76
  360. package/.agents/skills/masked-reveal/SKILL.md +1 -76
  361. package/.agents/skills/mcp-builder/SKILL.md +1 -76
  362. package/.agents/skills/micro-interaction/SKILL.md +1 -76
  363. package/.agents/skills/mobile-design/SKILL.md +1 -76
  364. package/.agents/skills/monorepo-management/SKILL.md +1 -76
  365. package/.agents/skills/morphing-icons/SKILL.md +1 -76
  366. package/.agents/skills/motion-engineering/SKILL.md +1 -76
  367. package/.agents/skills/nextjs-react-expert/SKILL.md +1 -76
  368. package/.agents/skills/nodejs-best-practices/SKILL.md +1 -76
  369. package/.agents/skills/observability/SKILL.md +1 -76
  370. package/.agents/skills/opentelemetry-observability/SKILL.md +1 -76
  371. package/.agents/skills/page-transition-animation/SKILL.md +1 -76
  372. package/.agents/skills/parallel-agents/SKILL.md +1 -76
  373. package/.agents/skills/performance-profiling/SKILL.md +1 -76
  374. package/.agents/skills/plan-writing/SKILL.md +1 -76
  375. package/.agents/skills/platform-engineer/SKILL.md +1 -76
  376. package/.agents/skills/platform-engineering-opentofu/SKILL.md +1 -76
  377. package/.agents/skills/playwright-ai-e2e/SKILL.md +1 -76
  378. package/.agents/skills/playwright-best-practices/SKILL.md +1 -76
  379. package/.agents/skills/polish/SKILL.md +1 -76
  380. package/.agents/skills/powershell-windows/SKILL.md +1 -76
  381. package/.agents/skills/pricing-page/SKILL.md +1 -76
  382. package/.agents/skills/product-aware-heuristics/SKILL.md +1 -76
  383. package/.agents/skills/progressive-blur/SKILL.md +1 -76
  384. package/.agents/skills/project-idioms/SKILL.md +1 -76
  385. package/.agents/skills/property-based-testing/SKILL.md +1 -76
  386. package/.agents/skills/python-patterns/SKILL.md +1 -76
  387. package/.agents/skills/python-pro/SKILL.md +1 -76
  388. package/.agents/skills/quieter/SKILL.md +1 -76
  389. package/.agents/skills/react-doctor/SKILL.md +1 -76
  390. package/.agents/skills/react-specialist/SKILL.md +1 -76
  391. package/.agents/skills/readme-builder/SKILL.md +1 -76
  392. package/.agents/skills/realtime-patterns/SKILL.md +1 -76
  393. package/.agents/skills/red-team-tactics/SKILL.md +1 -76
  394. package/.agents/skills/redesign-skill/SKILL.md +1 -76
  395. package/.agents/skills/review-animations/SKILL.md +1 -76
  396. package/.agents/skills/rust-pro/SKILL.md +1 -76
  397. package/.agents/skills/seo-fundamentals/SKILL.md +1 -76
  398. package/.agents/skills/server-management/SKILL.md +1 -76
  399. package/.agents/skills/shadcn-ui-expert/SKILL.md +1 -76
  400. package/.agents/skills/shape/SKILL.md +1 -76
  401. package/.agents/skills/skill-creator/SKILL.md +124 -90
  402. package/.agents/skills/soft-skill/SKILL.md +1 -76
  403. package/.agents/skills/sounds-on-the-web/SKILL.md +1 -76
  404. package/.agents/skills/sql-pro/SKILL.md +1 -76
  405. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +1 -76
  406. package/.agents/skills/svg-animation/SKILL.md +1 -76
  407. package/.agents/skills/swiftui-expert/SKILL.md +1 -76
  408. package/.agents/skills/swiss-design/SKILL.md +1 -76
  409. package/.agents/skills/system-design-pro/SKILL.md +1 -76
  410. package/.agents/skills/systematic-debugging/SKILL.md +1 -76
  411. package/.agents/skills/tailwind-patterns/SKILL.md +1 -76
  412. package/.agents/skills/taste-skill/SKILL.md +1 -76
  413. package/.agents/skills/tdd-workflow/SKILL.md +1 -76
  414. package/.agents/skills/test-result-analyzer/SKILL.md +1 -76
  415. package/.agents/skills/testing-patterns/SKILL.md +1 -76
  416. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +1 -76
  417. package/.agents/skills/thinking-protocol/SKILL.md +1 -78
  418. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +1 -76
  419. package/.agents/skills/transitions-dev/SKILL.md +1 -76
  420. package/.agents/skills/trend-researcher/SKILL.md +1 -76
  421. package/.agents/skills/typescript-advanced/SKILL.md +1 -76
  422. package/.agents/skills/typeset/SKILL.md +1 -76
  423. package/.agents/skills/ui-reasoning-engine/SKILL.md +1 -76
  424. package/.agents/skills/ui-skill-packs/SKILL.md +1 -76
  425. package/.agents/skills/ui-skills-root/SKILL.md +1 -76
  426. package/.agents/skills/ui-ux-pro-max/SKILL.md +1 -76
  427. package/.agents/skills/ui-ux-researcher/SKILL.md +1 -76
  428. package/.agents/skills/vector-search-pgvector/SKILL.md +1 -76
  429. package/.agents/skills/verification-before-completion/SKILL.md +1 -76
  430. package/.agents/skills/vue-expert/SKILL.md +1 -76
  431. package/.agents/skills/vulnerability-scanner/SKILL.md +1 -76
  432. package/.agents/skills/web-accessibility-auditor/SKILL.md +1 -76
  433. package/.agents/skills/web-design-guidelines/SKILL.md +1 -76
  434. package/.agents/skills/web-quality-audit/SKILL.md +1 -76
  435. package/.agents/skills/webapp-testing/SKILL.md +1 -76
  436. package/.agents/skills/webgpu-performance/SKILL.md +1 -76
  437. package/.agents/skills/whimsy-injector/SKILL.md +1 -76
  438. package/.agents/skills/workflow-optimizer/SKILL.md +1 -76
  439. package/.agents/skills/zero-trust-passkeys/SKILL.md +1 -76
  440. package/README.md +542 -542
  441. package/bin/adapter-install.js +263 -263
  442. package/bin/mcp-server.js +71 -46
  443. package/bin/wrapper.js +10 -1
  444. package/dist/commands/init.js +25 -11
  445. package/dist/tui/banner.js +1 -1
  446. package/gemini-extension.json +1 -1
  447. package/package.json +13 -10
  448. package/plugin.json +1 -1
  449. package/scripts/context_compiler.js +49 -0
  450. package/scripts/skill_enhancement_engine.js +5 -31
  451. package/scripts/telemetry_gc.js +3 -1
  452. package/scripts/validate-payload.js +1 -6
  453. package/skills/12-principles-of-animation/SKILL.md +1 -76
  454. package/skills/60fps-animation/SKILL.md +1 -76
  455. package/skills/accessible-animation/SKILL.md +1 -76
  456. package/skills/adapt/SKILL.md +1 -76
  457. package/skills/advanced-rag-pipelines/SKILL.md +1 -76
  458. package/skills/agent-organizer/SKILL.md +1 -76
  459. package/skills/agentic-patterns/SKILL.md +1 -76
  460. package/skills/agentic-workflows-2026/SKILL.md +1 -76
  461. package/skills/ai-app-hardening/SKILL.md +1 -76
  462. package/skills/ai-prompt-injection-defense/SKILL.md +1 -76
  463. package/skills/animation-on-scroll/SKILL.md +1 -76
  464. package/skills/animation-systems/SKILL.md +1 -76
  465. package/skills/antfu-conventions/SKILL.md +0 -75
  466. package/skills/api-patterns/SKILL.md +1 -76
  467. package/skills/api-security-auditor/SKILL.md +1 -76
  468. package/skills/app-builder/SKILL.md +1 -76
  469. package/skills/appflow-wireframe/SKILL.md +1 -76
  470. package/skills/apple-design/SKILL.md +1 -76
  471. package/skills/architecture/SKILL.md +1 -76
  472. package/skills/audit-and-fix/SKILL.md +41 -77
  473. package/skills/authentication-best-practices/SKILL.md +1 -76
  474. package/skills/backend-security-expert/SKILL.md +1 -76
  475. package/skills/baseline-ui/SKILL.md +1 -76
  476. package/skills/bash-linux/SKILL.md +1 -76
  477. package/skills/behavioral-modes/SKILL.md +1 -76
  478. package/skills/better-colors/SKILL.md +1 -76
  479. package/skills/better-typography/SKILL.md +1 -76
  480. package/skills/better-ui/SKILL.md +1 -76
  481. package/skills/bolder/SKILL.md +1 -76
  482. package/skills/brainstorming/SKILL.md +1 -76
  483. package/skills/browser-audit/SKILL.md +1 -76
  484. package/skills/browser-native-ai/SKILL.md +1 -76
  485. package/skills/build-primitive/SKILL.md +1 -76
  486. package/skills/building-native-ui/SKILL.md +1 -76
  487. package/skills/cicd-pro/SKILL.md +1 -76
  488. package/skills/clarify/SKILL.md +1 -76
  489. package/skills/clean-code/SKILL.md +1 -76
  490. package/skills/cloud-architect/SKILL.md +1 -76
  491. package/skills/cobejs/SKILL.md +1 -76
  492. package/skills/code-review-checklist/SKILL.md +1 -76
  493. package/skills/codebase-design/SKILL.md +1 -76
  494. package/skills/colorize/SKILL.md +1 -76
  495. package/skills/compact-landing/SKILL.md +1 -76
  496. package/skills/company-logos/SKILL.md +1 -76
  497. package/skills/config-validator/SKILL.md +1 -76
  498. package/skills/containerization-pro/SKILL.md +1 -76
  499. package/skills/context-engineering-pro/SKILL.md +1 -76
  500. package/skills/create-design-md/SKILL.md +1 -76
  501. package/skills/critique/SKILL.md +1 -76
  502. package/skills/csharp-developer/SKILL.md +1 -76
  503. package/skills/data-validation-schemas/SKILL.md +1 -76
  504. package/skills/database-design/SKILL.md +1 -76
  505. package/skills/delight/SKILL.md +1 -76
  506. package/skills/deployment-procedures/SKILL.md +1 -76
  507. package/skills/design-lab/SKILL.md +1 -76
  508. package/skills/devops-engineer/SKILL.md +1 -76
  509. package/skills/devops-incident-responder/SKILL.md +1 -76
  510. package/skills/diagnosing-bugs/SKILL.md +1 -76
  511. package/skills/distill/SKILL.md +1 -76
  512. package/skills/documentation-templates/SKILL.md +1 -76
  513. package/skills/domain-modeling/SKILL.md +1 -76
  514. package/skills/duckdb-analytical-sql/SKILL.md +1 -76
  515. package/skills/edge-ai-mobile/SKILL.md +1 -76
  516. package/skills/edge-computing/SKILL.md +1 -76
  517. package/skills/emil-design-eng/SKILL.md +1 -76
  518. package/skills/error-resilience/SKILL.md +1 -76
  519. package/skills/expo-router-v4/SKILL.md +1 -76
  520. package/skills/extract-design-system/SKILL.md +1 -76
  521. package/skills/fabel-protocol/SKILL.md +1 -76
  522. package/skills/fixing-accessibility/SKILL.md +1 -76
  523. package/skills/fixing-metadata/SKILL.md +1 -76
  524. package/skills/fixing-motion-performance/SKILL.md +1 -76
  525. package/skills/framer-motion-expert/SKILL.md +1 -76
  526. package/skills/frontend-design/SKILL.md +1 -76
  527. package/skills/frontend-security-expert/SKILL.md +1 -76
  528. package/skills/game-design-expert/SKILL.md +1 -76
  529. package/skills/game-engineering-expert/SKILL.md +1 -76
  530. package/skills/generative-ui-expert/SKILL.md +1 -76
  531. package/skills/geo-fundamentals/SKILL.md +1 -76
  532. package/skills/git-pro/SKILL.md +1 -76
  533. package/skills/github-operations/SKILL.md +1 -76
  534. package/skills/gpt-taste/SKILL.md +1 -76
  535. package/skills/gsap-core/SKILL.md +1 -76
  536. package/skills/gsap-frameworks/SKILL.md +1 -76
  537. package/skills/gsap-performance/SKILL.md +1 -76
  538. package/skills/gsap-plugins/SKILL.md +1 -76
  539. package/skills/gsap-react/SKILL.md +1 -76
  540. package/skills/gsap-scrolltrigger/SKILL.md +1 -76
  541. package/skills/gsap-timeline/SKILL.md +1 -76
  542. package/skills/gsap-utils/SKILL.md +1 -76
  543. package/skills/harden/SKILL.md +1 -76
  544. package/skills/harness-protocol/SKILL.md +1 -76
  545. package/skills/i18n-localization/SKILL.md +1 -76
  546. package/skills/impeccable/SKILL.md +1 -76
  547. package/skills/improve-codebase-architecture/SKILL.md +1 -76
  548. package/skills/improve-ui/SKILL.md +1 -76
  549. package/skills/intelligent-routing/SKILL.md +2 -88
  550. package/skills/knowledge-graph/SKILL.md +1 -76
  551. package/skills/landing-page/SKILL.md +1 -76
  552. package/skills/lint-and-validate/SKILL.md +1 -76
  553. package/skills/llm-engineering/SKILL.md +1 -76
  554. package/skills/local-first/SKILL.md +1 -76
  555. package/skills/local-first-architecture/SKILL.md +1 -76
  556. package/skills/lottie-animation/SKILL.md +1 -76
  557. package/skills/marquee-loop/SKILL.md +1 -76
  558. package/skills/masked-reveal/SKILL.md +1 -76
  559. package/skills/mcp-builder/SKILL.md +1 -76
  560. package/skills/micro-interaction/SKILL.md +1 -76
  561. package/skills/mobile-design/SKILL.md +1 -76
  562. package/skills/monorepo-management/SKILL.md +1 -76
  563. package/skills/morphing-icons/SKILL.md +1 -76
  564. package/skills/motion-engineering/SKILL.md +1 -76
  565. package/skills/nextjs-react-expert/SKILL.md +1 -76
  566. package/skills/nodejs-best-practices/SKILL.md +1 -76
  567. package/skills/observability/SKILL.md +1 -76
  568. package/skills/opentelemetry-observability/SKILL.md +1 -76
  569. package/skills/page-transition-animation/SKILL.md +1 -76
  570. package/skills/parallel-agents/SKILL.md +1 -76
  571. package/skills/performance-profiling/SKILL.md +1 -76
  572. package/skills/plan-writing/SKILL.md +1 -76
  573. package/skills/platform-engineer/SKILL.md +1 -76
  574. package/skills/platform-engineering-opentofu/SKILL.md +1 -76
  575. package/skills/playwright-ai-e2e/SKILL.md +1 -76
  576. package/skills/playwright-best-practices/SKILL.md +1 -76
  577. package/skills/polish/SKILL.md +1 -76
  578. package/skills/powershell-windows/SKILL.md +1 -76
  579. package/skills/pricing-page/SKILL.md +1 -76
  580. package/skills/product-aware-heuristics/SKILL.md +1 -76
  581. package/skills/progressive-blur/SKILL.md +1 -76
  582. package/skills/project-idioms/SKILL.md +1 -76
  583. package/skills/property-based-testing/SKILL.md +1 -76
  584. package/skills/python-patterns/SKILL.md +1 -76
  585. package/skills/python-pro/SKILL.md +1 -76
  586. package/skills/quieter/SKILL.md +1 -76
  587. package/skills/react-doctor/SKILL.md +1 -76
  588. package/skills/react-specialist/SKILL.md +1 -76
  589. package/skills/readme-builder/SKILL.md +1 -76
  590. package/skills/realtime-patterns/SKILL.md +1 -76
  591. package/skills/red-team-tactics/SKILL.md +1 -76
  592. package/skills/redesign-skill/SKILL.md +1 -76
  593. package/skills/review-animations/SKILL.md +1 -76
  594. package/skills/rust-pro/SKILL.md +1 -76
  595. package/skills/seo-fundamentals/SKILL.md +1 -76
  596. package/skills/server-management/SKILL.md +1 -76
  597. package/skills/shadcn-ui-expert/SKILL.md +1 -76
  598. package/skills/shape/SKILL.md +1 -76
  599. package/skills/skill-creator/SKILL.md +124 -90
  600. package/skills/soft-skill/SKILL.md +1 -76
  601. package/skills/sounds-on-the-web/SKILL.md +1 -76
  602. package/skills/sql-pro/SKILL.md +1 -76
  603. package/skills/supabase-postgres-best-practices/SKILL.md +1 -76
  604. package/skills/svg-animation/SKILL.md +1 -76
  605. package/skills/swiftui-expert/SKILL.md +1 -76
  606. package/skills/swiss-design/SKILL.md +1 -76
  607. package/skills/system-design-pro/SKILL.md +1 -76
  608. package/skills/systematic-debugging/SKILL.md +1 -76
  609. package/skills/tailwind-patterns/SKILL.md +1 -76
  610. package/skills/taste-skill/SKILL.md +1 -76
  611. package/skills/tdd-workflow/SKILL.md +1 -76
  612. package/skills/test-result-analyzer/SKILL.md +1 -76
  613. package/skills/testing-patterns/SKILL.md +1 -76
  614. package/skills/thermo-nuclear-code-quality-review/SKILL.md +1 -76
  615. package/skills/thinking-protocol/SKILL.md +1 -78
  616. package/skills/to-spring-or-not-to-spring/SKILL.md +1 -76
  617. package/skills/transitions-dev/SKILL.md +1 -76
  618. package/skills/trend-researcher/SKILL.md +1 -76
  619. package/skills/typescript-advanced/SKILL.md +1 -76
  620. package/skills/typeset/SKILL.md +1 -76
  621. package/skills/ui-reasoning-engine/SKILL.md +1 -76
  622. package/skills/ui-skill-packs/SKILL.md +1 -76
  623. package/skills/ui-skills-root/SKILL.md +1 -76
  624. package/skills/ui-ux-pro-max/SKILL.md +1 -76
  625. package/skills/ui-ux-researcher/SKILL.md +1 -76
  626. package/skills/vector-search-pgvector/SKILL.md +1 -76
  627. package/skills/verification-before-completion/SKILL.md +1 -76
  628. package/skills/vue-expert/SKILL.md +1 -76
  629. package/skills/vulnerability-scanner/SKILL.md +1 -76
  630. package/skills/web-accessibility-auditor/SKILL.md +1 -76
  631. package/skills/web-design-guidelines/SKILL.md +1 -76
  632. package/skills/web-quality-audit/SKILL.md +1 -76
  633. package/skills/webapp-testing/SKILL.md +1 -76
  634. package/skills/webgpu-performance/SKILL.md +1 -76
  635. package/skills/whimsy-injector/SKILL.md +1 -76
  636. package/skills/workflow-optimizer/SKILL.md +1 -76
  637. package/skills/zero-trust-passkeys/SKILL.md +1 -76
package/bin/mcp-server.js CHANGED
@@ -55,6 +55,9 @@ class ToolRepeatGuard {
55
55
  }
56
56
  return sorted;
57
57
  }
58
+ if (typeof obj === 'string') {
59
+ return obj.trim().toLowerCase().replace(/\s+/g, ' ');
60
+ }
58
61
  return obj;
59
62
  };
60
63
 
@@ -745,36 +748,28 @@ async function handleRequest(req) {
745
748
  const check = req.params?.arguments?.check;
746
749
 
747
750
  try {
748
- const compiler = require('../scripts/context_compiler');
749
751
  const workspaceRoot = process.cwd();
750
-
752
+
751
753
  if (check) {
752
- const drift = compiler.checkDrift(workspaceRoot);
754
+ const { spawn } = require('child_process');
755
+ const result = await new Promise((resolve, reject) => {
756
+ const child = spawn(process.execPath, [path.join(__dirname, '../scripts/context_compiler.js'), '--check', '--json'], { cwd: workspaceRoot, encoding: 'utf8' });
757
+ let out = '';
758
+ child.stdout.on('data', d => out += d);
759
+ child.stderr.on('data', d => out += d);
760
+ child.on('close', code => resolve(out));
761
+ child.on('error', reject);
762
+ });
753
763
  return {
754
764
  content: [
755
765
  {
756
766
  type: 'text',
757
- text: JSON.stringify(drift, null, 2),
767
+ text: result,
758
768
  },
759
769
  ],
760
770
  };
761
771
  }
762
772
 
763
- if (target && compareWith) {
764
- const bridge = compiler.analyzeMultiFileBridge(target, compareWith, workspaceRoot);
765
- const md = compiler.renderBridgeDossier(bridge);
766
- if (write) {
767
- const outName = `${path.basename(target).replace(/\.[^.]+$/, '')}__${path.basename(compareWith).replace(/\.[^.]+$/, '')}.bridge.md`;
768
- const dest = path.join(workspaceRoot, 'docs', 'context', outName);
769
- fs.mkdirSync(path.dirname(dest), { recursive: true });
770
- fs.writeFileSync(dest, md, 'utf8');
771
- compiler.syncVaultIndex(workspaceRoot);
772
- }
773
- return {
774
- content: [{ type: 'text', text: md }],
775
- };
776
- }
777
-
778
773
  if (!target) {
779
774
  throw new RpcError(
780
775
  -32602,
@@ -782,33 +777,33 @@ async function handleRequest(req) {
782
777
  );
783
778
  }
784
779
 
785
- const absTarget = path.isAbsolute(target) ? target : path.resolve(workspaceRoot, target);
786
- if (fs.existsSync(absTarget) && fs.statSync(absTarget).isDirectory()) {
787
- const dirData = compiler.analyzeDirectory(absTarget, workspaceRoot);
788
- const md = compiler.renderDirectoryDossier(dirData);
789
- if (write) {
790
- const outName = `${path.basename(absTarget)}.context.md`;
791
- const dest = path.join(workspaceRoot, 'docs', 'context', outName);
792
- fs.mkdirSync(path.dirname(dest), { recursive: true });
793
- fs.writeFileSync(dest, md, 'utf8');
794
- compiler.syncVaultIndex(workspaceRoot);
795
- }
796
- return {
797
- content: [{ type: 'text', text: md }],
798
- };
780
+ // We use scripts/context_compiler.js to parse AST without blocking the event loop
781
+ const { spawn } = require('child_process');
782
+ const args = [path.join(__dirname, '../scripts/context_compiler.js')];
783
+
784
+ if (compareWith) {
785
+ args.push('--multi', target, compareWith);
786
+ } else {
787
+ args.push(target);
799
788
  }
800
-
801
- const fileData = compiler.analyzeSingleFile(target, workspaceRoot);
802
- const md = compiler.renderSingleFileDossier(fileData);
789
+
803
790
  if (write) {
804
- const outName = `${path.basename(target).replace(/\.[^.]+$/, '')}.context.md`;
805
- const dest = path.join(workspaceRoot, 'docs', 'context', outName);
806
- fs.mkdirSync(path.dirname(dest), { recursive: true });
807
- fs.writeFileSync(dest, md, 'utf8');
808
- compiler.syncVaultIndex(workspaceRoot);
791
+ args.push('--write');
809
792
  }
793
+
794
+ const result = await new Promise((resolve, reject) => {
795
+ const child = spawn(process.execPath, args, { cwd: workspaceRoot, encoding: 'utf8' });
796
+ let out = '';
797
+ child.stdout.on('data', d => out += d);
798
+ child.stderr.on('data', d => out += d);
799
+ child.on('close', code => {
800
+ resolve(out);
801
+ });
802
+ child.on('error', reject);
803
+ });
804
+
810
805
  return {
811
- content: [{ type: 'text', text: md }],
806
+ content: [{ type: 'text', text: result }],
812
807
  };
813
808
  } catch (e) {
814
809
  return {
@@ -1329,10 +1324,40 @@ async function handleRequest(req) {
1329
1324
  }
1330
1325
 
1331
1326
  try {
1332
- const brokerScript = path.join(agentDest, 'scripts', 'context_broker.js');
1333
- const { broker } = require(brokerScript);
1334
- const brokerResult = broker(task, files, model, agentDest);
1335
- return { content: [{ type: 'text', text: stripBoilerplate(brokerResult.promptText) }] };
1327
+ const workspaceRoot = process.cwd();
1328
+ const { spawn } = require('child_process');
1329
+ const args = [path.join(__dirname, 'wrapper.js'), 'context-broker', '--repo-path', workspaceRoot];
1330
+ if (files && files.length > 0) {
1331
+ args.push('--target-file');
1332
+ args.push(files[0]);
1333
+ }
1334
+
1335
+ const result = await new Promise((resolve, reject) => {
1336
+ const child = spawn(process.execPath, args, { cwd: workspaceRoot, encoding: 'utf8' });
1337
+ let out = '';
1338
+ child.stdout.on('data', d => out += d);
1339
+ child.stderr.on('data', d => out += d);
1340
+ child.on('close', code => {
1341
+ resolve(out);
1342
+ });
1343
+ child.on('error', reject);
1344
+ });
1345
+
1346
+ let finalOutput = '';
1347
+ try {
1348
+ const parsed = JSON.parse(result);
1349
+ finalOutput = `# Tribunal Context Broker\n\n`;
1350
+ if (task) {
1351
+ finalOutput += `Task: ${task}\n\n`;
1352
+ }
1353
+ if (parsed.context_snapshot) {
1354
+ finalOutput += parsed.context_snapshot;
1355
+ }
1356
+ } catch (e) {
1357
+ finalOutput = result;
1358
+ }
1359
+
1360
+ return { content: [{ type: 'text', text: stripBoilerplate(finalOutput) }] };
1336
1361
  } catch (e) {
1337
1362
  return {
1338
1363
  content: [{ type: 'text', text: `Failed to retrieve sparse context: ${e.message}` }],
package/bin/wrapper.js CHANGED
@@ -39,6 +39,7 @@ const RUST_COMMANDS = new Set([
39
39
  'genome',
40
40
  'compile',
41
41
  'purge',
42
+ 'ast-extract',
42
43
  ]);
43
44
 
44
45
  // Determine the path to the compiled Rust binary
@@ -199,4 +200,12 @@ function main() {
199
200
  runLegacyFallback();
200
201
  }
201
202
 
202
- main();
203
+ if (require.main === module) {
204
+ main();
205
+ }
206
+
207
+ module.exports = {
208
+ getBinaryPath,
209
+ runRustBinary,
210
+ RUST_COMMANDS,
211
+ };
@@ -263,6 +263,20 @@ async function generateIDEBridges(targetDir, agentDest, dryRun = false, isMinima
263
263
  catch {
264
264
  // rules file doesn't exist
265
265
  }
266
+ // Bridge files consume the high-density kernel rules to save tokens, falling back to GEMINI.md
267
+ const kernelFile = path_1.default.join(agentDest, 'rules', 'kernel.md');
268
+ let bridgeRulesContent = '';
269
+ let bridgeSource = rulesFilename;
270
+ try {
271
+ bridgeRulesContent = await fs_1.default.promises.readFile(kernelFile, 'utf8');
272
+ bridgeSource = 'kernel.md';
273
+ }
274
+ catch {
275
+ bridgeRulesContent = rulesContent;
276
+ }
277
+ if (!bridgeRulesContent) {
278
+ bridgeRulesContent = rulesContent;
279
+ }
266
280
  // Helper: write a bridge file only if it doesn't already exist
267
281
  const writeBridge = async (filePath, content, label) => {
268
282
  if (dryRun) {
@@ -285,16 +299,16 @@ async function generateIDEBridges(targetDir, agentDest, dryRun = false, isMinima
285
299
  // โ”€โ”€ 1. Cursor (.cursorrules) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
286
300
  const cursorRules = `# Tribunal Kit โ€” Cursor Bridge
287
301
  # Auto-generated by tribunal-kit init. Do not edit manually.
288
- # Source: .agent/rules/${rulesFilename}
302
+ # Source: .agent/rules/${bridgeSource}
289
303
 
290
- ${rulesContent}
304
+ ${bridgeRulesContent}
291
305
  `;
292
306
  // โ”€โ”€ 2. Windsurf (.windsurfrules) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
293
307
  const windsurfRules = `# Tribunal Kit โ€” Windsurf Bridge
294
308
  # Auto-generated by tribunal-kit init. Do not edit manually.
295
- # Source: .agent/rules/${rulesFilename}
309
+ # Source: .agent/rules/${bridgeSource}
296
310
 
297
- ${rulesContent}
311
+ ${bridgeRulesContent}
298
312
  `;
299
313
  // โ”€โ”€ 3. Gemini / Antigravity (.gemini/settings.json) โ”€โ”€
300
314
  const geminiSettings = JSON.stringify({
@@ -314,28 +328,28 @@ trigger: always_on
314
328
  # Auto-generated by tribunal-kit init.
315
329
  # Full rules: .agent/rules/${rulesFilename}
316
330
 
317
- ${rulesContent}
331
+ ${bridgeRulesContent}
318
332
  `;
319
333
  // โ”€โ”€ 4. GitHub Copilot (.github/copilot-instructions.md) โ”€โ”€
320
334
  const copilotInstructions = `# Tribunal Kit โ€” Copilot Bridge
321
335
  # Auto-generated by tribunal-kit init. Do not edit manually.
322
- # Source: .agent/rules/${rulesFilename}
336
+ # Source: .agent/rules/${bridgeSource}
323
337
 
324
- ${rulesContent}
338
+ ${bridgeRulesContent}
325
339
  `;
326
340
  // โ”€โ”€ 5. Claude (.claude/CLAUDE.md & CLAUDE.md) โ”€โ”€โ”€โ”€โ”€โ”€โ”€
327
341
  const claudeRules = `# Tribunal Kit โ€” Claude Bridge
328
342
  # Auto-generated by tribunal-kit init. Do not edit manually.
329
- # Source: .agent/rules/${rulesFilename}
343
+ # Source: .agent/rules/${bridgeSource}
330
344
 
331
- ${rulesContent}
345
+ ${bridgeRulesContent}
332
346
  `;
333
347
  // โ”€โ”€ 6. Codex & Universal Agents (AGENTS.md) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
334
348
  const codexRules = `# Tribunal Kit โ€” Codex Bridge
335
349
  # Auto-generated by tribunal-kit init. Do not edit manually.
336
- # Source: .agent/rules/${rulesFilename}
350
+ # Source: .agent/rules/${bridgeSource}
337
351
 
338
- ${rulesContent}
352
+ ${bridgeRulesContent}
339
353
  `;
340
354
  // Fire ALL bridge writes concurrently via Promise.all
341
355
  const bridges = [
@@ -7,7 +7,7 @@
7
7
 
8
8
  const { isTTY, hasColor, hasTrueColor, RGB, GLYPHS, color, bold, getColumns } = require('./theme');
9
9
 
10
- function renderBanner(version = '9.2.1', quiet = false) {
10
+ function renderBanner(version = '9.2.3', quiet = false) {
11
11
  if (quiet) return;
12
12
  if (!isTTY && !hasColor) {
13
13
  console.error(`TRIBUNAL-KIT v${version} โ€” Anti-Hallucination Governance Layer`);
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tribunal-kit",
3
3
  "description": "Enterprise-grade governance layer and anti-hallucination engine: 52 specialists, 28 parallel reviewers, Rust core, and SDD workflows.",
4
- "version": "9.2.1",
4
+ "version": "9.2.3",
5
5
  "contextFileName": ".agent/rules/GEMINI.md"
6
6
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tribunal-kit",
3
- "version": "9.2.1",
4
- "description": "Your AI writes code that doesn't exist. Tribunal Kit stops it. The governance layer for AI coding agents โ€” 52 specialists, 28 parallel reviewers, 185 skills, Rust core, MCP server. Works with Cursor, VSCode, Windsurf, Claude Code, and Aider.",
3
+ "version": "9.2.3",
4
+ "description": "Tribunal Kit is the governance layer for AI coding agents that stops AI hallucinations and npm ghost packages before they hit disk. Works with Cursor, Windsurf, Claude Code, and Aider.",
5
5
  "keywords": [
6
6
  "ai",
7
7
  "ai-agent",
@@ -45,7 +45,10 @@
45
45
  "autonomous-workflows",
46
46
  "code-correctness",
47
47
  "claude-code-plugin",
48
- "claude-plugin"
48
+ "claude-plugin",
49
+ "ai-coding-agent-governance",
50
+ "ai-governance",
51
+ "ai-hallucination-prevention"
49
52
  ],
50
53
  "homepage": "https://github.com/Harmitx7/tribunal-kit",
51
54
  "repository": {
@@ -138,7 +141,7 @@
138
141
  "lint": "eslint .",
139
142
  "typecheck": "tsc --noEmit",
140
143
  "clean:pycache": "node scripts/clean-pycache.js",
141
- "prepack": "npm run clean:pycache",
144
+ "prepack": "npm run clean:pycache && npm run skills:sync",
142
145
  "format": "prettier --write .",
143
146
  "format:check": "prettier --check .",
144
147
  "build": "npm run build:rust"
@@ -151,12 +154,12 @@
151
154
  "ws": "^8.21.3"
152
155
  },
153
156
  "optionalDependencies": {
154
- "@tribunal-kit/core-darwin-arm64": "^9.2.1",
155
- "@tribunal-kit/core-darwin-x64": "^9.2.1",
156
- "@tribunal-kit/core-linux-arm64": "^9.2.1",
157
- "@tribunal-kit/core-linux-x64": "^9.2.1",
158
- "@tribunal-kit/core-win32-arm64": "^9.2.1",
159
- "@tribunal-kit/core-win32-x64": "^9.2.1"
157
+ "@tribunal-kit/core-darwin-arm64": "^9.2.3",
158
+ "@tribunal-kit/core-darwin-x64": "^9.2.3",
159
+ "@tribunal-kit/core-linux-arm64": "^9.2.3",
160
+ "@tribunal-kit/core-linux-x64": "^9.2.3",
161
+ "@tribunal-kit/core-win32-arm64": "^9.2.3",
162
+ "@tribunal-kit/core-win32-x64": "^9.2.3"
160
163
  },
161
164
  "jest": {
162
165
  "testMatch": [
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tribunal-kit",
3
3
  "description": "Enterprise-grade governance layer and anti-hallucination engine for AI coding agents: 52 specialists, 28 parallel reviewers, Rust core, Subagent-Driven Development (SDD), and strict TDD workflows.",
4
- "version": "9.2.1",
4
+ "version": "9.2.3",
5
5
  "author": {
6
6
  "name": "Harmitx7",
7
7
  "email": "harmit@tribunalkit.com"
@@ -91,6 +91,51 @@ function extractFileSkeleton(filePath, rawContent) {
91
91
 
92
92
  // 2. Language-Specific Parsers
93
93
  if (ext === '.ts' || ext === '.tsx' || ext === '.js' || ext === '.jsx' || ext === '.mjs') {
94
+ // Phase 1: Try Rust AST Extraction
95
+ try {
96
+ const absPath = path.resolve(process.cwd(), filePath);
97
+ let corePath = null;
98
+ try {
99
+ const { getBinaryPath } = require('../.agent/scripts/_utils');
100
+ corePath = getBinaryPath();
101
+ } catch (_) {
102
+ try {
103
+ const { getBinaryPath } = require('./_utils');
104
+ corePath = getBinaryPath();
105
+ } catch (_2) {
106
+ try {
107
+ const wrapper = require('../bin/wrapper');
108
+ corePath = wrapper.getBinaryPath ? wrapper.getBinaryPath() : null;
109
+ } catch (_3) {}
110
+ }
111
+ }
112
+
113
+ if (!corePath && process.env.TRIBUNAL_CORE_PATH && fs.existsSync(process.env.TRIBUNAL_CORE_PATH)) {
114
+ corePath = process.env.TRIBUNAL_CORE_PATH;
115
+ }
116
+
117
+ if (corePath && fs.existsSync(corePath)) {
118
+ const result = require('child_process').execSync(`"${corePath}" ast-extract --file "${absPath}"`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
119
+ const data = JSON.parse(result);
120
+ if (data && data.success) {
121
+ // We map the Rust JSON into the exact format expected by the rest of the JS code
122
+ const mappedImports = data.imports.map(i => ({ source: i.source, specifiers: i.specifiers, line: 0 }));
123
+ const mappedExports = data.exports.map(e => ({ kind: e.kind, name: e.name, signature: e.signature, line: 0 }));
124
+ const mappedTypes = data.types.map(t => ({ kind: t.kind, name: t.name, signature: t.signature, line: 0 }));
125
+
126
+ return {
127
+ imports: mappedImports,
128
+ exports: mappedExports,
129
+ types: mappedTypes,
130
+ landmines: data.landmines,
131
+ interfaceHash: computeInterfaceHash(mappedExports.concat(mappedTypes))
132
+ };
133
+ }
134
+ }
135
+ } catch(e) {
136
+ // Silent fallback to Regex parsing
137
+ }
138
+
94
139
  lines.forEach((line, idx) => {
95
140
  const trimmed = line.trim();
96
141
 
@@ -954,6 +999,10 @@ function main() {
954
999
 
955
1000
  if (args.includes('--check')) {
956
1001
  const drift = checkDrift(workspaceRoot);
1002
+ if (args.includes('--json')) {
1003
+ console.log(JSON.stringify(drift));
1004
+ process.exit(0);
1005
+ }
957
1006
  console.log(`\n${C.BOLD}โ•โ•โ• Context Vault Drift Audit โ•โ•โ•${C.RESET}`);
958
1007
  console.log(`Total Dossiers: ${drift.total}`);
959
1008
  console.log(`๐ŸŸข Fresh: ${drift.fresh}`);
@@ -413,13 +413,9 @@ function buildEnhancedSkill(skillName, originalContent) {
413
413
  coreBody = coreBody.replace(/(\n---\s*)+$/, '').trim();
414
414
 
415
415
  // Format frontmatter with SDO trigger guarantee
416
- let desc = meta.description || `${skillName} mastery.`;
417
- if (
418
- !desc.toLowerCase().startsWith('use when') &&
419
- !desc.toLowerCase().startsWith('activate when')
420
- ) {
421
- desc = `Use when ${desc.replace(/^["']|["']$/g, '')}`;
422
- }
416
+ let desc = (meta.description || `${skillName} mastery.`).replace(/^["']|["']$/g, '');
417
+ desc = desc.replace(/^(use\s+when\s+)+/i, '').trim();
418
+ desc = `Use when ${desc}`;
423
419
 
424
420
  // Ensure scripts-binding
425
421
  const scripts = Array.isArray(meta['scripts-binding'])
@@ -433,7 +429,7 @@ function buildEnhancedSkill(skillName, originalContent) {
433
429
  const formattedFrontmatter = [
434
430
  '---',
435
431
  `name: ${skillName}`,
436
- `description: ${desc}`,
432
+ `description: "${desc.replace(/"/g, '\\"')}"`,
437
433
  `version: 5.0.0`,
438
434
  `last-updated: 2026-09-13`,
439
435
  meta.skills && meta.skills.length
@@ -509,34 +505,12 @@ ${preflights.join('\n')}
509
505
  - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
510
506
  - โœ… **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.`;
511
507
 
512
- // Assemble the complete enhanced document
508
+ // Assemble the complete enhanced document (Boilerplate stripped)
513
509
  const enhancedContent = `${formattedFrontmatter}
514
510
 
515
511
  # ${title}
516
512
 
517
- ${section1_Preflight}
518
-
519
- ${section2_Boundaries}
520
-
521
- ${section3_ExecutionProtocol}
522
-
523
- ---
524
-
525
- ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
526
-
527
513
  ${coreBody}
528
-
529
- ---
530
-
531
- ${section4_EdgeCases}
532
-
533
- ---
534
-
535
- ${section5_Traps}
536
-
537
- ---
538
-
539
- ${section6_Tribunal}
540
514
  `;
541
515
 
542
516
  return enhancedContent.trim() + '\n';
@@ -101,7 +101,9 @@ function run() {
101
101
  if (dryRun) {
102
102
  console.log('\n [DRY RUN] Would archive these monthly summaries:');
103
103
  for (const [month, bucket] of Object.entries(monthlyBuckets)) {
104
- console.log(` ${month}: ${bucket.total_dispatches} events, ${bucket.total_tokens} tokens`);
104
+ console.info(
105
+ ` ${month}: ${bucket.total_dispatches} events, ${bucket.total_tokens} tokens`,
106
+ );
105
107
  }
106
108
  console.log(` [DRY RUN] Would retain ${retained.length} recent events.\n`);
107
109
  return;
@@ -24,12 +24,7 @@ function validateMarkdownFile(filePath) {
24
24
  // Exclude templates and documentation that aren't strict skills
25
25
  if (!filePath.includes('SKILL.md')) return errors;
26
26
 
27
- if (!content.includes('Pre-Flight Checklist') && !content.includes('Pre-Flight')) {
28
- errors.push('Missing mandatory header/section: Pre-Flight Checklist');
29
- }
30
- if (!content.includes('VBC Protocol') && !content.includes('VBC')) {
31
- errors.push('Missing mandatory header/section: VBC Protocol');
32
- }
27
+ // Removed Pre-Flight and VBC checks as they are now centralized in system prompts to save tokens.
33
28
  }
34
29
 
35
30
  return errors;
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: 12-principles-of-animation
3
- 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.
3
+ 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."
4
4
  version: 5.0.0
5
5
  last-updated: 2026-09-13
6
6
  skills:
@@ -15,35 +15,6 @@ scripts-binding:
15
15
 
16
16
  # 12 Principles of Animation โ€” Web UI Motion Theory
17
17
 
18
- ## Mandatory Pre-Flight Context Inspection
19
-
20
- Before generating, refactoring, or reviewing code in the `12-principles-of-animation` domain, inspect these 5 critical parameters:
21
-
22
- 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
- 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
- 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
- 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
- 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
-
28
- ## Activation Boundaries
29
-
30
- - **Activate when:** 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.
31
- - **DO NOT activate when:** The task falls outside the `12-principles-of-animation` domain or is managed by a different dedicated specialist.
32
-
33
- ## ๐Ÿ” Multi-Pass Execution Protocol
34
-
35
- Execute all non-trivial tasks through this 7-pass cognitive loop:
36
-
37
- | Pass | Phase | Core Action |
38
- | :--------- | :--------------- | :------------------------------------------------------------------------------------------- |
39
- | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
40
- | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
41
- | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
42
- | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
43
- | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
44
- | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
45
- | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
46
-
47
18
  ---
48
19
 
49
20
  ## ๐Ÿ› ๏ธ Technical Architecture & Reference Recipes
@@ -78,49 +49,3 @@ Execute all non-trivial tasks through this 7-pass cognitive loop:
78
49
  ### 6. Follow Through & Overlapping Action
79
50
 
80
51
  - Secondary elements (e.g. badge text inside a sliding card) lag slightly behind the main container (stagger delay 30ms - 50ms), creating organic physical realism.
81
-
82
- ---
83
-
84
- ## ๐Ÿšจ Edge-Case & Failure Mode Matrix
85
-
86
- | Scenario | Risk | Mitigation Strategy |
87
- | :------------------------------------- | :--------------------------------------------------- | :------------------------------------------------------------------------------ |
88
- | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
89
- | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
90
- | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
91
- | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
92
- | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
93
-
94
- ---
95
-
96
- ## ๐Ÿค– LLM-Specific Traps Table
97
-
98
- | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
99
- | :----------------------- | :-------------------------------------------------------------------- | :------------------------------------------------------------------ |
100
- | **The Instant Pop Trap** | Conditionally unmounting elements without animated interpolation | Use AnimatePresence or coordinate morphs with continuous geometry |
101
- | **Layout Thrashing** | Animating width, height, top, or left inside animation loops | Animate composite-only transform (translate3d, scale) and opacity |
102
- | **Sluggish Duration** | Setting micro-interaction transitions to 600ms+ causing interface lag | Cap interactive feedback at 160msโ€“240ms with snappy ease-out curves |
103
-
104
- ---
105
-
106
- ## ๐Ÿ›๏ธ Tribunal Verification & Guardrails
107
-
108
- **Active Reviewers:** `frontend-reviewer` ยท `motion-reviewer` ยท `ui-ux-auditor`
109
- **Slash Command:** `/review` or `/tribunal-full`
110
-
111
- ### โœ… Pre-Flight Self-Audit Checklist
112
-
113
- ```
114
- โœ… Does animation maintain 60fps/120fps using transform and opacity?
115
- โœ… Is optical mass conserved across state interpolations without volume collapse?
116
- โœ… Is duration capped within micro-interaction budgets (160msโ€“280ms)?
117
- โœ… Is prefers-reduced-motion respected with graceful instant fallbacks?
118
- โœ… Did I prevent layout thrashing and continuous geometry mutations?
119
- ```
120
-
121
- ### ๐Ÿ›‘ Verification-Before-Completion (VBC) Protocol
122
-
123
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
124
-
125
- - โŒ **Forbidden:** Declaring a task complete because the output "looks correct."
126
- - โœ… **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.