@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
|
@@ -36,25 +36,28 @@ export enum AuthoredConfidence {
|
|
|
36
36
|
HIGH = 'HIGH',
|
|
37
37
|
}
|
|
38
38
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Re-exported, not re-declared. {@link ReviewCadence} moved to `@wildo-ai/saas-models` on 2026-09-11
|
|
42
|
+
* when an application-declared `assuranceReviewCadence` gave it a consumer in
|
|
43
|
+
* `@wildo-ai/platform-config-lib`, a contracts-only package that does not depend on this one. The
|
|
44
|
+
* re-export keeps every existing importer here working unchanged and keeps ONE runtime source.
|
|
45
|
+
*/
|
|
46
|
+
import { ReviewCadence } from '@wildo-ai/saas-models';
|
|
47
|
+
|
|
48
|
+
export { REVIEW_CADENCE_TO_DAYS, ReviewCadence, deriveNextReviewOn } from '@wildo-ai/saas-models';
|
|
46
49
|
|
|
47
50
|
export const MarketAuthoredMetadataSchema = z.object({
|
|
48
51
|
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
49
52
|
lastAuthoredAt: z.iso.datetime(),
|
|
50
53
|
/** Author's self-assessed confidence in the current content. */
|
|
51
|
-
confidence: z.enum(AuthoredConfidence),
|
|
54
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
52
55
|
/**
|
|
53
56
|
* Cadence at which the entity should be re-reviewed. When set, the
|
|
54
57
|
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
55
58
|
* cadence < now`. When omitted, no staleness check runs.
|
|
56
59
|
*/
|
|
57
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
60
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
58
61
|
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
59
62
|
reviewer: NonEmptyStringSchema.optional(),
|
|
60
63
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -36,7 +36,7 @@ export const MarketChannelConfigSchema = z.object({
|
|
|
36
36
|
name: NonEmptyStringSchema,
|
|
37
37
|
/** One-sentence explanation of why this surface earns investment. */
|
|
38
38
|
description: NonEmptyStringSchema,
|
|
39
|
-
channelKind: z.enum(ChannelKind),
|
|
39
|
+
channelKind: z.enum(ChannelKind).systemEnum('ChannelKind'),
|
|
40
40
|
/**
|
|
41
41
|
* Tactical surface name (`'LinkedIn'`, `'r/productmanagement'`, …).
|
|
42
42
|
* Free-form so authoring is not bottlenecked on enum sprawl.
|
|
@@ -48,9 +48,9 @@ export const MarketChannelConfigSchema = z.object({
|
|
|
48
48
|
* not actionable). Multiple stages are valid (a single surface
|
|
49
49
|
* often spans the funnel).
|
|
50
50
|
*/
|
|
51
|
-
buyingJourneyStages: z.array(z.enum(BuyingJourneyStage)).min(1),
|
|
51
|
+
buyingJourneyStages: z.array(z.enum(BuyingJourneyStage).systemEnum('BuyingJourneyStage')).min(1),
|
|
52
52
|
/** Optional cost model. Omit for surfaces with no attributable cost. */
|
|
53
|
-
costModel: z.enum(ChannelCostModel).optional(),
|
|
53
|
+
costModel: z.enum(ChannelCostModel).systemEnum('ChannelCostModel').optional(),
|
|
54
54
|
/** Free-form authoring notes (rationale, observed performance, …). */
|
|
55
55
|
notes: z.array(NonEmptyStringSchema).default([]),
|
|
56
56
|
authored: MarketAuthoredMetadataSchema.optional(),
|
|
@@ -43,7 +43,7 @@ export const FeatureBenefitConfigSchema = z.object({
|
|
|
43
43
|
claim: NonEmptyStringSchema,
|
|
44
44
|
/** Optional supporting evidence (metrics, customer quotes, demo URL). */
|
|
45
45
|
evidence: NonEmptyStringSchema.optional(),
|
|
46
|
-
role: z.enum(BenefitRole),
|
|
46
|
+
role: z.enum(BenefitRole).systemEnum('BenefitRole'),
|
|
47
47
|
/**
|
|
48
48
|
* `FeatureRef[]` — cross-family refs into the application's
|
|
49
49
|
* `FeatureSpecification` registry. Required + non-empty: a benefit
|
|
@@ -41,7 +41,7 @@ export const MarketGainConfigSchema = z.object({
|
|
|
41
41
|
ref: NonEmptyStringSchema,
|
|
42
42
|
/** Plain-English statement of the desired outcome. */
|
|
43
43
|
statement: NonEmptyStringSchema,
|
|
44
|
-
gainKind: z.enum(GainKind),
|
|
44
|
+
gainKind: z.enum(GainKind).systemEnum('GainKind'),
|
|
45
45
|
/** Concrete supporting observations (interview quotes, metrics). */
|
|
46
46
|
evidence: z.array(NonEmptyStringSchema).default([]),
|
|
47
47
|
authored: MarketAuthoredMetadataSchema.optional(),
|
|
@@ -36,9 +36,9 @@ export const MarketICPConfigSchema = z
|
|
|
36
36
|
ref: NonEmptyStringSchema,
|
|
37
37
|
/** Display name for authoring tools and prompt blocks. */
|
|
38
38
|
name: NonEmptyStringSchema,
|
|
39
|
-
archetype: z.enum(ICPArchetype),
|
|
39
|
+
archetype: z.enum(ICPArchetype).systemEnum('ICPArchetype'),
|
|
40
40
|
purposeMix: PurposeMixSchema,
|
|
41
|
-
priority: z.enum(ICPPriority),
|
|
41
|
+
priority: z.enum(ICPPriority).systemEnum('ICPPriority'),
|
|
42
42
|
profile: ICPProfileSchema,
|
|
43
43
|
/** Personas that participate in this ICP's buying group / decision. */
|
|
44
44
|
buyingGroup: z
|
|
@@ -37,7 +37,7 @@ export const MarketJobConfigSchema = z.object({
|
|
|
37
37
|
ref: NonEmptyStringSchema,
|
|
38
38
|
/** "When …, I want to …, so I can …" statement. */
|
|
39
39
|
statement: NonEmptyStringSchema,
|
|
40
|
-
jobKind: z.enum(JobKind),
|
|
40
|
+
jobKind: z.enum(JobKind).systemEnum('JobKind'),
|
|
41
41
|
/** Optional context details that don't fit inside the statement. */
|
|
42
42
|
context: NonEmptyStringSchema.optional(),
|
|
43
43
|
/** Observable signals the job has been done well. */
|
|
@@ -69,7 +69,7 @@ export const MarketMessageTemplateConfigSchema = z.object({
|
|
|
69
69
|
ref: NonEmptyStringSchema,
|
|
70
70
|
name: NonEmptyStringSchema,
|
|
71
71
|
description: NonEmptyStringSchema,
|
|
72
|
-
outputKind: z.enum(MarketMessageOutputKind),
|
|
72
|
+
outputKind: z.enum(MarketMessageOutputKind).systemEnum('MarketMessageOutputKind'),
|
|
73
73
|
/**
|
|
74
74
|
* Mustache-style prompt body in English. Recognized placeholders
|
|
75
75
|
* include `{{icp.name}}`, `{{benefit.claim}}`, `{{output_language}}`,
|
|
@@ -77,7 +77,7 @@ export const MarketMessageTemplateConfigSchema = z.object({
|
|
|
77
77
|
* together with the agent implementation.
|
|
78
78
|
*/
|
|
79
79
|
promptTemplate: NonEmptyStringSchema,
|
|
80
|
-
requiredInputs: z.array(z.enum(MarketMessageRequiredInput)).default([]),
|
|
80
|
+
requiredInputs: z.array(z.enum(MarketMessageRequiredInput).systemEnum('MarketMessageRequiredInput')).default([]),
|
|
81
81
|
/** Optional `ToneOfVoiceRef` to bias the rendered output. */
|
|
82
82
|
preferredVoiceRef: NonEmptyStringSchema.optional(),
|
|
83
83
|
authored: MarketAuthoredMetadataSchema.optional(),
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
export const MarketObjectionConfigSchema = z.object({
|
|
38
38
|
/** Stable kebab-case ref (e.g. `'objection-pricing-too-high'`). */
|
|
39
39
|
ref: NonEmptyStringSchema,
|
|
40
|
-
objectionKind: z.enum(ObjectionKind),
|
|
40
|
+
objectionKind: z.enum(ObjectionKind).systemEnum('ObjectionKind'),
|
|
41
41
|
/** The objection as the buyer raises it. */
|
|
42
42
|
statement: NonEmptyStringSchema,
|
|
43
43
|
/** ICPs that raise this objection. At least one required. */
|
|
@@ -41,7 +41,7 @@ export const MarketPainConfigSchema = z.object({
|
|
|
41
41
|
ref: NonEmptyStringSchema,
|
|
42
42
|
/** Plain-English statement of the undesired outcome. */
|
|
43
43
|
statement: NonEmptyStringSchema,
|
|
44
|
-
painKind: z.enum(PainKind),
|
|
44
|
+
painKind: z.enum(PainKind).systemEnum('PainKind'),
|
|
45
45
|
/** Concrete supporting observations (interview quotes, metrics). */
|
|
46
46
|
evidence: z.array(NonEmptyStringSchema).default([]),
|
|
47
47
|
authored: MarketAuthoredMetadataSchema.optional(),
|
|
@@ -32,9 +32,9 @@ export const MarketPersonaConfigSchema = z.object({
|
|
|
32
32
|
ref: NonEmptyStringSchema,
|
|
33
33
|
/** Display name for authoring tools and prompt blocks. */
|
|
34
34
|
name: NonEmptyStringSchema,
|
|
35
|
-
personaScope: z.enum(PersonaScope),
|
|
35
|
+
personaScope: z.enum(PersonaScope).systemEnum('PersonaScope'),
|
|
36
36
|
/** Required when `personaScope === BUYING_GROUP_MEMBER` (validated downstream). */
|
|
37
|
-
dmuRole: z.enum(DmuRole).optional(),
|
|
37
|
+
dmuRole: z.enum(DmuRole).systemEnum('DmuRole').optional(),
|
|
38
38
|
/** ICPs this persona belongs to. At least one. */
|
|
39
39
|
belongsToIcpRefs: z.array(NonEmptyStringSchema).min(1),
|
|
40
40
|
profile: z.object({
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
export const MarketProofConfigSchema = z.object({
|
|
30
30
|
/** Stable kebab-case ref (e.g. `'proof-acme-cut-meetings-80pct'`). */
|
|
31
31
|
ref: NonEmptyStringSchema,
|
|
32
|
-
proofKind: z.enum(ProofKind),
|
|
32
|
+
proofKind: z.enum(ProofKind).systemEnum('ProofKind'),
|
|
33
33
|
/** The proof statement as it would appear in copy. */
|
|
34
34
|
statement: NonEmptyStringSchema,
|
|
35
35
|
/** Optional attribution block. */
|
|
@@ -152,6 +152,21 @@ export interface MarketSnapshotValidationResult {
|
|
|
152
152
|
issues: MarketSnapshotIssue[];
|
|
153
153
|
}
|
|
154
154
|
|
|
155
|
+
/**
|
|
156
|
+
* Options for this family validator.
|
|
157
|
+
*
|
|
158
|
+
* ## The cross-family sets are OPT-IN, and omitting one SKIPS its check
|
|
159
|
+
*
|
|
160
|
+
* A family validator sees one family. It cannot resolve a reference into another family's
|
|
161
|
+
* vocabulary unless you hand it that family's refs — so each `available*Refs` option is the caller
|
|
162
|
+
* saying "I have this context, use it". Omit one and the matching check does not run: no issue is
|
|
163
|
+
* reported, and the absence looks exactly like a snapshot with no such reference.
|
|
164
|
+
*
|
|
165
|
+
* That is deliberate — the families are decoupled on purpose — but it means a validator called with
|
|
166
|
+
* the snapshot alone is checking this family's INTERNAL consistency only. If you want dangling
|
|
167
|
+
* cross-family references caught, supply the sets; if you validate one family in isolation, expect
|
|
168
|
+
* them to be found later by whatever holds every family at once.
|
|
169
|
+
*/
|
|
155
170
|
export interface ValidateMarketSnapshotOptions {
|
|
156
171
|
/**
|
|
157
172
|
* Cross-family ref check for `FeatureBenefit.deliveredByFeatureRefs`.
|
|
@@ -73,7 +73,7 @@ export const ToneOfVoiceConfigSchema = z.object({
|
|
|
73
73
|
* for the same reason as `doExamples`.
|
|
74
74
|
*/
|
|
75
75
|
dontExamples: z.array(NonEmptyStringSchema).min(3).max(5),
|
|
76
|
-
address: z.enum(ToneOfVoiceAddress),
|
|
76
|
+
address: z.enum(ToneOfVoiceAddress).systemEnum('ToneOfVoiceAddress'),
|
|
77
77
|
authored: MarketAuthoredMetadataSchema.optional(),
|
|
78
78
|
});
|
|
79
79
|
export type ToneOfVoiceConfig = z.infer<typeof ToneOfVoiceConfigSchema>;
|
|
@@ -31,7 +31,7 @@ export const MarketTriggerConfigSchema = z.object({
|
|
|
31
31
|
name: NonEmptyStringSchema,
|
|
32
32
|
/** One-sentence explanation of the buying-intent shift this triggers. */
|
|
33
33
|
description: NonEmptyStringSchema,
|
|
34
|
-
triggerKind: z.enum(TriggerKind),
|
|
34
|
+
triggerKind: z.enum(TriggerKind).systemEnum('TriggerKind'),
|
|
35
35
|
/** Observable signals that this trigger has fired (≥ 1 required). */
|
|
36
36
|
signals: z.array(NonEmptyStringSchema).min(1),
|
|
37
37
|
/** ICPs whose buying intent shifts when this trigger fires (≥ 1 required). */
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# minions.tick-contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-minions-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-minions-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
export interface MinionTickContext {
|
|
13
|
+
/** Stable occurrence and fresh attempt identities for effect idempotency and reconciliation. */
|
|
14
|
+
scheduledAttempt: ScheduledAttemptContext;
|
|
15
|
+
/**
|
|
16
|
+
* The sanctioned privileged-access door, already contained by this minion's
|
|
17
|
+
* `resourceAccess` whitelist.
|
|
18
|
+
*
|
|
19
|
+
* Use this — never a repository directly (the `no-direct-repo-from-minion` ESLint
|
|
20
|
+
* rule enforces that) — so every access stays inside both doors and leaves an
|
|
21
|
+
* attributable audit record naming this minion.
|
|
22
|
+
*/
|
|
23
|
+
systemAccess: SystemAccessBackendService;
|
|
24
|
+
/** This minion's name, as declared in `wildo.saas.config.ts > minions`. */
|
|
25
|
+
minionName: string;
|
|
26
|
+
/**
|
|
27
|
+
* Read this minion's OWN cron schedule and recent runs (R4).
|
|
28
|
+
*
|
|
29
|
+
* Present only when the application declared the `own_cron_records` scope in
|
|
30
|
+
* this minion's `platformAccess`; otherwise the platform refuses and `read()`
|
|
31
|
+
* rejects. It is deliberately NOT absent from the type in that case — the
|
|
32
|
+
* authority decision belongs to the platform, and a client-side `undefined`
|
|
33
|
+
* would be this process guessing at it, which drifts the moment the
|
|
34
|
+
* declaration changes under a running minion.
|
|
35
|
+
*
|
|
36
|
+
* `read()` takes no arguments, and that is the contract rather than a
|
|
37
|
+
* convenience: the subject is derived from this runtime's attested identity,
|
|
38
|
+
* so another minion's schedule is not something this call could be asked for.
|
|
39
|
+
*/
|
|
40
|
+
ownSchedule: OwnScheduleReaderBackendService;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* Tick handler invoked for each admitted execution attempt of an authenticated
|
|
45
|
+
* occurrence addressed to this minion. Duplicate deliveries do not create new attempts.
|
|
46
|
+
*/
|
|
47
|
+
export type MinionTickAuthorHandler = (
|
|
48
|
+
token: Parameters<MinionTickHandler>[0],
|
|
49
|
+
context: MinionTickContext,
|
|
50
|
+
) => Promise<void>;
|
|
51
|
+
|
|
52
|
+
/** Reconcile durable/provider evidence of an earlier attempt; uncertainty must remain inconclusive. */
|
|
53
|
+
export type MinionTickReconciliationHandler = (
|
|
54
|
+
token: Parameters<MinionTickHandler>[0],
|
|
55
|
+
context: MinionTickContext,
|
|
56
|
+
) => Promise<ScheduledReconciliationResult>;
|
|
57
|
+
|
|
58
|
+
export type MinionInitializationConfig = Omit<ProjectedMinionInitializationConfig, 'providerRuntime'> & {
|
|
59
|
+
providerRuntime?: ProviderRuntimeArtifact | MinionProviderRuntimeArtifact;
|
|
60
|
+
/**
|
|
61
|
+
* Tick handler for admitted execution attempts addressed to this minion,
|
|
62
|
+
* receiving the framework-supplied {@link MinionTickContext}. Recovery follows
|
|
63
|
+
* the locally declared tickRecovery contract, never broker redelivery alone.
|
|
64
|
+
*
|
|
65
|
+
* Minion authors typically route the tick into the locally-hosted
|
|
66
|
+
* `flowsActorsRegistry` (per Q9 LOCKED — per-minion-local actor
|
|
67
|
+
* catalog). If omitted, the consumer still subscribes to the
|
|
68
|
+
* per-minion queue but refuses execution. A missing handler must never
|
|
69
|
+
* be recorded as successful work.
|
|
70
|
+
*/
|
|
71
|
+
onTick?: MinionTickAuthorHandler;
|
|
72
|
+
/** Locally authored effect-safety contract. Undeclared handlers default to manual review after uncertainty. */
|
|
73
|
+
tickRecovery?: Partial<ScheduledRecoveryPolicy>;
|
|
74
|
+
/** Required for reconciliation-based recovery; runs with the same contained access surface as onTick. */
|
|
75
|
+
reconcileTick?: MinionTickReconciliationHandler;
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
export function defineMinionInit(
|
|
79
|
+
config: MinionInitializationConfig,
|
|
80
|
+
): MinionInitializationConfig {
|
|
81
|
+
return config;
|
|
82
|
+
}
|
|
83
|
+
```
|
|
@@ -0,0 +1,369 @@
|
|
|
1
|
+
# placement-plan.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Versioning for the placement-plan payload format itself. `V1` — initial
|
|
14
|
+
* shape (declared groups + one decision per subject). The shape grows
|
|
15
|
+
* additively across versions; `version` is the explicit marker for consumers
|
|
16
|
+
* that branch on era.
|
|
17
|
+
*/
|
|
18
|
+
export enum PlacementPlanVersion {
|
|
19
|
+
V1 = 'v1',
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** Stable prefix every placement decision ref carries; the trusted runtime stamps it, a provider supplies only the slug. */
|
|
23
|
+
export const PLACEMENT_DECISION_REF_PREFIX = 'placement-';
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* WHICH shell surface a subject is placed on — a closed vocabulary, because
|
|
27
|
+
* each member names a different authoring file with a different vocabulary,
|
|
28
|
+
* and the dispatching coding agent derives which skill and which file from it.
|
|
29
|
+
*
|
|
30
|
+
* Deliberately NOT merged into one "navigation surface" bucket: a settings
|
|
31
|
+
* placement names a rail CATEGORY, a sidebar placement names a sidebar
|
|
32
|
+
* SECTION, and the two are different concepts that happen to both be groups.
|
|
33
|
+
*/
|
|
34
|
+
export enum PlacementSurface {
|
|
35
|
+
/** The settings hub rail (`frontend/src/config/settings-hub.config.ts`). Grouped by category. */
|
|
36
|
+
SETTINGS_HUB = 'SETTINGS_HUB',
|
|
37
|
+
/** The application sidebar (`appShellConfig[SIDEBAR].contentSections`). Grouped by section. */
|
|
38
|
+
SIDEBAR = 'SIDEBAR',
|
|
39
|
+
/** The user dropdown's settings entries. Flat — no groups. */
|
|
40
|
+
USER_MENU = 'USER_MENU',
|
|
41
|
+
/** The command palette (Cmd+K). Flat — its `category` is a search facet, not a placement group. */
|
|
42
|
+
COMMAND_MENU = 'COMMAND_MENU',
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** The surfaces whose placements MUST name a declared group. The other members are flat by construction. */
|
|
46
|
+
export const GROUPED_PLACEMENT_SURFACES: readonly PlacementSurface[] = [
|
|
47
|
+
PlacementSurface.SETTINGS_HUB,
|
|
48
|
+
PlacementSurface.SIDEBAR,
|
|
49
|
+
];
|
|
50
|
+
|
|
51
|
+
/** WHAT is being placed. */
|
|
52
|
+
export enum PlacementSubjectKind {
|
|
53
|
+
/**
|
|
54
|
+
* An engine-owned settings destination, named by its `SettingsDestination.ref`.
|
|
55
|
+
*
|
|
56
|
+
* `_core` deliberately does not import a catalog, so ref EXISTENCE is checked by the caller that
|
|
57
|
+
* holds one — see `validatePlacementPlan`'s `knownSubjects`. The app-creation semantic authority
|
|
58
|
+
* supplies `ENGINE_SETTINGS_DESTINATION_REFS` from `@wildo-ai/saas-models`, so an unknown ref is
|
|
59
|
+
* a hard floor there. What each ref MEANS (its render target, its role and capability gating)
|
|
60
|
+
* stays in `@wildo-ai/saas-frontend-lib`, which is why the ref vocabulary was moved out of it on
|
|
61
|
+
* 2026-09-09: a backend-side caller could not reach it, and the floor had no holder.
|
|
62
|
+
*
|
|
63
|
+
* (Two earlier drafts of this note were wrong in ways worth not repeating: the parameter was
|
|
64
|
+
* called `knownSubjectRefs`, a name that never existed and made the pointer ungreppable; and
|
|
65
|
+
* "no caller supplies one yet" outlived the wiring that made one.)
|
|
66
|
+
*/
|
|
67
|
+
ENGINE_SETTINGS_DESTINATION = 'ENGINE_SETTINGS_DESTINATION',
|
|
68
|
+
/** A resource operation surface the application owns (its LIST, its READ, a custom verb). */
|
|
69
|
+
RESOURCE_OPERATION = 'RESOURCE_OPERATION',
|
|
70
|
+
/** An application-scoped view (composite, chart, execution, full-custom). */
|
|
71
|
+
APP_VIEW = 'APP_VIEW',
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Which subject kinds each surface can actually CARRY — a property of the shell's vocabulary, stated
|
|
76
|
+
* once, total over {@link PlacementSurface}.
|
|
77
|
+
*
|
|
78
|
+
* The sidebar and the command palette hold LAUNCHERS, and a launcher can open a resource operation, an
|
|
79
|
+
* application view or a settings section. The settings rail and the user dropdown hold SETTINGS
|
|
80
|
+
* DESTINATIONS: the engine's, and the application's own, whose target is a resource operation, a
|
|
81
|
+
* framework panel or a registered component. No settings target renders an application view, so an
|
|
82
|
+
* APP_VIEW placed there is a decision no configuration can realise.
|
|
83
|
+
*
|
|
84
|
+
* Why it is written down rather than left to the coding task: the plan IS that task's specification. A
|
|
85
|
+
* placement no configuration can express produces a task that can never land, however well the agent
|
|
86
|
+
* works, and the first thing to notice would be the landing check after a full coding run. Refused at
|
|
87
|
+
* the plan instead (`validatePlacementPlan`'s `SUBJECT_NOT_EXPRESSIBLE_ON_SURFACE`), the deciding panel
|
|
88
|
+
* is told while it can still put the subject where a subject of that kind can go.
|
|
89
|
+
*
|
|
90
|
+
* A RESOURCE_OPERATION on the settings rail is realised by the application declaring its own
|
|
91
|
+
* destination (`SettingsHubConfig.destinations`) whose target is that operation, then placing it. On
|
|
92
|
+
* the user dropdown it is the same destination, listed in `settingsEntries`.
|
|
93
|
+
*
|
|
94
|
+
* Not offered: a settings target that renders an application view inside the rail's panel. Each view
|
|
95
|
+
* content type would need its own in-panel renderer, and a view already reaches people through the
|
|
96
|
+
* sidebar or the palette. Content that genuinely belongs in settings can be a registered component the
|
|
97
|
+
* application declares as its own destination.
|
|
98
|
+
*/
|
|
99
|
+
export const PLACEMENT_SURFACE_EXPRESSIBLE_SUBJECT_KINDS: Readonly<Record<PlacementSurface, readonly PlacementSubjectKind[]>> = {
|
|
100
|
+
[PlacementSurface.SETTINGS_HUB]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],
|
|
101
|
+
[PlacementSurface.USER_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],
|
|
102
|
+
[PlacementSurface.SIDEBAR]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],
|
|
103
|
+
[PlacementSurface.COMMAND_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],
|
|
104
|
+
};
|
|
105
|
+
|
|
106
|
+
const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
107
|
+
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
108
|
+
|
|
109
|
+
export const PlacementSubjectSchema = z.discriminatedUnion('kind', [
|
|
110
|
+
z.strictObject({
|
|
111
|
+
kind: z.literal(PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION).systemEnum('PlacementSubjectKind'),
|
|
112
|
+
destinationRef: SlugSchema,
|
|
113
|
+
}),
|
|
114
|
+
z.strictObject({
|
|
115
|
+
kind: z.literal(PlacementSubjectKind.RESOURCE_OPERATION).systemEnum('PlacementSubjectKind'),
|
|
116
|
+
moduleRef: SlugSchema,
|
|
117
|
+
resourceRef: SlugSchema,
|
|
118
|
+
/** The operation this placement surfaces (`list`, `read`, a custom verb ref). */
|
|
119
|
+
operation: NonEmptyStringSchema,
|
|
120
|
+
}),
|
|
121
|
+
z.strictObject({
|
|
122
|
+
kind: z.literal(PlacementSubjectKind.APP_VIEW).systemEnum('PlacementSubjectKind'),
|
|
123
|
+
viewRef: SlugSchema,
|
|
124
|
+
}),
|
|
125
|
+
]);
|
|
126
|
+
export type PlacementSubject = z.infer<typeof PlacementSubjectSchema>;
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* A container the plan decides should exist on a grouped surface — a settings
|
|
130
|
+
* rail category, or a sidebar section.
|
|
131
|
+
*
|
|
132
|
+
* `purpose` is prose, and it is load-bearing rather than decorative: it is what
|
|
133
|
+
* grounds the generated `settings_hub.categories.<ref>.label` /
|
|
134
|
+
* `sidebar_sections.<ref>.title` labels in authored intent instead of letting a
|
|
135
|
+
* model invent filler from the ref alone. The plan does NOT author the label
|
|
136
|
+
* string — that is the labelling pipeline's job.
|
|
137
|
+
*/
|
|
138
|
+
export const PlacementGroupSchema = z.strictObject({
|
|
139
|
+
groupRef: SlugSchema,
|
|
140
|
+
/** Which grouped surface this group belongs to. */
|
|
141
|
+
surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),
|
|
142
|
+
/** Why this group exists / what it gathers, from a product perspective. */
|
|
143
|
+
purpose: NonEmptyStringSchema,
|
|
144
|
+
/** Sort order among groups on its surface (lower = higher). */
|
|
145
|
+
order: z.number().int().min(0),
|
|
146
|
+
});
|
|
147
|
+
export type PlacementGroup = z.infer<typeof PlacementGroupSchema>;
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* WHERE a placed subject sits. Discriminated on surface because the address
|
|
151
|
+
* vocabularies genuinely differ: the grouped surfaces name a group, the flat
|
|
152
|
+
* ones do not have one to name.
|
|
153
|
+
*/
|
|
154
|
+
export const PlacementAddressSchema = z.discriminatedUnion('surface', [
|
|
155
|
+
z.strictObject({
|
|
156
|
+
surface: z.literal(PlacementSurface.SETTINGS_HUB).systemEnum('PlacementSurface'),
|
|
157
|
+
/** The `PlacementGroup.groupRef` of the settings rail category. */
|
|
158
|
+
groupRef: SlugSchema,
|
|
159
|
+
order: z.number().int().min(0),
|
|
160
|
+
}),
|
|
161
|
+
z.strictObject({
|
|
162
|
+
surface: z.literal(PlacementSurface.SIDEBAR).systemEnum('PlacementSurface'),
|
|
163
|
+
/** The `PlacementGroup.groupRef` of the sidebar section. */
|
|
164
|
+
groupRef: SlugSchema,
|
|
165
|
+
order: z.number().int().min(0),
|
|
166
|
+
}),
|
|
167
|
+
z.strictObject({
|
|
168
|
+
surface: z.literal(PlacementSurface.USER_MENU).systemEnum('PlacementSurface'),
|
|
169
|
+
order: z.number().int().min(0),
|
|
170
|
+
}),
|
|
171
|
+
z.strictObject({
|
|
172
|
+
surface: z.literal(PlacementSurface.COMMAND_MENU).systemEnum('PlacementSurface'),
|
|
173
|
+
order: z.number().int().min(0),
|
|
174
|
+
}),
|
|
175
|
+
]);
|
|
176
|
+
export type PlacementAddress = z.infer<typeof PlacementAddressSchema>;
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Whether a considered subject was placed or deliberately left unplaced.
|
|
180
|
+
*
|
|
181
|
+
* `DECLINED` is a first-class outcome, not an absence. A subject that is simply
|
|
182
|
+
* missing from the plan is a COVERAGE GAP (the decision was never taken); a
|
|
183
|
+
* subject recorded as `DECLINED` is a decision, with a reason a reader can
|
|
184
|
+
* disagree with. Collapsing the two would make "we thought about it and said no"
|
|
185
|
+
* indistinguishable from "nobody looked".
|
|
186
|
+
*/
|
|
187
|
+
export enum PlacementDisposition {
|
|
188
|
+
PLACED = 'PLACED',
|
|
189
|
+
DECLINED = 'DECLINED',
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* WHOSE judgement a decision currently represents.
|
|
194
|
+
*
|
|
195
|
+
* The placement plan is produced by an expert-panel deliberation, and every decision carries a
|
|
196
|
+
* `rationale` written by that panel. Nothing stopped a later edit — a re-run, or a human changing
|
|
197
|
+
* the landed file — from leaving that rationale in place while changing what it explains, so the
|
|
198
|
+
* artifact went on asserting panel reasoning for a decision the panel never took.
|
|
199
|
+
*
|
|
200
|
+
* This is the field that makes the difference legible. It is REQUIRED and has NO DEFAULT, which is
|
|
201
|
+
* the whole point: a defaulted `DELIBERATED` would mean silence claims the panel, and silence is
|
|
202
|
+
* exactly what a hand-edit produces.
|
|
203
|
+
*
|
|
204
|
+
* ⚠️ TRUSTED, like `decisionRef`. `PlacementDecisionGenerationSchema` cannot express it, so a
|
|
205
|
+
* provider cannot declare its own output a human revision; `parsePlacementPlanGeneration` stamps
|
|
206
|
+
* `DELIBERATED` because a panel run is by definition the panel's judgement.
|
|
207
|
+
*
|
|
208
|
+
* ⚠️ This is not an audit trail and must not grow into one. Git already records WHO changed a
|
|
209
|
+
* decision, WHEN, and with what commit message, mergeably and across branches — git is the
|
|
210
|
+
* accepted state, and a second ledger beside it cannot merge. What git cannot tell a reader who is looking at the
|
|
211
|
+
* FILE — the config, in an editor, asking "why is Billing under Account?" — is that this particular
|
|
212
|
+
* line is no longer what the panel decided. That is the one fact this carries.
|
|
213
|
+
*/
|
|
214
|
+
export enum PlacementDecisionOrigin {
|
|
215
|
+
/** The expert panel decided it, and nobody has changed it since. */
|
|
216
|
+
DELIBERATED = 'DELIBERATED',
|
|
217
|
+
/** A human changed it after the panel decided otherwise. {@link PlacementSupersededDecisionSchema} says what the panel had said. */
|
|
218
|
+
REVISED = 'REVISED',
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* What a revision replaced — the panel's own reasoning, kept beside the human's.
|
|
223
|
+
*
|
|
224
|
+
* Only the RATIONALE, deliberately. The decision schema's own note already says the reasoning is
|
|
225
|
+
* "the artifact's most perishable and most valuable part", and it is the half a reader cannot
|
|
226
|
+
* reconstruct: the prior address is visible in `git diff`, the prior argument is not, because a
|
|
227
|
+
* diff shows the words that changed and never the case they were making.
|
|
228
|
+
*
|
|
229
|
+
* Keeping more — the old address, a timestamp, an author — would grow a shadow decision beside the
|
|
230
|
+
* real one, and every one of those is something git already holds, in a form that merges.
|
|
231
|
+
*/
|
|
232
|
+
export const PlacementSupersededDecisionSchema = z.strictObject({
|
|
233
|
+
/** The rationale the panel gave for the decision this one replaced. */
|
|
234
|
+
rationale: NonEmptyStringSchema,
|
|
235
|
+
});
|
|
236
|
+
export type PlacementSupersededDecision = z.infer<typeof PlacementSupersededDecisionSchema>;
|
|
237
|
+
|
|
238
|
+
/**
|
|
239
|
+
* One placement decision.
|
|
240
|
+
*
|
|
241
|
+
* `rationale` is REQUIRED on both arms. It is what lets a creator ask "why is
|
|
242
|
+
* Billing under Organization?" and get an answer without re-running the panel
|
|
243
|
+
* that decided it — the plan is produced by an expert-panel deliberation, so
|
|
244
|
+
* the reasoning is the artifact's most perishable and most valuable part.
|
|
245
|
+
*
|
|
246
|
+
* A subject may legitimately be placed on SEVERAL surfaces (billing sits in the
|
|
247
|
+
* settings rail AND answers to the command palette), so one decision per
|
|
248
|
+
* (subject, surface) — never one per subject.
|
|
249
|
+
*/
|
|
250
|
+
export const PlacementDecisionSchema = z.discriminatedUnion('disposition', [
|
|
251
|
+
z.strictObject({
|
|
252
|
+
/** `placement-<slug>`, stamped by the trusted runtime. */
|
|
253
|
+
decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
254
|
+
disposition: z.literal(PlacementDisposition.PLACED).systemEnum('PlacementDisposition'),
|
|
255
|
+
/** Whose judgement this is. Required, never defaulted — see {@link PlacementDecisionOrigin}. */
|
|
256
|
+
origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),
|
|
257
|
+
subject: PlacementSubjectSchema,
|
|
258
|
+
address: PlacementAddressSchema,
|
|
259
|
+
/** Why this subject belongs at this address. One or two sentences, product-level. */
|
|
260
|
+
rationale: NonEmptyStringSchema,
|
|
261
|
+
/** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */
|
|
262
|
+
supersedes: PlacementSupersededDecisionSchema.optional(),
|
|
263
|
+
}),
|
|
264
|
+
z.strictObject({
|
|
265
|
+
decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
266
|
+
disposition: z.literal(PlacementDisposition.DECLINED).systemEnum('PlacementDisposition'),
|
|
267
|
+
origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),
|
|
268
|
+
subject: PlacementSubjectSchema,
|
|
269
|
+
/** Why this subject is deliberately NOT surfaced anywhere. */
|
|
270
|
+
rationale: NonEmptyStringSchema,
|
|
271
|
+
supersedes: PlacementSupersededDecisionSchema.optional(),
|
|
272
|
+
}),
|
|
273
|
+
]).superRefine((decision, context) => {
|
|
274
|
+
/*
|
|
275
|
+
* The pairing, enforced on the DECISION rather than on the plan.
|
|
276
|
+
*
|
|
277
|
+
* `PlacementDecisionSchema` is exported and parsed on its own, so a check that lived only in the
|
|
278
|
+
* plan's `superRefine` would hold for a whole plan and not for a decision — one of the two call
|
|
279
|
+
* sites of an invariant — the shape where a guard is applied at one call site and silently
|
|
280
|
+
* missing at another. Here it cannot be bypassed by parsing at a different granularity.
|
|
281
|
+
*
|
|
282
|
+
* Both directions, and the second matters as much as the first. A REVISED decision with no
|
|
283
|
+
* `supersedes` is the defect this whole field was added for, wearing the new vocabulary: it says
|
|
284
|
+
* "a human changed this" and still cannot say what was changed. A DELIBERATED decision that
|
|
285
|
+
* CARRIES a `supersedes` is a plan claiming the panel overruled itself — no run produces that, so
|
|
286
|
+
* it can only come from an edit that changed one half and forgot the other.
|
|
287
|
+
*/
|
|
288
|
+
if (decision.origin === PlacementDecisionOrigin.REVISED && decision.supersedes === undefined) {
|
|
289
|
+
context.addIssue({
|
|
290
|
+
code: 'custom',
|
|
291
|
+
message: `placement decision "${decision.decisionRef}" is REVISED but records no superseded rationale — a revision must say what the panel had decided, or the artifact loses the argument it replaced`,
|
|
292
|
+
path: ['supersedes'],
|
|
293
|
+
});
|
|
294
|
+
}
|
|
295
|
+
if (decision.origin === PlacementDecisionOrigin.DELIBERATED && decision.supersedes !== undefined) {
|
|
296
|
+
context.addIssue({
|
|
297
|
+
code: 'custom',
|
|
298
|
+
message: `placement decision "${decision.decisionRef}" is DELIBERATED and records a superseded rationale — a panel decision supersedes nothing; set origin to REVISED, or drop the supersedes block`,
|
|
299
|
+
path: ['supersedes'],
|
|
300
|
+
});
|
|
301
|
+
}
|
|
302
|
+
});
|
|
303
|
+
export type PlacementDecision = z.infer<typeof PlacementDecisionSchema>;
|
|
304
|
+
|
|
305
|
+
/**
|
|
306
|
+
* THE placement payload — a **single aggregate per application**: which shell
|
|
307
|
+
* surface every destination, resource operation and app view sits on, and why.
|
|
308
|
+
*
|
|
309
|
+
* **Artifact-family id: `placement-plan`.** This schema is the shape of the
|
|
310
|
+
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
311
|
+
* 'placement-plan'` (the `family` vocabulary stays an open string owned by the
|
|
312
|
+
* selector surface; this note is the single place tying the SHAPE to the NAME).
|
|
313
|
+
* Produced by the `bottom_up.placement-plan` playbook — an expert-panel
|
|
314
|
+
* deliberation, not a creator elicitation — and consumed by `build-decompose`,
|
|
315
|
+
* which turns it into the coding tasks that author the real config files.
|
|
316
|
+
*
|
|
317
|
+
* Invariants enforced HERE: unique decision refs; at least one decision; every
|
|
318
|
+
* placement on a grouped surface names a group declared in this plan, of the
|
|
319
|
+
* SAME surface; no two groups share a ref on one surface. Coherence beyond
|
|
320
|
+
* structure — duplicate placements, empty groups, order collisions, coverage
|
|
321
|
+
* against the engine catalog — is `validatePlacementPlan`'s job.
|
|
322
|
+
*/
|
|
323
|
+
export const PlacementPlanSchema = z.object({
|
|
324
|
+
version: z.enum(PlacementPlanVersion).default(PlacementPlanVersion.V1),
|
|
325
|
+
/**
|
|
326
|
+
* The groups the plan decides should exist. May be empty only when no
|
|
327
|
+
* grouped-surface placement is made — enforced below rather than by a
|
|
328
|
+
* `min(1)`, because a plan that places nothing but command-menu entries is
|
|
329
|
+
* legitimate and needs no group.
|
|
330
|
+
*/
|
|
331
|
+
groups: z.array(PlacementGroupSchema).default([]),
|
|
332
|
+
/**
|
|
333
|
+
* At least one decision, at the SCHEMA. A plan that decided nothing is a
|
|
334
|
+
* refusal ("there was nothing to place"), never an artifact — and an empty
|
|
335
|
+
* artifact that LANDS overwrites a real one, which is exactly how a completed
|
|
336
|
+
* 3-task build plan was destroyed by a vacuous one on 2026-08-24.
|
|
337
|
+
*/
|
|
338
|
+
decisions: z.array(PlacementDecisionSchema).min(1),
|
|
339
|
+
}).superRefine((plan, context) => {
|
|
340
|
+
const groupKeys = new Set<string>();
|
|
341
|
+
plan.groups.forEach((group, index) => {
|
|
342
|
+
const key = `${group.surface}::${group.groupRef}`;
|
|
343
|
+
if (groupKeys.has(key)) {
|
|
344
|
+
context.addIssue({ code: 'custom', message: `duplicate placement group "${group.groupRef}" on surface ${group.surface}`, path: ['groups', index, 'groupRef'] });
|
|
345
|
+
}
|
|
346
|
+
groupKeys.add(key);
|
|
347
|
+
});
|
|
348
|
+
|
|
349
|
+
const decisionRefs = new Set<string>();
|
|
350
|
+
plan.decisions.forEach((decision, index) => {
|
|
351
|
+
if (decisionRefs.has(decision.decisionRef)) {
|
|
352
|
+
context.addIssue({ code: 'custom', message: `duplicate placement decision ref "${decision.decisionRef}"`, path: ['decisions', index, 'decisionRef'] });
|
|
353
|
+
}
|
|
354
|
+
decisionRefs.add(decision.decisionRef);
|
|
355
|
+
|
|
356
|
+
if (decision.disposition !== PlacementDisposition.PLACED) return;
|
|
357
|
+
const address = decision.address;
|
|
358
|
+
if (!('groupRef' in address)) return;
|
|
359
|
+
if (!groupKeys.has(`${address.surface}::${address.groupRef}`)) {
|
|
360
|
+
context.addIssue({
|
|
361
|
+
code: 'custom',
|
|
362
|
+
message: `placement "${decision.decisionRef}" names group "${address.groupRef}", which this plan does not declare for surface ${address.surface}`,
|
|
363
|
+
path: ['decisions', index, 'address', 'groupRef'],
|
|
364
|
+
});
|
|
365
|
+
}
|
|
366
|
+
});
|
|
367
|
+
});
|
|
368
|
+
export type PlacementPlan = z.infer<typeof PlacementPlanSchema>;
|
|
369
|
+
```
|