blendops 0.0.0-stage → 1.0.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 +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -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 +72 -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/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 +99 -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 +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -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,531 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { fileURLToPath } from 'node:url';
|
|
5
|
+
import Ajv2020 from 'ajv/dist/2020.js';
|
|
6
|
+
|
|
7
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
8
|
+
const __dirname = path.dirname(__filename);
|
|
9
|
+
const ROOT_DIR = path.resolve(__dirname, '..');
|
|
10
|
+
const DEFAULT_SCHEMA_PATH = path.join(ROOT_DIR, 'schemas', 'runtime-capability-policy.schema.json');
|
|
11
|
+
const DEFAULT_POLICY_PATH = path.join(ROOT_DIR, 'registry', 'runtime-capability-policy.json');
|
|
12
|
+
|
|
13
|
+
export const TIER_RANKS = Object.freeze({
|
|
14
|
+
L0: 0,
|
|
15
|
+
L1: 1,
|
|
16
|
+
L2: 2,
|
|
17
|
+
L3: 3,
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
const CLEARED_ASSET_LICENSES = new Set([
|
|
21
|
+
'CC0-1.0',
|
|
22
|
+
'CC-BY-4.0',
|
|
23
|
+
'Royalty-Free-Commercial',
|
|
24
|
+
'Proprietary-First-Party',
|
|
25
|
+
]);
|
|
26
|
+
|
|
27
|
+
// Governed runtime ceiling per skill when the user transitions from BlendOps planning into external MCP/CLI execution.
|
|
28
|
+
// Note: Every BlendOps skill itself operates at capabilityTier = "L0" (content/planning/validation layer),
|
|
29
|
+
// while governing target runtime actions up to governedRuntimeCeiling with mandatory backup/license/confirmation gates.
|
|
30
|
+
const GOVERNED_CEILING_BY_SKILL = Object.freeze({
|
|
31
|
+
// L1 — Reversible Scene Mutation planners
|
|
32
|
+
'product-hero-scene-planner': 'L1',
|
|
33
|
+
'camera-composition': 'L1',
|
|
34
|
+
'lighting-material-plan': 'L1',
|
|
35
|
+
'character-portrait': 'L1',
|
|
36
|
+
'environment-shot': 'L1',
|
|
37
|
+
'interior-scene': 'L1',
|
|
38
|
+
'product-grid-scene-planner': 'L1',
|
|
39
|
+
'color-management-decision': 'L1',
|
|
40
|
+
'resolution-aspect-decision': 'L1',
|
|
41
|
+
'cycles-vs-eevee-decision': 'L1',
|
|
42
|
+
|
|
43
|
+
// L2 — File Export & External Asset Import planners / handoffs
|
|
44
|
+
'asset-discovery': 'L2',
|
|
45
|
+
'asset-license-checker': 'L2',
|
|
46
|
+
'asset-style-check': 'L2',
|
|
47
|
+
'asset-fallback-strategy': 'L2',
|
|
48
|
+
'asset-library-plan': 'L2',
|
|
49
|
+
'output-format-decision': 'L2',
|
|
50
|
+
'glb-web-handoff': 'L2',
|
|
51
|
+
'mobile-glb-budget': 'L2',
|
|
52
|
+
'glb-animation-handoff': 'L2',
|
|
53
|
+
'render-export-evidence': 'L2',
|
|
54
|
+
|
|
55
|
+
// L3 — Headless CLI / Batch Execution Outlines (requires explicit confirmation + backup + no user-facing raw Python)
|
|
56
|
+
'cli-appendix-job-outline': 'L3',
|
|
57
|
+
});
|
|
58
|
+
|
|
59
|
+
let cachedSchemaValidator = null;
|
|
60
|
+
|
|
61
|
+
function getPolicySchemaValidator(schemaPath = DEFAULT_SCHEMA_PATH) {
|
|
62
|
+
if (cachedSchemaValidator && cachedSchemaValidator.schemaPath === schemaPath) {
|
|
63
|
+
return cachedSchemaValidator.validate;
|
|
64
|
+
}
|
|
65
|
+
const raw = fs.readFileSync(schemaPath, 'utf8');
|
|
66
|
+
const schema = JSON.parse(raw);
|
|
67
|
+
const ajv = new Ajv2020({ allErrors: true, strict: true });
|
|
68
|
+
const validate = ajv.compile(schema);
|
|
69
|
+
cachedSchemaValidator = { schemaPath, validate };
|
|
70
|
+
return validate;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export function buildExpectedCapabilityPolicy(rootDir = ROOT_DIR) {
|
|
74
|
+
const skillsDir = path.join(rootDir, 'skills');
|
|
75
|
+
const catalogSkillIds = fs
|
|
76
|
+
.readdirSync(skillsDir, { withFileTypes: true })
|
|
77
|
+
.filter((d) => d.isDirectory() && d.name !== '_template')
|
|
78
|
+
.map((d) => d.name)
|
|
79
|
+
.filter((id) => fs.existsSync(path.join(skillsDir, id, 'SKILL.md')))
|
|
80
|
+
.sort();
|
|
81
|
+
|
|
82
|
+
const skills = catalogSkillIds.map((skillId) => {
|
|
83
|
+
const contractPath = path.join(skillsDir, skillId, 'contract.json');
|
|
84
|
+
let contractTier = 'L0';
|
|
85
|
+
if (fs.existsSync(contractPath)) {
|
|
86
|
+
const c = JSON.parse(fs.readFileSync(contractPath, 'utf8'));
|
|
87
|
+
contractTier = c.capabilityTier || 'L0';
|
|
88
|
+
}
|
|
89
|
+
const ceiling = GOVERNED_CEILING_BY_SKILL[skillId] || 'L0';
|
|
90
|
+
const ceilingRank = TIER_RANKS[ceiling] ?? 0;
|
|
91
|
+
|
|
92
|
+
return {
|
|
93
|
+
skillId,
|
|
94
|
+
capabilityTier: contractTier,
|
|
95
|
+
governedRuntimeCeiling: ceiling,
|
|
96
|
+
requiresPreMutationBackupWhenExecuted: ceilingRank >= 1,
|
|
97
|
+
requiresAssetLicenseClearance: ceilingRank >= 2,
|
|
98
|
+
requiresExplicitOperatorConfirmation: ceilingRank >= 3,
|
|
99
|
+
userFacingPythonAllowed: false,
|
|
100
|
+
};
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
return {
|
|
104
|
+
$schema: '../schemas/runtime-capability-policy.schema.json',
|
|
105
|
+
schemaVersion: '1.0.0',
|
|
106
|
+
defaultCapabilityTier: 'L0',
|
|
107
|
+
runtimeExecutionState: {
|
|
108
|
+
blenderRuntime: 'Not Run',
|
|
109
|
+
liveRollbackEngineExecuted: false,
|
|
110
|
+
honestyNote:
|
|
111
|
+
'BlendOps is a portable content and governance layer. This policy defines and validates L0-L3 capability boundaries and pre-mutation .blend backup requirements without claiming that a live Blender rollback execution engine ran inside this repository.',
|
|
112
|
+
},
|
|
113
|
+
tiers: {
|
|
114
|
+
L0: {
|
|
115
|
+
id: 'L0',
|
|
116
|
+
rank: 0,
|
|
117
|
+
name: 'Planning & Read-Only Inspection',
|
|
118
|
+
summary:
|
|
119
|
+
'Default tier for all BlendOps skills. Permits pure workflow planning, validation, and read-only MCP inspection (get_blendfile_summary_datablocks, get_objects_summary, get_scene_info) with zero scene mutations and zero file writes.',
|
|
120
|
+
allowSceneMutation: false,
|
|
121
|
+
allowFileExport: false,
|
|
122
|
+
allowExternalAssetImport: false,
|
|
123
|
+
allowArbitraryCodeExecution: false,
|
|
124
|
+
requiresPreMutationBlendBackup: false,
|
|
125
|
+
requiresExplicitOperatorConfirmation: false,
|
|
126
|
+
requiresAssetLicenseClearance: false,
|
|
127
|
+
userFacingPythonAllowed: false,
|
|
128
|
+
},
|
|
129
|
+
L1: {
|
|
130
|
+
id: 'L1',
|
|
131
|
+
rank: 1,
|
|
132
|
+
name: 'Reversible Scene Mutation',
|
|
133
|
+
summary:
|
|
134
|
+
'Permits bounded camera, lighting, material, and object transform mutations inside an active Blender scene only after a verified pre-mutation .blend checkpoint backup is saved on disk.',
|
|
135
|
+
allowSceneMutation: true,
|
|
136
|
+
allowFileExport: false,
|
|
137
|
+
allowExternalAssetImport: false,
|
|
138
|
+
allowArbitraryCodeExecution: false,
|
|
139
|
+
requiresPreMutationBlendBackup: true,
|
|
140
|
+
requiresExplicitOperatorConfirmation: false,
|
|
141
|
+
requiresAssetLicenseClearance: false,
|
|
142
|
+
userFacingPythonAllowed: false,
|
|
143
|
+
},
|
|
144
|
+
L2: {
|
|
145
|
+
id: 'L2',
|
|
146
|
+
rank: 2,
|
|
147
|
+
name: 'File Export & External Asset Import',
|
|
148
|
+
summary:
|
|
149
|
+
'Permits rendering still/turntable outputs, exporting .glb containers to an allowlisted output directory, and importing external 3D/material assets cleared by asset-license-checker.',
|
|
150
|
+
allowSceneMutation: true,
|
|
151
|
+
allowFileExport: true,
|
|
152
|
+
allowExternalAssetImport: true,
|
|
153
|
+
allowArbitraryCodeExecution: false,
|
|
154
|
+
requiresPreMutationBlendBackup: true,
|
|
155
|
+
requiresExplicitOperatorConfirmation: false,
|
|
156
|
+
requiresAssetLicenseClearance: true,
|
|
157
|
+
userFacingPythonAllowed: false,
|
|
158
|
+
},
|
|
159
|
+
L3: {
|
|
160
|
+
id: 'L3',
|
|
161
|
+
rank: 3,
|
|
162
|
+
name: 'Arbitrary Code / Destructive Operations',
|
|
163
|
+
summary:
|
|
164
|
+
'Governs headless CLI batch execution or destructive multi-object operations. Requires explicit operator confirmation, verified pre-execution .blend backup, and strict compliance with laws/no-arbitrary-python-interface.md.',
|
|
165
|
+
allowSceneMutation: true,
|
|
166
|
+
allowFileExport: true,
|
|
167
|
+
allowExternalAssetImport: true,
|
|
168
|
+
allowArbitraryCodeExecution: true,
|
|
169
|
+
requiresPreMutationBlendBackup: true,
|
|
170
|
+
requiresExplicitOperatorConfirmation: true,
|
|
171
|
+
requiresAssetLicenseClearance: true,
|
|
172
|
+
userFacingPythonAllowed: false,
|
|
173
|
+
},
|
|
174
|
+
},
|
|
175
|
+
rollbackProtocol: {
|
|
176
|
+
checkpointPattern: '<scene>.pre-<skill-id>-<ISO8601-UTC>.blend',
|
|
177
|
+
requiredBackupFields: [
|
|
178
|
+
'sourceBlendPath',
|
|
179
|
+
'backupPath',
|
|
180
|
+
'byteSize',
|
|
181
|
+
'sha256',
|
|
182
|
+
'createdBeforeMutation',
|
|
183
|
+
'verifiedOnDisk',
|
|
184
|
+
],
|
|
185
|
+
failClosedOnBackupFailure: true,
|
|
186
|
+
recoveryVerificationTools: {
|
|
187
|
+
path1: ['get_blendfile_summary_datablocks', 'get_objects_summary'],
|
|
188
|
+
path2: ['get_scene_info', 'get_object_info'],
|
|
189
|
+
},
|
|
190
|
+
postRecoveryTruthRule:
|
|
191
|
+
'If a scene mutation fails and the pre-mutation .blend backup is restored, the operation must be reported as Runtime status: Failed (or Attempted) with rollback verified, and Artifact status: Not Produced.',
|
|
192
|
+
},
|
|
193
|
+
skills,
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
export function validateCapabilityPolicyObject(
|
|
198
|
+
policy,
|
|
199
|
+
{ rootDir = ROOT_DIR, schemaPath = DEFAULT_SCHEMA_PATH } = {},
|
|
200
|
+
) {
|
|
201
|
+
const errors = [];
|
|
202
|
+
if (!policy || typeof policy !== 'object' || Array.isArray(policy)) {
|
|
203
|
+
return { valid: false, errors: ['Capability policy root must be a JSON object'] };
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
const validateSchema = getPolicySchemaValidator(schemaPath);
|
|
207
|
+
const schemaOk = validateSchema(policy);
|
|
208
|
+
if (!schemaOk) {
|
|
209
|
+
for (const err of validateSchema.errors || []) {
|
|
210
|
+
errors.push(`schema(${err.instancePath || '/'}): ${err.message}`);
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
const skillsDir = path.join(rootDir, 'skills');
|
|
215
|
+
const catalogSkillIds = fs
|
|
216
|
+
.readdirSync(skillsDir, { withFileTypes: true })
|
|
217
|
+
.filter((d) => d.isDirectory() && d.name !== '_template')
|
|
218
|
+
.map((d) => d.name)
|
|
219
|
+
.filter((id) => fs.existsSync(path.join(skillsDir, id, 'SKILL.md')))
|
|
220
|
+
.sort();
|
|
221
|
+
const catalogSet = new Set(catalogSkillIds);
|
|
222
|
+
|
|
223
|
+
const seenSkills = new Set();
|
|
224
|
+
for (const entry of policy.skills || []) {
|
|
225
|
+
if (!entry || typeof entry !== 'object') continue;
|
|
226
|
+
if (seenSkills.has(entry.skillId)) {
|
|
227
|
+
errors.push(`Duplicate skill entry in capability policy: '${entry.skillId}'`);
|
|
228
|
+
}
|
|
229
|
+
seenSkills.add(entry.skillId);
|
|
230
|
+
|
|
231
|
+
if (!catalogSet.has(entry.skillId)) {
|
|
232
|
+
errors.push(`Capability policy references unknown skill '${entry.skillId}'`);
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
const tierRank = TIER_RANKS[entry.capabilityTier];
|
|
236
|
+
const ceilingRank = TIER_RANKS[entry.governedRuntimeCeiling];
|
|
237
|
+
if (tierRank !== undefined && ceilingRank !== undefined && tierRank > ceilingRank) {
|
|
238
|
+
errors.push(
|
|
239
|
+
`Skill '${entry.skillId}' capabilityTier (${entry.capabilityTier}) exceeds its governedRuntimeCeiling (${entry.governedRuntimeCeiling})`,
|
|
240
|
+
);
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// Verify tier flags match governedRuntimeCeiling requirements
|
|
244
|
+
if (ceilingRank >= 1 && entry.requiresPreMutationBackupWhenExecuted !== true) {
|
|
245
|
+
errors.push(
|
|
246
|
+
`Skill '${entry.skillId}' with governedRuntimeCeiling ${entry.governedRuntimeCeiling} must set requiresPreMutationBackupWhenExecuted: true`,
|
|
247
|
+
);
|
|
248
|
+
}
|
|
249
|
+
if (ceilingRank >= 2 && entry.requiresAssetLicenseClearance !== true) {
|
|
250
|
+
errors.push(
|
|
251
|
+
`Skill '${entry.skillId}' with governedRuntimeCeiling ${entry.governedRuntimeCeiling} must set requiresAssetLicenseClearance: true`,
|
|
252
|
+
);
|
|
253
|
+
}
|
|
254
|
+
if (ceilingRank >= 3 && entry.requiresExplicitOperatorConfirmation !== true) {
|
|
255
|
+
errors.push(
|
|
256
|
+
`Skill '${entry.skillId}' with governedRuntimeCeiling ${entry.governedRuntimeCeiling} must set requiresExplicitOperatorConfirmation: true`,
|
|
257
|
+
);
|
|
258
|
+
}
|
|
259
|
+
if (entry.userFacingPythonAllowed !== false) {
|
|
260
|
+
errors.push(
|
|
261
|
+
`Skill '${entry.skillId}' violates laws/no-arbitrary-python-interface.md: userFacingPythonAllowed must be false`,
|
|
262
|
+
);
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
// Cross-check contracted skills
|
|
266
|
+
const contractPath = path.join(skillsDir, entry.skillId, 'contract.json');
|
|
267
|
+
if (fs.existsSync(contractPath)) {
|
|
268
|
+
const c = JSON.parse(fs.readFileSync(contractPath, 'utf8'));
|
|
269
|
+
const cTier = c.capabilityTier || 'L0';
|
|
270
|
+
if (cTier !== entry.capabilityTier) {
|
|
271
|
+
errors.push(
|
|
272
|
+
`Contract capabilityTier mismatch for '${entry.skillId}': contract.json has '${cTier}', policy has '${entry.capabilityTier}'`,
|
|
273
|
+
);
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
for (const id of catalogSkillIds) {
|
|
279
|
+
if (!seenSkills.has(id)) {
|
|
280
|
+
errors.push(`Catalog skill '${id}' is missing from registry/runtime-capability-policy.json`);
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
return {
|
|
285
|
+
valid: errors.length === 0,
|
|
286
|
+
errors,
|
|
287
|
+
};
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
/**
|
|
291
|
+
* Evaluates a proposed runtime operation against the L0-L3 capability model and pre-mutation rollback protocol.
|
|
292
|
+
* Defaults any undeclared skill or tier to L0 and blocks mutation whenever backup or authorization gates fail.
|
|
293
|
+
*/
|
|
294
|
+
export function evaluateRuntimeCapabilityInvocation(invocation, policy = null) {
|
|
295
|
+
const errors = [];
|
|
296
|
+
let mutationBlockedByBackupFailure = false;
|
|
297
|
+
|
|
298
|
+
if (!invocation || typeof invocation !== 'object' || Array.isArray(invocation)) {
|
|
299
|
+
return {
|
|
300
|
+
allowed: false,
|
|
301
|
+
effectiveGrantedTier: 'L0',
|
|
302
|
+
requestedOperationTier: null,
|
|
303
|
+
mutationBlockedByBackupFailure: false,
|
|
304
|
+
errors: ['Invocation request must be a JSON object'],
|
|
305
|
+
};
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
const requestedTier = invocation.requestedOperationTier || 'L0';
|
|
309
|
+
if (!(requestedTier in TIER_RANKS)) {
|
|
310
|
+
return {
|
|
311
|
+
allowed: false,
|
|
312
|
+
effectiveGrantedTier: 'L0',
|
|
313
|
+
requestedOperationTier: requestedTier,
|
|
314
|
+
mutationBlockedByBackupFailure: false,
|
|
315
|
+
errors: [`Invalid requestedOperationTier '${requestedTier}' (expected L0, L1, L2, or L3)`],
|
|
316
|
+
};
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
// Determine effective granted tier (defaults to L0 if omitted or not found in policy)
|
|
320
|
+
let grantedTier = invocation.grantedTier || 'L0';
|
|
321
|
+
if (policy && Array.isArray(policy.skills) && typeof invocation.skillId === 'string') {
|
|
322
|
+
const entry = policy.skills.find((s) => s.skillId === invocation.skillId);
|
|
323
|
+
if (!entry) {
|
|
324
|
+
errors.push(`Unknown skillId '${invocation.skillId}'; defaulting granted capability tier to L0`);
|
|
325
|
+
grantedTier = 'L0';
|
|
326
|
+
} else if (!invocation.grantedTier) {
|
|
327
|
+
grantedTier = entry.governedRuntimeCeiling || 'L0';
|
|
328
|
+
} else if (TIER_RANKS[invocation.grantedTier] > TIER_RANKS[entry.governedRuntimeCeiling]) {
|
|
329
|
+
errors.push(
|
|
330
|
+
`Implicit privilege escalation blocked for '${invocation.skillId}': requested grant '${invocation.grantedTier}' exceeds skill ceiling '${entry.governedRuntimeCeiling}'`,
|
|
331
|
+
);
|
|
332
|
+
grantedTier = entry.governedRuntimeCeiling;
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
if (!(grantedTier in TIER_RANKS)) {
|
|
337
|
+
errors.push(`Invalid grantedTier '${grantedTier}'; defaulting to L0`);
|
|
338
|
+
grantedTier = 'L0';
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
const reqRank = TIER_RANKS[requestedTier];
|
|
342
|
+
const grantRank = TIER_RANKS[grantedTier];
|
|
343
|
+
|
|
344
|
+
if (reqRank > grantRank) {
|
|
345
|
+
errors.push(
|
|
346
|
+
`Privilege escalation denied: operation requires tier ${requestedTier} (rank ${reqRank}), but granted tier is ${grantedTier} (rank ${grantRank})`,
|
|
347
|
+
);
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
// Law check: never expose raw Python as user-facing output in any tier
|
|
351
|
+
if (invocation.exposesRawPythonToEndUser === true) {
|
|
352
|
+
errors.push(
|
|
353
|
+
'Violation of laws/no-arbitrary-python-interface.md: raw Python must never be exposed as the final user-facing surface',
|
|
354
|
+
);
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
// L1+ (Reversible Scene Mutation, Export, Destructive) requires verified pre-mutation .blend backup + mutation boundaries + recovery protocol
|
|
358
|
+
if (reqRank >= 1 && invocation.mutatesScene !== false) {
|
|
359
|
+
const backup = invocation.backupRecord;
|
|
360
|
+
if (!backup || typeof backup !== 'object') {
|
|
361
|
+
mutationBlockedByBackupFailure = true;
|
|
362
|
+
errors.push(
|
|
363
|
+
`Pre-mutation backup required for ${requestedTier}: missing backupRecord (.blend checkpoint must be created and verified before mutating scene)`,
|
|
364
|
+
);
|
|
365
|
+
} else {
|
|
366
|
+
if (typeof backup.sourceBlendPath !== 'string' || !backup.sourceBlendPath.endsWith('.blend')) {
|
|
367
|
+
mutationBlockedByBackupFailure = true;
|
|
368
|
+
errors.push('backupRecord.sourceBlendPath must be a valid .blend file path');
|
|
369
|
+
}
|
|
370
|
+
if (
|
|
371
|
+
typeof backup.backupPath !== 'string' ||
|
|
372
|
+
!backup.backupPath.endsWith('.blend') ||
|
|
373
|
+
backup.backupPath === backup.sourceBlendPath
|
|
374
|
+
) {
|
|
375
|
+
mutationBlockedByBackupFailure = true;
|
|
376
|
+
errors.push('backupRecord.backupPath must be a distinct .blend checkpoint path');
|
|
377
|
+
}
|
|
378
|
+
if (backup.createdBeforeMutation !== true) {
|
|
379
|
+
mutationBlockedByBackupFailure = true;
|
|
380
|
+
errors.push('backupRecord.createdBeforeMutation must be true before any scene mutation');
|
|
381
|
+
}
|
|
382
|
+
if (backup.verifiedOnDisk !== true) {
|
|
383
|
+
mutationBlockedByBackupFailure = true;
|
|
384
|
+
errors.push('backupRecord.verifiedOnDisk must be true; unverified backup blocks mutation');
|
|
385
|
+
}
|
|
386
|
+
if (!Number.isInteger(backup.byteSize) || backup.byteSize <= 0) {
|
|
387
|
+
mutationBlockedByBackupFailure = true;
|
|
388
|
+
errors.push('backupRecord.byteSize must be a positive integer');
|
|
389
|
+
}
|
|
390
|
+
if (typeof backup.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(backup.sha256)) {
|
|
391
|
+
mutationBlockedByBackupFailure = true;
|
|
392
|
+
errors.push('backupRecord.sha256 must be a 64-character lowercase hex digest');
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
const bounds = invocation.mutationBoundaries;
|
|
397
|
+
if (
|
|
398
|
+
!bounds ||
|
|
399
|
+
typeof bounds !== 'object' ||
|
|
400
|
+
!Array.isArray(bounds.allowedDatablocks) ||
|
|
401
|
+
bounds.allowedDatablocks.length === 0 ||
|
|
402
|
+
!Number.isInteger(bounds.maxObjectsModified) ||
|
|
403
|
+
bounds.maxObjectsModified < 1
|
|
404
|
+
) {
|
|
405
|
+
errors.push(
|
|
406
|
+
`Missing or invalid mutationBoundaries for ${requestedTier}: must specify non-empty allowedDatablocks and positive maxObjectsModified`,
|
|
407
|
+
);
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
const recovery = invocation.recoveryProtocol;
|
|
411
|
+
if (
|
|
412
|
+
!recovery ||
|
|
413
|
+
typeof recovery !== 'object' ||
|
|
414
|
+
typeof recovery.restoreFromBackupPath !== 'string' ||
|
|
415
|
+
typeof recovery.postRecoveryVerificationTool !== 'string' ||
|
|
416
|
+
recovery.onRecoveryFailure !== 'halt-and-report-failed'
|
|
417
|
+
) {
|
|
418
|
+
errors.push(
|
|
419
|
+
`Missing or invalid recoveryProtocol for ${requestedTier}: must define restoreFromBackupPath, postRecoveryVerificationTool, and onRecoveryFailure: 'halt-and-report-failed'`,
|
|
420
|
+
);
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
// L2+ (File Export & External Asset Import) checks
|
|
425
|
+
if (reqRank >= 2) {
|
|
426
|
+
if (invocation.exportsFile === true || typeof invocation.targetOutputPath === 'string') {
|
|
427
|
+
const allowlist = Array.isArray(invocation.outputDirectoryAllowlist)
|
|
428
|
+
? invocation.outputDirectoryAllowlist
|
|
429
|
+
: [];
|
|
430
|
+
const outPath = invocation.targetOutputPath || '';
|
|
431
|
+
const normOut = outPath.replace(/\\/g, '/');
|
|
432
|
+
if (!outPath || normOut.split('/').includes('..')) {
|
|
433
|
+
errors.push(`Unsafe or missing targetOutputPath for ${requestedTier} export: '${outPath}'`);
|
|
434
|
+
} else if (
|
|
435
|
+
allowlist.length === 0 ||
|
|
436
|
+
!allowlist.some((prefix) => {
|
|
437
|
+
const normPrefix = String(prefix).replace(/\\/g, '/').replace(/\/+$/, '') + '/';
|
|
438
|
+
return normOut.startsWith(normPrefix);
|
|
439
|
+
})
|
|
440
|
+
) {
|
|
441
|
+
errors.push(
|
|
442
|
+
`targetOutputPath '${outPath}' is not inside outputDirectoryAllowlist (${JSON.stringify(allowlist)})`,
|
|
443
|
+
);
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
if (invocation.importsExternalAssets === true) {
|
|
448
|
+
const clearance = invocation.assetLicenseClearance;
|
|
449
|
+
if (
|
|
450
|
+
!clearance ||
|
|
451
|
+
typeof clearance !== 'object' ||
|
|
452
|
+
clearance.status !== 'Cleared' ||
|
|
453
|
+
!CLEARED_ASSET_LICENSES.has(clearance.spdxOrCategory) ||
|
|
454
|
+
clearance.verifiedBySkill !== 'asset-license-checker'
|
|
455
|
+
) {
|
|
456
|
+
errors.push(
|
|
457
|
+
`External asset import blocked in ${requestedTier}: requires assetLicenseClearance { status: 'Cleared', spdxOrCategory in [${[...CLEARED_ASSET_LICENSES].join(', ')}], verifiedBySkill: 'asset-license-checker' }`,
|
|
458
|
+
);
|
|
459
|
+
}
|
|
460
|
+
}
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
// L3 (Arbitrary Code / Destructive Operations) checks
|
|
464
|
+
if (reqRank >= 3) {
|
|
465
|
+
const confirm = invocation.operatorConfirmation;
|
|
466
|
+
if (
|
|
467
|
+
!confirm ||
|
|
468
|
+
typeof confirm !== 'object' ||
|
|
469
|
+
confirm.confirmed !== true ||
|
|
470
|
+
typeof confirm.confirmedBy !== 'string' ||
|
|
471
|
+
confirm.confirmedBy.trim().length === 0 ||
|
|
472
|
+
typeof confirm.scopeSummary !== 'string' ||
|
|
473
|
+
confirm.scopeSummary.trim().length < 5
|
|
474
|
+
) {
|
|
475
|
+
errors.push(
|
|
476
|
+
'L3 execution denied: requires explicit operatorConfirmation { confirmed: true, confirmedBy, scopeSummary }',
|
|
477
|
+
);
|
|
478
|
+
}
|
|
479
|
+
}
|
|
480
|
+
|
|
481
|
+
return {
|
|
482
|
+
allowed: errors.length === 0,
|
|
483
|
+
effectiveGrantedTier: grantedTier,
|
|
484
|
+
requestedOperationTier: requestedTier,
|
|
485
|
+
mutationBlockedByBackupFailure,
|
|
486
|
+
errors,
|
|
487
|
+
};
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
function main() {
|
|
491
|
+
const args = new Set(process.argv.slice(2));
|
|
492
|
+
const checkOnly = args.has('--check');
|
|
493
|
+
const expectedPolicy = buildExpectedCapabilityPolicy(ROOT_DIR);
|
|
494
|
+
const expectedJson = `${JSON.stringify(expectedPolicy, null, 2)}\n`;
|
|
495
|
+
|
|
496
|
+
if (checkOnly) {
|
|
497
|
+
if (!fs.existsSync(DEFAULT_POLICY_PATH)) {
|
|
498
|
+
console.error('Missing registry/runtime-capability-policy.json');
|
|
499
|
+
process.exit(1);
|
|
500
|
+
}
|
|
501
|
+
const diskJson = fs.readFileSync(DEFAULT_POLICY_PATH, 'utf8');
|
|
502
|
+
const diskObj = JSON.parse(diskJson);
|
|
503
|
+
const val = validateCapabilityPolicyObject(diskObj, { rootDir: ROOT_DIR });
|
|
504
|
+
if (!val.valid) {
|
|
505
|
+
console.error('Capability policy validation failed:');
|
|
506
|
+
for (const e of val.errors) console.error(`- ${e}`);
|
|
507
|
+
process.exit(1);
|
|
508
|
+
}
|
|
509
|
+
if (diskJson !== expectedJson) {
|
|
510
|
+
console.error('Stale registry/runtime-capability-policy.json does not match expected policy');
|
|
511
|
+
process.exit(1);
|
|
512
|
+
}
|
|
513
|
+
console.log(`Capability policy --check passed (${diskObj.skills.length} skills, default=${diskObj.defaultCapabilityTier})`);
|
|
514
|
+
return;
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
const val = validateCapabilityPolicyObject(expectedPolicy, { rootDir: ROOT_DIR });
|
|
518
|
+
if (!val.valid) {
|
|
519
|
+
console.error('Capability policy generation failed validation:');
|
|
520
|
+
for (const e of val.errors) console.error(`- ${e}`);
|
|
521
|
+
process.exit(1);
|
|
522
|
+
}
|
|
523
|
+
|
|
524
|
+
fs.mkdirSync(path.dirname(DEFAULT_POLICY_PATH), { recursive: true });
|
|
525
|
+
fs.writeFileSync(DEFAULT_POLICY_PATH, expectedJson, 'utf8');
|
|
526
|
+
console.log(`Generated registry/runtime-capability-policy.json (${expectedPolicy.skills.length} skills)`);
|
|
527
|
+
}
|
|
528
|
+
|
|
529
|
+
if (process.argv[1] && path.resolve(process.argv[1]) === __filename) {
|
|
530
|
+
main();
|
|
531
|
+
}
|