@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
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/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.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/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- 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 +1 -1
- 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 +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- 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 +326 -8
- 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 +5 -3
- 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 +21 -14
- 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 +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- 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 +10 -5
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -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 +1 -1
- 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 +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- 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 +167 -9
- 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 +171 -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 +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- 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 +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- 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 +8 -7
- 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 +3 -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 +22 -3
- 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 +5 -3
- 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 +21 -12
- 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 +192 -27
- 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 +172 -33
- 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 +2 -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 +6 -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 +182 -5
- 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 +191 -5
- 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 +2 -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 +3 -2
- 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 +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -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 +2 -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 +2 -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 +6 -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 +2 -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 +2 -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 +2 -2
- 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 +7 -3
- 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 +32 -4
- 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 +27 -3
- 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 +2 -2
- 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 +4 -2
- 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 +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- 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 +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- 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 +187 -4
- 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 +6 -5
- 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 +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.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 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- 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/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -34,8 +34,149 @@ export enum BuildPlanTaskTargetKind {
|
|
|
34
34
|
RESOURCE_STAGE = 'RESOURCE_STAGE',
|
|
35
35
|
/** One relationship between two resources. */
|
|
36
36
|
RELATIONSHIP = 'RELATIONSHIP',
|
|
37
|
-
/** A companion-owned deterministic generation step (labels,
|
|
37
|
+
/** A companion-owned deterministic generation step (labels, email templates, logo or database migrations) interleaved by the build loop, never a coding-agent run. */
|
|
38
38
|
COMPANION_GENERATION_STEP = 'COMPANION_GENERATION_STEP',
|
|
39
|
+
/**
|
|
40
|
+
* Authoring one SHELL SURFACE's placement configuration from the accepted
|
|
41
|
+
* placement plan — the settings rail, the sidebar, the user menu or the
|
|
42
|
+
* command palette.
|
|
43
|
+
*
|
|
44
|
+
* Its own kind rather than a reuse of the neighbours, because none of them is
|
|
45
|
+
* true of it: it is not a MODULE or a RESOURCE_STAGE (it is application-wide
|
|
46
|
+
* and belongs to no resource), not a RELATIONSHIP, and emphatically not a
|
|
47
|
+
* COMPANION_GENERATION_STEP — that kind is documented as "never a coding-agent
|
|
48
|
+
* run" and writing `settings-hub.config.ts` is exactly a coding-agent run.
|
|
49
|
+
* Borrowing one would hand the host the wrong mutation scope and the wrong
|
|
50
|
+
* verification, which is what the closed vocabulary exists to prevent.
|
|
51
|
+
*/
|
|
52
|
+
SHELL_PLACEMENT = 'SHELL_PLACEMENT',
|
|
53
|
+
/*
|
|
54
|
+
* THE NON-RESOURCE SURFACES (#1490). Until 2026-09-22 the five kinds above were the whole
|
|
55
|
+
* vocabulary, and every one of them is about a resource or the shell placement of one. The
|
|
56
|
+
* decompose method meanwhile told the planner to emit tasks for views, navigation, the design
|
|
57
|
+
* system, custom components, PDF templates, workers, minions, providers, the website and the
|
|
58
|
+
* documentation — surfaces the framework's own composition scenarios and 85 of its 111 skills
|
|
59
|
+
* already build. A task for any of them had no kind to declare, so it either declared none
|
|
60
|
+
* (landing as RAN-not-PROVEN forever) or borrowed `MODULE` with a product the module scope could
|
|
61
|
+
* not prove. The members below are those surfaces, one per write scope the host can derive.
|
|
62
|
+
*/
|
|
63
|
+
/**
|
|
64
|
+
* The FRONTEND and SPECIFICATION layers of one module — its composite, custom and chart views,
|
|
65
|
+
* its custom components and their specifications.
|
|
66
|
+
*
|
|
67
|
+
* Narrower than `MODULE` on purpose: a view task never touches `shared-lib` or `backend-api`, so
|
|
68
|
+
* handing it the four-layer scope also hands it four typechecks and the FK sweep for a change
|
|
69
|
+
* that can only break the frontend and the specifications package.
|
|
70
|
+
*/
|
|
71
|
+
MODULE_FRONTEND = 'MODULE_FRONTEND',
|
|
72
|
+
/**
|
|
73
|
+
* The BACKEND layer of one module beside its shared-lib declarations — PDF templates and their
|
|
74
|
+
* bindings, backend addons (services, controllers, flows-actors), email definitions.
|
|
75
|
+
*
|
|
76
|
+
* Shared-lib is in scope because a PDF template is bound to a resource FIELD the config declares
|
|
77
|
+
* (`generatedSummaryPdf`), and a backend addon usually declares its contract there first.
|
|
78
|
+
*/
|
|
79
|
+
MODULE_BACKEND = 'MODULE_BACKEND',
|
|
80
|
+
/**
|
|
81
|
+
* ONE application-wide frontend configuration surface — navigation, the design system, the app
|
|
82
|
+
* shell's composition, the global views — named by {@link FrontendConfigSurface}.
|
|
83
|
+
*
|
|
84
|
+
* Distinct from {@link SHELL_PLACEMENT}, which authors the placement plan's decisions into the
|
|
85
|
+
* shell files: a placement puts a decided subject in a decided group, while this kind COMPOSES
|
|
86
|
+
* the surface itself (which sidebar sections exist, which transitions the primary zone uses,
|
|
87
|
+
* which palette the product carries). Same file for `APP_SHELL`, different question.
|
|
88
|
+
*/
|
|
89
|
+
APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',
|
|
90
|
+
/** The marketing website workspace (`website/`), composed by the `add-website` scenario. Pages and sections are its products. */
|
|
91
|
+
WEBSITE = 'WEBSITE',
|
|
92
|
+
/**
|
|
93
|
+
* The technical-documentation workspace (`technical-doc/`) and the specification package's
|
|
94
|
+
* `technical-documentation/` declarations that feed it. Its generated tree is never written by a
|
|
95
|
+
* task: the companion publishes into it, and the coding policy prohibits it by prefix.
|
|
96
|
+
*/
|
|
97
|
+
TECHNICAL_DOCUMENTATION = 'TECHNICAL_DOCUMENTATION',
|
|
98
|
+
/** One worker package (`workers/<workerRef>/`), Node or Rust, plus its declaration in the SaaS config. */
|
|
99
|
+
WORKER = 'WORKER',
|
|
100
|
+
/** One cron minion package (`minions/<minionRef>/`) plus its declaration in the SaaS config. */
|
|
101
|
+
MINION = 'MINION',
|
|
102
|
+
/**
|
|
103
|
+
* Declaring one provider in the application — the SaaS config's provider scopes, the backend
|
|
104
|
+
* package dependency, the frontend provider module and its companion contribution.
|
|
105
|
+
*
|
|
106
|
+
* Application-wide by construction: a provider binding names no module, and the four files it
|
|
107
|
+
* may touch are the same for every provider.
|
|
108
|
+
*/
|
|
109
|
+
PROVIDER_BINDING = 'PROVIDER_BINDING',
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* WHICH application-wide frontend configuration surface a task composes — one file each, in
|
|
114
|
+
* `frontend/src/config/`, and the coding policy resolves the member to that file exactly as
|
|
115
|
+
* `SHELL_PLACEMENT` resolves a `PlacementSurface`.
|
|
116
|
+
*
|
|
117
|
+
* Its own vocabulary rather than a reuse of `PlacementSurface`: a placement surface is WHERE a
|
|
118
|
+
* subject sits in the shell (settings hub, sidebar, user menu, command palette), and three of
|
|
119
|
+
* those live in one file. A configuration surface is WHICH FILE a composition task authors, and
|
|
120
|
+
* navigation and the design system are not places anything is placed.
|
|
121
|
+
*/
|
|
122
|
+
export enum FrontendConfigSurface {
|
|
123
|
+
/** `frontend/src/config/navigation.config.ts` — zones, transitions, overlay appearance. */
|
|
124
|
+
NAVIGATION = 'NAVIGATION',
|
|
125
|
+
/** `frontend/src/config/design-system.config.ts` — palette, typography, shell appearance from the brand's visual tone. */
|
|
126
|
+
DESIGN_SYSTEM = 'DESIGN_SYSTEM',
|
|
127
|
+
/** `frontend/src/config/app-shell.config.ts` — top bar, sidebar sections, quick switcher: the shell's COMPOSITION, not a placement into it. */
|
|
128
|
+
APP_SHELL = 'APP_SHELL',
|
|
129
|
+
/** `frontend/src/config/global-views.config.ts` — the application-level launcher and view registrations. */
|
|
130
|
+
GLOBAL_VIEWS = 'GLOBAL_VIEWS',
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* The two shapes of guidance an application gives a person, and the file each is declared in.
|
|
135
|
+
*
|
|
136
|
+
* They are distinct because they are found differently: an onboarding DOCUMENT is embedded in a
|
|
137
|
+
* screen (`EmbedOnboarding`) and is there whenever that screen is, while a guidance FLOW is started
|
|
138
|
+
* by an event and shows once. Both are listed on the owning frontend module — `onboardingViews` and
|
|
139
|
+
* `guidanceFlows`. Each kind has a CONVENTIONAL definitions file, which the authoring skill teaches
|
|
140
|
+
* and a landing probe reads for the declared ref (alongside the module's `index.ts`, where a small
|
|
141
|
+
* module may declare inline). A convention for generated applications: a hand-authored application
|
|
142
|
+
* may keep its declarations elsewhere, and then simply is not probed by a build plan.
|
|
143
|
+
*/
|
|
144
|
+
export enum ApplicationGuidanceKind {
|
|
145
|
+
/** `frontend/src/modules/<m>/app-level-views/onboarding-views.definitions.ts` — an embedded onboarding document. */
|
|
146
|
+
ONBOARDING_DOCUMENT = 'ONBOARDING_DOCUMENT',
|
|
147
|
+
/** `frontend/src/modules/<m>/app-level-views/guidance-flows.definitions.ts` — a triggered guidance flow. */
|
|
148
|
+
GUIDANCE_FLOW = 'GUIDANCE_FLOW',
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* The two worker runtimes the framework composes (`add-worker-node`, `add-worker-rust`). The
|
|
153
|
+
* runtime decides the entry file a landing probe reads and whether a typecheck exists to run: a
|
|
154
|
+
* Node worker is verified by its package typecheck, a Rust worker has no TypeScript to check and
|
|
155
|
+
* the policy says so rather than inventing a command.
|
|
156
|
+
*
|
|
157
|
+
* Not the SaaS config's `WorkerRuntime`, which is a free-form `{ type, language }` pair an
|
|
158
|
+
* application authors for deployment; this is the closed set a creation run can COMPOSE.
|
|
159
|
+
*/
|
|
160
|
+
export enum BuildPlanWorkerRuntime {
|
|
161
|
+
NODE = 'NODE',
|
|
162
|
+
RUST = 'RUST',
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* WHERE a provider is bound — which runtime owner's scope its declaration lands in. Each member
|
|
167
|
+
* is a different file, so a probe and a write grant both derive from it.
|
|
168
|
+
*
|
|
169
|
+
* Named after the SaaS config's own scope keys (`providers.scopes.backend`, `.companion`,
|
|
170
|
+
* `.frontendServices.app`, `.frontendServices.website`), which the `add-provider` and
|
|
171
|
+
* `add-file-picker-provider` scenarios write. Minion and worker scopes are deliberately absent:
|
|
172
|
+
* a provider reaching a minion is declared on that minion's own `providers` block and belongs to
|
|
173
|
+
* the {@link BuildPlanTaskTargetKind.MINION} task that builds it.
|
|
174
|
+
*/
|
|
175
|
+
export enum ProviderBindingScope {
|
|
176
|
+
BACKEND = 'BACKEND',
|
|
177
|
+
COMPANION = 'COMPANION',
|
|
178
|
+
FRONTEND_APP = 'FRONTEND_APP',
|
|
179
|
+
WEBSITE = 'WEBSITE',
|
|
39
180
|
}
|
|
40
181
|
|
|
41
182
|
/** The per-resource build stages, in their fixed order. */
|
|
@@ -47,6 +188,34 @@ export enum BuildPlanResourceStage {
|
|
|
47
188
|
}
|
|
48
189
|
|
|
49
190
|
const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* The governed document a task produces, named as a COMPLIANCE-DOCUMENT CANDIDATE names it:
|
|
194
|
+
* `document:<namespace>.<id>`, e.g. `document:public.privacy-notice`.
|
|
195
|
+
*
|
|
196
|
+
* **This field was `SlugSchema`, and a slug cannot name a governed document — so until 2026-09-16 no
|
|
197
|
+
* build plan in any application could declare a document the engine catalog defines.** A slug forbids
|
|
198
|
+
* the colon and the dot, the catalog's definitions are `document-definition:public.privacy-notice`,
|
|
199
|
+
* and `selectAssuranceDocumentBlueprintForDocumentRef` joins the two namespaces by exact suffix — so
|
|
200
|
+
* every authored `documentRef` resolved to NO blueprint, and a blueprint is what says which sections,
|
|
201
|
+
* facts and claim guards the document owes. The two vocabularies were disjoint by construction.
|
|
202
|
+
*
|
|
203
|
+
* The cost is measured rather than theoretical. Wonder CRM's plan declares two such products
|
|
204
|
+
* (`gdpr-data-handling-governance`, `terminal-access-governance`), neither of which names anything;
|
|
205
|
+
* the first was dispatched, and its agent spent a full turn establishing — with a positive control —
|
|
206
|
+
* that the document does not exist and could only be invented, which the authoring skill forbids.
|
|
207
|
+
*
|
|
208
|
+
* The bare slug is STILL ACCEPTED, and that is deliberate rather than tidiness left undone: tightening
|
|
209
|
+
* this to the namespaced form alone would make every already-accepted plan carrying one fail to parse,
|
|
210
|
+
* and a build plan that cannot be READ stops the whole lane — the gate
|
|
211
|
+
* `application-creation-directive.md` forbids, for a task nobody can fix by re-running anything. A slug
|
|
212
|
+
* simply resolves to no blueprint, so the dispatcher skips that task with a message naming the ref,
|
|
213
|
+
* and the rest of the plan proceeds.
|
|
214
|
+
*/
|
|
215
|
+
const DocumentProductRefSchema = z.union([
|
|
216
|
+
z.string().regex(/^document:[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
217
|
+
SlugSchema,
|
|
218
|
+
]);
|
|
50
219
|
/**
|
|
51
220
|
* A skill ref is the skill's FOLDER id in the app-knowledge catalog, which is
|
|
52
221
|
* also its `SKILL.md` frontmatter `name` — one id, kebab-case. The host refuses
|
|
@@ -56,6 +225,283 @@ const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
|
56
225
|
const SkillRefSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
57
226
|
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
58
227
|
|
|
228
|
+
/**
|
|
229
|
+
* WHAT a build task PRODUCES — the artifact whose presence in the application
|
|
230
|
+
* proves the task is done.
|
|
231
|
+
*
|
|
232
|
+
* **This is not `target`, and the difference is the whole reason it exists.**
|
|
233
|
+
* `target` is a WRITE SCOPE: the host turns it into the path prefixes a run may
|
|
234
|
+
* mutate, and several tasks legitimately share one. `produces` is a PRODUCT
|
|
235
|
+
* IDENTITY: it says which artifact this task, and no other, is accountable for.
|
|
236
|
+
*
|
|
237
|
+
* Measured 2026-09-10 on Wonder CRM (issue #597): `build-task-pipeline-view`
|
|
238
|
+
* and `build-task-deal-follow-through-operation` carry BYTE-IDENTICAL targets
|
|
239
|
+
* (`{ kind: MODULE, moduleRef: 'deals' }`), and 7 of that plan's 42 tasks share
|
|
240
|
+
* 3 targets. Landing had been answered by narrowing the target to a module
|
|
241
|
+
* DIRECTORY — which `wildo compose` commits on day one, and which cannot tell
|
|
242
|
+
* two tasks apart even in principle. The loop reported 40 of 42 tasks landed
|
|
243
|
+
* while no coding task had ever run, so `dispatch-next` skipped every one of
|
|
244
|
+
* them and the phase-advance gate read a build that was all but complete.
|
|
245
|
+
*
|
|
246
|
+
* Like `target`, this stays SEMANTIC: a product names a resource, a field, a
|
|
247
|
+
* relationship or a view — never a path, and never a command. The host owns the
|
|
248
|
+
* translation from a product to the physical question it asks of the working
|
|
249
|
+
* tree, exactly as it owns the translation from a target kind to path prefixes.
|
|
250
|
+
* A model that could author the path could author its own mutation scope.
|
|
251
|
+
*/
|
|
252
|
+
export enum BuildPlanTaskProductKind {
|
|
253
|
+
/**
|
|
254
|
+
* Named fields on one resource's schema.
|
|
255
|
+
*
|
|
256
|
+
* The shape an ENRICHMENT task needs, and the reason a product cannot always
|
|
257
|
+
* be "a file": every resource file already exists, written by the scaffold
|
|
258
|
+
* with its self-described STARTER shape, so file presence answers nothing.
|
|
259
|
+
* The FIELDS are what the task adds.
|
|
260
|
+
*/
|
|
261
|
+
RESOURCE_SCHEMA_FIELDS = 'RESOURCE_SCHEMA_FIELDS',
|
|
262
|
+
/**
|
|
263
|
+
* One resource's declared operations — its registry presence, named by the verbs it gains.
|
|
264
|
+
*
|
|
265
|
+
* The VERBS, not the config file: `<r>.resources-config.ts` is written by the scaffold, so its
|
|
266
|
+
* existence is satisfied before any task runs. That is the exact shape of the defect this
|
|
267
|
+
* vocabulary replaces, and a kind that reproduced it would be worse than no kind at all.
|
|
268
|
+
*/
|
|
269
|
+
RESOURCE_REGISTRATION = 'RESOURCE_REGISTRATION',
|
|
270
|
+
/** One resource's frontend ui-behavior. */
|
|
271
|
+
RESOURCE_UI_BEHAVIOR = 'RESOURCE_UI_BEHAVIOR',
|
|
272
|
+
/**
|
|
273
|
+
* One resource's specification, named by the fields it documents.
|
|
274
|
+
*
|
|
275
|
+
* The FIELDS, for the same reason as {@link RESOURCE_REGISTRATION}: every resource is scaffolded
|
|
276
|
+
* with a `*.resource.specification.ts` documenting only the starter shape, so file existence
|
|
277
|
+
* proves nothing about the task that was meant to enrich it.
|
|
278
|
+
*/
|
|
279
|
+
RESOURCE_SPECIFICATION = 'RESOURCE_SPECIFICATION',
|
|
280
|
+
/** One relationship edge between two resources, named by the domain plan's `relationshipRef`. */
|
|
281
|
+
RESOURCE_RELATIONSHIP = 'RESOURCE_RELATIONSHIP',
|
|
282
|
+
/** One named custom operation on one resource. */
|
|
283
|
+
RESOURCE_OPERATION = 'RESOURCE_OPERATION',
|
|
284
|
+
/** One named application-level view. */
|
|
285
|
+
APPLICATION_VIEW = 'APPLICATION_VIEW',
|
|
286
|
+
/** One named governed application document (a compliance notice, a governance statement). */
|
|
287
|
+
APPLICATION_DOCUMENT = 'APPLICATION_DOCUMENT',
|
|
288
|
+
/** One application module, registered across the layer registries under one module identity. */
|
|
289
|
+
APPLICATION_MODULE = 'APPLICATION_MODULE',
|
|
290
|
+
/*
|
|
291
|
+
* THE NON-RESOURCE PRODUCTS (#1490). Each names an artifact of a surface the five target kinds
|
|
292
|
+
* above `MODULE_FRONTEND` could not express, and each is probed by the host from committed bytes —
|
|
293
|
+
* a declaration in the one file that registers it, never a directory a scenario already wrote.
|
|
294
|
+
*/
|
|
295
|
+
/**
|
|
296
|
+
* Named declarations in ONE application-wide frontend configuration file — a sidebar section
|
|
297
|
+
* ref the app shell gains, a zone the navigation config declares, a token the design system sets.
|
|
298
|
+
*
|
|
299
|
+
* The DECLARATIONS, never the file: every `frontend/src/config/*.config.ts` is written by
|
|
300
|
+
* `wildo init`, so its presence is true before any task runs. Same reasoning as
|
|
301
|
+
* {@link RESOURCE_SCHEMA_FIELDS}, one level up.
|
|
302
|
+
*/
|
|
303
|
+
APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',
|
|
304
|
+
/**
|
|
305
|
+
* One composite view of one resource — the cross-resource surface a resource's ui-behavior
|
|
306
|
+
* declares under `compositeViews`. Distinct from {@link APPLICATION_VIEW}, which is
|
|
307
|
+
* application-level and owned by a module rather than a resource.
|
|
308
|
+
*/
|
|
309
|
+
RESOURCE_COMPOSITE_VIEW = 'RESOURCE_COMPOSITE_VIEW',
|
|
310
|
+
/** One custom operation or execution view of one resource, bound in its ui-behavior. */
|
|
311
|
+
RESOURCE_CUSTOM_VIEW = 'RESOURCE_CUSTOM_VIEW',
|
|
312
|
+
/** One chart view of one resource, declared under its ui-behavior's `chartViews`. */
|
|
313
|
+
RESOURCE_CHART_VIEW = 'RESOURCE_CHART_VIEW',
|
|
314
|
+
/** One custom frontend component, registered by `componentRef` in the module's or the engine's registrations. */
|
|
315
|
+
CUSTOM_COMPONENT = 'CUSTOM_COMPONENT',
|
|
316
|
+
/**
|
|
317
|
+
* One milestone a module declares — the moment the application recognises and celebrates.
|
|
318
|
+
*
|
|
319
|
+
* Named by its identifier, which is what the module's `milestones.ts` declares
|
|
320
|
+
* (`first-project-created` is spelled `FIRST_PROJECT_CREATED` there). The module FILE is not the
|
|
321
|
+
* product: a module may carry milestones before this task runs, and only the identifier says this
|
|
322
|
+
* one landed.
|
|
323
|
+
*/
|
|
324
|
+
APPLICATION_MILESTONE = 'APPLICATION_MILESTONE',
|
|
325
|
+
/** One onboarding document or guidance flow a module declares, named by its ref. */
|
|
326
|
+
APPLICATION_GUIDANCE = 'APPLICATION_GUIDANCE',
|
|
327
|
+
/** One PDF template bound to one resource's generated-file field. */
|
|
328
|
+
PDF_TEMPLATE = 'PDF_TEMPLATE',
|
|
329
|
+
/**
|
|
330
|
+
* One worker's JOBS — the named handlers its entry file declares.
|
|
331
|
+
*
|
|
332
|
+
* The jobs, not the package: `add-worker-node` writes the package, so its directory proves
|
|
333
|
+
* nothing. What a coding task adds is behaviour, and behaviour is a symbol in the entry file.
|
|
334
|
+
*/
|
|
335
|
+
APPLICATION_WORKER = 'APPLICATION_WORKER',
|
|
336
|
+
/** One minion's BEHAVIOURS — the named tick handlers its entry file declares. Same reasoning as the worker. */
|
|
337
|
+
APPLICATION_MINION = 'APPLICATION_MINION',
|
|
338
|
+
/** One provider declared in one runtime owner's scope. */
|
|
339
|
+
PROVIDER_BINDING = 'PROVIDER_BINDING',
|
|
340
|
+
/** One website page, registered in the website root config by its manifest. */
|
|
341
|
+
WEBSITE_PAGE = 'WEBSITE_PAGE',
|
|
342
|
+
/** One section of one website page, declared in that page's sections file. */
|
|
343
|
+
WEBSITE_SECTION = 'WEBSITE_SECTION',
|
|
344
|
+
/**
|
|
345
|
+
* One authored documentation chapter — a consumer guide the specifications package declares
|
|
346
|
+
* for the documentation portal to publish (#874's publication input).
|
|
347
|
+
*/
|
|
348
|
+
DOCUMENTATION_CHAPTER = 'DOCUMENTATION_CHAPTER',
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
/**
|
|
352
|
+
* One artifact a task is accountable for. Closed by construction: a product the
|
|
353
|
+
* host cannot ask a question about is a product that can never be shown to have
|
|
354
|
+
* landed, so the vocabulary only grows alongside the resolver that answers it.
|
|
355
|
+
*/
|
|
356
|
+
export const BuildPlanTaskProductSchema = z.discriminatedUnion('kind', [
|
|
357
|
+
z.strictObject({
|
|
358
|
+
kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS).systemEnum('BuildPlanTaskProductKind'),
|
|
359
|
+
resourceRef: SlugSchema,
|
|
360
|
+
/**
|
|
361
|
+
* At least one field, because a task that enriches a schema with nothing is
|
|
362
|
+
* the vacuity this whole field exists to stop: it would land the moment the
|
|
363
|
+
* scaffold existed, which is the defect being fixed.
|
|
364
|
+
*/
|
|
365
|
+
fieldRefs: z.array(NonEmptyStringSchema).min(1),
|
|
366
|
+
}),
|
|
367
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_REGISTRATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
368
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema }),
|
|
369
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SPECIFICATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, fieldRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
370
|
+
z.strictObject({
|
|
371
|
+
kind: z.literal(BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP).systemEnum('BuildPlanTaskProductKind'),
|
|
372
|
+
relationshipRef: SlugSchema,
|
|
373
|
+
/*
|
|
374
|
+
* The two resources the edge relates, NAMED rather than parsed out of the ref.
|
|
375
|
+
*
|
|
376
|
+
* A ref is `<source>-<target>` by convention and that convention is not invertible:
|
|
377
|
+
* `next-step-deal` splits as (`next`, `step-deal`) or (`next-step`, `deal`) and only the domain
|
|
378
|
+
* plan knows which. The domain plan already carries both, so the plan passes them on instead of
|
|
379
|
+
* making the host guess — a host that guesses wrong probes for a resource that does not exist
|
|
380
|
+
* and reports the task permanently unlanded.
|
|
381
|
+
*/
|
|
382
|
+
sourceResourceRef: SlugSchema,
|
|
383
|
+
targetResourceRef: SlugSchema,
|
|
384
|
+
}),
|
|
385
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_OPERATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRef: SlugSchema }),
|
|
386
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_VIEW).systemEnum('BuildPlanTaskProductKind'), viewRef: SlugSchema }),
|
|
387
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_DOCUMENT).systemEnum('BuildPlanTaskProductKind'), documentRef: DocumentProductRefSchema }),
|
|
388
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MODULE).systemEnum('BuildPlanTaskProductKind'), moduleRef: SlugSchema }),
|
|
389
|
+
z.strictObject({
|
|
390
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG).systemEnum('BuildPlanTaskProductKind'),
|
|
391
|
+
configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),
|
|
392
|
+
/** At least one, for the same vacuity reason as a schema's `fieldRefs`: the file exists on day one. */
|
|
393
|
+
declarationRefs: z.array(NonEmptyStringSchema).min(1),
|
|
394
|
+
}),
|
|
395
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),
|
|
396
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),
|
|
397
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CHART_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, chartRef: SlugSchema }),
|
|
398
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.CUSTOM_COMPONENT).systemEnum('BuildPlanTaskProductKind'), componentRef: SlugSchema }),
|
|
399
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MILESTONE).systemEnum('BuildPlanTaskProductKind'), milestoneRef: SlugSchema }),
|
|
400
|
+
z.strictObject({
|
|
401
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_GUIDANCE).systemEnum('BuildPlanTaskProductKind'),
|
|
402
|
+
/** Which definitions file carries it — a document and a flow live in different ones. */
|
|
403
|
+
guidanceKind: z.enum(ApplicationGuidanceKind).systemEnum('ApplicationGuidanceKind'),
|
|
404
|
+
guidanceRef: SlugSchema,
|
|
405
|
+
}),
|
|
406
|
+
z.strictObject({
|
|
407
|
+
kind: z.literal(BuildPlanTaskProductKind.PDF_TEMPLATE).systemEnum('BuildPlanTaskProductKind'),
|
|
408
|
+
resourceRef: SlugSchema,
|
|
409
|
+
/** The generated-file FIELD the template is bound to (`generatedSummaryPdf`) — a symbol, so any spelling. */
|
|
410
|
+
templateRef: NonEmptyStringSchema,
|
|
411
|
+
}),
|
|
412
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_WORKER).systemEnum('BuildPlanTaskProductKind'), workerRef: SlugSchema, jobRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
413
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MINION).systemEnum('BuildPlanTaskProductKind'), minionRef: SlugSchema, behaviorRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
414
|
+
z.strictObject({
|
|
415
|
+
kind: z.literal(BuildPlanTaskProductKind.PROVIDER_BINDING).systemEnum('BuildPlanTaskProductKind'),
|
|
416
|
+
providerRef: SlugSchema,
|
|
417
|
+
scope: z.enum(ProviderBindingScope).systemEnum('ProviderBindingScope'),
|
|
418
|
+
}),
|
|
419
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_PAGE).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema }),
|
|
420
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_SECTION).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema, sectionRef: SlugSchema }),
|
|
421
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER).systemEnum('BuildPlanTaskProductKind'), chapterRef: SlugSchema }),
|
|
422
|
+
]);
|
|
423
|
+
export type BuildPlanTaskProduct = z.infer<typeof BuildPlanTaskProductSchema>;
|
|
424
|
+
|
|
425
|
+
/**
|
|
426
|
+
* Every artifact identity a product claims — one string per artifact, not one
|
|
427
|
+
* per product, because a product may claim several.
|
|
428
|
+
*
|
|
429
|
+
* `RESOURCE_SCHEMA_FIELDS` is why this returns a list. Two tasks may both enrich
|
|
430
|
+
* one resource's schema (a domain shape and a billing concern, say), and that is
|
|
431
|
+
* legitimate; what must never overlap is the FIELDS. Comparing whole products
|
|
432
|
+
* would refuse the legitimate pair, and comparing only the resource would let two
|
|
433
|
+
* tasks claim one field and make landing ambiguous again.
|
|
434
|
+
*
|
|
435
|
+
* Derived from the product's own members rather than stored, and total over the
|
|
436
|
+
* vocabulary, so a kind added tomorrow must state its identity here or fail to
|
|
437
|
+
* compile — it cannot be silently treated as equal to its siblings.
|
|
438
|
+
*/
|
|
439
|
+
export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): readonly string[] {
|
|
440
|
+
switch (product.kind) {
|
|
441
|
+
case BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS:
|
|
442
|
+
return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);
|
|
443
|
+
case BuildPlanTaskProductKind.RESOURCE_REGISTRATION:
|
|
444
|
+
return product.operationRefs.map((operationRef) => `${product.kind}:${product.resourceRef}:${operationRef}`);
|
|
445
|
+
case BuildPlanTaskProductKind.RESOURCE_SPECIFICATION:
|
|
446
|
+
return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);
|
|
447
|
+
case BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR:
|
|
448
|
+
return [`${product.kind}:${product.resourceRef}`];
|
|
449
|
+
case BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP:
|
|
450
|
+
return [`${product.kind}:${product.relationshipRef}`];
|
|
451
|
+
case BuildPlanTaskProductKind.RESOURCE_OPERATION:
|
|
452
|
+
return [`${product.kind}:${product.resourceRef}:${product.operationRef}`];
|
|
453
|
+
case BuildPlanTaskProductKind.APPLICATION_VIEW:
|
|
454
|
+
return [`${product.kind}:${product.viewRef}`];
|
|
455
|
+
case BuildPlanTaskProductKind.APPLICATION_DOCUMENT:
|
|
456
|
+
/*
|
|
457
|
+
* The ref AS AUTHORED, so a slug and a namespaced ref are different artifact identities even
|
|
458
|
+
* where they mean the same document — the duplicate-artifact refusal cannot see two tasks
|
|
459
|
+
* claiming one document if they spell it differently. Not normalisable: a slug carries no
|
|
460
|
+
* namespace, so nothing can recover `public.` from `privacy-notice`. It costs nothing today
|
|
461
|
+
* because a slug names no catalogued document at all, and the dispatcher skips such a task.
|
|
462
|
+
*/
|
|
463
|
+
return [`${product.kind}:${product.documentRef}`];
|
|
464
|
+
case BuildPlanTaskProductKind.APPLICATION_MODULE:
|
|
465
|
+
return [`${product.kind}:${product.moduleRef}`];
|
|
466
|
+
// One identity per DECLARATION, like schema fields: two tasks may compose one config file as
|
|
467
|
+
// long as they declare different things in it.
|
|
468
|
+
case BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG:
|
|
469
|
+
return product.declarationRefs.map((declarationRef) => `${product.kind}:${product.configSurface}:${declarationRef}`);
|
|
470
|
+
case BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW:
|
|
471
|
+
case BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW:
|
|
472
|
+
return [`${product.kind}:${product.resourceRef}:${product.viewRef}`];
|
|
473
|
+
case BuildPlanTaskProductKind.RESOURCE_CHART_VIEW:
|
|
474
|
+
return [`${product.kind}:${product.resourceRef}:${product.chartRef}`];
|
|
475
|
+
case BuildPlanTaskProductKind.CUSTOM_COMPONENT:
|
|
476
|
+
return [`${product.kind}:${product.componentRef}`];
|
|
477
|
+
case BuildPlanTaskProductKind.APPLICATION_MILESTONE:
|
|
478
|
+
return [`${product.kind}:${product.milestoneRef}`];
|
|
479
|
+
// The ref alone: a document and a flow sharing one ref is still one guidance identity, and the
|
|
480
|
+
// runtime keys a person's saved state by it — two artifacts claiming it would collide there too.
|
|
481
|
+
case BuildPlanTaskProductKind.APPLICATION_GUIDANCE:
|
|
482
|
+
return [`${product.kind}:${product.guidanceRef}`];
|
|
483
|
+
case BuildPlanTaskProductKind.PDF_TEMPLATE:
|
|
484
|
+
return [`${product.kind}:${product.resourceRef}:${product.templateRef}`];
|
|
485
|
+
case BuildPlanTaskProductKind.APPLICATION_WORKER:
|
|
486
|
+
return product.jobRefs.map((jobRef) => `${product.kind}:${product.workerRef}:${jobRef}`);
|
|
487
|
+
case BuildPlanTaskProductKind.APPLICATION_MINION:
|
|
488
|
+
return product.behaviorRefs.map((behaviorRef) => `${product.kind}:${product.minionRef}:${behaviorRef}`);
|
|
489
|
+
// The SCOPE is part of the identity: one provider bound on the backend and on the website is two artifacts.
|
|
490
|
+
case BuildPlanTaskProductKind.PROVIDER_BINDING:
|
|
491
|
+
return [`${product.kind}:${product.scope}:${product.providerRef}`];
|
|
492
|
+
case BuildPlanTaskProductKind.WEBSITE_PAGE:
|
|
493
|
+
return [`${product.kind}:${product.pageRef}`];
|
|
494
|
+
case BuildPlanTaskProductKind.WEBSITE_SECTION:
|
|
495
|
+
return [`${product.kind}:${product.pageRef}:${product.sectionRef}`];
|
|
496
|
+
case BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER:
|
|
497
|
+
return [`${product.kind}:${product.chapterRef}`];
|
|
498
|
+
default: {
|
|
499
|
+
const unhandled: never = product;
|
|
500
|
+
throw new Error(`Unhandled build-plan task product ${JSON.stringify(unhandled)}.`);
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
}
|
|
504
|
+
|
|
59
505
|
export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
60
506
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef: SlugSchema }),
|
|
61
507
|
z.strictObject({
|
|
@@ -71,9 +517,47 @@ export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
|
71
517
|
}),
|
|
72
518
|
z.strictObject({
|
|
73
519
|
kind: z.literal(BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP),
|
|
74
|
-
/** The companion generation step this task runs (e.g. labels,
|
|
520
|
+
/** The companion generation step this task runs (e.g. i18n-labels, email-templates); resolved by the companion, never by a coding agent. */
|
|
75
521
|
generationStepRef: SlugSchema,
|
|
76
522
|
}),
|
|
523
|
+
z.strictObject({
|
|
524
|
+
kind: z.literal(BuildPlanTaskTargetKind.SHELL_PLACEMENT),
|
|
525
|
+
/**
|
|
526
|
+
* Which shell surface this task authors — the placement family's OWN
|
|
527
|
+
* `PlacementSurface`, deliberately not a build-plan copy of it.
|
|
528
|
+
*
|
|
529
|
+
* A copy was written first and was a defect, caught by probing the landing
|
|
530
|
+
* renderer rather than by any test: `PlacementAddress` discriminates on
|
|
531
|
+
* `surface` with `z.literal(...)` per option, so only the VALUES survive into
|
|
532
|
+
* the schema, and the renderer resolves a discriminator by matching that value
|
|
533
|
+
* SET against the exported enums. Two enums with identical values made the
|
|
534
|
+
* match ambiguous, the renderer correctly refused to guess an owner, and the
|
|
535
|
+
* address discriminator became unnameable — a landed placement plan would have
|
|
536
|
+
* emitted `surface: "SETTINGS_HUB"` as a bare string instead of
|
|
537
|
+
* `PlacementSurface.SETTINGS_HUB`. One concept, one named source.
|
|
538
|
+
*/
|
|
539
|
+
surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),
|
|
540
|
+
}),
|
|
541
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_FRONTEND), moduleRef: SlugSchema }),
|
|
542
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_BACKEND), moduleRef: SlugSchema }),
|
|
543
|
+
z.strictObject({
|
|
544
|
+
kind: z.literal(BuildPlanTaskTargetKind.APPLICATION_FRONTEND_CONFIG),
|
|
545
|
+
configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),
|
|
546
|
+
}),
|
|
547
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.WEBSITE) }),
|
|
548
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.TECHNICAL_DOCUMENTATION) }),
|
|
549
|
+
z.strictObject({
|
|
550
|
+
kind: z.literal(BuildPlanTaskTargetKind.WORKER),
|
|
551
|
+
/** The worker's directory under `workers/` and its key in the SaaS config, in slug form. */
|
|
552
|
+
workerRef: SlugSchema,
|
|
553
|
+
runtime: z.enum(BuildPlanWorkerRuntime).systemEnum('BuildPlanWorkerRuntime'),
|
|
554
|
+
}),
|
|
555
|
+
z.strictObject({
|
|
556
|
+
kind: z.literal(BuildPlanTaskTargetKind.MINION),
|
|
557
|
+
/** The minion's directory under `minions/` and its key in the SaaS config, in slug form. */
|
|
558
|
+
minionRef: SlugSchema,
|
|
559
|
+
}),
|
|
560
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.PROVIDER_BINDING), providerRef: SlugSchema }),
|
|
77
561
|
]);
|
|
78
562
|
export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
79
563
|
|
|
@@ -91,16 +575,69 @@ export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
|
91
575
|
export const BuildPlanTaskSchema = z.strictObject({
|
|
92
576
|
/** `build-task-<slug>`, stamped by the trusted runtime. */
|
|
93
577
|
taskRef: z.string().regex(new RegExp(`^${BUILD_PLAN_TASK_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
94
|
-
/**
|
|
95
|
-
|
|
578
|
+
/**
|
|
579
|
+
* One sentence of intent: what this task delivers.
|
|
580
|
+
*
|
|
581
|
+
* Its OWN instance, not the file's shared leaf, which `templateRef` and the product ref lists also
|
|
582
|
+
* hold. A display decorator mutates the instance it is applied to, and the workbench gives those
|
|
583
|
+
* refs a receding identifier look, which the objective sentence then took too.
|
|
584
|
+
*/
|
|
585
|
+
objective: z.string().trim().min(1),
|
|
96
586
|
target: BuildPlanTaskTargetSchema,
|
|
97
|
-
/**
|
|
98
|
-
|
|
587
|
+
/**
|
|
588
|
+
* The artifacts this task is accountable for — what proves it done.
|
|
589
|
+
*
|
|
590
|
+
* Coding tasks should declare at least one product that composition did not already
|
|
591
|
+
* write. A target is a shared mutation scope; its scaffolded file is not evidence
|
|
592
|
+
* that this task's intended work exists. Products identify the output to probe.
|
|
593
|
+
*
|
|
594
|
+
* Empty declarations remain representable and produce the advisory
|
|
595
|
+
* `TASK_DECLARES_NO_PRODUCT`. The host may advance after a COMPLETED durable run,
|
|
596
|
+
* while naming the task in `unverifiableLandedTaskRefs`: it ran, but its output
|
|
597
|
+
* cannot be proven from a product declaration. An unexecuted task is not landed.
|
|
598
|
+
* This distinction avoids repeatedly dispatching the same unprovable task without
|
|
599
|
+
* presenting execution history as evidence that the intended product is correct.
|
|
600
|
+
*
|
|
601
|
+
* The ONE hard exception is a `COMPANION_GENERATION_STEP`, which must declare NONE.
|
|
602
|
+
* That kind already carries its own typed landed condition, owned by the
|
|
603
|
+
* generation-step service — a set computed asynchronously (planner units x
|
|
604
|
+
* enabled locales), and for the migration step a STATE rather than files. A
|
|
605
|
+
* product declared beside it would be read by nothing, which is the inert
|
|
606
|
+
* declaration this field exists to avoid. Enforced on the graph below, in both
|
|
607
|
+
* directions.
|
|
608
|
+
*/
|
|
609
|
+
produces: z.array(BuildPlanTaskProductSchema).default([]),
|
|
610
|
+
/**
|
|
611
|
+
* Exactly ONE functional topic this task belongs to.
|
|
612
|
+
*
|
|
613
|
+
* **It does NOT drive ordering** — this said "drives cross-app ordering" until 2026-08-30 and
|
|
614
|
+
* nothing ever ordered by it. Sequencing is `prerequisiteTaskRefs`, resolved by the host, and it
|
|
615
|
+
* is the only thing that decides what may run next.
|
|
616
|
+
*
|
|
617
|
+
* What it DOES: the dispatch host stamps it into the coding-agent's task payload beside
|
|
618
|
+
* `skillRefs`, so the agent is told which phase of building the application this task belongs to.
|
|
619
|
+
* That is context an LLM reads, not a value the runtime branches on — the distinction matters,
|
|
620
|
+
* because a reader who believes it orders will look here for a scheduling bug that lives in the
|
|
621
|
+
* prerequisite graph. See issue #124.
|
|
622
|
+
*/
|
|
623
|
+
functionalTopic: z.enum(MetaWorkflow_FunctionalTopic).systemEnum('MetaWorkflow_FunctionalTopic'),
|
|
99
624
|
/** Installed app-knowledge skill folders that carry the technical HOW; resolved via the skills router at dispatch. */
|
|
100
625
|
skillRefs: z.array(SkillRefSchema).min(1),
|
|
101
626
|
/** Task refs that must have landed first; resolved by the host, not solved by the model. */
|
|
102
627
|
prerequisiteTaskRefs: z.array(z.string()).default([]),
|
|
103
|
-
/**
|
|
628
|
+
/**
|
|
629
|
+
* What this task is accountable to — traceability only, NEVER scope authority.
|
|
630
|
+
*
|
|
631
|
+
* The vocabulary is the five aspects `BUILD_PLAN_FAMILY_ASPECTS` declares as targets: functional
|
|
632
|
+
* and non-functional requirements, roadmap phases, and the vision's success criteria and
|
|
633
|
+
* constraints. It reads "Requirement / roadmap refs" until 2026-09-11, and the last two were added
|
|
634
|
+
* because the producer had been writing them all along (#629) — the generation contract asks for a
|
|
635
|
+
* plain string list, so nothing here has ever refused a key.
|
|
636
|
+
*
|
|
637
|
+
* A key outside those five is not rejected and must not be: this is traceability a human or a
|
|
638
|
+
* model wrote down, and dropping it loses the intent. The workbench renders such a key as visibly
|
|
639
|
+
* unresolved instead, which is what makes a producer drift legible rather than silent.
|
|
640
|
+
*/
|
|
104
641
|
servesRefs: z.array(NonEmptyStringSchema).default([]),
|
|
105
642
|
});
|
|
106
643
|
export type BuildPlanTask = z.infer<typeof BuildPlanTaskSchema>;
|
|
@@ -140,6 +677,43 @@ export const BuildPlanTaskGraphSchema = z.object({
|
|
|
140
677
|
}
|
|
141
678
|
refs.add(task.taskRef);
|
|
142
679
|
});
|
|
680
|
+
/*
|
|
681
|
+
* No two tasks claim the same artifact.
|
|
682
|
+
*
|
|
683
|
+
* This is what makes landing DECIDABLE, not a tidiness rule. If two tasks name
|
|
684
|
+
* one product, the host cannot tell which of them a present artifact proves —
|
|
685
|
+
* exactly the ambiguity that shared `target`s created, arriving through the
|
|
686
|
+
* field that replaced them. Enforced here rather than left to the validator
|
|
687
|
+
* because a graph that cannot answer "has this task landed?" is not a graph
|
|
688
|
+
* the loop may run at all.
|
|
689
|
+
*/
|
|
690
|
+
graph.tasks.forEach((task, index) => {
|
|
691
|
+
const isGenerationStep = task.target.kind === BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP;
|
|
692
|
+
if (isGenerationStep && task.produces.length > 0) {
|
|
693
|
+
context.addIssue({
|
|
694
|
+
code: 'custom',
|
|
695
|
+
message: `build task "${task.taskRef}" is a companion generation step and must declare no products; its landing is the generation step's own condition`,
|
|
696
|
+
path: ['tasks', index, 'produces'],
|
|
697
|
+
});
|
|
698
|
+
}
|
|
699
|
+
});
|
|
700
|
+
const productOwners = new Map<string, string>();
|
|
701
|
+
graph.tasks.forEach((task, index) => {
|
|
702
|
+
task.produces.forEach((product, productIndex) => {
|
|
703
|
+
buildPlanTaskProductIdentities(product).forEach((identity) => {
|
|
704
|
+
const owner = productOwners.get(identity);
|
|
705
|
+
if (owner !== undefined) {
|
|
706
|
+
context.addIssue({
|
|
707
|
+
code: 'custom',
|
|
708
|
+
message: `build task "${task.taskRef}" claims the same artifact as "${owner}" (${identity}); an artifact is produced by exactly one task`,
|
|
709
|
+
path: ['tasks', index, 'produces', productIndex],
|
|
710
|
+
});
|
|
711
|
+
return;
|
|
712
|
+
}
|
|
713
|
+
productOwners.set(identity, task.taskRef);
|
|
714
|
+
});
|
|
715
|
+
});
|
|
716
|
+
});
|
|
143
717
|
graph.tasks.forEach((task, index) => {
|
|
144
718
|
task.prerequisiteTaskRefs.forEach((prerequisite, prerequisiteIndex) => {
|
|
145
719
|
if (prerequisite === task.taskRef) {
|
|
@@ -48,14 +48,14 @@ export const BusinessModelAuthoredMetadataSchema = z.object({
|
|
|
48
48
|
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
49
49
|
lastAuthoredAt: z.iso.datetime(),
|
|
50
50
|
/** Author's self-assessed confidence in the current content. */
|
|
51
|
-
confidence: z.enum(AuthoredConfidence),
|
|
51
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
52
52
|
/**
|
|
53
53
|
* Cadence at which the entity should be re-reviewed. When set, the
|
|
54
54
|
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt + cadence <
|
|
55
55
|
* now`. When omitted, no staleness check runs (same semantics as the
|
|
56
56
|
* market / vision / requirements / roadmap / assertions families).
|
|
57
57
|
*/
|
|
58
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
58
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
59
59
|
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
60
60
|
reviewer: NonEmptyStringSchema.optional(),
|
|
61
61
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -93,7 +93,7 @@ export const PricingPlanConfigSchema = z.object({
|
|
|
93
93
|
*/
|
|
94
94
|
billingPeriod: NonEmptyStringSchema.optional(),
|
|
95
95
|
/** Coarse price-scaling classification — see `PricingModelAxis`. */
|
|
96
|
-
pricingModel: z.enum(PricingModelAxis).optional(),
|
|
96
|
+
pricingModel: z.enum(PricingModelAxis).systemEnum('PricingModelAxis').optional(),
|
|
97
97
|
/**
|
|
98
98
|
* What the plan bundles, in prose ("all Team features + SSO"). A human
|
|
99
99
|
* summary — distinct from the typed `includesRequirementRefs`.
|