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.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,540 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/ThanhNguyxnOrg/blendops/schemas/runtime-qualification-report.schema.json",
4
+ "title": "BlendOps Upstream MCP Runtime Qualification & Smoke Report Schema",
5
+ "description": "Machine-readable schema for BlendOps upstream Blender MCP runtime qualification, tool inventory classification, operation-to-tool mapping verification, and controlled offline/live smoke execution.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": [
9
+ "$schema",
10
+ "schema_version",
11
+ "report_id",
12
+ "timestamp",
13
+ "qualification_mode",
14
+ "evidence_classification",
15
+ "runtime_path",
16
+ "runtime_server_identity",
17
+ "server_version",
18
+ "blender_version",
19
+ "addon_version",
20
+ "mcp_protocol_version",
21
+ "transport_type",
22
+ "runtime_reachability",
23
+ "qualification_states",
24
+ "qualification_verdict",
25
+ "upstream_tool_inventory",
26
+ "tool_inventory_fingerprint",
27
+ "unsafe_tool_inventory",
28
+ "operation_to_tool_mappings",
29
+ "qualification_results",
30
+ "executed_smoke_operations",
31
+ "independent_readback_evidence",
32
+ "checkpoint_details",
33
+ "postcondition_verification",
34
+ "rollback_verification",
35
+ "secrets_redacted",
36
+ "truth_states",
37
+ "known_limitations"
38
+ ],
39
+ "properties": {
40
+ "$schema": {
41
+ "type": "string"
42
+ },
43
+ "schema_version": {
44
+ "type": "string",
45
+ "const": "1.0.0"
46
+ },
47
+ "report_id": {
48
+ "type": "string",
49
+ "pattern": "^qual\\.[a-z0-9-]+$",
50
+ "minLength": 10,
51
+ "maxLength": 120
52
+ },
53
+ "timestamp": {
54
+ "type": "string",
55
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}"
56
+ },
57
+ "qualification_mode": {
58
+ "type": "string",
59
+ "enum": ["offline_contract", "live_runtime"]
60
+ },
61
+ "evidence_classification": {
62
+ "type": "string",
63
+ "enum": [
64
+ "mock_verified",
65
+ "contract_verified",
66
+ "live_discovered",
67
+ "live_read_only_verified",
68
+ "live_mutation_verified",
69
+ "live_export_verified",
70
+ "not_run"
71
+ ]
72
+ },
73
+ "runtime_path": {
74
+ "type": "string",
75
+ "enum": [
76
+ "path-1-host-a",
77
+ "path-1-host-b",
78
+ "path-2-community",
79
+ "cli-appendix",
80
+ "none"
81
+ ]
82
+ },
83
+ "runtime_server_identity": {
84
+ "type": ["string", "null"]
85
+ },
86
+ "server_version": {
87
+ "type": ["string", "null"]
88
+ },
89
+ "blender_version": {
90
+ "type": ["string", "null"]
91
+ },
92
+ "addon_version": {
93
+ "type": ["string", "null"]
94
+ },
95
+ "mcp_protocol_version": {
96
+ "type": ["string", "null"]
97
+ },
98
+ "transport_type": {
99
+ "type": "string",
100
+ "enum": [
101
+ "stdio",
102
+ "sse",
103
+ "streamable-http",
104
+ "mock-in-memory",
105
+ "cli-subprocess",
106
+ "unconfigured"
107
+ ]
108
+ },
109
+ "runtime_reachability": {
110
+ "type": "string",
111
+ "enum": [
112
+ "reachable",
113
+ "unreachable",
114
+ "not_configured",
115
+ "blocked_opt_in_missing",
116
+ "blocked_invalid_endpoint",
117
+ "protocol_error",
118
+ "identity_mismatch",
119
+ "version_unsupported"
120
+ ]
121
+ },
122
+ "qualification_states": {
123
+ "type": "object",
124
+ "additionalProperties": false,
125
+ "required": [
126
+ "runtime_discovered",
127
+ "runtime_reachable",
128
+ "runtime_identity_verified",
129
+ "protocol_compatible",
130
+ "blender_version_compatible",
131
+ "tool_inventory_verified",
132
+ "read_only_qualified",
133
+ "mutation_qualified",
134
+ "export_import_qualified",
135
+ "live_runtime_verified"
136
+ ],
137
+ "properties": {
138
+ "runtime_discovered": { "type": "boolean" },
139
+ "runtime_reachable": { "type": "boolean" },
140
+ "runtime_identity_verified": { "type": "boolean" },
141
+ "protocol_compatible": { "type": "boolean" },
142
+ "blender_version_compatible": { "type": "boolean" },
143
+ "tool_inventory_verified": { "type": "boolean" },
144
+ "read_only_qualified": { "type": "boolean" },
145
+ "mutation_qualified": { "type": "boolean" },
146
+ "export_import_qualified": { "type": "boolean" },
147
+ "live_runtime_verified": { "type": "boolean" },
148
+ "conditional_export_available": { "type": "boolean" }
149
+ }
150
+ },
151
+ "connection_lifecycle_state": {
152
+ "type": "string",
153
+ "enum": [
154
+ "configured",
155
+ "transport_connected",
156
+ "initialized",
157
+ "protocol_negotiated",
158
+ "tools_discovered",
159
+ "contract_qualified",
160
+ "live_read_only_verified"
161
+ ]
162
+ },
163
+ "provenance_verification": {
164
+ "type": "object",
165
+ "additionalProperties": true
166
+ },
167
+ "tool_list_changed_events": {
168
+ "type": ["integer", "array"]
169
+ },
170
+ "qualification_verdict": {
171
+ "type": "string",
172
+ "enum": [
173
+ "unqualified",
174
+ "connected_unqualified",
175
+ "read_only_qualified",
176
+ "read_only_and_export_qualified",
177
+ "read_only_and_mutation_qualified",
178
+ "fully_qualified",
179
+ "fully_governed_qualified"
180
+ ]
181
+ },
182
+ "upstream_tool_inventory": {
183
+ "type": "array",
184
+ "items": {
185
+ "type": "object",
186
+ "additionalProperties": false,
187
+ "required": [
188
+ "tool_name",
189
+ "server_identity",
190
+ "server_version",
191
+ "description",
192
+ "input_schema",
193
+ "tool_schema_fingerprint",
194
+ "output_shape_summary",
195
+ "side_effects",
196
+ "required_capability_tier",
197
+ "executes_arbitrary_code",
198
+ "modifies_scene_state",
199
+ "reads_files",
200
+ "writes_files",
201
+ "accesses_external_services",
202
+ "bounded_and_independently_verifiable",
203
+ "classification",
204
+ "schema_drift_detected",
205
+ "description_injection_detected",
206
+ "requalification_required",
207
+ "qualification_rationale"
208
+ ],
209
+ "properties": {
210
+ "tool_name": { "type": "string", "minLength": 1 },
211
+ "server_identity": { "type": ["string", "null"] },
212
+ "server_version": { "type": ["string", "null"] },
213
+ "description": { "type": "string" },
214
+ "input_schema": { "type": "object" },
215
+ "tool_schema_fingerprint": {
216
+ "type": "string",
217
+ "pattern": "^[a-f0-9]{64}$"
218
+ },
219
+ "output_shape_summary": { "type": "string" },
220
+ "side_effects": {
221
+ "type": "string",
222
+ "enum": [
223
+ "none",
224
+ "scene_mutation",
225
+ "file_write",
226
+ "ui_state_mutation",
227
+ "external_network_and_scene_mutation",
228
+ "telemetry_or_config_mutation",
229
+ "arbitrary_code_execution",
230
+ "unknown_side_effects"
231
+ ]
232
+ },
233
+ "required_capability_tier": {
234
+ "type": "string",
235
+ "enum": ["L0", "L1", "L2", "L3"]
236
+ },
237
+ "executes_arbitrary_code": { "type": "boolean" },
238
+ "modifies_scene_state": { "type": "boolean" },
239
+ "reads_files": { "type": "boolean" },
240
+ "writes_files": { "type": "boolean" },
241
+ "accesses_external_services": { "type": "boolean" },
242
+ "bounded_and_independently_verifiable": { "type": "boolean" },
243
+ "classification": {
244
+ "type": "string",
245
+ "enum": [
246
+ "safe_direct",
247
+ "conditional",
248
+ "read_only_only",
249
+ "unsafe_raw_code",
250
+ "unsupported",
251
+ "unknown"
252
+ ]
253
+ },
254
+ "schema_drift_detected": { "type": "boolean" },
255
+ "description_injection_detected": { "type": "boolean" },
256
+ "requalification_required": { "type": "boolean" },
257
+ "qualification_rationale": { "type": "string", "minLength": 5 },
258
+ "title": { "type": ["string", "null"] },
259
+ "output_schema": { "type": ["object", "null"] },
260
+ "annotations": { "type": ["object", "null"] },
261
+ "icons": { "type": ["array", "null"] },
262
+ "execution_metadata": { "type": ["object", "null"] },
263
+ "contract_fingerprints": { "type": "object" },
264
+ "drift_severity": { "type": ["string", "null"] },
265
+ "synthetic_extension_spoof_detected": { "type": "boolean" },
266
+ "known_upstream_issues": {
267
+ "type": "array",
268
+ "items": { "type": "string" }
269
+ },
270
+ "conditional_execution_requirements": {
271
+ "type": "array",
272
+ "items": { "type": "string" }
273
+ }
274
+ }
275
+ }
276
+ },
277
+ "tool_inventory_fingerprint": {
278
+ "type": ["string", "null"],
279
+ "pattern": "^[a-f0-9]{64}$"
280
+ },
281
+ "unsafe_tool_inventory": {
282
+ "type": "array",
283
+ "items": {
284
+ "type": "object",
285
+ "additionalProperties": false,
286
+ "required": [
287
+ "tool_name",
288
+ "classification",
289
+ "executes_arbitrary_code",
290
+ "blocking_reason"
291
+ ],
292
+ "properties": {
293
+ "tool_name": { "type": "string", "minLength": 1 },
294
+ "classification": {
295
+ "type": "string",
296
+ "enum": ["unsafe_raw_code", "conditional", "unsupported", "unknown"]
297
+ },
298
+ "executes_arbitrary_code": { "type": "boolean" },
299
+ "blocking_reason": { "type": "string", "minLength": 5 }
300
+ }
301
+ }
302
+ },
303
+ "operation_to_tool_mappings": {
304
+ "type": "array",
305
+ "minItems": 18,
306
+ "items": {
307
+ "type": "object",
308
+ "additionalProperties": false,
309
+ "required": [
310
+ "operation_id",
311
+ "required_capability_tier",
312
+ "runtime_path",
313
+ "exact_upstream_mcp_tool_name",
314
+ "tool_schema_fingerprint",
315
+ "required_arguments",
316
+ "expected_side_effects",
317
+ "required_preconditions",
318
+ "required_postconditions",
319
+ "readback_strategy",
320
+ "checkpoint_requirement",
321
+ "rollback_strategy",
322
+ "qualification_status",
323
+ "evidence_supporting_decision"
324
+ ],
325
+ "properties": {
326
+ "operation_id": { "type": "string", "minLength": 3 },
327
+ "required_capability_tier": {
328
+ "type": "string",
329
+ "enum": ["L0", "L1", "L2", "L3"]
330
+ },
331
+ "runtime_path": { "type": "string" },
332
+ "exact_upstream_mcp_tool_name": { "type": ["string", "null"] },
333
+ "tool_schema_fingerprint": { "type": ["string", "null"] },
334
+ "required_arguments": {
335
+ "type": "array",
336
+ "items": { "type": "string" }
337
+ },
338
+ "expected_side_effects": { "type": "string" },
339
+ "required_preconditions": {
340
+ "type": "array",
341
+ "items": { "type": "string" }
342
+ },
343
+ "required_postconditions": {
344
+ "type": "array",
345
+ "items": { "type": "string" }
346
+ },
347
+ "readback_strategy": { "type": "string" },
348
+ "checkpoint_requirement": { "type": "string" },
349
+ "rollback_strategy": { "type": "string" },
350
+ "qualification_status": {
351
+ "type": "string",
352
+ "enum": [
353
+ "qualified_read_only",
354
+ "qualified_safe_direct",
355
+ "conditional_upstream_known_issues",
356
+ "blocked_missing_bounded_upstream_tool",
357
+ "blocked_unsafe_raw_code_tool",
358
+ "blocked_unbounded_upstream_side_effects",
359
+ "blocked_schema_drift",
360
+ "blocked_capability_mismatch",
361
+ "blocked_runtime_unqualified",
362
+ "permanently_blocked_l3"
363
+ ]
364
+ },
365
+ "evidence_supporting_decision": { "type": "string", "minLength": 5 }
366
+ }
367
+ }
368
+ },
369
+ "qualification_results": {
370
+ "type": "object",
371
+ "additionalProperties": false,
372
+ "required": [
373
+ "total_canonical_operations",
374
+ "qualified_read_only_operations",
375
+ "qualified_mutation_operations",
376
+ "qualified_export_import_operations",
377
+ "blocked_operations",
378
+ "permanently_blocked_l3_interfaces"
379
+ ],
380
+ "properties": {
381
+ "total_canonical_operations": { "type": "integer", "minimum": 18 },
382
+ "qualified_read_only_operations": {
383
+ "type": "array",
384
+ "items": { "type": "string" }
385
+ },
386
+ "qualified_mutation_operations": {
387
+ "type": "array",
388
+ "items": { "type": "string" }
389
+ },
390
+ "qualified_export_import_operations": {
391
+ "type": "array",
392
+ "items": { "type": "string" }
393
+ },
394
+ "blocked_operations": {
395
+ "type": "array",
396
+ "items": { "type": "string" }
397
+ },
398
+ "permanently_blocked_l3_interfaces": {
399
+ "type": "array",
400
+ "items": { "type": "string" }
401
+ }
402
+ }
403
+ },
404
+ "executed_smoke_operations": {
405
+ "type": "array",
406
+ "items": {
407
+ "type": "object",
408
+ "additionalProperties": false,
409
+ "required": [
410
+ "operation_id",
411
+ "mapped_tool_name",
412
+ "tier",
413
+ "status",
414
+ "independent_readback_verified"
415
+ ],
416
+ "properties": {
417
+ "operation_id": { "type": "string" },
418
+ "mapped_tool_name": { "type": ["string", "null"] },
419
+ "tier": { "type": "string", "enum": ["L0", "L1", "L2", "L3"] },
420
+ "status": {
421
+ "type": "string",
422
+ "enum": ["succeeded", "blocked", "failed", "not_run"]
423
+ },
424
+ "independent_readback_verified": { "type": "boolean" }
425
+ }
426
+ }
427
+ },
428
+ "independent_readback_evidence": {
429
+ "type": "object",
430
+ "additionalProperties": false,
431
+ "required": ["performed", "verified", "readback_tool_names", "summary"],
432
+ "properties": {
433
+ "performed": { "type": "boolean" },
434
+ "verified": { "type": "boolean" },
435
+ "readback_tool_names": {
436
+ "type": "array",
437
+ "items": { "type": "string" }
438
+ },
439
+ "summary": { "type": "string" }
440
+ }
441
+ },
442
+ "checkpoint_details": {
443
+ "type": ["object", "null"],
444
+ "additionalProperties": false,
445
+ "required": [
446
+ "required",
447
+ "verified_on_disk",
448
+ "source_blend_path",
449
+ "backup_path",
450
+ "sha256"
451
+ ],
452
+ "properties": {
453
+ "required": { "type": "boolean" },
454
+ "verified_on_disk": { "type": "boolean" },
455
+ "source_blend_path": { "type": ["string", "null"] },
456
+ "backup_path": { "type": ["string", "null"] },
457
+ "sha256": { "type": ["string", "null"] }
458
+ }
459
+ },
460
+ "postcondition_verification": {
461
+ "type": "object",
462
+ "additionalProperties": false,
463
+ "required": ["checked", "passed", "details"],
464
+ "properties": {
465
+ "checked": { "type": "boolean" },
466
+ "passed": { "type": "boolean" },
467
+ "details": { "type": "string" }
468
+ }
469
+ },
470
+ "rollback_verification": {
471
+ "type": "object",
472
+ "additionalProperties": false,
473
+ "required": ["triggered", "status", "details"],
474
+ "properties": {
475
+ "triggered": { "type": "boolean" },
476
+ "status": {
477
+ "type": "string",
478
+ "enum": [
479
+ "not_needed",
480
+ "rollback_verified",
481
+ "rollback_unverified",
482
+ "rollback_failed",
483
+ "unknown_remote_execution_outcome"
484
+ ]
485
+ },
486
+ "details": { "type": "string" },
487
+ "unknown_remote_execution_outcome": { "type": "boolean" },
488
+ "checks": {
489
+ "type": "array",
490
+ "items": { "type": "object" }
491
+ }
492
+ }
493
+ },
494
+ "secrets_redacted": {
495
+ "type": "boolean"
496
+ },
497
+ "truth_states": {
498
+ "type": "object",
499
+ "additionalProperties": false,
500
+ "required": [
501
+ "runtime_status",
502
+ "artifact_status",
503
+ "live_qualification",
504
+ "is_mock_runtime"
505
+ ],
506
+ "properties": {
507
+ "runtime_status": {
508
+ "type": "string",
509
+ "enum": ["Not Run", "Attempted", "Produced", "Verified", "Failed"]
510
+ },
511
+ "artifact_status": {
512
+ "type": "string",
513
+ "enum": ["Not Produced", "Attempted", "Produced", "Verified", "Failed"]
514
+ },
515
+ "live_qualification": {
516
+ "type": "string",
517
+ "enum": [
518
+ "Not Run",
519
+ "Attempted",
520
+ "Discovered Only",
521
+ "Read-Only Verified",
522
+ "Mutation Verified",
523
+ "Failed"
524
+ ]
525
+ },
526
+ "is_mock_runtime": {
527
+ "type": "boolean"
528
+ }
529
+ }
530
+ },
531
+ "known_limitations": {
532
+ "type": "array",
533
+ "minItems": 1,
534
+ "items": {
535
+ "type": "string",
536
+ "minLength": 5
537
+ }
538
+ }
539
+ }
540
+ }