@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
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/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yCAAyC,EAEzC,sDAAsD,EACtD,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAE1B,uCAAuC,EACvC,oCAAoC,EACpC,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwC,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAsFxH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,qCAAqC,IAAI,8BAA8B,CAAC,0BAA0B,CAAC,CAalH;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAE1E;AAED,wBAAgB,gCAAgC,IAAI,oCAAoC,EAAE,CAEzF;AAED,wBAAgB,+BAA+B,IAAI,4BAA4B,CAE9E;AAED,wBAAgB,4BAA4B,IAAI,iCAAiC,EAAE,CAElF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAyB1F;AAED,wBAAgB,6BAA6B,CAAC,aAAa,SAAS,8BAA8B,EAChG,YAAY,EAAE,aAAa,GAC1B,6BAA6B,CAAC,aAAa,CAAC,CAE9C;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,uCAAuC,EAAE,CAK3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAmD5F;AAED,4EAA4E;AAC5E,wBAAgB,6CAA6C,IAAI,sDAAsD,EAAE,CAGxH;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,yCAAyC,GAAG,IAAI,CA0B5I;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sDAAsD,CACpE,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,8BAA8B,CAAC,OAAO,CAAC,GAAG,IAAI,CAWhD;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,IAAI,8BAA8B,EAAE,CAsBvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhF;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAQhE"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\nimport { describeCaughtError } from '@wildo-ai/saas-models';\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\n/**\n * The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.\n *\n * `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from\n * the backend library. The backend library's copy was imported here twice — before #1412, and again by\n * the #1518 sweep that made the helper mandatory at every catch — and each time that one import made\n * this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency\n * (everything else this package takes from it is an erased `import type` in the playbook definitions),\n * a devDependency is not installed for a consumer of the published package, and a VALUE import on a\n * public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`\n * pins it.\n *\n * The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native\n * `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to\n * cover a call into the engine: put that call behind its own catch in a package allowed to depend on\n * the engine at runtime.\n */\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\n/**\n * One compiled skill's BODY — the `SKILL.md` a method means when it says \"follow the `X` skill\".\n *\n * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:\n * that projection is for CHOOSING between skills and carries one line each, and a method that has\n * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods\n * instructed their model to follow a named skill \"for the exact field contracts\" while only its\n * purpose line ever reached the brief (#1435).\n *\n * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those\n * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs\n * them, and a structured generation cannot open anything — inlining them would put tens of\n * kilobytes of material nobody asked for into every brief. What the body says about them stays\n * true for the coding agent that later executes the work.\n *\n * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than\n * rendering an empty section that reads like a skill with nothing in it.\n */\nexport function readFrameworkKnowledgeSkillBody(skillName: string): string | null {\n // A name is a folder, so anything path-shaped would escape the skills directory. Refused rather\n // than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.\n if (!/^[a-z0-9-]+$/u.test(skillName)) return null;\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) return null;\n return readTextKnowledgeAsset(skillPath);\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
|
|
1
|
+
{"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\nimport { describeCaughtError } from '@wildo-ai/saas-models';\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\n/**\n * The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.\n *\n * `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from\n * the backend library. The backend library's copy was imported here twice — before #1412, and again by\n * the #1518 sweep that made the helper mandatory at every catch — and each time that one import made\n * this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency\n * (everything else this package takes from it is an erased `import type` in the playbook definitions),\n * a devDependency is not installed for a consumer of the published package, and a VALUE import on a\n * public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`\n * pins it.\n *\n * The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native\n * `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to\n * cover a call into the engine: put that call behind its own catch in a package allowed to depend on\n * the engine at runtime.\n */\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\n/**\n * One compiled skill's BODY — the `SKILL.md` a method means when it says \"follow the `X` skill\".\n *\n * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:\n * that projection is for CHOOSING between skills and carries one line each, and a method that has\n * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods\n * instructed their model to follow a named skill \"for the exact field contracts\" while only its\n * purpose line ever reached the brief (#1435).\n *\n * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those\n * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs\n * them, and a structured generation cannot open anything — inlining them would put tens of\n * kilobytes of material nobody asked for into every brief. What the body says about them stays\n * true for the coding agent that later executes the work.\n *\n * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than\n * rendering an empty section that reads like a skill with nothing in it.\n */\nexport function readFrameworkKnowledgeSkillBody(skillName: string): string | null {\n // A name is a folder, so anything path-shaped would escape the skills directory. Refused rather\n // than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.\n if (!/^[a-z0-9-]+$/u.test(skillName)) return null;\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) return null;\n return readTextKnowledgeAsset(skillPath);\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
|
|
@@ -18,7 +18,8 @@ import { ResearchProvenanceCatalogReading } from '@wildo-ai/saas-models/meta-wor
|
|
|
18
18
|
* whatever those children output is research-informed. Measured on the catalog of 2026-10-19 this yields the whole
|
|
19
19
|
* `market-snapshot` family (`top_down.market-analysis`), the whole `brand-name-screening` family
|
|
20
20
|
* (`top_down.brand-naming`), and the `vision.constraint` aspect alone (`top_down.compliance-analysis`, whose producer
|
|
21
|
-
*
|
|
21
|
+
* declared it wrote only that slice). Since #3362 that producer writes `compliance-posture.constraint` instead, and the
|
|
22
|
+
* derivation follows it with no edit here, which is the point of deriving it. A hand-kept list was rejected: a research composite added tomorrow would have to
|
|
22
23
|
* remember to update it, and the failure is silent.
|
|
23
24
|
*
|
|
24
25
|
* ## The grain, and what is deliberately TRUSTED
|
|
@@ -26,9 +27,10 @@ import { ResearchProvenanceCatalogReading } from '@wildo-ai/saas-models/meta-wor
|
|
|
26
27
|
* An output that declares `aspects` taints those aspects; one that does not taints its whole family. Transitive taint
|
|
27
28
|
* is NOT followed: a step that reads a committed research-informed family (the requirements, the website plan) writes
|
|
28
29
|
* from inside, the application's own decision about that material, so its output is trusted. Following taint through
|
|
29
|
-
* every reader would mark nearly every family third-party and the class would stop discriminating.
|
|
30
|
-
*
|
|
31
|
-
*
|
|
30
|
+
* every reader would mark nearly every family third-party and the class would stop discriminating. What closes the gap
|
|
31
|
+
* instead is upstream (#2937): the companion screens a generation step's research-informed INPUT before the producing
|
|
32
|
+
* model reads it, so a flagged instruction never reaches the model whose output is trusted, and with no classifier bound
|
|
33
|
+
* the coding brief says its trusted text was derived from unscreened input.
|
|
32
34
|
*/
|
|
33
35
|
/** Research-informed content, as the catalog defines it. Each entry names the research playbooks that informed it. */
|
|
34
36
|
export interface ResearchInformedContent {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.research-provenance.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"framework-knowledge.research-provenance.d.ts","sourceRoot":"","sources":["../../src/framework-knowledge.research-provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAG/G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAUH,sHAAsH;AACtH,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC1D,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzD,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC;IACnD,sHAAsH;IACtH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC/F,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAmBvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,uBAAuB,CA8C/G;AAID;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,SAAS,oBAAoB,EAAE,GAAG,uBAAuB,CAavH;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,IAAI,uBAAuB,CAQ7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAGvI"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.research-provenance.js","sourceRoot":"","sources":["../../../src/framework-knowledge.research-provenance.ts"],"names":[],"mappings":"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","sourcesContent":["import { MetaWorkflow_Executor, ResearchProvenanceCatalogReading } from '@wildo-ai/saas-models/meta-workflows';\nimport { getFrameworkKnowledgePlaybook, listFrameworkKnowledgePlaybooks } from './framework-knowledge.loader.js';\n\n/**\n * WHICH decided elements a coding agent's brief must treat as written outside the repository (#2846).\n *\n * ## The threat, and where it enters\n *\n * A research agent fetches web pages. Its evidence becomes a step value inside its composite, a sibling generation step\n * writes a specification family from it, and the family is committed (automatically, under the YOLO posture). A coding\n * brief then carries elements of that family: a website section draws on market proofs, a task serves a compliance\n * constraint. An instruction planted in a fetched page can therefore reach an agent that writes the application's code,\n * which is indirect prompt injection. Everything else a brief carries is written by the system or by the application's\n * own people: framework knowledge, the companion's derivations, the application's code, configuration and specifications.\n *\n * ## Derived from the catalog, never listed\n *\n * The elements at risk are the ones a step filled from research, and the compiled playbook catalog already says which\n * steps those are: a composite that admits a RESEARCH_AGENT child hands that child's evidence to its other children, so\n * whatever those children output is research-informed. Measured on the catalog of 2026-10-19 this yields the whole\n * `market-snapshot` family (`top_down.market-analysis`), the whole `brand-name-screening` family\n * (`top_down.brand-naming`), and the `vision.constraint` aspect alone (`top_down.compliance-analysis`, whose producer\n * declares it writes only that slice). A hand-kept list was rejected: a research composite added tomorrow would have to\n * remember to update it, and the failure is silent.\n *\n * ## The grain, and what is deliberately TRUSTED\n *\n * An output that declares `aspects` taints those aspects; one that does not taints its whole family. Transitive taint\n * is NOT followed: a step that reads a committed research-informed family (the requirements, the website plan) writes\n * from inside, the application's own decision about that material, so its output is trusted. Following taint through\n * every reader would mark nearly every family third-party and the class would stop discriminating. The cost of that\n * choice is stated rather than hidden: text a generation step copied VERBATIM from a research-informed family into its\n * own output is not screened by this lane.\n */\n\n/*\n * Owned here, beside the catalog it reads (#2846 review B2): the dev companion routes a brief's elements by it, and an\n * evidence collector runs the SAME function from the catalog an application's companion ships, rather than a copy that\n * could drift. Its reading vocabulary, `ResearchProvenanceCatalogReading`, lives in `@wildo-ai/saas-models/meta-workflows`\n * beside the brief's trust vocabulary, so the assurance basis can name it: `@wildo-ai/saas-specifications` cannot\n * depend on this package, which depends on it.\n */\n\n/** Research-informed content, as the catalog defines it. Each entry names the research playbooks that informed it. */\nexport interface ResearchInformedContent {\n /** Families a research-fed step writes WHOLE (its output declares no aspects). */\n readonly families: ReadonlyMap<string, readonly string[]>;\n /** Aspects a research-fed step writes, when its output names them. */\n readonly aspects: ReadonlyMap<string, readonly string[]>;\n /** Every RESEARCH_AGENT entry the catalog declares, sorted. */\n readonly researchSteps: readonly string[];\n readonly reading: ResearchProvenanceCatalogReading;\n /** Why the reading is not READ: operator-facing, recorded on the coding run's row. Present exactly when it is not. */\n readonly unreadableReason?: string;\n}\n\n/** What the derivation reads from one compiled catalog entry: nothing else. */\nexport interface ResearchCatalogEntry {\n readonly ref: string;\n readonly executor?: string;\n readonly outputs: readonly { readonly family: string; readonly aspects?: readonly string[] }[];\n readonly admits: readonly string[];\n}\n\n/** One compiled entry read structurally; `undefined` for something that is not an entry. */\nexport function readResearchCatalogEntry(raw: unknown): ResearchCatalogEntry | undefined {\n if (typeof raw !== 'object' || raw === null) return undefined;\n const entry = raw as { ref?: unknown; executor?: unknown; outputs?: unknown; method?: { choreography?: { admits?: unknown } } };\n if (typeof entry.ref !== 'string') return undefined;\n const outputs = Array.isArray(entry.outputs)\n ? entry.outputs.flatMap((output: unknown) => {\n const candidate = output as { family?: unknown; aspects?: unknown };\n if (typeof candidate?.family !== 'string') return [];\n const aspects = Array.isArray(candidate.aspects) ? candidate.aspects.filter((aspect): aspect is string => typeof aspect === 'string') : undefined;\n return [{ family: candidate.family, ...(aspects && aspects.length > 0 ? { aspects } : {}) }];\n })\n : [];\n const admits = entry.method?.choreography?.admits;\n return {\n ref: entry.ref,\n ...(typeof entry.executor === 'string' ? { executor: entry.executor } : {}),\n outputs,\n admits: Array.isArray(admits) ? admits.filter((child): child is string => typeof child === 'string') : [],\n };\n}\n\n/**\n * The research-informed content of a catalog, seeded from EVERY RESEARCH_AGENT entry:\n *\n * - a research entry's OWN declared outputs (none today; a research step that wrote a family would fill it from the web);\n * - for every composite admitting a research child, each OTHER child's outputs, attributed to the research children\n * that fed them. A child that is itself a composite passes the research evidence on to its own children (step values\n * flow down a choreography), so its whole subtree is tainted.\n *\n * Pure, so it can be pinned on a fixture catalog.\n *\n * assurance-control: WILDO.SOFTWARE.AI_PRODUCED_CHANGE_CONTROL — which decided elements are third-party is derived from the compiled catalog, seeded from every research step, never listed.\n */\nexport function deriveResearchInformedContent(entries: readonly ResearchCatalogEntry[]): ResearchInformedContent {\n const byRef = new Map(entries.map((entry) => [entry.ref, entry] as const));\n const families = new Map<string, Set<string>>();\n const aspects = new Map<string, Set<string>>();\n const researchSteps: string[] = [];\n const attribute = (into: Map<string, Set<string>>, key: string, researchRefs: readonly string[]) => {\n const set = into.get(key) ?? new Set<string>();\n researchRefs.forEach((ref) => set.add(ref));\n into.set(key, set);\n };\n const taintOutputs = (entry: ResearchCatalogEntry, researchRefs: readonly string[]) => {\n for (const output of entry.outputs) {\n if (output.aspects !== undefined) output.aspects.forEach((aspect) => attribute(aspects, aspect, researchRefs));\n else attribute(families, output.family, researchRefs);\n }\n };\n const taintSubtree = (ref: string, researchRefs: readonly string[], seen: Set<string>) => {\n if (seen.has(ref)) return;\n seen.add(ref);\n const entry = byRef.get(ref);\n // A research child's own outputs are tainted by the seed below, under its own ref.\n if (entry === undefined || entry.executor === MetaWorkflow_Executor.RESEARCH_AGENT) return;\n taintOutputs(entry, researchRefs);\n entry.admits.forEach((child) => taintSubtree(child, researchRefs, seen));\n };\n for (const entry of entries) {\n if (entry.executor !== MetaWorkflow_Executor.RESEARCH_AGENT) continue;\n researchSteps.push(entry.ref);\n taintOutputs(entry, [entry.ref]);\n }\n for (const composite of entries) {\n const researchRefs = composite.admits.filter((child) => byRef.get(child)?.executor === MetaWorkflow_Executor.RESEARCH_AGENT);\n if (researchRefs.length === 0) continue;\n const seen = new Set<string>();\n for (const childRef of composite.admits) taintSubtree(childRef, researchRefs, seen);\n }\n const freeze = (map: Map<string, Set<string>>) => new Map([...map].map(([key, refs]) => [key, [...refs].sort()] as const));\n const sortedSteps = researchSteps.sort();\n return {\n families: freeze(families),\n aspects: freeze(aspects),\n researchSteps: sortedSteps,\n ...(sortedSteps.length > 0\n ? { reading: ResearchProvenanceCatalogReading.READ }\n : { reading: ResearchProvenanceCatalogReading.NO_RESEARCH_STEP, unreadableReason: 'The compiled playbook catalog names no research step, so which elements came from web research is unknown.' }),\n };\n}\n\nlet compiledResearchInformedContent: ResearchInformedContent | undefined;\n\n/**\n * The derivation over a catalog loader, never throwing: a loader that throws is an UNREADABLE reading, which marks every\n * element third-party, so a misread catalog can neither stop a dispatch nor pass research text as trusted.\n *\n * assurance-control: WILDO.SOFTWARE.AI_PRODUCED_CHANGE_CONTROL — a catalog that cannot be read marks every routed element third-party; it never stops the dispatch.\n */\nexport function readResearchInformedContent(loadEntries: () => readonly ResearchCatalogEntry[]): ResearchInformedContent {\n try {\n return deriveResearchInformedContent(loadEntries());\n } catch (error) {\n const message = error instanceof Error && error.message.trim().length > 0 ? error.message : String(error);\n return {\n families: new Map(),\n aspects: new Map(),\n researchSteps: [],\n reading: ResearchProvenanceCatalogReading.UNREADABLE,\n unreadableReason: `The compiled playbook catalog could not be read (${message || 'no message'}), so which elements came from web research is unknown.`,\n };\n }\n}\n\n/**\n * The derivation over the compiled catalog this companion ships with. A READ answer is kept for the process: the catalog\n * is a packaged artifact, and it changes only when the companion is redelivered, which restarts it. Any other answer is\n * not kept, so a transient failure is retried by the next brief.\n */\nexport function readCompiledResearchInformedContent(): ResearchInformedContent {\n if (compiledResearchInformedContent !== undefined) return compiledResearchInformedContent;\n const content = readResearchInformedContent(() => listFrameworkKnowledgePlaybooks().flatMap((entry) => {\n const read = readResearchCatalogEntry(getFrameworkKnowledgePlaybook(entry.ref)?.playbook);\n return read ? [read] : [];\n }));\n if (content.reading === ResearchProvenanceCatalogReading.READ) compiledResearchInformedContent = content;\n return content;\n}\n\n/**\n * The research playbooks that informed an element of this family and aspect; `undefined` when none did (the element is\n * trusted). When the catalog could not be read, every element answers `[]`: third-party, provenance unknown.\n */\nexport function researchProvenanceOf(content: ResearchInformedContent, family: string, aspectKey: string): readonly string[] | undefined {\n if (content.reading !== ResearchProvenanceCatalogReading.READ) return [];\n return content.aspects.get(aspectKey) ?? content.families.get(family);\n}\n\n"]}
|
|
1
|
+
{"version":3,"file":"framework-knowledge.research-provenance.js","sourceRoot":"","sources":["../../src/framework-knowledge.research-provenance.ts"],"names":[],"mappings":"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","sourcesContent":["import { MetaWorkflow_Executor, ResearchProvenanceCatalogReading } from '@wildo-ai/saas-models/meta-workflows';\nimport { getFrameworkKnowledgePlaybook, listFrameworkKnowledgePlaybooks } from './framework-knowledge.loader.js';\n\n/**\n * WHICH decided elements a coding agent's brief must treat as written outside the repository (#2846).\n *\n * ## The threat, and where it enters\n *\n * A research agent fetches web pages. Its evidence becomes a step value inside its composite, a sibling generation step\n * writes a specification family from it, and the family is committed (automatically, under the YOLO posture). A coding\n * brief then carries elements of that family: a website section draws on market proofs, a task serves a compliance\n * constraint. An instruction planted in a fetched page can therefore reach an agent that writes the application's code,\n * which is indirect prompt injection. Everything else a brief carries is written by the system or by the application's\n * own people: framework knowledge, the companion's derivations, the application's code, configuration and specifications.\n *\n * ## Derived from the catalog, never listed\n *\n * The elements at risk are the ones a step filled from research, and the compiled playbook catalog already says which\n * steps those are: a composite that admits a RESEARCH_AGENT child hands that child's evidence to its other children, so\n * whatever those children output is research-informed. Measured on the catalog of 2026-10-19 this yields the whole\n * `market-snapshot` family (`top_down.market-analysis`), the whole `brand-name-screening` family\n * (`top_down.brand-naming`), and the `vision.constraint` aspect alone (`top_down.compliance-analysis`, whose producer\n * declared it wrote only that slice). Since #3362 that producer writes `compliance-posture.constraint` instead, and the\n * derivation follows it with no edit here, which is the point of deriving it. A hand-kept list was rejected: a research composite added tomorrow would have to\n * remember to update it, and the failure is silent.\n *\n * ## The grain, and what is deliberately TRUSTED\n *\n * An output that declares `aspects` taints those aspects; one that does not taints its whole family. Transitive taint\n * is NOT followed: a step that reads a committed research-informed family (the requirements, the website plan) writes\n * from inside, the application's own decision about that material, so its output is trusted. Following taint through\n * every reader would mark nearly every family third-party and the class would stop discriminating. What closes the gap\n * instead is upstream (#2937): the companion screens a generation step's research-informed INPUT before the producing\n * model reads it, so a flagged instruction never reaches the model whose output is trusted, and with no classifier bound\n * the coding brief says its trusted text was derived from unscreened input.\n */\n\n/*\n * Owned here, beside the catalog it reads (#2846 review B2): the dev companion routes a brief's elements by it, and an\n * evidence collector runs the SAME function from the catalog an application's companion ships, rather than a copy that\n * could drift. Its reading vocabulary, `ResearchProvenanceCatalogReading`, lives in `@wildo-ai/saas-models/meta-workflows`\n * beside the brief's trust vocabulary, so the assurance basis can name it: `@wildo-ai/saas-specifications` cannot\n * depend on this package, which depends on it.\n */\n\n/** Research-informed content, as the catalog defines it. Each entry names the research playbooks that informed it. */\nexport interface ResearchInformedContent {\n /** Families a research-fed step writes WHOLE (its output declares no aspects). */\n readonly families: ReadonlyMap<string, readonly string[]>;\n /** Aspects a research-fed step writes, when its output names them. */\n readonly aspects: ReadonlyMap<string, readonly string[]>;\n /** Every RESEARCH_AGENT entry the catalog declares, sorted. */\n readonly researchSteps: readonly string[];\n readonly reading: ResearchProvenanceCatalogReading;\n /** Why the reading is not READ: operator-facing, recorded on the coding run's row. Present exactly when it is not. */\n readonly unreadableReason?: string;\n}\n\n/** What the derivation reads from one compiled catalog entry: nothing else. */\nexport interface ResearchCatalogEntry {\n readonly ref: string;\n readonly executor?: string;\n readonly outputs: readonly { readonly family: string; readonly aspects?: readonly string[] }[];\n readonly admits: readonly string[];\n}\n\n/** One compiled entry read structurally; `undefined` for something that is not an entry. */\nexport function readResearchCatalogEntry(raw: unknown): ResearchCatalogEntry | undefined {\n if (typeof raw !== 'object' || raw === null) return undefined;\n const entry = raw as { ref?: unknown; executor?: unknown; outputs?: unknown; method?: { choreography?: { admits?: unknown } } };\n if (typeof entry.ref !== 'string') return undefined;\n const outputs = Array.isArray(entry.outputs)\n ? entry.outputs.flatMap((output: unknown) => {\n const candidate = output as { family?: unknown; aspects?: unknown };\n if (typeof candidate?.family !== 'string') return [];\n const aspects = Array.isArray(candidate.aspects) ? candidate.aspects.filter((aspect): aspect is string => typeof aspect === 'string') : undefined;\n return [{ family: candidate.family, ...(aspects && aspects.length > 0 ? { aspects } : {}) }];\n })\n : [];\n const admits = entry.method?.choreography?.admits;\n return {\n ref: entry.ref,\n ...(typeof entry.executor === 'string' ? { executor: entry.executor } : {}),\n outputs,\n admits: Array.isArray(admits) ? admits.filter((child): child is string => typeof child === 'string') : [],\n };\n}\n\n/**\n * The research-informed content of a catalog, seeded from EVERY RESEARCH_AGENT entry:\n *\n * - a research entry's OWN declared outputs (none today; a research step that wrote a family would fill it from the web);\n * - for every composite admitting a research child, each OTHER child's outputs, attributed to the research children\n * that fed them. A child that is itself a composite passes the research evidence on to its own children (step values\n * flow down a choreography), so its whole subtree is tainted.\n *\n * Pure, so it can be pinned on a fixture catalog.\n *\n * assurance-control: WILDO.SOFTWARE.AI_PRODUCED_CHANGE_CONTROL — which decided elements are third-party is derived from the compiled catalog, seeded from every research step, never listed.\n */\nexport function deriveResearchInformedContent(entries: readonly ResearchCatalogEntry[]): ResearchInformedContent {\n const byRef = new Map(entries.map((entry) => [entry.ref, entry] as const));\n const families = new Map<string, Set<string>>();\n const aspects = new Map<string, Set<string>>();\n const researchSteps: string[] = [];\n const attribute = (into: Map<string, Set<string>>, key: string, researchRefs: readonly string[]) => {\n const set = into.get(key) ?? new Set<string>();\n researchRefs.forEach((ref) => set.add(ref));\n into.set(key, set);\n };\n const taintOutputs = (entry: ResearchCatalogEntry, researchRefs: readonly string[]) => {\n for (const output of entry.outputs) {\n if (output.aspects !== undefined) output.aspects.forEach((aspect) => attribute(aspects, aspect, researchRefs));\n else attribute(families, output.family, researchRefs);\n }\n };\n const taintSubtree = (ref: string, researchRefs: readonly string[], seen: Set<string>) => {\n if (seen.has(ref)) return;\n seen.add(ref);\n const entry = byRef.get(ref);\n // A research child's own outputs are tainted by the seed below, under its own ref.\n if (entry === undefined || entry.executor === MetaWorkflow_Executor.RESEARCH_AGENT) return;\n taintOutputs(entry, researchRefs);\n entry.admits.forEach((child) => taintSubtree(child, researchRefs, seen));\n };\n for (const entry of entries) {\n if (entry.executor !== MetaWorkflow_Executor.RESEARCH_AGENT) continue;\n researchSteps.push(entry.ref);\n taintOutputs(entry, [entry.ref]);\n }\n for (const composite of entries) {\n const researchRefs = composite.admits.filter((child) => byRef.get(child)?.executor === MetaWorkflow_Executor.RESEARCH_AGENT);\n if (researchRefs.length === 0) continue;\n const seen = new Set<string>();\n for (const childRef of composite.admits) taintSubtree(childRef, researchRefs, seen);\n }\n const freeze = (map: Map<string, Set<string>>) => new Map([...map].map(([key, refs]) => [key, [...refs].sort()] as const));\n const sortedSteps = researchSteps.sort();\n return {\n families: freeze(families),\n aspects: freeze(aspects),\n researchSteps: sortedSteps,\n ...(sortedSteps.length > 0\n ? { reading: ResearchProvenanceCatalogReading.READ }\n : { reading: ResearchProvenanceCatalogReading.NO_RESEARCH_STEP, unreadableReason: 'The compiled playbook catalog names no research step, so which elements came from web research is unknown.' }),\n };\n}\n\nlet compiledResearchInformedContent: ResearchInformedContent | undefined;\n\n/**\n * The derivation over a catalog loader, never throwing: a loader that throws is an UNREADABLE reading, which marks every\n * element third-party, so a misread catalog can neither stop a dispatch nor pass research text as trusted.\n *\n * assurance-control: WILDO.SOFTWARE.AI_PRODUCED_CHANGE_CONTROL — a catalog that cannot be read marks every routed element third-party; it never stops the dispatch.\n */\nexport function readResearchInformedContent(loadEntries: () => readonly ResearchCatalogEntry[]): ResearchInformedContent {\n try {\n return deriveResearchInformedContent(loadEntries());\n } catch (error) {\n const message = error instanceof Error && error.message.trim().length > 0 ? error.message : String(error);\n return {\n families: new Map(),\n aspects: new Map(),\n researchSteps: [],\n reading: ResearchProvenanceCatalogReading.UNREADABLE,\n unreadableReason: `The compiled playbook catalog could not be read (${message || 'no message'}), so which elements came from web research is unknown.`,\n };\n }\n}\n\n/**\n * The derivation over the compiled catalog this companion ships with. A READ answer is kept for the process: the catalog\n * is a packaged artifact, and it changes only when the companion is redelivered, which restarts it. Any other answer is\n * not kept, so a transient failure is retried by the next brief.\n */\nexport function readCompiledResearchInformedContent(): ResearchInformedContent {\n if (compiledResearchInformedContent !== undefined) return compiledResearchInformedContent;\n const content = readResearchInformedContent(() => listFrameworkKnowledgePlaybooks().flatMap((entry) => {\n const read = readResearchCatalogEntry(getFrameworkKnowledgePlaybook(entry.ref)?.playbook);\n return read ? [read] : [];\n }));\n if (content.reading === ResearchProvenanceCatalogReading.READ) compiledResearchInformedContent = content;\n return content;\n}\n\n/**\n * The research playbooks that informed an element of this family and aspect; `undefined` when none did (the element is\n * trusted). When the catalog could not be read, every element answers `[]`: third-party, provenance unknown.\n */\nexport function researchProvenanceOf(content: ResearchInformedContent, family: string, aspectKey: string): readonly string[] | undefined {\n if (content.reading !== ResearchProvenanceCatalogReading.READ) return [];\n return content.aspects.get(aspectKey) ?? content.families.get(family);\n}\n\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
|
|
1
|
+
{"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
|
package/dist/esm/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4BAA4B,CAAC"}
|
package/dist/esm/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4BAA4B,CAAC","sourcesContent":["export * from './framework-knowledge.schemas.js';\nexport * from './framework-knowledge.definitions.js';\nexport * from './framework-knowledge.loader.js';\nexport * from './framework-knowledge.research-provenance.js';\nexport * from './source-anchor-grammar.js';\n"]}
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
*/
|
|
19
19
|
export declare const playbookDefinition: {
|
|
20
20
|
readonly ref: "bottom_up.assemble-verify";
|
|
21
|
-
readonly version: "0.4.
|
|
21
|
+
readonly version: "0.4.3";
|
|
22
22
|
readonly phase: "bottom_up";
|
|
23
|
-
readonly intent: "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over EVERY workspace package the application has (specifications, shared-lib, backend-api, frontend, and the website, technical documentation site, workers and minions it composed), derived from those packages rather than listed, OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty: the check set is the whole-application TYPECHECK across every package — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in every package and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. Since #2228 it also asks the two questions a typecheck cannot: does each optional site BUILD (the website's `astro build`, the documentation portal's `docusaurus build`; an absent package answers 'nothing to build'), and does the configuration pass `wildo config validate` (errors fail, warnings do not, a missing CLI is 'we could not ask'); and it asks the RUNNING backend's readiness and renders the frontend in a browser, each reported unrun rather than passed when the stack is not up. Since #2404 it also builds the resources registry offline, as the backend's startup does (`check:resources-registry-init`), so a resource configuration the engine refuses at start is named before the running backend is asked. Since #2784 it also holds the website's drawn demos to the application (`check:website-demo-facts`), because a later resource change can make a landed drawing untrue. The whole test suite and OpenAPI/docs regeneration are NOT in this set.";
|
|
23
|
+
readonly intent: "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over EVERY workspace package the application has (specifications, shared-lib, backend-api, frontend, and the website, technical documentation site, workers and minions it composed), derived from those packages rather than listed, OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty: the check set is the whole-application TYPECHECK across every package — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in every package and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. Since #2228 it also asks the two questions a typecheck cannot: does each optional site BUILD (the website's `astro build`, the documentation portal's `docusaurus build`; an absent package answers 'nothing to build'), and does the configuration pass `wildo config validate` (errors fail, warnings do not, a missing CLI is 'we could not ask'); and it asks the RUNNING backend's readiness and renders the frontend in a browser, each reported unrun rather than passed when the stack is not up. Since #2404 it also builds the resources registry offline, as the backend's startup does (`check:resources-registry-init`), so a resource configuration the engine refuses at start is named before the running backend is asked. Since #2784 it also holds the website's drawn demos to the application (`check:website-demo-facts`), because a later resource change can make a landed drawing untrue. Since #3211 it also evaluates the specifications package as the companion does (`check:specification-exports`), so a specification its factory refuses — valid TypeScript, dropped from what the companion serves — is named. The whole test suite and OpenAPI/docs regeneration are NOT in this set.";
|
|
24
24
|
readonly preconditions: readonly [{
|
|
25
25
|
readonly kind: "artifact_exists";
|
|
26
26
|
readonly selector: {
|
|
@@ -38,7 +38,6 @@ export declare const playbookDefinition: {
|
|
|
38
38
|
readonly approval: "approve_result";
|
|
39
39
|
readonly budget: {
|
|
40
40
|
readonly maxRuns: 40;
|
|
41
|
-
readonly maxDurationMs: 3600000;
|
|
42
41
|
};
|
|
43
42
|
readonly onFailure: "keep_and_flag";
|
|
44
43
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;CAyBrB,CAAC"}
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
*/
|
|
19
19
|
export const playbookDefinition = {
|
|
20
20
|
"ref": "bottom_up.assemble-verify",
|
|
21
|
-
"version": "0.4.
|
|
21
|
+
"version": "0.4.3",
|
|
22
22
|
"phase": "bottom_up",
|
|
23
|
-
"intent": "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over EVERY workspace package the application has (specifications, shared-lib, backend-api, frontend, and the website, technical documentation site, workers and minions it composed), derived from those packages rather than listed, OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty: the check set is the whole-application TYPECHECK across every package — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in every package and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. Since #2228 it also asks the two questions a typecheck cannot: does each optional site BUILD (the website's `astro build`, the documentation portal's `docusaurus build`; an absent package answers 'nothing to build'), and does the configuration pass `wildo config validate` (errors fail, warnings do not, a missing CLI is 'we could not ask'); and it asks the RUNNING backend's readiness and renders the frontend in a browser, each reported unrun rather than passed when the stack is not up. Since #2404 it also builds the resources registry offline, as the backend's startup does (`check:resources-registry-init`), so a resource configuration the engine refuses at start is named before the running backend is asked. Since #2784 it also holds the website's drawn demos to the application (`check:website-demo-facts`), because a later resource change can make a landed drawing untrue. The whole test suite and OpenAPI/docs regeneration are NOT in this set.",
|
|
23
|
+
"intent": "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over EVERY workspace package the application has (specifications, shared-lib, backend-api, frontend, and the website, technical documentation site, workers and minions it composed), derived from those packages rather than listed, OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty: the check set is the whole-application TYPECHECK across every package — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in every package and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. Since #2228 it also asks the two questions a typecheck cannot: does each optional site BUILD (the website's `astro build`, the documentation portal's `docusaurus build`; an absent package answers 'nothing to build'), and does the configuration pass `wildo config validate` (errors fail, warnings do not, a missing CLI is 'we could not ask'); and it asks the RUNNING backend's readiness and renders the frontend in a browser, each reported unrun rather than passed when the stack is not up. Since #2404 it also builds the resources registry offline, as the backend's startup does (`check:resources-registry-init`), so a resource configuration the engine refuses at start is named before the running backend is asked. Since #2784 it also holds the website's drawn demos to the application (`check:website-demo-facts`), because a later resource change can make a landed drawing untrue. Since #3211 it also evaluates the specifications package as the companion does (`check:specification-exports`), so a specification its factory refuses — valid TypeScript, dropped from what the companion serves — is named. The whole test suite and OpenAPI/docs regeneration are NOT in this set.",
|
|
24
24
|
"preconditions": [
|
|
25
25
|
{ "kind": "artifact_exists", "selector": { "family": "build-plan" } }
|
|
26
26
|
],
|
|
@@ -35,17 +35,9 @@ export const playbookDefinition = {
|
|
|
35
35
|
},
|
|
36
36
|
"executor": "deterministic_cli",
|
|
37
37
|
"approval": "approve_result",
|
|
38
|
-
|
|
39
|
-
* Token and model-call ceilings are OMITTED, not zeroed.
|
|
40
|
-
*
|
|
41
|
-
* Every field here is optional, and this tier makes no model calls at all — it runs typechecks in
|
|
42
|
-
* a subprocess. Declaring `maxModelCalls: 0` is rejected by the schema (positive only), and
|
|
43
|
-
* declaring `1` to satisfy it would state a ceiling nobody chose for a resource that is never
|
|
44
|
-
* consumed. What IS bounded is wall-clock and how many times the step may run.
|
|
45
|
-
*/
|
|
38
|
+
// How many times the step may run (#1344). It makes no model call: it runs typechecks in a subprocess.
|
|
46
39
|
"budget": {
|
|
47
|
-
"maxRuns": 40
|
|
48
|
-
"maxDurationMs": 3600000
|
|
40
|
+
"maxRuns": 40
|
|
49
41
|
},
|
|
50
42
|
"onFailure": "keep_and_flag",
|
|
51
43
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,2mGAA2mG;IACrnG,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;KACtE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,YAAY,EAAE;KAC3B;IACD,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE;QACR,WAAW,EAAE;YACX,iCAAiC;SAClC;KACF;IACD,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B,uGAAuG;IACvG,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;KACd;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for topic 7 — the app-wide assemble/verify step.\n *\n * REBUILT rather than restored (issue #147). A playbook of this ref existed from\n * 2026-07-10 and was deleted on 2026-08-25 with the app-creation digest\n * demolition; the question it asked went with it, even though answering \"does\n * the built application assemble?\" needs no digests. Restoring it verbatim was\n * rejected: it declared the retired `COMPOSITE` executor, depended on two\n * families the demolition removed (`foundation-manifest`, `build-verification`),\n * and its method was explicit that NONE of its checks were actually run by the\n * runner — `// TODO CLI COMMAND:` placeholders and \"companion affordances that\n * do not exist yet\".\n *\n * What is different now is that the checks RUN. `DETERMINISTIC_CLI` is honoured\n * by the runtime as of #147, and the check refs below resolve through the same\n * closed `APPLICATION_CODING_TASK_VERIFICATION_CATALOG` a coding task uses, so\n * an unknown ref is refused rather than silently skipped.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.assemble-verify\",\n \"version\": \"0.4.3\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over EVERY workspace package the application has (specifications, shared-lib, backend-api, frontend, and the website, technical documentation site, workers and minions it composed), derived from those packages rather than listed, OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty: the check set is the whole-application TYPECHECK across every package — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in every package and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. Since #2228 it also asks the two questions a typecheck cannot: does each optional site BUILD (the website's `astro build`, the documentation portal's `docusaurus build`; an absent package answers 'nothing to build'), and does the configuration pass `wildo config validate` (errors fail, warnings do not, a missing CLI is 'we could not ask'); and it asks the RUNNING backend's readiness and renders the frontend in a browser, each reported unrun rather than passed when the stack is not up. Since #2404 it also builds the resources registry offline, as the backend's startup does (`check:resources-registry-init`), so a resource configuration the engine refuses at start is named before the running backend is asked. Since #2784 it also holds the website's drawn demos to the application (`check:website-demo-facts`), because a later resource change can make a landed drawing untrue. Since #3211 it also evaluates the specifications package as the companion does (`check:specification-exports`), so a specification its factory refuses — valid TypeScript, dropped from what the companion serves — is named. The whole test suite and OpenAPI/docs regeneration are NOT in this set.\",\n \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"build-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"build-plan\" }\n ],\n \"outputs\": [],\n \"method\": {\n \"skillRefs\": [\n \"application-database-migrations\"\n ]\n },\n \"executor\": \"deterministic_cli\",\n \"approval\": \"approve_result\",\n // How many times the step may run (#1344). It makes no model call: it runs typechecks in a subprocess.\n \"budget\": {\n \"maxRuns\": 40\n },\n \"onFailure\": \"keep_and_flag\",\n} as const;\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.build/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqI9B,CAAC"}
|
|
@@ -94,7 +94,7 @@ import { MetaWorkflow_InputRender, MetaWorkflow_Phase, } from '@wildo-ai/saas-sp
|
|
|
94
94
|
*/
|
|
95
95
|
export const playbookDefinition = {
|
|
96
96
|
ref: 'bottom_up.build',
|
|
97
|
-
version: '0.
|
|
97
|
+
version: '0.2.0',
|
|
98
98
|
phase: MetaWorkflow_Phase.BOTTOM_UP,
|
|
99
99
|
intent: 'Drive the BUILD of the application as one lane: decompose the accepted conception into a build plan, dispatch the plan\'s ready tasks in parallel waves — up to the application\'s build parallelism at once (5 by default; 1 means one at a time), coding runs and the companion\'s own generation steps alike — until every task has landed, then assemble and verify the built application, and read its maturity against the requirements it was asked to satisfy. An umbrella: it authors nothing itself; every child declares what it needs and the runtime recomputes what may run after each round. The build plan is decomposed ONCE unless its inputs have moved since it landed (the decomposer\'s own gate says so). Dispatch is one wave per run (the parallelism is inside it, so select ONE child per round) and lands no family, so it is offered every round: keep selecting it while the plan has tasks left, with each round\'s objective naming what the previous round\'s wave dispatched and how each run came out. Prefer build-dispatch to build-scale: both start the same wave. When dispatch reports the plan exhausted, select assemble-verify, and then the maturity reading. STOP on the reading: it is what this lane ends on, and it names a STAGE rather than a completion. Stop early only when dispatch reports a task that cannot land twice, or a parked question waits on the creator — say which. A parked coding question waits for the creator; run everything else.',
|
|
100
100
|
preconditions: [
|
|
@@ -150,6 +150,17 @@ export const playbookDefinition = {
|
|
|
150
150
|
'bottom_up.build-scale',
|
|
151
151
|
'bottom_up.build-dispatch',
|
|
152
152
|
'bottom_up.build-decompose',
|
|
153
|
+
/*
|
|
154
|
+
* The STAFFING step, admitted for one reason: a build task can make an expert's charter stale. The design-system
|
|
155
|
+
* task changes the design system the art director's and the design-system guardian's charters read, and the next
|
|
156
|
+
* generation step that seats them (the logo panel) is refused until they are derived again (#3244). Before this
|
|
157
|
+
* admission the refusal ended the lane and the build sat idle while the root ran other lanes (reference run
|
|
158
|
+
* 42218788356: 32 of 98 tasks, 40 idle minutes). Now the wave holds that step and keeps filling, and the dispatch
|
|
159
|
+
* child runs this staffing step itself after its wave (`staffingRepair`). Admitted so the lane's write scope
|
|
160
|
+
* claims the charters: the conception lane admits it too, so the two lanes never share a root round and never
|
|
161
|
+
* derive a charter at the same time.
|
|
162
|
+
*/
|
|
163
|
+
'top_down.expert-personas',
|
|
153
164
|
],
|
|
154
165
|
/*
|
|
155
166
|
* The schema's ceiling, and for this lane it is the BINDING bound: one round per wave (per task
|