@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,407 @@
1
+ /**
2
+ * Layers stored in NexusCore (ADR-0004, DEM-ZEN-FEA-126 over DEM-NEX-FEA-129).
3
+ *
4
+ * A layer directory is packed into one opaque bundle (gzip of JSON) and
5
+ * published as a new version under the owner's NexusCore key. Generation pulls
6
+ * it back into a local cache, so a person keeps their private skills without a
7
+ * git repo. Secrets never travel: the pack step refuses secret-looking files
8
+ * and contents before anything leaves the machine, and the API key is read
9
+ * only from the environment or a key file, never from the layer.
10
+ *
11
+ * Spec accepted wherever a layer directory is: `nexuscore:<name>[@<version>]`.
12
+ */
13
+ import { createHash } from "node:crypto";
14
+ import { promises as fs } from "node:fs";
15
+ import os from "node:os";
16
+ import path from "node:path";
17
+ import { gunzipSync, gzipSync } from "node:zlib";
18
+ import { LAYER_MANIFEST, loadLayer } from "./layers.mjs";
19
+ import { listSkillNames, loadBundleFiles, loadLayerBundles, resolveBundle } from "./bundle.mjs";
20
+ import { STAMPED, stampProblems } from "./content-checks.mjs";
21
+
22
+ export const BUNDLE_FORMAT = "zenkit-layer/1";
23
+ /** Same cap the NexusCore route enforces (720 KB of bundle bytes). */
24
+ export const MAX_BUNDLE_BYTES = 720 * 1024;
25
+ export const REMOTE_PREFIX = "nexuscore:";
26
+ const NAME_RE = /^[a-z0-9][a-z0-9-]{0,62}$/;
27
+ // bundles/ travels as data (the recipes of a paid pack); generate does not read it yet.
28
+ const SUBTREES = ["skills", "agents", "rules", "sections", "bundles"];
29
+
30
+ const SECRET_FILE_RE = /(^|\/)(\.env(\..*)?|.*\.pem|.*\.key|.*\.p12|.*\.pfx|id_(rsa|ed25519|ecdsa)(\.pub)?|\.credentials\.json|\.npmrc|\.netrc)$/i;
31
+ const SECRET_CONTENT = [
32
+ ["chave privada PEM", /-----BEGIN [A-Z ]*PRIVATE KEY-----/],
33
+ ["token Anthropic/OpenAI", /\bsk-(ant-)?[A-Za-z0-9_-]{20,}/],
34
+ ["chave NexusCore", /\bnxk_[0-9a-f]{16,}/],
35
+ ["token GitHub", /\b(ghp|gho|ghs|ghu)_[A-Za-z0-9]{20,}|\bgithub_pat_[A-Za-z0-9_]{20,}/],
36
+ ["chave AWS", /\bAKIA[0-9A-Z]{16}\b/],
37
+ ["token Slack", /\bxox[abpr]-[A-Za-z0-9-]{10,}/],
38
+ [
39
+ "atribuição de segredo",
40
+ /\b[A-Za-z_]*(api[_-]?key|secret|token|password|passwd)[A-Za-z_]*\s*[:=]\s*["']?(?![<$%{]|x{4,}|\.\.\.|your|seu|sua|changeme|example|process\.env|os\.environ|env\.|getenv)[A-Za-z0-9+/_\-.]{16,}/i,
41
+ ],
42
+ ];
43
+
44
+ export const ARCHIVE_PREFIX = "archive:";
45
+ /** A paid or shared layer file can be bigger than what NexusCore accepts per version. */
46
+ export const MAX_ARCHIVE_BYTES = 20 * 1024 * 1024;
47
+
48
+ /** A layer spec that is not a local directory: `nexuscore:` or `archive:`. */
49
+ export function isRemoteSpec(spec) {
50
+ return typeof spec === "string" && (spec.startsWith(REMOTE_PREFIX) || spec.startsWith(ARCHIVE_PREFIX));
51
+ }
52
+
53
+ /**
54
+ * `archive:<url>#sha256=<64 hex>`. The pin is mandatory: a layer file from the
55
+ * network is accepted only if it is exactly the one the buyer was given. HTTPS
56
+ * only (plain http just for localhost), and never a credential inside the URL:
57
+ * the token comes from ZENKIT_ARCHIVE_TOKEN or ZENKIT_ARCHIVE_TOKEN_FILE.
58
+ */
59
+ export function parseArchiveSpec(spec) {
60
+ const raw = spec.slice(ARCHIVE_PREFIX.length);
61
+ const at = raw.lastIndexOf("#sha256=");
62
+ const pin = at >= 0 ? raw.slice(at + "#sha256=".length).toLowerCase() : "";
63
+ if (!/^[0-9a-f]{64}$/.test(pin)) {
64
+ throw new Error(`camada archive sem sha256 válido: use archive:<url>#sha256=<64 hex>`);
65
+ }
66
+ let url;
67
+ try {
68
+ url = new URL(raw.slice(0, at));
69
+ } catch {
70
+ throw new Error("camada archive com URL inválida");
71
+ }
72
+ const local = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
73
+ if (url.protocol !== "https:" && !(url.protocol === "http:" && local)) {
74
+ throw new Error(`camada archive só por https (recebido ${url.protocol}//${url.host})`);
75
+ }
76
+ if (url.username || url.password) {
77
+ throw new Error("camada archive com credencial na URL; use ZENKIT_ARCHIVE_TOKEN ou ZENKIT_ARCHIVE_TOKEN_FILE");
78
+ }
79
+ return { url: url.href, where: `${url.origin}${url.pathname}`, sha256: pin };
80
+ }
81
+
82
+ export function parseRemoteSpec(spec) {
83
+ const rest = spec.slice(REMOTE_PREFIX.length);
84
+ const [name, version, extra] = rest.split("@");
85
+ if (extra !== undefined || !NAME_RE.test(name || "")) {
86
+ throw new Error(`camada remota inválida: '${spec}' (use nexuscore:<nome>[@<versão>])`);
87
+ }
88
+ if (version !== undefined && !/^[1-9][0-9]*$/.test(version)) {
89
+ throw new Error(`camada remota inválida: '${spec}' (versão deve ser inteiro positivo)`);
90
+ }
91
+ return { name, version: version ? Number(version) : undefined };
92
+ }
93
+
94
+ /** Find secret-looking material; returns `path: motivo` strings, empty when clean. */
95
+ export function findSecrets(files) {
96
+ const hits = [];
97
+ for (const { path: rel, data } of files) {
98
+ if (SECRET_FILE_RE.test(rel)) {
99
+ hits.push(`${rel}: arquivo de credencial`);
100
+ continue;
101
+ }
102
+ const text = data.toString("utf8");
103
+ for (const [label, re] of SECRET_CONTENT) {
104
+ if (re.test(text)) hits.push(`${rel}: ${label}`);
105
+ }
106
+ }
107
+ return hits;
108
+ }
109
+
110
+ async function walk(root, rel, out) {
111
+ const entries = await fs.readdir(path.join(root, rel), { withFileTypes: true }).catch((err) => {
112
+ if (err.code === "ENOENT") return [];
113
+ throw err;
114
+ });
115
+ for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
116
+ const childRel = rel ? `${rel}/${e.name}` : e.name;
117
+ if (e.isSymbolicLink()) throw new Error(`camada com link simbólico recusada: ${childRel}`);
118
+ if (e.isDirectory()) await walk(root, childRel, out);
119
+ else if (e.isFile()) out.push({ path: childRel, data: await fs.readFile(path.join(root, childRel)) });
120
+ }
121
+ }
122
+
123
+ /**
124
+ * Pack a layer directory into the bundle bytes. Refuses secrets and oversize.
125
+ * With `bundle`, packs only what that recipe needs from the layer (a storefront
126
+ * cut out of a paid pack): see sliceForBundle.
127
+ */
128
+ export async function packLayer(dir, { maxBytes = MAX_BUNDLE_BYTES, bundle } = {}) {
129
+ const layer = await loadLayer(dir);
130
+ const { name, files } = bundle ? await sliceForBundle(layer, bundle) : await wholeLayer(layer);
131
+
132
+ const secrets = findSecrets(files);
133
+ if (secrets.length) {
134
+ throw new Error(
135
+ `camada '${name}' parece conter segredo; nada foi enviado:\n ${secrets.join("\n ")}\n` +
136
+ "Segredo fica no ambiente (liste o nome em 'secrets:' no manifesto), nunca na camada.",
137
+ );
138
+ }
139
+ const json = JSON.stringify({
140
+ format: BUNDLE_FORMAT,
141
+ name,
142
+ files: files.map((f) => ({ path: f.path, data: f.data.toString("base64") })),
143
+ });
144
+ const bytes = gzipSync(Buffer.from(json, "utf8"), { level: 9 });
145
+ if (bytes.length > maxBytes) {
146
+ throw new Error(`camada '${name}' tem ${bytes.length} bytes compactada; o máximo é ${maxBytes}`);
147
+ }
148
+ return { name, bytes, sha256: sha256(bytes), files: files.length };
149
+ }
150
+
151
+ async function wholeLayer(layer) {
152
+ const files = [{ path: LAYER_MANIFEST, data: await fs.readFile(path.join(layer.dir, LAYER_MANIFEST)) }];
153
+ for (const sub of SUBTREES) await walk(layer.dir, sub, files);
154
+ return { name: layer.name, files };
155
+ }
156
+
157
+ const SKILL_REF = /@\[skills\/([a-z0-9-]+)\]/g;
158
+
159
+ /** Drop the lines of a section that point at a skill the buyer will not have. */
160
+ export function dropLinesCitingAbsent(text, available) {
161
+ return text
162
+ .split("\n")
163
+ .filter((line) => [...line.matchAll(SKILL_REF)].every((m) => available.has(m[1])))
164
+ .join("\n");
165
+ }
166
+
167
+ /**
168
+ * A storefront cut out of a layer. The recipe resolves against the core's and
169
+ * the layer's bundles; the pack carries only the layer skills (and agents) the
170
+ * recipe uses, since the core ones the buyer already has. Sections keep only
171
+ * lines whose skill references the buyer will have. Stamped skills must pass
172
+ * their content check, or nothing is packed.
173
+ */
174
+ async function sliceForBundle(layer, bundleName) {
175
+ const core = await loadBundleFiles();
176
+ const own = await loadLayerBundles(layer.dir);
177
+ const clash = [...own.keys()].filter((n) => core.has(n));
178
+ if (clash.length) throw new Error(`receita na camada com o nome de uma do núcleo: ${clash.join(", ")}`);
179
+ const recipe = resolveBundle(bundleName, new Map([...core, ...own]));
180
+
181
+ const coreSkills = new Set(await listSkillNames());
182
+ const keep = [...recipe.skills].filter((s) => layer.skills.has(s)).sort();
183
+ const absent = [...recipe.skills].filter((s) => !layer.skills.has(s) && !coreSkills.has(s));
184
+ if (absent.length) throw new Error(`receita '${bundleName}' cita skill que não existe no núcleo nem na camada: ${absent.join(", ")}`);
185
+ if (keep.length === 0) throw new Error(`receita '${bundleName}' não usa nenhuma skill da camada '${layer.name}'`);
186
+
187
+ const problems = [];
188
+ for (const s of keep.filter((s) => STAMPED.includes(s))) {
189
+ problems.push(...stampProblems(s, await fs.readFile(path.join(layer.skills.get(s), "SKILL.md"), "utf8")));
190
+ }
191
+ if (problems.length) throw new Error(`receita '${bundleName}' não empacotada:\n ${problems.join("\n ")}`);
192
+
193
+ const overrides = keep.filter((s) => coreSkills.has(s));
194
+ const manifest =
195
+ `name: ${bundleName}\n` + (overrides.length ? `override:\n${overrides.map((s) => ` - ${s}\n`).join("")}` : "");
196
+ const files = [{ path: LAYER_MANIFEST, data: Buffer.from(manifest, "utf8") }];
197
+ for (const s of keep) await walk(layer.dir, `skills/${s}`, files);
198
+ for (const a of [...recipe.agents].filter((a) => layer.agents.has(a)).sort()) {
199
+ files.push({ path: `agents/${a}.md`, data: await fs.readFile(layer.agents.get(a)) });
200
+ }
201
+ const available = new Set([...keep, ...coreSkills]);
202
+ for (const [id, text] of layer.sections) {
203
+ const kept = dropLinesCitingAbsent(text, available);
204
+ if (kept.trim()) files.push({ path: `sections/${id}.md`, data: Buffer.from(kept, "utf8") });
205
+ }
206
+ return { name: bundleName, files };
207
+ }
208
+
209
+ function safeRel(rel) {
210
+ const norm = path.posix.normalize(rel);
211
+ const top = norm.split("/")[0];
212
+ const ok =
213
+ typeof rel === "string" &&
214
+ !path.posix.isAbsolute(rel) &&
215
+ !rel.includes("\\") &&
216
+ !norm.startsWith("..") &&
217
+ (norm === LAYER_MANIFEST || (SUBTREES.includes(top) && norm !== top));
218
+ if (!ok) throw new Error(`camada recebida com caminho inválido: ${JSON.stringify(rel)}`);
219
+ return norm;
220
+ }
221
+
222
+ /** Write bundle bytes into `dest` (replaced atomically). Returns the layer name. */
223
+ export async function unpackLayer(bytes, dest) {
224
+ let doc;
225
+ try {
226
+ doc = JSON.parse(gunzipSync(bytes).toString("utf8"));
227
+ } catch {
228
+ throw new Error("camada recebida não é um pacote ZenKit válido");
229
+ }
230
+ if (doc?.format !== BUNDLE_FORMAT || !Array.isArray(doc.files)) {
231
+ throw new Error(`camada recebida em formato desconhecido: ${doc?.format ?? "?"}`);
232
+ }
233
+ const tmp = `${dest}.tmp-${process.pid}-${Date.now()}`;
234
+ await fs.rm(tmp, { recursive: true, force: true });
235
+ try {
236
+ for (const f of doc.files) {
237
+ const rel = safeRel(f.path);
238
+ const out = path.join(tmp, ...rel.split("/"));
239
+ await fs.mkdir(path.dirname(out), { recursive: true });
240
+ await fs.writeFile(out, Buffer.from(String(f.data), "base64"));
241
+ }
242
+ await fs.access(path.join(tmp, LAYER_MANIFEST));
243
+ await fs.rm(dest, { recursive: true, force: true });
244
+ await fs.mkdir(path.dirname(dest), { recursive: true });
245
+ await fs.rename(tmp, dest);
246
+ } catch (err) {
247
+ await fs.rm(tmp, { recursive: true, force: true });
248
+ throw err;
249
+ }
250
+ return doc.name;
251
+ }
252
+
253
+ const sha256 = (buf) => createHash("sha256").update(buf).digest("hex");
254
+
255
+ /**
256
+ * NexusCore endpoint and key. URL: ZENKIT_NEXUS_URL or NEXUSCORE_URL.
257
+ * Key: ZENKIT_NEXUS_KEY, NEXUSCORE_BEARER, or the file in ZENKIT_NEXUS_KEY_FILE.
258
+ */
259
+ export async function nexusConfig(env = process.env) {
260
+ const url = (env.ZENKIT_NEXUS_URL || env.NEXUSCORE_URL || "").replace(/\/+$/, "");
261
+ if (!url) throw new Error("defina ZENKIT_NEXUS_URL (ou NEXUSCORE_URL) com o endereço do NexusCore");
262
+ let key = env.ZENKIT_NEXUS_KEY || env.NEXUSCORE_BEARER || "";
263
+ if (!key && env.ZENKIT_NEXUS_KEY_FILE) key = (await fs.readFile(env.ZENKIT_NEXUS_KEY_FILE, "utf8")).trim();
264
+ if (!key) {
265
+ throw new Error("defina ZENKIT_NEXUS_KEY (ou ZENKIT_NEXUS_KEY_FILE apontando para um arquivo com a chave)");
266
+ }
267
+ return { url, key };
268
+ }
269
+
270
+ async function request(cfg, method, route, body, fetchImpl = globalThis.fetch) {
271
+ const res = await fetchImpl(`${cfg.url}${route}`, {
272
+ method,
273
+ headers: {
274
+ authorization: `Bearer ${cfg.key}`,
275
+ ...(body ? { "content-type": "application/json" } : {}),
276
+ },
277
+ body: body ? JSON.stringify(body) : undefined,
278
+ });
279
+ const text = await res.text();
280
+ let json = null;
281
+ try {
282
+ json = text ? JSON.parse(text) : null;
283
+ } catch {
284
+ /* non-JSON error page */
285
+ }
286
+ if (!res.ok) {
287
+ const detail = json?.detail || json?.message || text.slice(0, 200) || res.statusText;
288
+ const err = new Error(`NexusCore ${method} ${route}: HTTP ${res.status} ${detail}`);
289
+ err.status = res.status;
290
+ throw err;
291
+ }
292
+ return json;
293
+ }
294
+
295
+ export async function pushLayer(dir, { env, fetch: fetchImpl } = {}) {
296
+ const packed = await packLayer(dir);
297
+ const cfg = await nexusConfig(env);
298
+ const res = await request(
299
+ cfg,
300
+ "PUT",
301
+ `/v1/layers/${encodeURIComponent(packed.name)}`,
302
+ { content_base64: packed.bytes.toString("base64") },
303
+ fetchImpl,
304
+ );
305
+ if (res?.sha256 !== packed.sha256) {
306
+ throw new Error(`NexusCore gravou sha256 ${res?.sha256}, esperado ${packed.sha256}`);
307
+ }
308
+ return { ...res, arquivos: packed.files };
309
+ }
310
+
311
+ export async function listRemoteLayers({ env, fetch: fetchImpl } = {}) {
312
+ const cfg = await nexusConfig(env);
313
+ return (await request(cfg, "GET", "/v1/layers", null, fetchImpl))?.camadas ?? [];
314
+ }
315
+
316
+ export function layerCacheDir(env = process.env) {
317
+ return env.ZENKIT_LAYER_CACHE || path.join(os.homedir(), ".zenkit", "layers");
318
+ }
319
+
320
+ async function cachedVersions(cacheRoot, name) {
321
+ const entries = await fs.readdir(path.join(cacheRoot, name), { withFileTypes: true }).catch(() => []);
322
+ return entries
323
+ .filter((e) => e.isDirectory() && /^[1-9][0-9]*$/.test(e.name))
324
+ .map((e) => Number(e.name))
325
+ .sort((a, b) => b - a);
326
+ }
327
+
328
+ /**
329
+ * Download a layer version and unpack it under the cache (or `into`). When
330
+ * NexusCore is unreachable and the cache already has a version of that layer,
331
+ * that version is used with a warning, so generation still works offline.
332
+ */
333
+ export async function pullLayer(name, { version, into, env = process.env, fetch: fetchImpl, warn = console.warn } = {}) {
334
+ const cacheRoot = layerCacheDir(env);
335
+ let res;
336
+ try {
337
+ const cfg = await nexusConfig(env);
338
+ const query = version ? `?version=${version}` : "";
339
+ res = await request(cfg, "GET", `/v1/layers/${encodeURIComponent(name)}${query}`, null, fetchImpl);
340
+ } catch (err) {
341
+ const offline = !into && err.status === undefined;
342
+ const cached = offline ? await cachedVersions(cacheRoot, name) : [];
343
+ const hit = version ? cached.find((v) => v === version) : cached[0];
344
+ if (!hit) throw err;
345
+ warn(`[zenkit] NexusCore indisponível (${err.message}); usando camada '${name}' v${hit} do cache`);
346
+ return { name, version: hit, dir: path.join(cacheRoot, name, String(hit)), cached: true };
347
+ }
348
+ const bytes = Buffer.from(res.content_base64 || "", "base64");
349
+ if (sha256(bytes) !== res.sha256) {
350
+ throw new Error(`camada '${name}' v${res.versao} chegou corrompida (sha256 não confere)`);
351
+ }
352
+ const dest = into ? path.resolve(into) : path.join(cacheRoot, name, String(res.versao));
353
+ await unpackLayer(bytes, dest);
354
+ return { name, version: res.versao, sha256: res.sha256, dir: dest, cached: false };
355
+ }
356
+
357
+ async function archiveToken(env) {
358
+ if (env.ZENKIT_ARCHIVE_TOKEN) return env.ZENKIT_ARCHIVE_TOKEN;
359
+ if (env.ZENKIT_ARCHIVE_TOKEN_FILE) return (await fs.readFile(env.ZENKIT_ARCHIVE_TOKEN_FILE, "utf8")).trim();
360
+ return "";
361
+ }
362
+
363
+ /**
364
+ * Download an `archive:` layer, check its sha256 against the pin and unpack it
365
+ * under the cache, keyed by that hash. A hash already in the cache is used
366
+ * without touching the network: the pin makes the content immutable.
367
+ */
368
+ export async function fetchArchiveLayer(spec, { env = process.env, fetch: fetchImpl = globalThis.fetch } = {}) {
369
+ const { url, where, sha256: pin } = parseArchiveSpec(spec);
370
+ const dest = path.join(layerCacheDir(env), "archive", pin);
371
+ try {
372
+ await fs.access(path.join(dest, LAYER_MANIFEST));
373
+ return { dir: dest, sha256: pin, cached: true };
374
+ } catch {
375
+ // Not cached yet.
376
+ }
377
+ const token = await archiveToken(env);
378
+ const res = await fetchImpl(url, { headers: token ? { authorization: `Bearer ${token}` } : {} });
379
+ if (!res.ok) throw new Error(`download da camada falhou: HTTP ${res.status} em ${where}`);
380
+ if (Number(res.headers.get("content-length") || 0) > MAX_ARCHIVE_BYTES) {
381
+ throw new Error(`camada em ${where} passa de ${MAX_ARCHIVE_BYTES} bytes`);
382
+ }
383
+ const bytes = Buffer.from(await res.arrayBuffer());
384
+ if (bytes.length > MAX_ARCHIVE_BYTES) throw new Error(`camada em ${where} passa de ${MAX_ARCHIVE_BYTES} bytes`);
385
+ const got = sha256(bytes);
386
+ if (got !== pin) {
387
+ throw new Error(`camada em ${where} não confere: sha256 ${got}, esperado ${pin}; nada foi instalado`);
388
+ }
389
+ await unpackLayer(bytes, dest);
390
+ return { dir: dest, sha256: pin, cached: false };
391
+ }
392
+
393
+ /** Turn every `nexuscore:` or `archive:` spec into a cached directory; local paths pass through. */
394
+ export async function resolveLayerSpecs(specs, opts = {}) {
395
+ const dirs = [];
396
+ for (const spec of specs) {
397
+ if (!isRemoteSpec(spec)) {
398
+ dirs.push(spec);
399
+ } else if (spec.startsWith(ARCHIVE_PREFIX)) {
400
+ dirs.push((await fetchArchiveLayer(spec, opts)).dir);
401
+ } else {
402
+ const { name, version } = parseRemoteSpec(spec);
403
+ dirs.push((await pullLayer(name, { ...opts, version })).dir);
404
+ }
405
+ }
406
+ return dirs;
407
+ }
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Pluggable layers (ADR-0004, DEM-ZEN-FEA-126).
3
+ *
4
+ * A layer is a directory with a `zenkit-layer.yaml` manifest and optional
5
+ * `skills/<name>/`, `agents/<name>.md`, `rules/<name>.mdc` and `sections/<slot>.md`. Layers stack
6
+ * on top of the public core in the order given, the later one being the more
7
+ * specific. Nothing is replaced silently: a skill or agent that already exists
8
+ * in a lower level is an error unless the layer lists it under `override`.
9
+ *
10
+ * Manifest (subset YAML, same parser as kit/bundles):
11
+ *
12
+ * name: caio
13
+ * override:
14
+ * - model-routing
15
+ * modules:
16
+ * - nexuscore
17
+ * secrets:
18
+ * - NEXUS_MCP_TOKEN
19
+ */
20
+ import { promises as fs } from "node:fs";
21
+ import path from "node:path";
22
+ import { parseSimpleYaml } from "./bundle.mjs";
23
+
24
+ export const LAYER_MANIFEST = "zenkit-layer.yaml";
25
+
26
+ const asList = (value) => (Array.isArray(value) ? value : value ? [value] : []);
27
+
28
+ async function readDirOrEmpty(dir) {
29
+ try {
30
+ return await fs.readdir(dir, { withFileTypes: true });
31
+ } catch (err) {
32
+ if (err.code === "ENOENT") return [];
33
+ throw err;
34
+ }
35
+ }
36
+
37
+ async function namedDirs(dir) {
38
+ const entries = await readDirOrEmpty(dir);
39
+ return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
40
+ }
41
+
42
+ async function namedFiles(dir, ext) {
43
+ const entries = await readDirOrEmpty(dir);
44
+ return entries
45
+ .filter((e) => e.isFile() && e.name.endsWith(ext))
46
+ .map((e) => e.name.slice(0, -ext.length))
47
+ .sort();
48
+ }
49
+
50
+ /** Read one layer directory into maps of skill dirs, agent files and slot sections. */
51
+ export async function loadLayer(dir) {
52
+ const root = path.resolve(dir);
53
+ const manifestPath = path.join(root, LAYER_MANIFEST);
54
+ let raw;
55
+ try {
56
+ raw = await fs.readFile(manifestPath, "utf8");
57
+ } catch (err) {
58
+ if (err.code === "ENOENT") throw new Error(`camada sem ${LAYER_MANIFEST}: ${root}`);
59
+ throw err;
60
+ }
61
+ const manifest = parseSimpleYaml(raw, manifestPath);
62
+ if (typeof manifest.name !== "string" || !manifest.name) {
63
+ throw new Error(`${manifestPath}: campo 'name' obrigatório`);
64
+ }
65
+
66
+ const skills = new Map(
67
+ (await namedDirs(path.join(root, "skills"))).map((n) => [n, path.join(root, "skills", n)]),
68
+ );
69
+ const agents = new Map(
70
+ (await namedFiles(path.join(root, "agents"), ".md")).map((n) => [
71
+ n,
72
+ path.join(root, "agents", `${n}.md`),
73
+ ]),
74
+ );
75
+ const sections = new Map();
76
+ for (const id of await namedFiles(path.join(root, "sections"), ".md")) {
77
+ // A Windows checkout gives kit-shipped sections CRLF; the master rule is rendered on LF.
78
+ const text = await fs.readFile(path.join(root, "sections", `${id}.md`), "utf8");
79
+ sections.set(id, text.replace(/\r\n/g, "\n"));
80
+ }
81
+ const rules = new Map(
82
+ (await namedFiles(path.join(root, "rules"), ".mdc")).map((n) => [n, path.join(root, "rules", `${n}.mdc`)]),
83
+ );
84
+ if (rules.has("ZENKIT")) {
85
+ throw new Error(`${root}: a camada não substitui o ZENKIT.mdc inteiro; use sections/<slot>.md`);
86
+ }
87
+
88
+ return {
89
+ name: manifest.name,
90
+ dir: root,
91
+ skills,
92
+ agents,
93
+ sections,
94
+ rules,
95
+ override: new Set(asList(manifest.override)),
96
+ modules: asList(manifest.modules),
97
+ secrets: asList(manifest.secrets),
98
+ };
99
+ }
100
+
101
+ export async function loadLayers(dirs = []) {
102
+ const layers = [];
103
+ for (const dir of dirs) layers.push(await loadLayer(dir));
104
+ return layers;
105
+ }
106
+
107
+ /**
108
+ * Product modules (ADR-0004) ship in the public package under `kit/modules/<name>/`,
109
+ * shaped like a layer, and stay off until a layer lists them under `modules`.
110
+ * They sit between the core and the user layers. A name the kit does not ship is
111
+ * reported, not fatal: a layer may name a module that a later kit version adds.
112
+ */
113
+ export async function loadModules(modulesRoot, layers = []) {
114
+ const names = [...new Set(layers.flatMap((l) => l.modules))];
115
+ const modules = [];
116
+ const unknown = [];
117
+ for (const name of names) {
118
+ const dir = path.join(modulesRoot, name);
119
+ try {
120
+ await fs.access(path.join(dir, LAYER_MANIFEST));
121
+ } catch {
122
+ unknown.push(name);
123
+ continue;
124
+ }
125
+ const mod = await loadLayer(dir);
126
+ if (mod.name !== name) throw new Error(`${dir}: módulo declara name '${mod.name}', esperado '${name}'`);
127
+ modules.push(mod);
128
+ }
129
+ return { modules, unknown };
130
+ }
131
+
132
+ /**
133
+ * Layer specs from the ZENKIT_LAYERS env var (path-delimited), used when no
134
+ * --layer flag is given. On POSIX the delimiter is ':' and would split a
135
+ * `nexuscore:<name>` spec in two, so that pair is joined back.
136
+ */
137
+ export function layerDirsFromEnv(env = process.env, delimiter = path.delimiter) {
138
+ const raw = env.ZENKIT_LAYERS;
139
+ if (!raw) return [];
140
+ const parts = raw.split(delimiter).map((s) => s.trim());
141
+ const specs = [];
142
+ for (let i = 0; i < parts.length; i++) {
143
+ if (delimiter === ":" && parts[i] === "nexuscore" && parts[i + 1]) {
144
+ specs.push(`nexuscore:${parts[++i]}`);
145
+ } else if (delimiter === ":" && parts[i] === "archive") {
146
+ // archive:https://host[:port]/file#sha256=... spans several ':' pieces; it ends at the pin.
147
+ const pieces = [parts[i]];
148
+ while (i + 1 < parts.length && !pieces[pieces.length - 1].includes("#sha256=")) pieces.push(parts[++i]);
149
+ specs.push(pieces.join(":"));
150
+ } else if (parts[i]) {
151
+ specs.push(parts[i]);
152
+ }
153
+ }
154
+ return specs;
155
+ }
156
+
157
+ /**
158
+ * Merge core sources with each layer's `skills` or `agents` map.
159
+ * @param {Map<string,string>} core name -> path in the core kit
160
+ * @param {Array} layers result of loadLayers
161
+ * @param {"skills"|"agents"|"rules"} kind
162
+ * @returns {Map<string,string>} name -> path, most specific level winning
163
+ */
164
+ export function mergeSources(core, layers, kind) {
165
+ const label = { skills: "skill", agents: "agente", rules: "regra" }[kind];
166
+ const merged = new Map([...core].map(([name, p]) => [name, { path: p, origin: "núcleo" }]));
167
+ for (const layer of layers) {
168
+ for (const [name, p] of layer[kind]) {
169
+ const previous = merged.get(name);
170
+ if (previous && !layer.override.has(name)) {
171
+ throw new Error(
172
+ `conflito: ${label} '${name}' da camada '${layer.name}' já existe em ${previous.origin}; ` +
173
+ `liste '${name}' em override no ${LAYER_MANIFEST} para substituir`,
174
+ );
175
+ }
176
+ merged.set(name, { path: p, origin: `camada '${layer.name}'` });
177
+ }
178
+ }
179
+ return new Map([...merged].map(([name, v]) => [name, v.path]));
180
+ }
181
+
182
+ const SLOT =
183
+ /<!-- zenkit:slot id="([a-z0-9-]+)" mode="(replace|append)" -->\r?\n([\s\S]*?)<!-- \/zenkit:slot -->(\r?\n)?/g;
184
+
185
+ /**
186
+ * Fill the `<!-- zenkit:slot -->` blocks of the master rule. With no layer
187
+ * section for a slot its default text stays; `replace` takes the most specific
188
+ * layer's text, `append` adds every layer's text after the default. Markers
189
+ * never reach the generated file. A layer section with no matching slot is an
190
+ * error: it would otherwise vanish without notice.
191
+ */
192
+ export function applySlots(body, layers = []) {
193
+ const known = new Set();
194
+ const out = body.replace(SLOT, (_m, id, mode, fallback) => {
195
+ known.add(id);
196
+ const fills = layers.filter((l) => l.sections.has(id)).map((l) => l.sections.get(id).trim() + "\n");
197
+ if (fills.length === 0) return fallback;
198
+ return mode === "replace" ? fills[fills.length - 1] : `${fallback}\n${fills.join("\n")}`;
199
+ });
200
+ for (const layer of layers) {
201
+ for (const id of layer.sections.keys()) {
202
+ if (!known.has(id)) {
203
+ throw new Error(`camada '${layer.name}': seção '${id}' não corresponde a nenhum slot do ZENKIT`);
204
+ }
205
+ }
206
+ }
207
+ return out;
208
+ }
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Catálogos nativos — um JSON por host, gerado dos bundles kind: storefront.
3
+ * Fonte: kit/bundles/*.yaml. Arquivos em .claude-plugin/ e .cursor-plugin/
4
+ * são o artefato; se divergirem do gerado, o doctor reprova.
5
+ */
6
+ import { promises as fs } from "node:fs";
7
+ import path from "node:path";
8
+ import {
9
+ AUTHOR,
10
+ MARKETPLACE_NAME,
11
+ pluginId,
12
+ ROOT,
13
+ storefrontBundles,
14
+ } from "./product.mjs";
15
+ import { loadBundleFiles } from "./bundle.mjs";
16
+
17
+ export function buildClaudeMarketplace(storefronts) {
18
+ return {
19
+ name: MARKETPLACE_NAME,
20
+ owner: AUTHOR,
21
+ description:
22
+ "Recortes do ZenKit. Gere os pacotes com: zenkit generate --plugins",
23
+ plugins: storefronts.map((b) => ({
24
+ name: pluginId(b.name),
25
+ source: `./plugins/${b.name}/claude`,
26
+ description: b.description || b.title,
27
+ })),
28
+ };
29
+ }
30
+
31
+ export function buildCursorMarketplace(storefronts) {
32
+ return {
33
+ name: MARKETPLACE_NAME,
34
+ owner: AUTHOR,
35
+ metadata: {
36
+ description:
37
+ "Recortes do ZenKit. Gere os pacotes com: zenkit generate --plugins",
38
+ pluginRoot: "plugins",
39
+ },
40
+ plugins: storefronts.map((b) => ({
41
+ name: pluginId(b.name),
42
+ source: `${b.name}/cursor`,
43
+ description: b.description || b.title,
44
+ })),
45
+ };
46
+ }
47
+
48
+ export function marketplacePaths() {
49
+ return {
50
+ claude: path.join(ROOT, ".claude-plugin", "marketplace.json"),
51
+ cursor: path.join(ROOT, ".cursor-plugin", "marketplace.json"),
52
+ };
53
+ }
54
+
55
+ export async function writeMarketplaces() {
56
+ const storefronts = storefrontBundles(await loadBundleFiles());
57
+ if (storefronts.length === 0) {
58
+ throw new Error("nenhum bundle kind: storefront");
59
+ }
60
+ const paths = marketplacePaths();
61
+ const claude = buildClaudeMarketplace(storefronts);
62
+ const cursor = buildCursorMarketplace(storefronts);
63
+ await fs.mkdir(path.dirname(paths.claude), { recursive: true });
64
+ await fs.mkdir(path.dirname(paths.cursor), { recursive: true });
65
+ await fs.writeFile(paths.claude, JSON.stringify(claude, null, 2) + "\n");
66
+ await fs.writeFile(paths.cursor, JSON.stringify(cursor, null, 2) + "\n");
67
+ return { claude, cursor, paths, storefronts };
68
+ }
69
+
70
+ export async function expectedMarketplaces() {
71
+ const storefronts = storefrontBundles(await loadBundleFiles());
72
+ return {
73
+ claude: buildClaudeMarketplace(storefronts),
74
+ cursor: buildCursorMarketplace(storefronts),
75
+ storefronts,
76
+ };
77
+ }