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.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- 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
|
+
|