blendops 0.0.0-stage → 1.1.0

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 (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,634 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs';
3
+ import os from 'node:os';
4
+ import path from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { zipSync } from 'fflate';
7
+ import { buildSharedCatalogFilesMap } from './build-knowledge-catalog.mjs';
8
+
9
+ const scriptRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
10
+ const root = fs.existsSync(path.join(process.cwd(), 'skills')) ? process.cwd() : scriptRoot;
11
+ const skillsDir = path.join(root, 'skills');
12
+
13
+ const PROTECTED_REPO_ENTRIES = new Set([
14
+ '.git',
15
+ '.github',
16
+ '.aistudio',
17
+ 'bundles',
18
+ 'docs',
19
+ 'evals',
20
+ 'laws',
21
+ 'node_modules',
22
+ 'packs',
23
+ 'registry',
24
+ 'schemas',
25
+ 'scripts',
26
+ 'skill-reviews',
27
+ 'skills',
28
+ 'AGENTS.md',
29
+ 'CHANGELOG.md',
30
+ 'CODE_OF_CONDUCT.md',
31
+ 'CONTRIBUTING.md',
32
+ 'LICENSE',
33
+ 'README.md',
34
+ 'SECURITY.md',
35
+ 'SUPPORT.md',
36
+ 'TODO.md',
37
+ 'package.json',
38
+ 'package-lock.json',
39
+ 'skills.sh.json',
40
+ ]);
41
+
42
+ function resolveWithExistingAncestorRealpath(targetPath) {
43
+ const absTarget = path.resolve(targetPath);
44
+ const tailSegments = [];
45
+ let cursor = absTarget;
46
+
47
+ while (!fs.existsSync(cursor)) {
48
+ const parent = path.dirname(cursor);
49
+ if (parent === cursor) break;
50
+ tailSegments.unshift(path.basename(cursor));
51
+ cursor = parent;
52
+ }
53
+
54
+ const baseReal = fs.existsSync(cursor) ? fs.realpathSync(cursor) : cursor;
55
+ return tailSegments.length > 0 ? path.join(baseReal, ...tailSegments) : baseReal;
56
+ }
57
+
58
+ function parseCliArgs(argv) {
59
+ let outputRootArg = null;
60
+
61
+ for (let i = 0; i < argv.length; i += 1) {
62
+ const arg = argv[i];
63
+ if (arg === '--output-root') {
64
+ if (outputRootArg !== null) {
65
+ throw new Error('Duplicate --output-root argument');
66
+ }
67
+ if (i + 1 >= argv.length) {
68
+ throw new Error('Missing value for --output-root');
69
+ }
70
+ const nextVal = argv[i + 1];
71
+ if (typeof nextVal !== 'string' || nextVal.trim() === '' || nextVal.startsWith('-')) {
72
+ throw new Error(`Invalid path value for --output-root: ${String(nextVal)}`);
73
+ }
74
+ outputRootArg = nextVal;
75
+ i += 1;
76
+ } else if (typeof arg === 'string' && arg.startsWith('--output-root=')) {
77
+ if (outputRootArg !== null) {
78
+ throw new Error('Duplicate --output-root argument');
79
+ }
80
+ const eqVal = arg.slice('--output-root='.length);
81
+ if (eqVal.trim() === '' || eqVal.startsWith('-')) {
82
+ throw new Error(`Invalid path value for --output-root: ${eqVal}`);
83
+ }
84
+ outputRootArg = eqVal;
85
+ } else {
86
+ throw new Error(`Unknown or malformed CLI argument: ${String(arg)}`);
87
+ }
88
+ }
89
+
90
+ return { outputRootArg };
91
+ }
92
+
93
+ function resolveSafeOutputRoot(rawOutputRoot, rootDir = root) {
94
+ if (rawOutputRoot === null || rawOutputRoot === undefined) {
95
+ return path.join(rootDir, 'dist', 'claude-skills');
96
+ }
97
+ if (
98
+ typeof rawOutputRoot !== 'string' ||
99
+ rawOutputRoot.trim() === '' ||
100
+ rawOutputRoot.includes('\0')
101
+ ) {
102
+ throw new Error('Invalid --output-root path');
103
+ }
104
+
105
+ const realRoot = fs.realpathSync(rootDir);
106
+ const resolvedCandidate = path.resolve(rootDir, rawOutputRoot.trim());
107
+ const effectiveTarget = resolveWithExistingAncestorRealpath(resolvedCandidate);
108
+
109
+ if (
110
+ resolvedCandidate === path.parse(resolvedCandidate).root ||
111
+ effectiveTarget === path.parse(effectiveTarget).root
112
+ ) {
113
+ throw new Error(`Unsafe --output-root destination (filesystem root): ${rawOutputRoot}`);
114
+ }
115
+
116
+ const tmpResolved = path.resolve(os.tmpdir());
117
+ const tmpReal = fs.existsSync(tmpResolved) ? fs.realpathSync(tmpResolved) : tmpResolved;
118
+ if (resolvedCandidate === tmpResolved || effectiveTarget === tmpReal) {
119
+ throw new Error(`Unsafe --output-root destination (OS temp root itself): ${rawOutputRoot}`);
120
+ }
121
+
122
+ const relFromTargetToRoot = path.relative(effectiveTarget, realRoot);
123
+ if (
124
+ relFromTargetToRoot === '' ||
125
+ (!relFromTargetToRoot.startsWith('..') && !path.isAbsolute(relFromTargetToRoot))
126
+ ) {
127
+ throw new Error(
128
+ `Unsafe --output-root destination (repository root or ancestor): ${rawOutputRoot}`,
129
+ );
130
+ }
131
+
132
+ const relFromRootToTarget = path.relative(realRoot, effectiveTarget);
133
+ const isInsideRepo =
134
+ relFromRootToTarget !== '' &&
135
+ !relFromRootToTarget.startsWith('..') &&
136
+ !path.isAbsolute(relFromRootToTarget);
137
+
138
+ if (isInsideRepo) {
139
+ const segments = relFromRootToTarget.split(path.sep);
140
+ const topSegment = segments[0];
141
+ if (PROTECTED_REPO_ENTRIES.has(topSegment)) {
142
+ throw new Error(
143
+ `Unsafe --output-root destination (protected repository path '${topSegment}'): ${rawOutputRoot}`,
144
+ );
145
+ }
146
+ if (topSegment === 'dist' && segments.length < 2) {
147
+ throw new Error(
148
+ `Unsafe --output-root destination (must be a subdirectory inside dist/, not dist/ itself): ${rawOutputRoot}`,
149
+ );
150
+ }
151
+ }
152
+
153
+ if (fs.existsSync(resolvedCandidate)) {
154
+ const candLstat = fs.lstatSync(resolvedCandidate);
155
+ if (candLstat.isSymbolicLink()) {
156
+ throw new Error(`Unsafe --output-root destination (symbolic link): ${rawOutputRoot}`);
157
+ }
158
+ }
159
+
160
+ if (fs.existsSync(effectiveTarget)) {
161
+ const targetLstat = fs.lstatSync(effectiveTarget);
162
+ if (targetLstat.isSymbolicLink()) {
163
+ throw new Error(`Unsafe --output-root destination (symbolic link): ${rawOutputRoot}`);
164
+ }
165
+ if (!targetLstat.isDirectory()) {
166
+ throw new Error(`Unsafe --output-root destination (existing file): ${rawOutputRoot}`);
167
+ }
168
+ const existingEntries = fs.readdirSync(effectiveTarget);
169
+ if (existingEntries.length > 0) {
170
+ throw new Error(
171
+ `Unsafe --output-root destination (refusing to overwrite non-empty directory): ${rawOutputRoot}`,
172
+ );
173
+ }
174
+ }
175
+
176
+ return resolvedCandidate;
177
+ }
178
+
179
+ function formatManifestOutputPrefix(targetPath, rootDir = root) {
180
+ const rel = path.relative(rootDir, targetPath);
181
+ if (rel && !rel.startsWith('..') && !path.isAbsolute(rel)) {
182
+ return rel.split(path.sep).join('/');
183
+ }
184
+ return targetPath.split(path.sep).join('/');
185
+ }
186
+
187
+ export const DETERMINISTIC_ZIP_TIMESTAMP_ISO = '1980-01-01T00:00:00.000Z';
188
+ export const DETERMINISTIC_ZIP_DOS_TIME = 0x0000; // 00:00:00
189
+ export const DETERMINISTIC_ZIP_DOS_DATE = 0x0021; // 1980-01-01 ((1980 - 1980) << 9 | (1 << 5) | 1)
190
+ export const DETERMINISTIC_ZIP_COMPRESSION_LEVEL = 6;
191
+ export const DETERMINISTIC_ZIP_OS = 0; // MS-DOS / FAT portable OS byte
192
+ export const DETERMINISTIC_ZIP_ATTRS = 0; // Normalized external file attributes
193
+
194
+ /**
195
+ * fflate's ZIP header writer (wzh) reads local Date getters (getFullYear, getMonth,
196
+ * getDate, getHours, getMinutes, getSeconds) to encode the MS-DOS 32-bit timestamp.
197
+ * Constructing a Date from the UTC components of DETERMINISTIC_ZIP_TIMESTAMP_ISO
198
+ * guarantees that fflate writes dosDate=0x0021 (1980-01-01) and dosTime=0x0000 (00:00:00)
199
+ * deterministically across all host timezones and operating systems.
200
+ */
201
+ export function getDeterministicZipMtime() {
202
+ const utc = new Date(DETERMINISTIC_ZIP_TIMESTAMP_ISO);
203
+ return new Date(
204
+ utc.getUTCFullYear(),
205
+ utc.getUTCMonth(),
206
+ utc.getUTCDate(),
207
+ utc.getUTCHours(),
208
+ utc.getUTCMinutes(),
209
+ utc.getUTCSeconds(),
210
+ utc.getUTCMilliseconds(),
211
+ );
212
+ }
213
+
214
+ export function compareCodeUnitOrder(a, b) {
215
+ return a < b ? -1 : a > b ? 1 : 0;
216
+ }
217
+
218
+ function rmrf(target) {
219
+ fs.rmSync(target, { recursive: true, force: true });
220
+ }
221
+
222
+ function mkdirp(target) {
223
+ fs.mkdirSync(target, { recursive: true });
224
+ }
225
+
226
+ function copyDir(src, dest) {
227
+ fs.cpSync(src, dest, { recursive: true });
228
+ }
229
+
230
+ function collectZipFileList(dir, baseDir, fileList = []) {
231
+ const dirStat = fs.lstatSync(dir);
232
+ if (dirStat.isSymbolicLink()) {
233
+ throw new Error(`Unsafe symbolic link directory encountered during ZIP packaging: ${dir}`);
234
+ }
235
+ const items = fs
236
+ .readdirSync(dir, { withFileTypes: true })
237
+ .sort((a, b) => compareCodeUnitOrder(a.name, b.name));
238
+
239
+ for (const item of items) {
240
+ const fullPath = path.join(dir, item.name);
241
+ const itemLstat = fs.lstatSync(fullPath);
242
+ if (item.isSymbolicLink() || itemLstat.isSymbolicLink()) {
243
+ throw new Error(`Unsafe symbolic link encountered during ZIP packaging: ${fullPath}`);
244
+ }
245
+ if (item.isDirectory()) {
246
+ collectZipFileList(fullPath, baseDir, fileList);
247
+ } else if (item.isFile()) {
248
+ const relPath = path.relative(baseDir, fullPath).split(path.sep).join('/');
249
+ fileList.push({ relPath, fullPath });
250
+ }
251
+ }
252
+ return fileList;
253
+ }
254
+
255
+ export function collectZipEntries(dir, baseDir, entries = {}) {
256
+ const sortedFiles = collectZipFileList(dir, baseDir).sort((a, b) =>
257
+ compareCodeUnitOrder(a.relPath, b.relPath),
258
+ );
259
+ const mtime = getDeterministicZipMtime();
260
+
261
+ for (const { relPath, fullPath } of sortedFiles) {
262
+ entries[relPath] = [
263
+ new Uint8Array(fs.readFileSync(fullPath)),
264
+ {
265
+ level: DETERMINISTIC_ZIP_COMPRESSION_LEVEL,
266
+ mtime,
267
+ os: DETERMINISTIC_ZIP_OS,
268
+ attrs: DETERMINISTIC_ZIP_ATTRS,
269
+ },
270
+ ];
271
+ }
272
+ return entries;
273
+ }
274
+
275
+ export function zipDir(srcDir, zipPath) {
276
+ const parent = path.dirname(srcDir);
277
+ const entries = collectZipEntries(srcDir, parent);
278
+ const mtime = getDeterministicZipMtime();
279
+ const zipped = zipSync(entries, {
280
+ level: DETERMINISTIC_ZIP_COMPRESSION_LEVEL,
281
+ mtime,
282
+ os: DETERMINISTIC_ZIP_OS,
283
+ attrs: DETERMINISTIC_ZIP_ATTRS,
284
+ });
285
+ fs.writeFileSync(zipPath, Buffer.from(zipped));
286
+ }
287
+
288
+ export function inspectZipMetadata(zipBuffer) {
289
+ const buf = Buffer.isBuffer(zipBuffer) ? zipBuffer : Buffer.from(zipBuffer);
290
+ const localHeaders = [];
291
+ const centralHeaders = [];
292
+ let offset = 0;
293
+
294
+ while (offset + 4 <= buf.length) {
295
+ const sig = buf.readUInt32LE(offset);
296
+ if (sig === 0x04034b50) {
297
+ const versionNeeded = buf.readUInt16LE(offset + 4);
298
+ const flags = buf.readUInt16LE(offset + 6);
299
+ const compression = buf.readUInt16LE(offset + 8);
300
+ const dosTime = buf.readUInt16LE(offset + 10);
301
+ const dosDate = buf.readUInt16LE(offset + 12);
302
+ const crc32 = buf.readUInt32LE(offset + 14);
303
+ const compressedSize = buf.readUInt32LE(offset + 18);
304
+ const uncompressedSize = buf.readUInt32LE(offset + 22);
305
+ const fileNameLength = buf.readUInt16LE(offset + 26);
306
+ const extraLength = buf.readUInt16LE(offset + 28);
307
+ const fileName = buf.subarray(offset + 30, offset + 30 + fileNameLength).toString('utf8');
308
+ localHeaders.push({
309
+ fileName,
310
+ versionNeeded,
311
+ flags,
312
+ compression,
313
+ dosTime,
314
+ dosDate,
315
+ crc32,
316
+ compressedSize,
317
+ uncompressedSize,
318
+ extraLength,
319
+ });
320
+ offset += 30 + fileNameLength + extraLength + compressedSize;
321
+ } else if (sig === 0x02014b50) {
322
+ const versionMadeBy = buf.readUInt8(offset + 4);
323
+ const os = buf.readUInt8(offset + 5);
324
+ const versionNeeded = buf.readUInt16LE(offset + 6);
325
+ const flags = buf.readUInt16LE(offset + 8);
326
+ const compression = buf.readUInt16LE(offset + 10);
327
+ const dosTime = buf.readUInt16LE(offset + 12);
328
+ const dosDate = buf.readUInt16LE(offset + 14);
329
+ const crc32 = buf.readUInt32LE(offset + 16);
330
+ const compressedSize = buf.readUInt32LE(offset + 20);
331
+ const uncompressedSize = buf.readUInt32LE(offset + 24);
332
+ const fileNameLength = buf.readUInt16LE(offset + 28);
333
+ const extraLength = buf.readUInt16LE(offset + 30);
334
+ const commentLength = buf.readUInt16LE(offset + 32);
335
+ const externalAttrs = buf.readUInt32LE(offset + 38);
336
+ const localHeaderOffset = buf.readUInt32LE(offset + 42);
337
+ const fileName = buf.subarray(offset + 46, offset + 46 + fileNameLength).toString('utf8');
338
+ centralHeaders.push({
339
+ fileName,
340
+ versionMadeBy,
341
+ os,
342
+ versionNeeded,
343
+ flags,
344
+ compression,
345
+ dosTime,
346
+ dosDate,
347
+ crc32,
348
+ compressedSize,
349
+ uncompressedSize,
350
+ extraLength,
351
+ commentLength,
352
+ externalAttrs,
353
+ localHeaderOffset,
354
+ });
355
+ offset += 46 + fileNameLength + extraLength + commentLength;
356
+ } else if (sig === 0x06054b50) {
357
+ break;
358
+ } else {
359
+ throw new Error(`Unexpected ZIP header signature 0x${sig.toString(16)} at offset ${offset}`);
360
+ }
361
+ }
362
+
363
+ return { localHeaders, centralHeaders };
364
+ }
365
+
366
+ function listSkillDirs() {
367
+ return fs
368
+ .readdirSync(skillsDir, { withFileTypes: true })
369
+ .filter((entry) => entry.isDirectory())
370
+ .map((entry) => entry.name)
371
+ .filter((name) => name !== '_template')
372
+ .filter((name) => fs.existsSync(path.join(skillsDir, name, 'SKILL.md')))
373
+ .sort(compareCodeUnitOrder);
374
+ }
375
+
376
+ const ALLOWED_EXISTING_SHARED_CATALOG_FILES = new Set([
377
+ 'README.md',
378
+ 'manifest.json',
379
+ 'blendops-knowledge-and-recipes.zip',
380
+ ]);
381
+
382
+ export function resolveSafeSharedCatalogDir(rawSharedCatalogDir, rootDir = root) {
383
+ if (
384
+ typeof rawSharedCatalogDir !== 'string' ||
385
+ rawSharedCatalogDir.trim() === '' ||
386
+ rawSharedCatalogDir.includes('\0')
387
+ ) {
388
+ throw new Error('Invalid sharedCatalogDir path');
389
+ }
390
+
391
+ const realRoot = fs.realpathSync(rootDir);
392
+ const resolvedCandidate = path.resolve(rootDir, rawSharedCatalogDir.trim());
393
+ const effectiveTarget = resolveWithExistingAncestorRealpath(resolvedCandidate);
394
+
395
+ if (
396
+ resolvedCandidate === path.parse(resolvedCandidate).root ||
397
+ effectiveTarget === path.parse(effectiveTarget).root
398
+ ) {
399
+ throw new Error(
400
+ `Unsafe sharedCatalogDir destination (filesystem root): ${rawSharedCatalogDir}`,
401
+ );
402
+ }
403
+
404
+ const tmpResolved = path.resolve(os.tmpdir());
405
+ const tmpReal = fs.existsSync(tmpResolved) ? fs.realpathSync(tmpResolved) : tmpResolved;
406
+ if (resolvedCandidate === tmpResolved || effectiveTarget === tmpReal) {
407
+ throw new Error(
408
+ `Unsafe sharedCatalogDir destination (OS temp root itself): ${rawSharedCatalogDir}`,
409
+ );
410
+ }
411
+
412
+ const relFromTargetToRoot = path.relative(effectiveTarget, realRoot);
413
+ if (
414
+ relFromTargetToRoot === '' ||
415
+ (!relFromTargetToRoot.startsWith('..') && !path.isAbsolute(relFromTargetToRoot))
416
+ ) {
417
+ throw new Error(
418
+ `Unsafe sharedCatalogDir destination (repository root or ancestor): ${rawSharedCatalogDir}`,
419
+ );
420
+ }
421
+
422
+ const relFromRootToTarget = path.relative(realRoot, effectiveTarget);
423
+ const isInsideRepo =
424
+ relFromRootToTarget !== '' &&
425
+ !relFromRootToTarget.startsWith('..') &&
426
+ !path.isAbsolute(relFromRootToTarget);
427
+
428
+ if (isInsideRepo) {
429
+ const segments = relFromRootToTarget.split(path.sep);
430
+ const topSegment = segments[0];
431
+ if (PROTECTED_REPO_ENTRIES.has(topSegment)) {
432
+ throw new Error(
433
+ `Unsafe sharedCatalogDir destination (protected repository path '${topSegment}'): ${rawSharedCatalogDir}`,
434
+ );
435
+ }
436
+ if (topSegment === 'dist' && segments.length < 2) {
437
+ throw new Error(
438
+ `Unsafe sharedCatalogDir destination (must be a subdirectory inside dist/, not dist/ itself): ${rawSharedCatalogDir}`,
439
+ );
440
+ }
441
+ }
442
+
443
+ // Check for symbolic links anywhere along resolvedCandidate
444
+ const parsed = path.parse(resolvedCandidate);
445
+ const parts = resolvedCandidate.slice(parsed.root.length).split(path.sep).filter(Boolean);
446
+ let cur = parsed.root;
447
+ for (const part of parts) {
448
+ cur = path.join(cur, part);
449
+ try {
450
+ const st = fs.lstatSync(cur);
451
+ if (st.isSymbolicLink()) {
452
+ throw new Error(
453
+ `Unsafe sharedCatalogDir destination (symbolic link at ${cur}): ${rawSharedCatalogDir}`,
454
+ );
455
+ }
456
+ } catch (err) {
457
+ if (err.message && err.message.startsWith('Unsafe sharedCatalogDir')) throw err;
458
+ }
459
+ }
460
+
461
+ if (fs.existsSync(effectiveTarget)) {
462
+ const targetLstat = fs.lstatSync(effectiveTarget);
463
+ if (targetLstat.isSymbolicLink()) {
464
+ throw new Error(
465
+ `Unsafe sharedCatalogDir destination (symbolic link): ${rawSharedCatalogDir}`,
466
+ );
467
+ }
468
+ if (!targetLstat.isDirectory()) {
469
+ throw new Error(
470
+ `Unsafe sharedCatalogDir destination (existing file): ${rawSharedCatalogDir}`,
471
+ );
472
+ }
473
+ const existingEntries = fs.readdirSync(effectiveTarget);
474
+ for (const entryName of existingEntries) {
475
+ const entryFull = path.join(effectiveTarget, entryName);
476
+ const entryStat = fs.lstatSync(entryFull);
477
+ if (
478
+ !ALLOWED_EXISTING_SHARED_CATALOG_FILES.has(entryName) ||
479
+ entryStat.isSymbolicLink() ||
480
+ entryStat.isDirectory()
481
+ ) {
482
+ throw new Error(
483
+ `Unsafe sharedCatalogDir destination (refusing to delete directory containing unrelated entry '${entryName}'): ${rawSharedCatalogDir}`,
484
+ );
485
+ }
486
+ }
487
+ }
488
+
489
+ return resolvedCandidate;
490
+ }
491
+
492
+ export function exportSharedCatalogArchive(
493
+ rootDir = root,
494
+ sharedCatalogDir = path.join(rootDir, 'dist', 'shared-catalog'),
495
+ ) {
496
+ const safeSharedCatalogDir = resolveSafeSharedCatalogDir(sharedCatalogDir, rootDir);
497
+ const knowledgeCatalogPath = path.join(rootDir, 'registry', 'knowledge-catalog.json');
498
+ if (!fs.existsSync(knowledgeCatalogPath)) {
499
+ return null;
500
+ }
501
+ const filesMap = buildSharedCatalogFilesMap(rootDir);
502
+ rmrf(safeSharedCatalogDir);
503
+ mkdirp(safeSharedCatalogDir);
504
+
505
+ fs.writeFileSync(path.join(safeSharedCatalogDir, 'README.md'), filesMap['README.md'], 'utf8');
506
+ fs.writeFileSync(
507
+ path.join(safeSharedCatalogDir, 'manifest.json'),
508
+ filesMap['manifest.json'],
509
+ 'utf8',
510
+ );
511
+
512
+ const mtime = getDeterministicZipMtime();
513
+ const zipEntries = {};
514
+ const sortedRelPaths = Object.keys(filesMap).sort(compareCodeUnitOrder);
515
+ for (const relPath of sortedRelPaths) {
516
+ const entryName = `blendops-knowledge-and-recipes/${relPath}`;
517
+ zipEntries[entryName] = [
518
+ new Uint8Array(Buffer.from(filesMap[relPath], 'utf8')),
519
+ {
520
+ level: DETERMINISTIC_ZIP_COMPRESSION_LEVEL,
521
+ mtime,
522
+ os: DETERMINISTIC_ZIP_OS,
523
+ attrs: DETERMINISTIC_ZIP_ATTRS,
524
+ },
525
+ ];
526
+ }
527
+
528
+ const zipped = zipSync(zipEntries, {
529
+ level: DETERMINISTIC_ZIP_COMPRESSION_LEVEL,
530
+ mtime,
531
+ os: DETERMINISTIC_ZIP_OS,
532
+ attrs: DETERMINISTIC_ZIP_ATTRS,
533
+ });
534
+ const zipPath = path.join(safeSharedCatalogDir, 'blendops-knowledge-and-recipes.zip');
535
+ fs.writeFileSync(zipPath, Buffer.from(zipped));
536
+ return {
537
+ sharedCatalogDir: safeSharedCatalogDir,
538
+ zipPath,
539
+ files: sortedRelPaths,
540
+ };
541
+ }
542
+
543
+ const isDirectExecution =
544
+ process.argv[1] &&
545
+ fs.existsSync(process.argv[1]) &&
546
+ fs.realpathSync(path.resolve(process.argv[1])) ===
547
+ fs.realpathSync(fileURLToPath(import.meta.url));
548
+
549
+ if (isDirectExecution) {
550
+ let outRoot;
551
+ let isCustomOutputRoot = false;
552
+ try {
553
+ const { outputRootArg } = parseCliArgs(process.argv.slice(2));
554
+ isCustomOutputRoot = outputRootArg !== null && outputRootArg !== undefined;
555
+ outRoot = resolveSafeOutputRoot(outputRootArg, root);
556
+ } catch (err) {
557
+ console.error(err instanceof Error ? err.message : String(err));
558
+ process.exit(1);
559
+ }
560
+
561
+ const desktopDir = path.join(outRoot, 'desktop-zips');
562
+ const codeDir = path.join(outRoot, 'claude-code-skills');
563
+
564
+ if (!fs.existsSync(skillsDir)) {
565
+ console.error(`Missing skills directory: ${skillsDir}`);
566
+ process.exit(1);
567
+ }
568
+
569
+ const skillNames = listSkillDirs();
570
+
571
+ for (const name of skillNames) {
572
+ const skillMdPath = path.join(skillsDir, name, 'SKILL.md');
573
+ const evalMdPath = path.join(skillsDir, name, 'EVAL.md');
574
+ if (!fs.existsSync(skillMdPath)) {
575
+ console.error(`Missing required SKILL.md for skill '${name}': ${skillMdPath}`);
576
+ process.exit(1);
577
+ }
578
+ if (!fs.existsSync(evalMdPath)) {
579
+ console.error(`Missing required EVAL.md for skill '${name}': ${evalMdPath}`);
580
+ process.exit(1);
581
+ }
582
+ }
583
+
584
+ if (isCustomOutputRoot) {
585
+ if (fs.existsSync(outRoot) && fs.readdirSync(outRoot).length > 0) {
586
+ console.error(
587
+ `Refusing to overwrite non-empty --output-root directory: ${outRoot}`,
588
+ );
589
+ process.exit(1);
590
+ }
591
+ } else {
592
+ rmrf(desktopDir);
593
+ rmrf(codeDir);
594
+ fs.rmSync(path.join(outRoot, 'manifest.json'), { force: true });
595
+ }
596
+ mkdirp(desktopDir);
597
+ mkdirp(codeDir);
598
+
599
+ for (const name of skillNames) {
600
+ const src = path.join(skillsDir, name);
601
+ const codeDest = path.join(codeDir, name);
602
+ copyDir(src, codeDest);
603
+ zipDir(codeDest, path.join(desktopDir, `${name}.zip`));
604
+ }
605
+
606
+ const desktopDisplay = formatManifestOutputPrefix(desktopDir, root);
607
+ const codeDisplay = formatManifestOutputPrefix(codeDir, root);
608
+
609
+ const manifest = {
610
+ generatedAt: new Date().toISOString(),
611
+ source: 'skills/*/SKILL.md',
612
+ skillCount: skillNames.length,
613
+ outputs: {
614
+ claudeDesktop: `${desktopDisplay}/*.zip`,
615
+ claudeCode: `${codeDisplay}/*/SKILL.md`,
616
+ },
617
+ skills: skillNames,
618
+ };
619
+
620
+ fs.writeFileSync(path.join(outRoot, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
621
+
622
+ console.log(`Exported ${skillNames.length} Claude skill zips to ${desktopDisplay}`);
623
+ console.log(`Exported ${skillNames.length} Claude Code skill folders to ${codeDisplay}`);
624
+
625
+ if (!isCustomOutputRoot) {
626
+ const sharedRes = exportSharedCatalogArchive(root, path.join(root, 'dist', 'shared-catalog'));
627
+ if (sharedRes) {
628
+ const sharedDisplay = formatManifestOutputPrefix(sharedRes.zipPath, root);
629
+ console.log(`Exported shared knowledge & recipe catalog archive to ${sharedDisplay}`);
630
+ }
631
+ }
632
+ }
633
+
634
+