@zenrick/zenkit 0.0.0-stage → 0.5.1

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 (355) hide show
  1. package/.claude-plugin/marketplace.json +19 -0
  2. package/.cursor-plugin/marketplace.json +22 -0
  3. package/INSTALL.md +73 -0
  4. package/LICENSE +202 -0
  5. package/NOTICE +5 -0
  6. package/README.md +69 -3
  7. package/TERMS.md +48 -0
  8. package/THIRD-PARTY-NOTICES.md +109 -0
  9. package/kit/agents/backend-specialist.md +263 -0
  10. package/kit/agents/code-archaeologist.md +106 -0
  11. package/kit/agents/database-architect.md +226 -0
  12. package/kit/agents/debugger.md +226 -0
  13. package/kit/agents/devops-engineer.md +242 -0
  14. package/kit/agents/documentation-writer.md +104 -0
  15. package/kit/agents/explorer-agent.md +73 -0
  16. package/kit/agents/frontend-specialist.md +593 -0
  17. package/kit/agents/game-developer.md +162 -0
  18. package/kit/agents/mobile-developer.md +377 -0
  19. package/kit/agents/orchestrator.md +489 -0
  20. package/kit/agents/penetration-tester.md +188 -0
  21. package/kit/agents/performance-optimizer.md +187 -0
  22. package/kit/agents/product-manager.md +112 -0
  23. package/kit/agents/product-owner.md +95 -0
  24. package/kit/agents/project-planner.md +409 -0
  25. package/kit/agents/qa-automation-engineer.md +103 -0
  26. package/kit/agents/security-auditor.md +170 -0
  27. package/kit/agents/seo-specialist.md +111 -0
  28. package/kit/agents/test-engineer.md +158 -0
  29. package/kit/bundles/agent-building.yaml +26 -0
  30. package/kit/bundles/backend-data.yaml +14 -0
  31. package/kit/bundles/base.yaml +10 -0
  32. package/kit/bundles/core.yaml +21 -0
  33. package/kit/bundles/kit-engenharia.yaml +8 -0
  34. package/kit/bundles/kit-lite.yaml +9 -0
  35. package/kit/bundles/security.yaml +11 -0
  36. package/kit/bundles/ship-run.yaml +16 -0
  37. package/kit/bundles/web-ui.yaml +18 -0
  38. package/kit/commands/docs.md +33 -0
  39. package/kit/commands/explain.md +41 -0
  40. package/kit/commands/fix.md +65 -0
  41. package/kit/commands/implement.md +35 -0
  42. package/kit/commands/refactor.md +59 -0
  43. package/kit/commands/review.md +55 -0
  44. package/kit/commands/test.md +63 -0
  45. package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
  46. package/kit/modules/bridge/zenkit-layer.yaml +1 -0
  47. package/kit/modules/nexuscore/sections/convivencia.md +12 -0
  48. package/kit/modules/nexuscore/sections/memoria.md +9 -0
  49. package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
  50. package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
  51. package/kit/rules/ZENKIT.mdc +294 -0
  52. package/kit/rules/git.mdc +51 -0
  53. package/kit/rules/karpathy-guidelines.mdc +70 -0
  54. package/kit/rules/model-routing.mdc +89 -0
  55. package/kit/rules/security-headers.mdc +41 -0
  56. package/kit/rules/social-automation.mdc +69 -0
  57. package/kit/rules/toc.mdc +40 -0
  58. package/kit/skills/api-patterns/SKILL.md +95 -0
  59. package/kit/skills/api-patterns/api-style.md +42 -0
  60. package/kit/skills/api-patterns/auth.md +24 -0
  61. package/kit/skills/api-patterns/documentation.md +26 -0
  62. package/kit/skills/api-patterns/graphql.md +41 -0
  63. package/kit/skills/api-patterns/rate-limiting.md +31 -0
  64. package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
  65. package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
  66. package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
  67. package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
  68. package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
  69. package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
  70. package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
  71. package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
  72. package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
  73. package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
  74. package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
  75. package/kit/skills/api-patterns/response.md +37 -0
  76. package/kit/skills/api-patterns/rest.md +40 -0
  77. package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
  78. package/kit/skills/api-patterns/security-testing.md +122 -0
  79. package/kit/skills/api-patterns/trpc.md +41 -0
  80. package/kit/skills/api-patterns/versioning.md +22 -0
  81. package/kit/skills/app-builder/SKILL.md +76 -0
  82. package/kit/skills/app-builder/agent-coordination.md +71 -0
  83. package/kit/skills/app-builder/feature-building.md +53 -0
  84. package/kit/skills/app-builder/project-detection.md +34 -0
  85. package/kit/skills/app-builder/scaffolding.md +118 -0
  86. package/kit/skills/app-builder/tech-stack.md +41 -0
  87. package/kit/skills/app-builder/templates/SKILL.md +39 -0
  88. package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  89. package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  90. package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  91. package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  92. package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  93. package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  94. package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  95. package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  96. package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  97. package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  98. package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  99. package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  100. package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  101. package/kit/skills/architecture/SKILL.md +56 -0
  102. package/kit/skills/architecture/context-discovery.md +43 -0
  103. package/kit/skills/architecture/examples.md +94 -0
  104. package/kit/skills/architecture/pattern-selection.md +68 -0
  105. package/kit/skills/architecture/patterns-reference.md +50 -0
  106. package/kit/skills/architecture/trade-off-analysis.md +77 -0
  107. package/kit/skills/bash-linux/SKILL.md +203 -0
  108. package/kit/skills/batch-operations/SKILL.md +112 -0
  109. package/kit/skills/behavioral-modes/SKILL.md +255 -0
  110. package/kit/skills/brainstorming/SKILL.md +189 -0
  111. package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
  112. package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
  113. package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
  114. package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
  115. package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
  116. package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
  117. package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
  118. package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
  119. package/kit/skills/claude-exec/SKILL.md +185 -0
  120. package/kit/skills/clean-code/SKILL.md +210 -0
  121. package/kit/skills/code-review-checklist/SKILL.md +115 -0
  122. package/kit/skills/code-review-graph/SKILL.md +50 -0
  123. package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
  124. package/kit/skills/code-review-graph/references/best-practices.md +9 -0
  125. package/kit/skills/code-review-graph/references/configuration.md +43 -0
  126. package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
  127. package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
  128. package/kit/skills/code-review-graph/references/installation.md +67 -0
  129. package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
  130. package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
  131. package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
  132. package/kit/skills/codex-exec/SKILL.md +161 -0
  133. package/kit/skills/context-compression/SKILL.md +145 -0
  134. package/kit/skills/coordinator-mode/SKILL.md +215 -0
  135. package/kit/skills/cursor-exec/SKILL.md +152 -0
  136. package/kit/skills/database-design/SKILL.md +53 -0
  137. package/kit/skills/database-design/database-selection.md +43 -0
  138. package/kit/skills/database-design/indexing.md +39 -0
  139. package/kit/skills/database-design/migrations.md +48 -0
  140. package/kit/skills/database-design/optimization.md +36 -0
  141. package/kit/skills/database-design/orm-selection.md +30 -0
  142. package/kit/skills/database-design/schema-design.md +56 -0
  143. package/kit/skills/database-design/scripts/schema_validator.py +172 -0
  144. package/kit/skills/deployment-procedures/SKILL.md +242 -0
  145. package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
  146. package/kit/skills/documentation-templates/SKILL.md +195 -0
  147. package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
  148. package/kit/skills/frontend-design/NOTICE.md +6 -0
  149. package/kit/skills/frontend-design/SKILL.md +456 -0
  150. package/kit/skills/frontend-design/animation-guide.md +331 -0
  151. package/kit/skills/frontend-design/color-system.md +311 -0
  152. package/kit/skills/frontend-design/decision-trees.md +418 -0
  153. package/kit/skills/frontend-design/motion-graphics.md +306 -0
  154. package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
  155. package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
  156. package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
  157. package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
  158. package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
  159. package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
  160. package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  161. package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
  162. package/kit/skills/frontend-design/typography-system.md +345 -0
  163. package/kit/skills/frontend-design/ux-psychology.md +1116 -0
  164. package/kit/skills/frontend-design/visual-effects.md +383 -0
  165. package/kit/skills/game-development/2d-games/SKILL.md +119 -0
  166. package/kit/skills/game-development/3d-games/SKILL.md +135 -0
  167. package/kit/skills/game-development/SKILL.md +168 -0
  168. package/kit/skills/game-development/game-art/SKILL.md +185 -0
  169. package/kit/skills/game-development/game-audio/SKILL.md +190 -0
  170. package/kit/skills/game-development/game-design/SKILL.md +129 -0
  171. package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
  172. package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
  173. package/kit/skills/game-development/pc-games/SKILL.md +144 -0
  174. package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
  175. package/kit/skills/game-development/web-games/SKILL.md +150 -0
  176. package/kit/skills/gemini-exec/SKILL.md +80 -0
  177. package/kit/skills/geo-fundamentals/SKILL.md +157 -0
  178. package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  179. package/kit/skills/git-worktrees/SKILL.md +107 -0
  180. package/kit/skills/i18n-localization/SKILL.md +145 -0
  181. package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  182. package/kit/skills/intelligent-routing/SKILL.md +128 -0
  183. package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
  184. package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
  185. package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
  186. package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
  187. package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
  188. package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
  189. package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
  190. package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
  191. package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
  192. package/kit/skills/intelligent-routing/references/summary.md +16 -0
  193. package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
  194. package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
  195. package/kit/skills/intelligent-routing/references/user-education.md +12 -0
  196. package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
  197. package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
  198. package/kit/skills/lint-and-validate/SKILL.md +46 -0
  199. package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  200. package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  201. package/kit/skills/mcp-atuacao/SKILL.md +238 -0
  202. package/kit/skills/mcp-builder/NOTICE.md +6 -0
  203. package/kit/skills/mcp-builder/SKILL.md +259 -0
  204. package/kit/skills/memory-system/SKILL.md +181 -0
  205. package/kit/skills/mobile-design/SKILL.md +395 -0
  206. package/kit/skills/mobile-design/decision-trees.md +516 -0
  207. package/kit/skills/mobile-design/mobile-backend.md +491 -0
  208. package/kit/skills/mobile-design/mobile-color-system.md +420 -0
  209. package/kit/skills/mobile-design/mobile-debugging.md +122 -0
  210. package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
  211. package/kit/skills/mobile-design/mobile-navigation.md +458 -0
  212. package/kit/skills/mobile-design/mobile-performance.md +767 -0
  213. package/kit/skills/mobile-design/mobile-testing.md +356 -0
  214. package/kit/skills/mobile-design/mobile-typography.md +433 -0
  215. package/kit/skills/mobile-design/platform-android.md +666 -0
  216. package/kit/skills/mobile-design/platform-ios.md +561 -0
  217. package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
  218. package/kit/skills/mobile-design/touch-psychology.md +537 -0
  219. package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
  220. package/kit/skills/negocio-atendimento/SKILL.md +134 -0
  221. package/kit/skills/negocio-linguagem/SKILL.md +166 -0
  222. package/kit/skills/negocio-preco/SKILL.md +174 -0
  223. package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
  224. package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
  225. package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
  226. package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
  227. package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
  228. package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
  229. package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
  230. package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
  231. package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
  232. package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
  233. package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
  234. package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
  235. package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
  236. package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
  237. package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
  238. package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
  239. package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
  240. package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
  241. package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
  242. package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
  243. package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
  244. package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
  245. package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  246. package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  247. package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
  248. package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
  249. package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
  250. package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
  251. package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
  252. package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
  253. package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
  254. package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
  255. package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
  256. package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
  257. package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
  258. package/kit/skills/opencode-go-exec/SKILL.md +101 -0
  259. package/kit/skills/parallel-agents/SKILL.md +184 -0
  260. package/kit/skills/performance-profiling/SKILL.md +145 -0
  261. package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  262. package/kit/skills/plan-writing/SKILL.md +213 -0
  263. package/kit/skills/powershell-windows/SKILL.md +196 -0
  264. package/kit/skills/provider-orchestration/SKILL.md +269 -0
  265. package/kit/skills/python-patterns/SKILL.md +80 -0
  266. package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
  267. package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
  268. package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
  269. package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
  270. package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
  271. package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
  272. package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
  273. package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
  274. package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
  275. package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
  276. package/kit/skills/red-team-tactics/SKILL.md +201 -0
  277. package/kit/skills/research/SKILL.md +166 -0
  278. package/kit/skills/rust-pro/SKILL.md +177 -0
  279. package/kit/skills/seo-fundamentals/SKILL.md +130 -0
  280. package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  281. package/kit/skills/sequential-thinking/.env.example +8 -0
  282. package/kit/skills/sequential-thinking/README.md +183 -0
  283. package/kit/skills/sequential-thinking/SKILL.md +95 -0
  284. package/kit/skills/sequential-thinking/package.json +31 -0
  285. package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
  286. package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
  287. package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
  288. package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
  289. package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
  290. package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
  291. package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
  292. package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
  293. package/kit/skills/server-management/SKILL.md +162 -0
  294. package/kit/skills/simplify-code/SKILL.md +133 -0
  295. package/kit/skills/skillify/SKILL.md +116 -0
  296. package/kit/skills/system-design-interview/SKILL.md +268 -0
  297. package/kit/skills/systematic-debugging/SKILL.md +110 -0
  298. package/kit/skills/tailwind-patterns/SKILL.md +283 -0
  299. package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
  300. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
  301. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
  302. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
  303. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
  304. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
  305. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
  306. package/kit/skills/tdd-workflow/SKILL.md +150 -0
  307. package/kit/skills/testing-patterns/SKILL.md +196 -0
  308. package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
  309. package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
  310. package/kit/skills/verify-changes/SKILL.md +125 -0
  311. package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
  312. package/kit/skills/vulnerability-scanner/checklists.md +121 -0
  313. package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  314. package/kit/skills/web-design-guidelines/SKILL.md +58 -0
  315. package/kit/skills/webapp-testing/NOTICE.md +6 -0
  316. package/kit/skills/webapp-testing/SKILL.md +188 -0
  317. package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  318. package/kit/workflows/brainstorm.md +113 -0
  319. package/kit/workflows/coordinate.md +72 -0
  320. package/kit/workflows/create.md +59 -0
  321. package/kit/workflows/debug.md +103 -0
  322. package/kit/workflows/deploy.md +176 -0
  323. package/kit/workflows/enhance.md +63 -0
  324. package/kit/workflows/orchestrate.md +237 -0
  325. package/kit/workflows/plan.md +89 -0
  326. package/kit/workflows/preview.md +81 -0
  327. package/kit/workflows/remember.md +67 -0
  328. package/kit/workflows/status.md +86 -0
  329. package/kit/workflows/test.md +144 -0
  330. package/kit/workflows/ui-ux-pro-max.md +296 -0
  331. package/kit/workflows/verify.md +72 -0
  332. package/licenses/Apache-2.0.txt +202 -0
  333. package/package.json +60 -6
  334. package/scripts/archive-codex-rollouts.ps1 +35 -0
  335. package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
  336. package/scripts/bundle.mjs +170 -0
  337. package/scripts/check-deps.mjs +178 -0
  338. package/scripts/check-models.mjs +150 -0
  339. package/scripts/cli.mjs +313 -0
  340. package/scripts/content-checks.mjs +18 -0
  341. package/scripts/continuidade-mandato.mjs +47 -0
  342. package/scripts/discriminar-turno.mjs +191 -0
  343. package/scripts/doctor.mjs +611 -0
  344. package/scripts/generate.mjs +688 -0
  345. package/scripts/install.mjs +11 -0
  346. package/scripts/layer-remote.mjs +407 -0
  347. package/scripts/layers.mjs +208 -0
  348. package/scripts/marketplace.mjs +77 -0
  349. package/scripts/product.mjs +32 -0
  350. package/scripts/ruleset-core.mjs +68 -0
  351. package/scripts/social-hooks.mjs +293 -0
  352. package/scripts/social-pacer.mjs +219 -0
  353. package/scripts/validate-bundles.mjs +14 -0
  354. package/scripts/validate-skills.mjs +174 -0
  355. package/scripts/zenkit-daemon-task.cmd +3 -0
@@ -0,0 +1,611 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * zenkit doctor — o kit está pronto para alguém se servir sozinho?
4
+ * Falha fechada: ausência de recorte lite, skill proibida no lite, ou
5
+ * carimbo de validade faltando em fiscal/LGPD reprova.
6
+ *
7
+ * node scripts/doctor.mjs
8
+ */
9
+ import { promises as fs } from "node:fs";
10
+ import os from "node:os";
11
+ import path from "node:path";
12
+ import { fileURLToPath } from "node:url";
13
+ import { generateKit, emitPluginPackage } from "./generate.mjs";
14
+ import { loadBundleFiles, resolveBundle } from "./bundle.mjs";
15
+ import { applySlots } from "./layers.mjs";
16
+ import { STAMPED, stampProblems } from "./content-checks.mjs";
17
+ import { expectedMarketplaces, marketplacePaths } from "./marketplace.mjs";
18
+ import { pluginId } from "./product.mjs";
19
+ import { spawnSync } from "node:child_process";
20
+
21
+ // doctor checks the public core: the operator's own layers stay out of its scratch installs.
22
+ delete process.env.ZENKIT_LAYERS;
23
+
24
+ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
25
+ const LITE_FORBIDDEN = [
26
+ "negocio-fiscal",
27
+ "negocio-privacidade",
28
+ "negocio-agenda",
29
+ "rust-pro",
30
+ ];
31
+
32
+ let failed = 0;
33
+
34
+ function ok(msg) {
35
+ process.stdout.write(` [OK ] ${msg}\n`);
36
+ }
37
+ function fail(msg) {
38
+ process.stdout.write(` [FALHA] ${msg}\n`);
39
+ failed += 1;
40
+ }
41
+ function warn(msg) {
42
+ process.stdout.write(` [AVISO] ${msg}\n`);
43
+ }
44
+
45
+ async function exists(p) {
46
+ try {
47
+ await fs.access(p);
48
+ return true;
49
+ } catch {
50
+ return false;
51
+ }
52
+ }
53
+
54
+ const norm = (s) => s.replace(/^\uFEFF/, "").replace(/\r\n/g, "\n");
55
+
56
+ /** Every file the generator WOULD emit must exist in the target and match. */
57
+ async function compareTree(expectedDir, actualDir) {
58
+ const missing = [];
59
+ const differ = [];
60
+ let expectedCount = 0;
61
+
62
+ async function countFiles(dir) {
63
+ let n = 0;
64
+ let entries;
65
+ try {
66
+ entries = await fs.readdir(dir, { withFileTypes: true });
67
+ } catch {
68
+ return 0;
69
+ }
70
+ for (const e of entries) {
71
+ if (e.isDirectory()) n += await countFiles(path.join(dir, e.name));
72
+ else n += 1;
73
+ }
74
+ return n;
75
+ }
76
+
77
+ async function walk(dir, rel) {
78
+ let entries;
79
+ try {
80
+ entries = await fs.readdir(dir, { withFileTypes: true });
81
+ } catch {
82
+ return;
83
+ }
84
+ for (const e of entries) {
85
+ const r = rel ? path.join(rel, e.name) : e.name;
86
+ if (e.isDirectory()) {
87
+ await walk(path.join(dir, e.name), r);
88
+ continue;
89
+ }
90
+ expectedCount += 1;
91
+ const actual = path.join(actualDir, r);
92
+ if (!(await exists(actual))) {
93
+ missing.push(r);
94
+ continue;
95
+ }
96
+ const a = norm(await fs.readFile(path.join(dir, e.name), "utf8").catch(() => "\u0000"));
97
+ const b = norm(await fs.readFile(actual, "utf8").catch(() => "\u0001"));
98
+ if (a !== b) differ.push(r);
99
+ }
100
+ }
101
+ await walk(expectedDir, "");
102
+ return { missing, differ, expectedCount, actualCount: await countFiles(actualDir) };
103
+ }
104
+
105
+ /**
106
+ * Reverse check: every file DEPLOYED that the kit also defines must match what
107
+ * the generator would emit for that same path. Files the kit does not define are
108
+ * not ours (synced skills); kit files that are not deployed are not a drift —
109
+ * the target may legitimately run a smaller bundle. This is what covers agents
110
+ * that arrive outside a bundle.
111
+ */
112
+ async function compareDeployed(actualDir, expectedDir) {
113
+ const differ = [];
114
+ const outside = [];
115
+ let compared = 0;
116
+
117
+ async function walk(dir, rel) {
118
+ let entries;
119
+ try {
120
+ entries = await fs.readdir(dir, { withFileTypes: true });
121
+ } catch {
122
+ return;
123
+ }
124
+ for (const e of entries) {
125
+ const r = rel ? path.join(rel, e.name) : e.name;
126
+ if (e.isDirectory()) {
127
+ await walk(path.join(dir, e.name), r);
128
+ continue;
129
+ }
130
+ const exp = path.join(expectedDir, r);
131
+ if (!(await exists(exp))) {
132
+ outside.push(r);
133
+ continue;
134
+ }
135
+ compared += 1;
136
+ const a = norm(await fs.readFile(exp, "utf8").catch(() => "\u0000"));
137
+ const b = norm(await fs.readFile(path.join(dir, e.name), "utf8").catch(() => "\u0001"));
138
+ if (a !== b) differ.push(r);
139
+ }
140
+ }
141
+ await walk(actualDir, "");
142
+ return { differ, outside, compared };
143
+ }
144
+
145
+ // Drift guard: a deployed copy that claims to be the source but is not is the
146
+ // failure mode this kit already paid for twice (2026-11-04: ZENKIT.mdc 2 weeks
147
+ // stale, social-automation.mdc missing 38 lines, model-routing.mdc ahead of kit).
148
+ // Opt-in, because only the caller knows where the target lives and which
149
+ // bundle it was installed with.
150
+ // node scripts/doctor.mjs --drift <target-dir> [--bundle <nome>]
151
+ // Regras são sempre comparadas. Agents/skills exigem --bundle, porque o alvo
152
+ // pode ter recebido um recorte menor (lite) ou skills extras legítimas.
153
+ // The public core must not carry the owner's infrastructure (ADR-0004): that
154
+ // lives in their private layer. Zenrick product names may appear only in the
155
+ // product modules (kit/modules/, off by default). The owner's own hosts and
156
+ // accounts must appear nowhere in what ships, and that list is itself private:
157
+ // it is read from ZENKIT_BRAND_BLOCKLIST or ~/.zenkit/brand-blocklist.txt (one
158
+ // term per line), never written in this file, which is published.
159
+ const PRODUCT_NAMES = /NexusCore|Kyron/gi;
160
+ const BRAND_CEILING = {};
161
+
162
+ async function personalBlocklist() {
163
+ const file = process.env.ZENKIT_BRAND_BLOCKLIST || path.join(os.homedir(), ".zenkit", "brand-blocklist.txt");
164
+ const raw = await fs.readFile(file, "utf8").catch(() => null);
165
+ const terms = (raw ?? "")
166
+ .split(/\r?\n/)
167
+ .map((s) => s.trim())
168
+ .filter((s) => s && !s.startsWith("#"));
169
+ if (!terms.length) return null;
170
+ return new RegExp(terms.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|"), "gi");
171
+ }
172
+
173
+ async function kitTextFiles(dir, rel = "kit") {
174
+ const out = [];
175
+ for (const entry of await fs.readdir(dir, { withFileTypes: true })) {
176
+ const p = path.join(dir, entry.name);
177
+ const r = `${rel}/${entry.name}`;
178
+ if (entry.isDirectory()) out.push(...(await kitTextFiles(p, r)));
179
+ else if (/\.(md|mdc|mjs|js|ts|json|ya?ml|txt|sh|ps1|py)$/i.test(entry.name)) out.push([r, p]);
180
+ }
181
+ return out;
182
+ }
183
+
184
+ /** What the npm package ships besides kit/: scripts (minus tests) and the root documents. */
185
+ async function shippedNonKitFiles() {
186
+ const scripts = (await kitTextFiles(path.join(ROOT, "scripts"), "scripts")).filter(
187
+ ([rel]) => !/\.test\.mjs$|\.sh$/.test(rel),
188
+ );
189
+ const root = [];
190
+ for (const f of ["README.md", "INSTALL.md", "TERMS.md", "NOTICE", "THIRD-PARTY-NOTICES.md"]) {
191
+ if (await exists(path.join(ROOT, f))) root.push([f, path.join(ROOT, f)]);
192
+ }
193
+ return [...scripts, ...root];
194
+ }
195
+
196
+ async function checkPersonalBrands() {
197
+ let total = 0;
198
+ let clean = true;
199
+ const seen = new Set();
200
+ const personal = await personalBlocklist();
201
+ if (!personal) {
202
+ warn("lista privada de marcas pessoais ausente (ZENKIT_BRAND_BLOCKLIST ou ~/.zenkit/brand-blocklist.txt); só nomes de produto conferidos");
203
+ }
204
+ for (const [rel, file] of await shippedNonKitFiles()) {
205
+ const hits = personal ? ((await fs.readFile(file, "utf8")).match(personal) ?? []).length : 0;
206
+ if (hits) {
207
+ clean = false;
208
+ fail(`${rel}: ${hits} menção(ões) à infraestrutura do dono num arquivo que vai no pacote`);
209
+ }
210
+ }
211
+ for (const [rel, file] of await kitTextFiles(path.join(ROOT, "kit"))) {
212
+ const text = await fs.readFile(file, "utf8");
213
+ const inModule = rel.startsWith("kit/modules/");
214
+ const hits =
215
+ (personal ? (text.match(personal) ?? []).length : 0) +
216
+ (inModule ? 0 : (text.match(PRODUCT_NAMES) ?? []).length);
217
+ if (hits === 0) continue;
218
+ total += hits;
219
+ seen.add(rel);
220
+ const ceiling = BRAND_CEILING[rel];
221
+ if (!ceiling) {
222
+ clean = false;
223
+ fail(`${rel}: ${hits} menção(ões) à infraestrutura do dono no núcleo público (vai na camada privada)`);
224
+ } else if (hits > ceiling.max) {
225
+ clean = false;
226
+ fail(`${rel}: ${hits} menções, teto ${ceiling.max} (${ceiling.plan}); o teto só desce`);
227
+ } else if (hits < ceiling.max) {
228
+ warn(`${rel}: ${hits} menções, abaixo do teto ${ceiling.max}; baixe o teto em BRAND_CEILING`);
229
+ }
230
+ }
231
+ for (const rel of Object.keys(BRAND_CEILING)) {
232
+ if (!seen.has(rel)) warn(`${rel}: sem menções; remova a entrada de BRAND_CEILING`);
233
+ }
234
+ if (clean) {
235
+ ok(`núcleo sem marca pessoal (nomes de produto só em kit/modules; ${total} fora disso)`);
236
+ }
237
+
238
+ const modulesDir = path.join(ROOT, "kit", "modules");
239
+ const names = (await fs.readdir(modulesDir, { withFileTypes: true }).catch(() => []))
240
+ .filter((e) => e.isDirectory())
241
+ .map((e) => e.name);
242
+ const broken = [];
243
+ for (const name of names) {
244
+ const manifest = await fs.readFile(path.join(modulesDir, name, "zenkit-layer.yaml"), "utf8").catch(() => "");
245
+ if (!new RegExp(`^name:\\s*${name}\\s*$`, "m").test(manifest)) broken.push(name);
246
+ }
247
+ if (broken.length) fail(`módulo sem zenkit-layer.yaml com name igual à pasta: ${broken.join(", ")}`);
248
+ else ok(`módulos do produto: ${names.join(", ") || "nenhum"}`);
249
+ }
250
+
251
+ /** Every rule the kit can install: core rules plus each product module's rules. */
252
+ async function kitRuleSources() {
253
+ const sources = new Map();
254
+ const core = path.join(ROOT, "kit", "rules");
255
+ for (const f of await fs.readdir(core)) if (f.endsWith(".mdc")) sources.set(f, { file: path.join(core, f), module: null });
256
+ const modulesDir = path.join(ROOT, "kit", "modules");
257
+ for (const e of await fs.readdir(modulesDir, { withFileTypes: true }).catch(() => [])) {
258
+ if (!e.isDirectory()) continue;
259
+ const dir = path.join(modulesDir, e.name, "rules");
260
+ for (const f of await fs.readdir(dir).catch(() => [])) {
261
+ if (f.endsWith(".mdc")) sources.set(f, { file: path.join(dir, f), module: e.name });
262
+ }
263
+ }
264
+ return sources;
265
+ }
266
+
267
+ async function checkRuleDrift(argv) {
268
+ const i = argv.indexOf("--drift");
269
+ if (i === -1) return;
270
+ const target = argv[i + 1];
271
+ if (!target) {
272
+ fail("--drift sem diretório alvo");
273
+ return;
274
+ }
275
+ const targetRoot = path.resolve(target);
276
+
277
+ const dstDir = path.join(targetRoot, ".cursor", "rules");
278
+ if (!(await exists(dstDir))) {
279
+ fail(`drift: ${dstDir} não existe (alvo não instalado?)`);
280
+ return;
281
+ }
282
+ const sources = await kitRuleSources();
283
+ const srcFiles = [...sources].filter(([, s]) => !s.module).map(([f]) => f).sort();
284
+ const dstFiles = (await fs.readdir(dstDir)).filter((f) => f.endsWith(".mdc")).sort();
285
+ // Core rules must be installed; a module rule shows up only when a layer turns its module on.
286
+ const missing = srcFiles.filter((f) => !dstFiles.includes(f));
287
+ const extra = dstFiles.filter((f) => !sources.has(f));
288
+ const differ = [];
289
+ for (const f of dstFiles.filter((f) => sources.has(f))) {
290
+ const src = await fs.readFile(sources.get(f).file, "utf8");
291
+ // The master rule is installed rendered (slot markers removed, core defaults kept).
292
+ const a = norm(f === "ZENKIT.mdc" ? applySlots(src) : src);
293
+ const b = norm(await fs.readFile(path.join(dstDir, f), "utf8"));
294
+ if (a !== b) differ.push(f);
295
+ }
296
+ if (missing.length) fail(`drift: regra no kit e ausente no alvo: ${missing.join(", ")}`);
297
+ if (extra.length) fail(`drift: regra no alvo que não existe no kit: ${extra.join(", ")}`);
298
+ if (differ.length) fail(`drift: cópia viva diverge da fonte: ${differ.join(", ")}`);
299
+ if (!missing.length && !extra.length && !differ.length) {
300
+ ok(`drift: ${srcFiles.length} regras idênticas entre kit e ${dstDir}`);
301
+ }
302
+
303
+ const bi = argv.indexOf("--bundle");
304
+ const bundle = bi === -1 ? null : argv[bi + 1];
305
+ const full = argv.includes("--full");
306
+ if (!bundle && !full) {
307
+ ok("drift: agents/skills não comparados (passe --bundle <nome> ou --full)");
308
+ return;
309
+ }
310
+ if (bundle && full) {
311
+ fail("drift: use --bundle OU --full, não os dois");
312
+ return;
313
+ }
314
+
315
+ // Compare against what the generator itself would emit for this bundle:
316
+ // both sides went through the same adaptation (model pin, frontmatter), so
317
+ // any difference left is real drift — no heuristic normalisation.
318
+ const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "zenkit-drift-"));
319
+ try {
320
+ await generateKit({ target: tmp, bundle: bundle ?? undefined });
321
+ const TREES = [
322
+ [".cursor/agents", "agents Cursor"],
323
+ [".claude/agents", "agents Claude"],
324
+ [".cursor/skills", "skills Cursor"],
325
+ [".claude/skills", "skills Claude"],
326
+ [".agents/skills", "skills .agents"],
327
+ ];
328
+
329
+ if (full) {
330
+ for (const [rel, label] of TREES) {
331
+ const { differ, outside, compared } = await compareDeployed(path.join(targetRoot, rel), path.join(tmp, rel));
332
+ if (differ.length) {
333
+ fail(
334
+ `drift: ${label} — ${differ.length} divergente(s) de ${compared}: ` +
335
+ `${differ.slice(0, 4).join(", ")}${differ.length > 4 ? "…" : ""}`,
336
+ );
337
+ } else {
338
+ ok(`drift: ${label} — ${compared} comparados${outside.length ? `, ${outside.length} fora do kit` : ""}`);
339
+ }
340
+ }
341
+ return;
342
+ }
343
+
344
+ for (const [rel, label] of TREES) {
345
+ const expectedDir = path.join(tmp, rel);
346
+ if (!(await exists(expectedDir))) continue;
347
+ const r = await compareTree(expectedDir, path.join(targetRoot, rel));
348
+ // Reporting "identical" over an empty expected set would be a claim with
349
+ // no evidence behind it — the exact defect this kit now forbids (§9).
350
+ if (r.expectedCount === 0) {
351
+ if (r.actualCount > 0) {
352
+ ok(`drift: ${label} — bundle não emite; ${r.actualCount} no alvo ficam sem cobertura`);
353
+ } else {
354
+ ok(`drift: ${label} — vazio nos dois lados`);
355
+ }
356
+ continue;
357
+ }
358
+ if (!r.missing.length && !r.differ.length) {
359
+ ok(`drift: ${label} idênticos (${r.expectedCount} arquivos, ${bundle})`);
360
+ } else {
361
+ const parts = [];
362
+ if (r.missing.length) {
363
+ parts.push(`${r.missing.length} ausente(s): ${r.missing.slice(0, 4).join(", ")}${r.missing.length > 4 ? "…" : ""}`);
364
+ }
365
+ if (r.differ.length) {
366
+ parts.push(`${r.differ.length} divergente(s): ${r.differ.slice(0, 4).join(", ")}${r.differ.length > 4 ? "…" : ""}`);
367
+ }
368
+ fail(`drift: ${label} — ${parts.join(" | ")}`);
369
+ }
370
+ }
371
+ } finally {
372
+ await fs.rm(tmp, { recursive: true, force: true, maxRetries: 3 }).catch(() => {});
373
+ }
374
+ }
375
+
376
+
377
+ async function main() {
378
+ process.stdout.write("zenkit doctor\n");
379
+
380
+ const major = Number(process.versions.node.split(".")[0]);
381
+ if (major >= 18) ok(`Node ${process.versions.node} (>= 18)`);
382
+ else fail(`Node ${process.versions.node} — precisa >= 18`);
383
+
384
+ for (const rel of [
385
+ "INSTALL.md",
386
+ "TERMS.md",
387
+ "LICENSE",
388
+ "NOTICE",
389
+ "THIRD-PARTY-NOTICES.md",
390
+ "kit/bundles/kit-lite.yaml",
391
+ "scripts/cli.mjs",
392
+ ]) {
393
+ if (await exists(path.join(ROOT, rel))) ok(`${rel} presente`);
394
+ else fail(`${rel} ausente`);
395
+ }
396
+ const license = await fs.readFile(path.join(ROOT, "LICENSE"), "utf8").catch(() => "");
397
+ if (/Apache License\s+Version 2\.0/.test(license)) ok("LICENSE é Apache-2.0");
398
+ else fail("LICENSE não é o texto da Apache-2.0");
399
+
400
+ let pkg;
401
+ try {
402
+ pkg = JSON.parse(await fs.readFile(path.join(ROOT, "package.json"), "utf8"));
403
+ } catch {
404
+ fail("package.json ilegível");
405
+ pkg = {};
406
+ }
407
+ if (pkg.bin && pkg.bin.zenkit) ok("package.json bin.zenkit");
408
+ else fail("package.json sem bin.zenkit — npx não acha o comando");
409
+ if (pkg.license === "Apache-2.0") ok("package.json license Apache-2.0");
410
+ else fail(`package.json license '${pkg.license ?? ""}', esperado Apache-2.0`);
411
+
412
+
413
+ const byName = await loadBundleFiles();
414
+ let lite;
415
+ try {
416
+ lite = resolveBundle("kit-lite", byName);
417
+ ok(`kit-lite resolve: ${lite.skills.size} skills`);
418
+ } catch (e) {
419
+ fail(`kit-lite não resolve: ${e.message}`);
420
+ process.exit(1);
421
+ }
422
+
423
+ const hit = [...lite.skills].filter((s) => LITE_FORBIDDEN.includes(s));
424
+ if (hit.length) fail(`kit-lite contém ofício/clínica: ${hit.join(", ")}`);
425
+ else ok("kit-lite sem fiscal, LGPD, agenda, rust-pro");
426
+
427
+ if (lite.skills.size < 4 || lite.skills.size > 8) {
428
+ fail(`kit-lite deveria ter 4–8 skills, tem ${lite.skills.size}`);
429
+ } else ok(`tamanho do lite (${lite.skills.size}) na faixa de porta de entrada`);
430
+
431
+ const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "zenkit-doctor-"));
432
+ try {
433
+ await generateKit({ target: tmp, bundle: "kit-lite" });
434
+ const cursorSkills = path.join(tmp, ".cursor", "skills");
435
+ const claudeSkills = path.join(tmp, ".claude", "skills");
436
+ const agentsSkills = path.join(tmp, ".agents", "skills");
437
+ const emitted = await fs.readdir(cursorSkills);
438
+ const extra = emitted.filter((s) => LITE_FORBIDDEN.includes(s));
439
+ if (extra.length) fail(`generate kit-lite emitiu ${extra.join(", ")}`);
440
+ else ok(`generate kit-lite emitiu ${emitted.length} skills, nenhuma proibida`);
441
+ const nClaude = (await fs.readdir(claudeSkills)).length;
442
+ const nAgents = (await fs.readdir(agentsSkills)).length;
443
+ if (nClaude !== emitted.length || nAgents !== emitted.length) {
444
+ fail(`contagem diverge: cursor=${emitted.length} claude=${nClaude} agents=${nAgents}`);
445
+ } else ok("Cursor, Claude e Codex (.agents) receberam o mesmo recorte");
446
+ if (!(await exists(path.join(tmp, ".claude", "CLAUDE.md")))) {
447
+ fail("generate kit-lite não emitiu .claude/CLAUDE.md");
448
+ } else ok("Claude Code: CLAUDE.md no lite");
449
+ if (!(await exists(path.join(tmp, ".codex", "AGENTS.md")))) {
450
+ fail("Codex global: .codex/AGENTS.md no lite");
451
+ } else ok("Codex global: .codex/AGENTS.md no lite");
452
+ if (!(await exists(path.join(tmp, "GEMINI.md")))) {
453
+ fail("generate kit-lite n\u00e3o emitiu GEMINI.md");
454
+ } else ok("Antigravity / Gemini: GEMINI.md no lite");
455
+
456
+ const plug = path.join(tmp, "plugin-lite");
457
+ const emittedPlug = await emitPluginPackage({ dest: plug, bundle: "kit-lite" });
458
+ if (emittedPlug.id !== pluginId("kit-lite")) {
459
+ fail(`plugin id ${emittedPlug.id} ≠ ${pluginId("kit-lite")}`);
460
+ } else ok(`plugin nativo ${emittedPlug.id}`);
461
+ const cursorManifest = JSON.parse(
462
+ await fs.readFile(
463
+ path.join(plug, "cursor", ".cursor-plugin", "plugin.json"),
464
+ "utf8",
465
+ ),
466
+ );
467
+ const agentManifest = JSON.parse(
468
+ await fs.readFile(path.join(plug, "claude", "plugin.json"), "utf8"),
469
+ );
470
+ if (cursorManifest.name !== emittedPlug.id) {
471
+ fail("Cursor plugin.json name diverge");
472
+ } else ok("Cursor plugin.json");
473
+ if (!agentManifest.$schema || agentManifest.name !== emittedPlug.id) {
474
+ fail("Agent Plugins plugin.json incompleto");
475
+ } else ok("Agent Plugins plugin.json");
476
+ const plugSkills = await fs.readdir(path.join(plug, "cursor", "skills"));
477
+ const plugForbidden = plugSkills.filter((s) => LITE_FORBIDDEN.includes(s));
478
+ if (plugForbidden.length) fail(`plugin lite emitiu ${plugForbidden.join(", ")}`);
479
+ else ok("plugin lite sem skill proibida");
480
+ } finally {
481
+ await fs.rm(tmp, { recursive: true, force: true });
482
+ }
483
+
484
+ const homeEntryPoints = [
485
+ { label: "~/.codex/AGENTS.md", file: path.join(os.homedir(), ".codex", "AGENTS.md"), tool: "Codex" },
486
+ { label: "~/.claude/CLAUDE.md", file: path.join(os.homedir(), ".claude", "CLAUDE.md"), tool: "Claude Code" },
487
+ ];
488
+ for (const { label, file, tool } of homeEntryPoints) {
489
+ if (!(await exists(file))) {
490
+ ok(`${label} ausente (ok se ${tool} não usa home)`);
491
+ continue;
492
+ }
493
+ const homeBody = await fs.readFile(file, "utf8");
494
+ if (!homeBody.includes("Gerado de `kit/rules/ZENKIT.mdc`")) {
495
+ warn(
496
+ `${label} não foi gerado pelo ZenKit: o ${tool} roda com regras defasadas. Rode o generate com target na home.`,
497
+ );
498
+ } else if (!homeBody.includes("## Ruleset global (NexusCore v")) {
499
+ warn(`${label} sem o ruleset do NexusCore: gere com ZENKIT_RULESET_SOURCE apontando para rules/ruleset.source.md.`);
500
+ } else {
501
+ ok(`${label} gerado pelo ZenKit com o ruleset do NexusCore`);
502
+ }
503
+ }
504
+
505
+ try {
506
+ const expected = await expectedMarketplaces();
507
+ const paths = marketplacePaths();
508
+ // Compare EOL-normalized: with core.autocrlf=true the checkout carries CRLF
509
+ // while fresh generation emits LF, so a byte-wise compare fails spuriously
510
+ // on Windows (content always matches).
511
+ const normalize = (s) => s.replace(/\r\n/g, "\n");
512
+ for (const side of ["claude", "cursor"]) {
513
+ const onDisk = normalize(await fs.readFile(paths[side], "utf8"));
514
+ const want = normalize(JSON.stringify(expected[side], null, 2) + "\n");
515
+ if (onDisk === want) ok(`catálogo ${side} bate com os storefronts`);
516
+ else fail(`catálogo ${side} divergiu — rode: zenkit generate --plugins`);
517
+ }
518
+ if (expected.storefronts.length < 1) fail("nenhum bundle storefront");
519
+ else ok(`${expected.storefronts.length} recortes de vitrine no catálogo`);
520
+ } catch (e) {
521
+ fail(`catálogo: ${e.message}`);
522
+ }
523
+
524
+ for (const name of STAMPED) {
525
+ const file = path.join(ROOT, "kit", "skills", name, "SKILL.md");
526
+ if (!(await exists(file))) {
527
+ warn(`${name} não está no núcleo (camada paga); o carimbo é conferido no zenkit layer pack --bundle`);
528
+ continue;
529
+ }
530
+ const problems = stampProblems(name, await fs.readFile(file, "utf8"));
531
+ if (problems.length === 0) ok(`carimbo de validade em ${name} e rascunho a validar`);
532
+ for (const p of problems) fail(p);
533
+ }
534
+
535
+ // §2c (P0): o encerramento tem de entregar as opções pelo MENU do runtime, não em
536
+ // texto puro. Régua: se a redação perder o menu, o fallback, o marcador "Recomendada"
537
+ // ou a proibição, o kit reprova — foi exatamente esse o defeito corrigido.
538
+ const regra = await fs.readFile(path.join(ROOT, "kit", "rules", "ZENKIT.mdc"), "utf8");
539
+ const secao2c = regra.split(/^## 2c\./m)[1]?.split(/^## /m)[0] ?? "";
540
+ if (/ferramenta de pergunta interativa/i.test(secao2c)) {
541
+ ok("§2c manda entregar as opções pelo menu do runtime");
542
+ } else fail("§2c não manda usar o menu (ferramenta de pergunta interativa)");
543
+ const MENU_TOOLS = ["AskUserQuestion", "AskQuestion", "ask_question", "ask_user", "`question`"];
544
+ const semFerramenta = MENU_TOOLS.filter((t) => !secao2c.includes(t));
545
+ if (semFerramenta.length === 0) ok(`§2c nomeia os menus por runtime (${MENU_TOOLS.length})`);
546
+ else fail(`§2c não cita o menu de: ${semFerramenta.join(", ")}`);
547
+ if (/fallback/i.test(secao2c)) ok("§2c marca a lista em texto como fallback");
548
+ else fail("§2c não diz quando a lista em texto vale (fallback)");
549
+ if (secao2c.includes("(Recomendada)")) ok("§2c mantém a recomendada marcada");
550
+ else fail("§2c perdeu o marcador (Recomendada)");
551
+ if (/Proibido/i.test(secao2c)) ok("§2c mantém a proibição de encerramento genérico");
552
+ else fail("§2c perdeu a proibição de frase genérica");
553
+
554
+ // §9 (P0): a régua de pronto. Se a redação perder a tabela por tipo, as
555
+ // invariantes fail-closed ou a saída honesta, o kit reprova — "concluído"
556
+ // volta a ser frase de encerramento em vez de afirmação verificável.
557
+ const secao9 = regra.split(/^## 9\./m)[1]?.split(/^## /m)[0] ?? "";
558
+ if (secao9 && /DEFINI[ÇC][ÃA]O DE PRONTO/i.test(regra)) ok("§9 define a régua de pronto");
559
+ else fail("§9 (definição de pronto) ausente");
560
+ const TIPOS = ["Código", "Config", "Doc", "Schema", "Deploy", "UI", "Investigação"];
561
+ const semTipo = TIPOS.filter((t) => !secao9.includes(t));
562
+ if (semTipo.length === 0) ok(`§9 cobre os tipos de tarefa (${TIPOS.length})`);
563
+ else fail(`§9 não cobre: ${semTipo.join(", ")}`);
564
+ if (/Verificador que n[ãa]o executou n[ãa]o é evidência/i.test(secao9)) {
565
+ ok("§9 trata verificador que não executou como BLOCKED");
566
+ } else fail("§9 perdeu a invariante do verificador que não executou");
567
+ if (/n[ãa]o verificado:\s*<motivo>/i.test(secao9)) ok("§9 aceita declarar o que não foi verificado");
568
+ else fail("§9 perdeu a saída honesta 'não verificado: <motivo>'");
569
+ if (/comando de efeito/i.test(secao9)) ok("§9 exige comando de efeito para afirmar deploy/merge");
570
+ else fail("§9 não exige comando de efeito");
571
+
572
+ // §10 (P0): a unidade de trabalho é a demanda. Se a redação perder a lista de
573
+ // forks legítimos, o agente volta a pedir permissão a cada passo — o defeito
574
+ // medido em 1.267 perguntas (344 delas travando trabalho reversível).
575
+ const secao10 = regra.split(/^## 10\./m)[1]?.split(/^## /m)[0] ?? "";
576
+ if (secao10 && /UNIDADE DE TRABALHO/i.test(regra)) ok("§10 define a unidade de trabalho (demanda)");
577
+ else fail("§10 (unidade de trabalho) ausente");
578
+ if (/bloqueio real/i.test(secao10)) ok("§10 manda continuar até bloqueio real");
579
+ else fail("§10 perdeu 'continue até bloqueio real'");
580
+ const FORKS = ["Credencial", "irrevers", "Dinheiro", "Spec", "Informação"];
581
+ const semFork = FORKS.filter((f) => !new RegExp(f, "i").test(secao10));
582
+ if (semFork.length === 0) ok(`§10 lista os forks legítimos (${FORKS.length})`);
583
+ else fail(`§10 não lista: ${semFork.join(", ")}`);
584
+ if (/j[áa] est[áa] escrita no processo/i.test(secao10)) ok("§10 exige o teste do menu antes de perguntar");
585
+ else fail("§10 perdeu o teste 'a recomendada já está no processo?'");
586
+ if (/n[ãa]o pergunte — execute/i.test(secao2c)) ok("§2c proíbe pedido de permissão disfarçado");
587
+ else fail("§2c perdeu 'não pergunte, execute'");
588
+ if (/unidade de trabalho/i.test(secao2c)) ok("§2c aponta para a unidade de trabalho (§10)");
589
+ else fail("§2c não aponta para §10");
590
+
591
+ const preco = path.join(ROOT, "kit", "skills", "negocio-preco", "scripts", "preco.mjs");
592
+ const r = spawnSync(process.execPath, [preco, "--self-test"], { encoding: "utf8" });
593
+ if (r.status === 0) ok("negocio-preco/scripts/preco.mjs --self-test");
594
+ else fail(`preco.mjs self-test: ${(r.stderr || r.stdout || "").trim() || "exit " + r.status}`);
595
+
596
+ await checkPersonalBrands();
597
+ await checkRuleDrift(process.argv.slice(2));
598
+
599
+ process.stdout.write("\n");
600
+ if (failed === 0) {
601
+ process.stdout.write("kit pronto para instalar sozinho.\n");
602
+ process.exit(0);
603
+ }
604
+ process.stderr.write(`doctor reprovou em ${failed} checagem(ns).\n`);
605
+ process.exit(1);
606
+ }
607
+
608
+ main().catch((e) => {
609
+ process.stderr.write(String(e?.stack || e) + "\n");
610
+ process.exit(1);
611
+ });