@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- 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 +547 -17
- 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 +2 -2
- 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 -4
- 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 +135 -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 +208 -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 +218 -9
- 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 +374 -11
- 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 +6 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
- 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 +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 +1 -6
- 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 +62 -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 +188 -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 +74 -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 +80 -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 +18 -8
- 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 +81 -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 +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -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 +84 -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 +69 -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 +2 -2
- 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 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -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 +93 -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 +104 -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 +184 -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/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/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 +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- 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 +158 -5
- 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 +173 -5
- 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 +6 -5
- 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 +9 -8
- 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 +23 -4
- 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 +6 -4
- 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 +22 -13
- 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 +193 -28
- 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 +173 -34
- 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 +3 -2
- 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 +7 -3
- 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 +183 -6
- 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 +192 -6
- 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 +3 -2
- 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 +4 -3
- 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 +173 -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 +264 -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.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/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 +3 -2
- 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 +7 -3
- 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 +3 -2
- 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 -4
- 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 +33 -5
- 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 +28 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
- 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 +5 -3
- 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 +6 -4
- 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 +19 -5
- 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 +156 -5
- 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 -5
- 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 +7 -6
- 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 +28 -19
- 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 +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -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 +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- 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 +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -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 +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -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 +964 -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 +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- 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 +349 -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 +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -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 +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -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 +40 -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 +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -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 +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -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 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- 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 +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- 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 +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- 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/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- 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 +649 -10
- 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 +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- 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 +28 -22
- 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-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -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.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- 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 +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -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 +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- 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.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -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.functional-requirement.config.md +8 -0
- 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.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- 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 +87 -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.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -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 +19 -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.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -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.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- 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.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -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-data.admin-endpoints.md +56 -2
- 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 +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -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.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -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-field-address.lookup-slot.md +74 -0
- 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.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -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 +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- 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.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- 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 +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- 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.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -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 +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -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 +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -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 +244 -32
- 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-submission-challenge.md +54 -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 +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -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.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- 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 +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- 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.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- 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/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -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 +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- 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 +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- 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 +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- 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 +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -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 +11 -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 +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- 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 +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -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 +162 -8
- 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 +518 -132
- 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 +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- 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-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -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 +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- 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 +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -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 +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -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 +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -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 +66 -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 +397 -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 +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -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 +192 -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 +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -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 +100 -91
- 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 +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -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 +60 -27
- 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-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- 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-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -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 +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -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 +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- 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 +198 -36
- 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/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -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/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -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 +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -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 +144 -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/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -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-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -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-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- 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-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -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 +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -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 +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -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 +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -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 +953 -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 +125 -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 +595 -45
- 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 +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -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 +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -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 +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -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-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -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/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -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 +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- 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 +78 -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 +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -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/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -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 +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -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 +3 -1
- 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 +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- 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 +4 -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 +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -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 +12659 -4142
- 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/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -41,10 +41,19 @@ to many concurrent coding agents and interleaves the companion generation steps.
|
|
|
41
41
|
|
|
42
42
|
The build plan is a typed family (`BuildPlanTaskGraph`): dispatch selects ONE
|
|
43
43
|
READY task (all declared prerequisite task refs have landed) and hands the
|
|
44
|
-
coding host exactly that task's `objective`, `target`, `
|
|
45
|
-
`skillRefs`. The host derives the physical
|
|
46
|
-
fixed verification from the target kind;
|
|
47
|
-
this method prose — authors a path, a
|
|
44
|
+
coding host exactly that task's `objective`, `target`, `produces`,
|
|
45
|
+
`functionalTopic` and `skillRefs`. The host derives the physical
|
|
46
|
+
allowed/prohibited paths and the fixed verification from the target kind;
|
|
47
|
+
nothing in the task — and nothing in this method prose — authors a path, a
|
|
48
|
+
command, a prompt or a runtime control.
|
|
49
|
+
|
|
50
|
+
`target` and `produces` answer two different questions, and a task needs both.
|
|
51
|
+
`target` is the WRITE SCOPE — where this run may edit, and several tasks
|
|
52
|
+
legitimately share one. `produces` is what the run is ACCOUNTABLE for: the
|
|
53
|
+
artifacts whose presence in the application proves the task done. A task has
|
|
54
|
+
landed when every artifact it declares is present and committed, so a run that
|
|
55
|
+
satisfies the objective's prose without delivering those artifacts is not
|
|
56
|
+
finished — the plan will offer the task again.
|
|
48
57
|
|
|
49
58
|
## Import Origins
|
|
50
59
|
|
|
@@ -80,8 +89,160 @@ export enum BuildPlanTaskTargetKind {
|
|
|
80
89
|
RESOURCE_STAGE = 'RESOURCE_STAGE',
|
|
81
90
|
/** One relationship between two resources. */
|
|
82
91
|
RELATIONSHIP = 'RELATIONSHIP',
|
|
83
|
-
/** A companion-owned deterministic generation step (labels,
|
|
92
|
+
/** A companion-owned deterministic generation step (labels, email templates, logo or database migrations) interleaved by the build loop, never a coding-agent run. */
|
|
84
93
|
COMPANION_GENERATION_STEP = 'COMPANION_GENERATION_STEP',
|
|
94
|
+
/**
|
|
95
|
+
* Authoring one SHELL SURFACE's placement configuration from the accepted
|
|
96
|
+
* placement plan — the settings rail, the sidebar, the user menu or the
|
|
97
|
+
* command palette.
|
|
98
|
+
*
|
|
99
|
+
* Its own kind rather than a reuse of the neighbours, because none of them is
|
|
100
|
+
* true of it: it is not a MODULE or a RESOURCE_STAGE (it is application-wide
|
|
101
|
+
* and belongs to no resource), not a RELATIONSHIP, and emphatically not a
|
|
102
|
+
* COMPANION_GENERATION_STEP — that kind is documented as "never a coding-agent
|
|
103
|
+
* run" and writing `settings-hub.config.ts` is exactly a coding-agent run.
|
|
104
|
+
* Borrowing one would hand the host the wrong mutation scope and the wrong
|
|
105
|
+
* verification, which is what the closed vocabulary exists to prevent.
|
|
106
|
+
*/
|
|
107
|
+
SHELL_PLACEMENT = 'SHELL_PLACEMENT',
|
|
108
|
+
/*
|
|
109
|
+
* THE NON-RESOURCE SURFACES (#1490). Until 2026-09-22 the five kinds above were the whole
|
|
110
|
+
* vocabulary, and every one of them is about a resource or the shell placement of one. The
|
|
111
|
+
* decompose method meanwhile told the planner to emit tasks for views, navigation, the design
|
|
112
|
+
* system, custom components, PDF templates, workers, minions, providers, the website and the
|
|
113
|
+
* documentation — surfaces the framework's own composition scenarios and 85 of its 111 skills
|
|
114
|
+
* already build. A task for any of them had no kind to declare, so it either declared none
|
|
115
|
+
* (landing as RAN-not-PROVEN forever) or borrowed `MODULE` with a product the module scope could
|
|
116
|
+
* not prove. The members below are those surfaces, one per write scope the host can derive.
|
|
117
|
+
*/
|
|
118
|
+
/**
|
|
119
|
+
* The FRONTEND and SPECIFICATION layers of one module — its composite, custom and chart views,
|
|
120
|
+
* its custom components and their specifications.
|
|
121
|
+
*
|
|
122
|
+
* Narrower than `MODULE` on purpose: a view task never touches `shared-lib` or `backend-api`, so
|
|
123
|
+
* handing it the four-layer scope also hands it four typechecks and the FK sweep for a change
|
|
124
|
+
* that can only break the frontend and the specifications package.
|
|
125
|
+
*/
|
|
126
|
+
MODULE_FRONTEND = 'MODULE_FRONTEND',
|
|
127
|
+
/**
|
|
128
|
+
* The BACKEND layer of one module beside its shared-lib declarations — PDF templates and their
|
|
129
|
+
* bindings, backend addons (services, controllers, flows-actors), email definitions.
|
|
130
|
+
*
|
|
131
|
+
* Shared-lib is in scope because a PDF template is bound to a resource FIELD the config declares
|
|
132
|
+
* (`generatedSummaryPdf`), and a backend addon usually declares its contract there first.
|
|
133
|
+
*/
|
|
134
|
+
MODULE_BACKEND = 'MODULE_BACKEND',
|
|
135
|
+
/**
|
|
136
|
+
* ONE application-wide frontend configuration surface — navigation, the design system, the app
|
|
137
|
+
* shell's composition, the global views — named by {@link FrontendConfigSurface}.
|
|
138
|
+
*
|
|
139
|
+
* Distinct from {@link SHELL_PLACEMENT}, which authors the placement plan's decisions into the
|
|
140
|
+
* shell files: a placement puts a decided subject in a decided group, while this kind COMPOSES
|
|
141
|
+
* the surface itself (which sidebar sections exist, which transitions the primary zone uses,
|
|
142
|
+
* which palette the product carries). Same file for `APP_SHELL`, different question.
|
|
143
|
+
*/
|
|
144
|
+
APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',
|
|
145
|
+
/** The marketing website workspace (`website/`), composed by the `add-website` scenario. Pages and sections are its products. */
|
|
146
|
+
WEBSITE = 'WEBSITE',
|
|
147
|
+
/**
|
|
148
|
+
* The technical-documentation workspace (`technical-doc/`) and the specification package's
|
|
149
|
+
* `technical-documentation/` declarations that feed it. Its generated tree is never written by a
|
|
150
|
+
* task: the companion publishes into it, and the coding policy prohibits it by prefix.
|
|
151
|
+
*/
|
|
152
|
+
TECHNICAL_DOCUMENTATION = 'TECHNICAL_DOCUMENTATION',
|
|
153
|
+
/** One worker package (`workers/<workerRef>/`), Node or Rust, plus its declaration in the SaaS config. */
|
|
154
|
+
WORKER = 'WORKER',
|
|
155
|
+
/** One cron minion package (`minions/<minionRef>/`) plus its declaration in the SaaS config. */
|
|
156
|
+
MINION = 'MINION',
|
|
157
|
+
/**
|
|
158
|
+
* Declaring one provider in the application — the SaaS config's provider scopes, the backend
|
|
159
|
+
* package dependency, the frontend provider module and its companion contribution.
|
|
160
|
+
*
|
|
161
|
+
* Application-wide by construction: a provider binding names no module, and the four files it
|
|
162
|
+
* may touch are the same for every provider.
|
|
163
|
+
*/
|
|
164
|
+
PROVIDER_BINDING = 'PROVIDER_BINDING',
|
|
165
|
+
/**
|
|
166
|
+
* The application's BILLING CATALOGUE — the `ProductDefinition[]` in `shared-lib/src/engine/product.ts`
|
|
167
|
+
* (and the product specifications that document it), which the backend syncs to the billing
|
|
168
|
+
* provider and the public website reads for its pricing page (#1835).
|
|
169
|
+
*
|
|
170
|
+
* Its own kind because none of the others is true of it: the catalogue is application-wide (a plan
|
|
171
|
+
* belongs to no module), it lives in the shared library's ENGINE module that no `MODULE_*` scope
|
|
172
|
+
* reaches, and before it existed a journey-built application reached its website with an EMPTY
|
|
173
|
+
* catalogue, so the website re-typed the business model's prices by hand.
|
|
174
|
+
*/
|
|
175
|
+
BILLING_CATALOG = 'BILLING_CATALOG',
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* WHICH application-wide frontend configuration surface a task composes — one file each, in
|
|
180
|
+
* `frontend/src/config/`, and the coding policy resolves the member to that file exactly as
|
|
181
|
+
* `SHELL_PLACEMENT` resolves a `PlacementSurface`.
|
|
182
|
+
*
|
|
183
|
+
* Its own vocabulary rather than a reuse of `PlacementSurface`: a placement surface is WHERE a
|
|
184
|
+
* subject sits in the shell (settings hub, sidebar, user menu, command palette), and three of
|
|
185
|
+
* those live in one file. A configuration surface is WHICH FILE a composition task authors, and
|
|
186
|
+
* navigation and the design system are not places anything is placed.
|
|
187
|
+
*/
|
|
188
|
+
export enum FrontendConfigSurface {
|
|
189
|
+
/** `frontend/src/config/navigation.config.ts` — zones, transitions, overlay appearance. */
|
|
190
|
+
NAVIGATION = 'NAVIGATION',
|
|
191
|
+
/** `frontend/src/config/design-system.config.ts` — palette, typography, shell appearance from the brand's visual tone. */
|
|
192
|
+
DESIGN_SYSTEM = 'DESIGN_SYSTEM',
|
|
193
|
+
/** `frontend/src/config/app-shell.config.ts` — top bar, sidebar sections, quick switcher: the shell's COMPOSITION, not a placement into it. */
|
|
194
|
+
APP_SHELL = 'APP_SHELL',
|
|
195
|
+
/** `frontend/src/config/global-views.config.ts` — the application-level launcher and view registrations. */
|
|
196
|
+
GLOBAL_VIEWS = 'GLOBAL_VIEWS',
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
* The two shapes of guidance an application gives a person, and the file each is declared in.
|
|
201
|
+
*
|
|
202
|
+
* They are distinct because they are found differently: an onboarding DOCUMENT is embedded in a
|
|
203
|
+
* screen (`EmbedOnboarding`) and is there whenever that screen is, while a guidance FLOW is started
|
|
204
|
+
* by an event and shows once. Both are listed on the owning frontend module — `onboardingViews` and
|
|
205
|
+
* `guidanceFlows`. Each kind has a CONVENTIONAL definitions file, which the authoring skill teaches
|
|
206
|
+
* and a landing probe reads for the declared ref (alongside the module's `index.ts`, where a small
|
|
207
|
+
* module may declare inline). A convention for generated applications: a hand-authored application
|
|
208
|
+
* may keep its declarations elsewhere, and then simply is not probed by a build plan.
|
|
209
|
+
*/
|
|
210
|
+
export enum ApplicationGuidanceKind {
|
|
211
|
+
/** `frontend/src/modules/<m>/app-level-views/onboarding-views.definitions.ts` — an embedded onboarding document. */
|
|
212
|
+
ONBOARDING_DOCUMENT = 'ONBOARDING_DOCUMENT',
|
|
213
|
+
/** `frontend/src/modules/<m>/app-level-views/guidance-flows.definitions.ts` — a triggered guidance flow. */
|
|
214
|
+
GUIDANCE_FLOW = 'GUIDANCE_FLOW',
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* The two worker runtimes the framework composes (`add-worker-node`, `add-worker-rust`). The
|
|
219
|
+
* runtime decides the entry file a landing probe reads and whether a typecheck exists to run: a
|
|
220
|
+
* Node worker is verified by its package typecheck, a Rust worker has no TypeScript to check and
|
|
221
|
+
* the policy says so rather than inventing a command.
|
|
222
|
+
*
|
|
223
|
+
* Not the SaaS config's `WorkerRuntime`, which is a free-form `{ type, language }` pair an
|
|
224
|
+
* application authors for deployment; this is the closed set a creation run can COMPOSE.
|
|
225
|
+
*/
|
|
226
|
+
export enum BuildPlanWorkerRuntime {
|
|
227
|
+
NODE = 'NODE',
|
|
228
|
+
RUST = 'RUST',
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* WHERE a provider is bound — which runtime owner's scope its declaration lands in. Each member
|
|
233
|
+
* is a different file, so a probe and a write grant both derive from it.
|
|
234
|
+
*
|
|
235
|
+
* Named after the SaaS config's own scope keys (`providers.scopes.backend`, `.companion`,
|
|
236
|
+
* `.frontendServices.app`, `.frontendServices.website`), which the `add-provider` and
|
|
237
|
+
* `add-file-picker-provider` scenarios write. Minion and worker scopes are deliberately absent:
|
|
238
|
+
* a provider reaching a minion is declared on that minion's own `providers` block and belongs to
|
|
239
|
+
* the {@link BuildPlanTaskTargetKind.MINION} task that builds it.
|
|
240
|
+
*/
|
|
241
|
+
export enum ProviderBindingScope {
|
|
242
|
+
BACKEND = 'BACKEND',
|
|
243
|
+
COMPANION = 'COMPANION',
|
|
244
|
+
FRONTEND_APP = 'FRONTEND_APP',
|
|
245
|
+
WEBSITE = 'WEBSITE',
|
|
85
246
|
}
|
|
86
247
|
|
|
87
248
|
/** The per-resource build stages, in their fixed order. */
|
|
@@ -93,6 +254,41 @@ export enum BuildPlanResourceStage {
|
|
|
93
254
|
}
|
|
94
255
|
|
|
95
256
|
const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* The key of the domain-plan MODULE a task targets or produces (`deals`, `tasks-manager`). Same
|
|
260
|
+
* slug grammar as the other keys, declared as its own schema because it names one thing — a
|
|
261
|
+
* module — where the other slugs name resources, relationships, steps, workers and products.
|
|
262
|
+
*/
|
|
263
|
+
const ModuleRefSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* The governed document a task produces, named as a COMPLIANCE-DOCUMENT CANDIDATE names it:
|
|
267
|
+
* `document:<namespace>.<id>`, e.g. `document:public.privacy-notice`.
|
|
268
|
+
*
|
|
269
|
+
* **This field was `SlugSchema`, and a slug cannot name a governed document — so until 2026-09-16 no
|
|
270
|
+
* build plan in any application could declare a document the engine catalog defines.** A slug forbids
|
|
271
|
+
* the colon and the dot, the catalog's definitions are `document-definition:public.privacy-notice`,
|
|
272
|
+
* and `selectAssuranceDocumentBlueprintForDocumentRef` joins the two namespaces by exact suffix — so
|
|
273
|
+
* every authored `documentRef` resolved to NO blueprint, and a blueprint is what says which sections,
|
|
274
|
+
* facts and claim guards the document owes. The two vocabularies were disjoint by construction.
|
|
275
|
+
*
|
|
276
|
+
* The cost is measured rather than theoretical. Wonder CRM's plan declares two such products
|
|
277
|
+
* (`gdpr-data-handling-governance`, `terminal-access-governance`), neither of which names anything;
|
|
278
|
+
* the first was dispatched, and its agent spent a full turn establishing — with a positive control —
|
|
279
|
+
* that the document does not exist and could only be invented, which the authoring skill forbids.
|
|
280
|
+
*
|
|
281
|
+
* The bare slug is STILL ACCEPTED, and that is deliberate rather than tidiness left undone: tightening
|
|
282
|
+
* this to the namespaced form alone would make every already-accepted plan carrying one fail to parse,
|
|
283
|
+
* and a build plan that cannot be READ stops the whole lane — the gate
|
|
284
|
+
* `application-creation-directive.md` forbids, for a task nobody can fix by re-running anything. A slug
|
|
285
|
+
* simply resolves to no blueprint, so the dispatcher skips that task with a message naming the ref,
|
|
286
|
+
* and the rest of the plan proceeds.
|
|
287
|
+
*/
|
|
288
|
+
const DocumentProductRefSchema = z.union([
|
|
289
|
+
z.string().regex(/^document:[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
290
|
+
SlugSchema,
|
|
291
|
+
]);
|
|
96
292
|
/**
|
|
97
293
|
* A skill ref is the skill's FOLDER id in the app-knowledge catalog, which is
|
|
98
294
|
* also its `SKILL.md` frontmatter `name` — one id, kebab-case. The host refuses
|
|
@@ -102,24 +298,376 @@ const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
|
102
298
|
const SkillRefSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
103
299
|
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
104
300
|
|
|
301
|
+
/**
|
|
302
|
+
* WHAT a build task PRODUCES — the artifact whose presence in the application
|
|
303
|
+
* proves the task is done.
|
|
304
|
+
*
|
|
305
|
+
* **This is not `target`, and the difference is the whole reason it exists.**
|
|
306
|
+
* `target` is a WRITE SCOPE: the host turns it into the path prefixes a run may
|
|
307
|
+
* mutate, and several tasks legitimately share one. `produces` is a PRODUCT
|
|
308
|
+
* IDENTITY: it says which artifact this task, and no other, is accountable for.
|
|
309
|
+
*
|
|
310
|
+
* Measured 2026-09-10 on Wonder CRM (issue #597): `build-task-pipeline-view`
|
|
311
|
+
* and `build-task-deal-follow-through-operation` carry BYTE-IDENTICAL targets
|
|
312
|
+
* (`{ kind: MODULE, moduleRef: 'deals' }`), and 7 of that plan's 42 tasks share
|
|
313
|
+
* 3 targets. Landing had been answered by narrowing the target to a module
|
|
314
|
+
* DIRECTORY — which `wildo compose` commits on day one, and which cannot tell
|
|
315
|
+
* two tasks apart even in principle. The loop reported 40 of 42 tasks landed
|
|
316
|
+
* while no coding task had ever run, so `dispatch-next` skipped every one of
|
|
317
|
+
* them and the phase-advance gate read a build that was all but complete.
|
|
318
|
+
*
|
|
319
|
+
* Like `target`, this stays SEMANTIC: a product names a resource, a field, a
|
|
320
|
+
* relationship or a view — never a path, and never a command. The host owns the
|
|
321
|
+
* translation from a product to the physical question it asks of the working
|
|
322
|
+
* tree, exactly as it owns the translation from a target kind to path prefixes.
|
|
323
|
+
* A model that could author the path could author its own mutation scope.
|
|
324
|
+
*/
|
|
325
|
+
export enum BuildPlanTaskProductKind {
|
|
326
|
+
/**
|
|
327
|
+
* Named fields on one resource's schema.
|
|
328
|
+
*
|
|
329
|
+
* The shape an ENRICHMENT task needs, and the reason a product cannot always
|
|
330
|
+
* be "a file": every resource file already exists, written by the scaffold
|
|
331
|
+
* with its self-described STARTER shape, so file presence answers nothing.
|
|
332
|
+
* The FIELDS are what the task adds.
|
|
333
|
+
*/
|
|
334
|
+
RESOURCE_SCHEMA_FIELDS = 'RESOURCE_SCHEMA_FIELDS',
|
|
335
|
+
/**
|
|
336
|
+
* One resource's declared operations — its registry presence, named by the verbs it gains.
|
|
337
|
+
*
|
|
338
|
+
* The VERBS, not the config file: `<r>.resources-config.ts` is written by the scaffold, so its
|
|
339
|
+
* existence is satisfied before any task runs. That is the exact shape of the defect this
|
|
340
|
+
* vocabulary replaces, and a kind that reproduced it would be worse than no kind at all.
|
|
341
|
+
*/
|
|
342
|
+
RESOURCE_REGISTRATION = 'RESOURCE_REGISTRATION',
|
|
343
|
+
/** One resource's frontend ui-behavior. */
|
|
344
|
+
RESOURCE_UI_BEHAVIOR = 'RESOURCE_UI_BEHAVIOR',
|
|
345
|
+
/**
|
|
346
|
+
* One resource's specification, named by the fields it documents.
|
|
347
|
+
*
|
|
348
|
+
* The FIELDS, for the same reason as {@link RESOURCE_REGISTRATION}: every resource is scaffolded
|
|
349
|
+
* with a `*.resource.specification.ts` documenting only the starter shape, so file existence
|
|
350
|
+
* proves nothing about the task that was meant to enrich it.
|
|
351
|
+
*/
|
|
352
|
+
RESOURCE_SPECIFICATION = 'RESOURCE_SPECIFICATION',
|
|
353
|
+
/** One relationship edge between two resources, named by the domain plan's `relationshipRef`. */
|
|
354
|
+
RESOURCE_RELATIONSHIP = 'RESOURCE_RELATIONSHIP',
|
|
355
|
+
/** One named custom operation on one resource. */
|
|
356
|
+
RESOURCE_OPERATION = 'RESOURCE_OPERATION',
|
|
357
|
+
/** One named application-level view. */
|
|
358
|
+
APPLICATION_VIEW = 'APPLICATION_VIEW',
|
|
359
|
+
/** One named governed application document (a compliance notice, a governance statement). */
|
|
360
|
+
APPLICATION_DOCUMENT = 'APPLICATION_DOCUMENT',
|
|
361
|
+
/** One application module, registered across the layer registries under one module identity. */
|
|
362
|
+
APPLICATION_MODULE = 'APPLICATION_MODULE',
|
|
363
|
+
/*
|
|
364
|
+
* THE NON-RESOURCE PRODUCTS (#1490). Each names an artifact of a surface the five target kinds
|
|
365
|
+
* above `MODULE_FRONTEND` could not express, and each is probed by the host from committed bytes —
|
|
366
|
+
* a declaration in the one file that registers it, never a directory a scenario already wrote.
|
|
367
|
+
*/
|
|
368
|
+
/**
|
|
369
|
+
* Named declarations in ONE application-wide frontend configuration file — a sidebar section
|
|
370
|
+
* ref the app shell gains, a zone the navigation config declares, a token the design system sets.
|
|
371
|
+
*
|
|
372
|
+
* The DECLARATIONS, never the file: every `frontend/src/config/*.config.ts` is written by
|
|
373
|
+
* `wildo init`, so its presence is true before any task runs. Same reasoning as
|
|
374
|
+
* {@link RESOURCE_SCHEMA_FIELDS}, one level up.
|
|
375
|
+
*/
|
|
376
|
+
APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',
|
|
377
|
+
/**
|
|
378
|
+
* One composite view of one resource — the cross-resource surface a resource's ui-behavior
|
|
379
|
+
* declares under `compositeViews`. Distinct from {@link APPLICATION_VIEW}, which is
|
|
380
|
+
* application-level and owned by a module rather than a resource.
|
|
381
|
+
*/
|
|
382
|
+
RESOURCE_COMPOSITE_VIEW = 'RESOURCE_COMPOSITE_VIEW',
|
|
383
|
+
/** One custom operation or execution view of one resource, bound in its ui-behavior. */
|
|
384
|
+
RESOURCE_CUSTOM_VIEW = 'RESOURCE_CUSTOM_VIEW',
|
|
385
|
+
/** One chart view of one resource, declared under its ui-behavior's `chartViews`. */
|
|
386
|
+
RESOURCE_CHART_VIEW = 'RESOURCE_CHART_VIEW',
|
|
387
|
+
/** One custom frontend component, registered by `componentRef` in the module's or the engine's registrations. */
|
|
388
|
+
CUSTOM_COMPONENT = 'CUSTOM_COMPONENT',
|
|
389
|
+
/**
|
|
390
|
+
* One milestone a module declares — the moment the application recognises and celebrates.
|
|
391
|
+
*
|
|
392
|
+
* Named by its identifier, which is what the module's `milestones.ts` declares
|
|
393
|
+
* (`first-project-created` is spelled `FIRST_PROJECT_CREATED` there). The module FILE is not the
|
|
394
|
+
* product: a module may carry milestones before this task runs, and only the identifier says this
|
|
395
|
+
* one landed.
|
|
396
|
+
*/
|
|
397
|
+
APPLICATION_MILESTONE = 'APPLICATION_MILESTONE',
|
|
398
|
+
/** One onboarding document or guidance flow a module declares, named by its ref. */
|
|
399
|
+
APPLICATION_GUIDANCE = 'APPLICATION_GUIDANCE',
|
|
400
|
+
/** One PDF template bound to one resource's generated-file field. */
|
|
401
|
+
PDF_TEMPLATE = 'PDF_TEMPLATE',
|
|
402
|
+
/**
|
|
403
|
+
* One worker's JOBS — the named handlers its entry file declares.
|
|
404
|
+
*
|
|
405
|
+
* The jobs, not the package: `add-worker-node` writes the package, so its directory proves
|
|
406
|
+
* nothing. What a coding task adds is behaviour, and behaviour is a symbol in the entry file.
|
|
407
|
+
*/
|
|
408
|
+
APPLICATION_WORKER = 'APPLICATION_WORKER',
|
|
409
|
+
/** One minion's BEHAVIOURS — the named tick handlers its entry file declares. Same reasoning as the worker. */
|
|
410
|
+
APPLICATION_MINION = 'APPLICATION_MINION',
|
|
411
|
+
/** One provider declared in one runtime owner's scope. */
|
|
412
|
+
PROVIDER_BINDING = 'PROVIDER_BINDING',
|
|
413
|
+
/**
|
|
414
|
+
* One product of the application's billing catalogue — a plan, add-on or purchase the application
|
|
415
|
+
* sells — named by its catalogue `key`, which the catalogue file declares (`key: 'team'`).
|
|
416
|
+
*
|
|
417
|
+
* The KEY, not the file: `wildo init` writes `product.ts` with an empty catalogue, so the file proves
|
|
418
|
+
* nothing. Written from the accepted business model's pricing plans, with the plan's price as typed
|
|
419
|
+
* money and the pricing-surface facts (recommended, price disclosure, availability) the plan implies.
|
|
420
|
+
*/
|
|
421
|
+
APPLICATION_BILLING_PRODUCT = 'APPLICATION_BILLING_PRODUCT',
|
|
422
|
+
/** One website page, registered in the website root config by its manifest. */
|
|
423
|
+
WEBSITE_PAGE = 'WEBSITE_PAGE',
|
|
424
|
+
/** One section of one website page, declared in that page's sections file. */
|
|
425
|
+
WEBSITE_SECTION = 'WEBSITE_SECTION',
|
|
426
|
+
/**
|
|
427
|
+
* One authored documentation chapter — a consumer guide the specifications package declares
|
|
428
|
+
* for the documentation portal to publish (#874's publication input).
|
|
429
|
+
*/
|
|
430
|
+
DOCUMENTATION_CHAPTER = 'DOCUMENTATION_CHAPTER',
|
|
431
|
+
/**
|
|
432
|
+
* One inbound CHANNEL handler — the code that decides what a message arriving on a channel causes
|
|
433
|
+
* (#1832). Named by the handler's `ref` (`matters.mail-intake`), which the handler file spells and whose
|
|
434
|
+
* file NAME is derived from it, so the module index's import of that file is what proves the handler is
|
|
435
|
+
* registered. Produced once per channel the integration plan declares (`inboundChannels`).
|
|
436
|
+
*/
|
|
437
|
+
INBOUND_CHANNEL_HANDLER = 'INBOUND_CHANNEL_HANDLER',
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
/**
|
|
441
|
+
* One artifact a task is accountable for. Closed by construction: a product the
|
|
442
|
+
* host cannot ask a question about is a product that can never be shown to have
|
|
443
|
+
* landed, so the vocabulary only grows alongside the resolver that answers it.
|
|
444
|
+
*/
|
|
445
|
+
export const BuildPlanTaskProductSchema = z.discriminatedUnion('kind', [
|
|
446
|
+
z.strictObject({
|
|
447
|
+
kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS).systemEnum('BuildPlanTaskProductKind'),
|
|
448
|
+
resourceRef: SlugSchema,
|
|
449
|
+
/**
|
|
450
|
+
* At least one field, because a task that enriches a schema with nothing is
|
|
451
|
+
* the vacuity this whole field exists to stop: it would land the moment the
|
|
452
|
+
* scaffold existed, which is the defect being fixed.
|
|
453
|
+
*/
|
|
454
|
+
fieldRefs: z.array(NonEmptyStringSchema).min(1),
|
|
455
|
+
}),
|
|
456
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_REGISTRATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
457
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema }),
|
|
458
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SPECIFICATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, fieldRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
459
|
+
z.strictObject({
|
|
460
|
+
kind: z.literal(BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP).systemEnum('BuildPlanTaskProductKind'),
|
|
461
|
+
relationshipRef: SlugSchema,
|
|
462
|
+
/*
|
|
463
|
+
* The two resources the edge relates, NAMED rather than parsed out of the ref.
|
|
464
|
+
*
|
|
465
|
+
* A ref is `<source>-<target>` by convention and that convention is not invertible:
|
|
466
|
+
* `next-step-deal` splits as (`next`, `step-deal`) or (`next-step`, `deal`) and only the domain
|
|
467
|
+
* plan knows which. The domain plan already carries both, so the plan passes them on instead of
|
|
468
|
+
* making the host guess — a host that guesses wrong probes for a resource that does not exist
|
|
469
|
+
* and reports the task permanently unlanded.
|
|
470
|
+
*/
|
|
471
|
+
sourceResourceRef: SlugSchema,
|
|
472
|
+
targetResourceRef: SlugSchema,
|
|
473
|
+
}),
|
|
474
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_OPERATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRef: SlugSchema }),
|
|
475
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_VIEW).systemEnum('BuildPlanTaskProductKind'), viewRef: SlugSchema }),
|
|
476
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_DOCUMENT).systemEnum('BuildPlanTaskProductKind'), documentRef: DocumentProductRefSchema }),
|
|
477
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MODULE).systemEnum('BuildPlanTaskProductKind'), moduleRef: ModuleRefSchema }),
|
|
478
|
+
z.strictObject({
|
|
479
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG).systemEnum('BuildPlanTaskProductKind'),
|
|
480
|
+
configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),
|
|
481
|
+
/** At least one, for the same vacuity reason as a schema's `fieldRefs`: the file exists on day one. */
|
|
482
|
+
declarationRefs: z.array(NonEmptyStringSchema).min(1),
|
|
483
|
+
}),
|
|
484
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),
|
|
485
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),
|
|
486
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CHART_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, chartRef: SlugSchema }),
|
|
487
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.CUSTOM_COMPONENT).systemEnum('BuildPlanTaskProductKind'), componentRef: SlugSchema }),
|
|
488
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MILESTONE).systemEnum('BuildPlanTaskProductKind'), milestoneRef: SlugSchema }),
|
|
489
|
+
z.strictObject({
|
|
490
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_GUIDANCE).systemEnum('BuildPlanTaskProductKind'),
|
|
491
|
+
/** Which definitions file carries it — a document and a flow live in different ones. */
|
|
492
|
+
guidanceKind: z.enum(ApplicationGuidanceKind).systemEnum('ApplicationGuidanceKind'),
|
|
493
|
+
guidanceRef: SlugSchema,
|
|
494
|
+
}),
|
|
495
|
+
z.strictObject({
|
|
496
|
+
kind: z.literal(BuildPlanTaskProductKind.PDF_TEMPLATE).systemEnum('BuildPlanTaskProductKind'),
|
|
497
|
+
resourceRef: SlugSchema,
|
|
498
|
+
/** The generated-file FIELD the template is bound to (`generatedSummaryPdf`) — a symbol, so any spelling. */
|
|
499
|
+
templateRef: NonEmptyStringSchema,
|
|
500
|
+
}),
|
|
501
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_WORKER).systemEnum('BuildPlanTaskProductKind'), workerRef: SlugSchema, jobRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
502
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MINION).systemEnum('BuildPlanTaskProductKind'), minionRef: SlugSchema, behaviorRefs: z.array(NonEmptyStringSchema).min(1) }),
|
|
503
|
+
z.strictObject({
|
|
504
|
+
kind: z.literal(BuildPlanTaskProductKind.PROVIDER_BINDING).systemEnum('BuildPlanTaskProductKind'),
|
|
505
|
+
providerRef: SlugSchema,
|
|
506
|
+
scope: z.enum(ProviderBindingScope).systemEnum('ProviderBindingScope'),
|
|
507
|
+
}),
|
|
508
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT).systemEnum('BuildPlanTaskProductKind'), productKey: SlugSchema }),
|
|
509
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_PAGE).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema }),
|
|
510
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_SECTION).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema, sectionRef: SlugSchema }),
|
|
511
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER).systemEnum('BuildPlanTaskProductKind'), chapterRef: SlugSchema }),
|
|
512
|
+
z.strictObject({
|
|
513
|
+
kind: z.literal(BuildPlanTaskProductKind.INBOUND_CHANNEL_HANDLER).systemEnum('BuildPlanTaskProductKind'),
|
|
514
|
+
/** The channel the handler serves — one the integration plan declared. Email is the only declarable channel. */
|
|
515
|
+
channel: z.literal(InboundChannelKind.EMAIL).systemEnum('InboundChannelKind'),
|
|
516
|
+
/** The handler's `ref`, exactly as `inboundHandlerRef()` will accept it. */
|
|
517
|
+
handlerRef: z.string().regex(INBOUND_HANDLER_REF_PATTERN),
|
|
518
|
+
}),
|
|
519
|
+
]);
|
|
520
|
+
export type BuildPlanTaskProduct = z.infer<typeof BuildPlanTaskProductSchema>;
|
|
521
|
+
|
|
522
|
+
/**
|
|
523
|
+
* Every artifact identity a product claims — one string per artifact, not one
|
|
524
|
+
* per product, because a product may claim several.
|
|
525
|
+
*
|
|
526
|
+
* `RESOURCE_SCHEMA_FIELDS` is why this returns a list. Two tasks may both enrich
|
|
527
|
+
* one resource's schema (a domain shape and a billing concern, say), and that is
|
|
528
|
+
* legitimate; what must never overlap is the FIELDS. Comparing whole products
|
|
529
|
+
* would refuse the legitimate pair, and comparing only the resource would let two
|
|
530
|
+
* tasks claim one field and make landing ambiguous again.
|
|
531
|
+
*
|
|
532
|
+
* Derived from the product's own members rather than stored, and total over the
|
|
533
|
+
* vocabulary, so a kind added tomorrow must state its identity here or fail to
|
|
534
|
+
* compile — it cannot be silently treated as equal to its siblings.
|
|
535
|
+
*/
|
|
536
|
+
export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): readonly string[] {
|
|
537
|
+
switch (product.kind) {
|
|
538
|
+
case BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS:
|
|
539
|
+
return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);
|
|
540
|
+
case BuildPlanTaskProductKind.RESOURCE_REGISTRATION:
|
|
541
|
+
return product.operationRefs.map((operationRef) => `${product.kind}:${product.resourceRef}:${operationRef}`);
|
|
542
|
+
case BuildPlanTaskProductKind.RESOURCE_SPECIFICATION:
|
|
543
|
+
return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);
|
|
544
|
+
case BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR:
|
|
545
|
+
return [`${product.kind}:${product.resourceRef}`];
|
|
546
|
+
case BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP:
|
|
547
|
+
return [`${product.kind}:${product.relationshipRef}`];
|
|
548
|
+
case BuildPlanTaskProductKind.RESOURCE_OPERATION:
|
|
549
|
+
return [`${product.kind}:${product.resourceRef}:${product.operationRef}`];
|
|
550
|
+
case BuildPlanTaskProductKind.APPLICATION_VIEW:
|
|
551
|
+
return [`${product.kind}:${product.viewRef}`];
|
|
552
|
+
case BuildPlanTaskProductKind.APPLICATION_DOCUMENT:
|
|
553
|
+
/*
|
|
554
|
+
* The ref AS AUTHORED, so a slug and a namespaced ref are different artifact identities even
|
|
555
|
+
* where they mean the same document — the duplicate-artifact refusal cannot see two tasks
|
|
556
|
+
* claiming one document if they spell it differently. Not normalisable: a slug carries no
|
|
557
|
+
* namespace, so nothing can recover `public.` from `privacy-notice`. It costs nothing today
|
|
558
|
+
* because a slug names no catalogued document at all, and the dispatcher skips such a task.
|
|
559
|
+
*/
|
|
560
|
+
return [`${product.kind}:${product.documentRef}`];
|
|
561
|
+
case BuildPlanTaskProductKind.APPLICATION_MODULE:
|
|
562
|
+
return [`${product.kind}:${product.moduleRef}`];
|
|
563
|
+
// One identity per DECLARATION, like schema fields: two tasks may compose one config file as
|
|
564
|
+
// long as they declare different things in it.
|
|
565
|
+
case BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG:
|
|
566
|
+
return product.declarationRefs.map((declarationRef) => `${product.kind}:${product.configSurface}:${declarationRef}`);
|
|
567
|
+
case BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW:
|
|
568
|
+
case BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW:
|
|
569
|
+
return [`${product.kind}:${product.resourceRef}:${product.viewRef}`];
|
|
570
|
+
case BuildPlanTaskProductKind.RESOURCE_CHART_VIEW:
|
|
571
|
+
return [`${product.kind}:${product.resourceRef}:${product.chartRef}`];
|
|
572
|
+
case BuildPlanTaskProductKind.CUSTOM_COMPONENT:
|
|
573
|
+
return [`${product.kind}:${product.componentRef}`];
|
|
574
|
+
case BuildPlanTaskProductKind.APPLICATION_MILESTONE:
|
|
575
|
+
return [`${product.kind}:${product.milestoneRef}`];
|
|
576
|
+
// The ref alone: a document and a flow sharing one ref is still one guidance identity, and the
|
|
577
|
+
// runtime keys a person's saved state by it — two artifacts claiming it would collide there too.
|
|
578
|
+
case BuildPlanTaskProductKind.APPLICATION_GUIDANCE:
|
|
579
|
+
return [`${product.kind}:${product.guidanceRef}`];
|
|
580
|
+
case BuildPlanTaskProductKind.PDF_TEMPLATE:
|
|
581
|
+
return [`${product.kind}:${product.resourceRef}:${product.templateRef}`];
|
|
582
|
+
case BuildPlanTaskProductKind.APPLICATION_WORKER:
|
|
583
|
+
return product.jobRefs.map((jobRef) => `${product.kind}:${product.workerRef}:${jobRef}`);
|
|
584
|
+
case BuildPlanTaskProductKind.APPLICATION_MINION:
|
|
585
|
+
return product.behaviorRefs.map((behaviorRef) => `${product.kind}:${product.minionRef}:${behaviorRef}`);
|
|
586
|
+
// The SCOPE is part of the identity: one provider bound on the backend and on the website is two artifacts.
|
|
587
|
+
case BuildPlanTaskProductKind.PROVIDER_BINDING:
|
|
588
|
+
return [`${product.kind}:${product.scope}:${product.providerRef}`];
|
|
589
|
+
case BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT:
|
|
590
|
+
return [`${product.kind}:${product.productKey}`];
|
|
591
|
+
case BuildPlanTaskProductKind.WEBSITE_PAGE:
|
|
592
|
+
return [`${product.kind}:${product.pageRef}`];
|
|
593
|
+
case BuildPlanTaskProductKind.WEBSITE_SECTION:
|
|
594
|
+
return [`${product.kind}:${product.pageRef}:${product.sectionRef}`];
|
|
595
|
+
case BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER:
|
|
596
|
+
return [`${product.kind}:${product.chapterRef}`];
|
|
597
|
+
case BuildPlanTaskProductKind.INBOUND_CHANNEL_HANDLER:
|
|
598
|
+
return [`${product.kind}:${product.handlerRef}`];
|
|
599
|
+
default: {
|
|
600
|
+
const unhandled: never = product;
|
|
601
|
+
throw new Error(`Unhandled build-plan task product ${JSON.stringify(unhandled)}.`);
|
|
602
|
+
}
|
|
603
|
+
}
|
|
604
|
+
}
|
|
605
|
+
|
|
606
|
+
/**
|
|
607
|
+
* The skill every billing-catalogue task is authored with (#1835): the product-catalogue contract, the
|
|
608
|
+
* money encoding (minor units), and the pricing-surface facts. The dispatch derives it from an
|
|
609
|
+
* `APPLICATION_BILLING_PRODUCT` product whatever the decomposer wrote, so an agent writing the catalogue
|
|
610
|
+
* the backend sells from is never without it.
|
|
611
|
+
*/
|
|
612
|
+
export const BILLING_CATALOG_SKILL_REF = 'configure-billing';
|
|
613
|
+
|
|
105
614
|
export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
106
|
-
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef:
|
|
615
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef: ModuleRefSchema }),
|
|
107
616
|
z.strictObject({
|
|
108
617
|
kind: z.literal(BuildPlanTaskTargetKind.RESOURCE_STAGE),
|
|
109
|
-
moduleRef:
|
|
618
|
+
moduleRef: ModuleRefSchema,
|
|
110
619
|
resourceRef: SlugSchema,
|
|
111
620
|
stage: z.enum(BuildPlanResourceStage),
|
|
112
621
|
}),
|
|
113
622
|
z.strictObject({
|
|
114
623
|
kind: z.literal(BuildPlanTaskTargetKind.RELATIONSHIP),
|
|
115
|
-
moduleRef:
|
|
624
|
+
moduleRef: ModuleRefSchema,
|
|
116
625
|
relationshipRef: SlugSchema,
|
|
117
626
|
}),
|
|
118
627
|
z.strictObject({
|
|
119
628
|
kind: z.literal(BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP),
|
|
120
|
-
/** The companion generation step this task runs (e.g. labels,
|
|
629
|
+
/** The companion generation step this task runs (e.g. i18n-labels, email-templates); resolved by the companion, never by a coding agent. */
|
|
121
630
|
generationStepRef: SlugSchema,
|
|
122
631
|
}),
|
|
632
|
+
z.strictObject({
|
|
633
|
+
kind: z.literal(BuildPlanTaskTargetKind.SHELL_PLACEMENT),
|
|
634
|
+
/**
|
|
635
|
+
* Which shell surface this task authors — the placement family's OWN
|
|
636
|
+
* `PlacementSurface`, deliberately not a build-plan copy of it.
|
|
637
|
+
*
|
|
638
|
+
* A copy was written first and was a defect, caught by probing the landing
|
|
639
|
+
* renderer rather than by any test: `PlacementAddress` discriminates on
|
|
640
|
+
* `surface` with `z.literal(...)` per option, so only the VALUES survive into
|
|
641
|
+
* the schema, and the renderer resolves a discriminator by matching that value
|
|
642
|
+
* SET against the exported enums. Two enums with identical values made the
|
|
643
|
+
* match ambiguous, the renderer correctly refused to guess an owner, and the
|
|
644
|
+
* address discriminator became unnameable — a landed placement plan would have
|
|
645
|
+
* emitted `surface: "SETTINGS_HUB"` as a bare string instead of
|
|
646
|
+
* `PlacementSurface.SETTINGS_HUB`. One concept, one named source.
|
|
647
|
+
*/
|
|
648
|
+
surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),
|
|
649
|
+
}),
|
|
650
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_FRONTEND), moduleRef: ModuleRefSchema }),
|
|
651
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_BACKEND), moduleRef: ModuleRefSchema }),
|
|
652
|
+
z.strictObject({
|
|
653
|
+
kind: z.literal(BuildPlanTaskTargetKind.APPLICATION_FRONTEND_CONFIG),
|
|
654
|
+
configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),
|
|
655
|
+
}),
|
|
656
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.WEBSITE) }),
|
|
657
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.TECHNICAL_DOCUMENTATION) }),
|
|
658
|
+
z.strictObject({
|
|
659
|
+
kind: z.literal(BuildPlanTaskTargetKind.WORKER),
|
|
660
|
+
/** The worker's directory under `workers/` and its key in the SaaS config, in slug form. */
|
|
661
|
+
workerRef: SlugSchema,
|
|
662
|
+
runtime: z.enum(BuildPlanWorkerRuntime).systemEnum('BuildPlanWorkerRuntime'),
|
|
663
|
+
}),
|
|
664
|
+
z.strictObject({
|
|
665
|
+
kind: z.literal(BuildPlanTaskTargetKind.MINION),
|
|
666
|
+
/** The minion's directory under `minions/` and its key in the SaaS config, in slug form. */
|
|
667
|
+
minionRef: SlugSchema,
|
|
668
|
+
}),
|
|
669
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.PROVIDER_BINDING), providerRef: SlugSchema }),
|
|
670
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.BILLING_CATALOG) }),
|
|
123
671
|
]);
|
|
124
672
|
export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
125
673
|
|
|
@@ -137,17 +685,80 @@ export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
|
137
685
|
export const BuildPlanTaskSchema = z.strictObject({
|
|
138
686
|
/** `build-task-<slug>`, stamped by the trusted runtime. */
|
|
139
687
|
taskRef: z.string().regex(new RegExp(`^${BUILD_PLAN_TASK_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
140
|
-
/**
|
|
141
|
-
|
|
688
|
+
/**
|
|
689
|
+
* One sentence of intent: what this task delivers.
|
|
690
|
+
*
|
|
691
|
+
* Its OWN instance, not the file's shared leaf, which `templateRef` and the product ref lists also
|
|
692
|
+
* hold. A display decorator mutates the instance it is applied to, and the workbench gives those
|
|
693
|
+
* refs a receding identifier look, which the objective sentence then took too.
|
|
694
|
+
*/
|
|
695
|
+
objective: z.string().trim().min(1),
|
|
142
696
|
target: BuildPlanTaskTargetSchema,
|
|
143
|
-
/**
|
|
144
|
-
|
|
697
|
+
/**
|
|
698
|
+
* The artifacts this task is accountable for — what proves it done.
|
|
699
|
+
*
|
|
700
|
+
* Coding tasks should declare at least one product that composition did not already
|
|
701
|
+
* write. A target is a shared mutation scope; its scaffolded file is not evidence
|
|
702
|
+
* that this task's intended work exists. Products identify the output to probe.
|
|
703
|
+
*
|
|
704
|
+
* Empty declarations remain representable and produce the advisory
|
|
705
|
+
* `TASK_DECLARES_NO_PRODUCT`. The host may advance after a COMPLETED durable run,
|
|
706
|
+
* while naming the task in `unverifiableLandedTaskRefs`: it ran, but its output
|
|
707
|
+
* cannot be proven from a product declaration. An unexecuted task is not landed.
|
|
708
|
+
* This distinction avoids repeatedly dispatching the same unprovable task without
|
|
709
|
+
* presenting execution history as evidence that the intended product is correct.
|
|
710
|
+
*
|
|
711
|
+
* The ONE hard exception is a `COMPANION_GENERATION_STEP`, which must declare NONE.
|
|
712
|
+
* That kind already carries its own typed landed condition, owned by the
|
|
713
|
+
* generation-step service — a set computed asynchronously (planner units x
|
|
714
|
+
* enabled locales), and for the migration step a STATE rather than files. A
|
|
715
|
+
* product declared beside it would be read by nothing, which is the inert
|
|
716
|
+
* declaration this field exists to avoid. Enforced on the graph below, in both
|
|
717
|
+
* directions.
|
|
718
|
+
*/
|
|
719
|
+
produces: z.array(BuildPlanTaskProductSchema).default([]),
|
|
720
|
+
/**
|
|
721
|
+
* Exactly ONE functional topic this task belongs to.
|
|
722
|
+
*
|
|
723
|
+
* **It does NOT drive ordering** — this said "drives cross-app ordering" until 2026-08-30 and
|
|
724
|
+
* nothing ever ordered by it. Sequencing is `prerequisiteTaskRefs`, resolved by the host, and it
|
|
725
|
+
* is the only thing that decides what may run next.
|
|
726
|
+
*
|
|
727
|
+
* What it DOES: the dispatch host stamps it into the coding-agent's task payload beside
|
|
728
|
+
* `skillRefs`, so the agent is told which phase of building the application this task belongs to.
|
|
729
|
+
* That is context an LLM reads, not a value the runtime branches on — the distinction matters,
|
|
730
|
+
* because a reader who believes it orders will look here for a scheduling bug that lives in the
|
|
731
|
+
* prerequisite graph. See issue #124.
|
|
732
|
+
*/
|
|
733
|
+
functionalTopic: z.enum(MetaWorkflow_FunctionalTopic).systemEnum('MetaWorkflow_FunctionalTopic'),
|
|
145
734
|
/** Installed app-knowledge skill folders that carry the technical HOW; resolved via the skills router at dispatch. */
|
|
146
735
|
skillRefs: z.array(SkillRefSchema).min(1),
|
|
147
736
|
/** Task refs that must have landed first; resolved by the host, not solved by the model. */
|
|
148
737
|
prerequisiteTaskRefs: z.array(z.string()).default([]),
|
|
149
|
-
/**
|
|
738
|
+
/**
|
|
739
|
+
* What this task is accountable to — traceability only, NEVER scope authority.
|
|
740
|
+
*
|
|
741
|
+
* The vocabulary is the five aspects `BUILD_PLAN_FAMILY_ASPECTS` declares as targets: functional
|
|
742
|
+
* and non-functional requirements, roadmap phases, and the vision's success criteria and
|
|
743
|
+
* constraints. It reads "Requirement / roadmap refs" until 2026-09-11, and the last two were added
|
|
744
|
+
* because the producer had been writing them all along (#629) — the generation contract asks for a
|
|
745
|
+
* plain string list, so nothing here has ever refused a key.
|
|
746
|
+
*
|
|
747
|
+
* A key outside those five is not rejected and must not be: this is traceability a human or a
|
|
748
|
+
* model wrote down, and dropping it loses the intent. The workbench renders such a key as visibly
|
|
749
|
+
* unresolved instead, which is what makes a producer drift legible rather than silent.
|
|
750
|
+
*/
|
|
150
751
|
servesRefs: z.array(NonEmptyStringSchema).default([]),
|
|
752
|
+
/**
|
|
753
|
+
* Who asked for this task DIRECTLY (#1608), rather than it being derived from the specifications: the
|
|
754
|
+
* signed-in person who added it in conversation. STAMPED by the append, never authored: a value in
|
|
755
|
+
* generated output is discarded. Absent on every task the decomposition derived.
|
|
756
|
+
*
|
|
757
|
+
* It is what keeps a requested task alive. Build decomposition refines the plan from the domain plan, and
|
|
758
|
+
* a task nothing in the specifications justifies would read as unjustified and be dropped; a requested
|
|
759
|
+
* task it leaves out is carried forward instead, keeping only the prerequisites the new plan still holds.
|
|
760
|
+
*/
|
|
761
|
+
requestedBy: NonEmptyStringSchema.optional(),
|
|
151
762
|
});
|
|
152
763
|
export type BuildPlanTask = z.infer<typeof BuildPlanTaskSchema>;
|
|
153
764
|
|
|
@@ -186,6 +797,43 @@ export const BuildPlanTaskGraphSchema = z.object({
|
|
|
186
797
|
}
|
|
187
798
|
refs.add(task.taskRef);
|
|
188
799
|
});
|
|
800
|
+
/*
|
|
801
|
+
* No two tasks claim the same artifact.
|
|
802
|
+
*
|
|
803
|
+
* This is what makes landing DECIDABLE, not a tidiness rule. If two tasks name
|
|
804
|
+
* one product, the host cannot tell which of them a present artifact proves —
|
|
805
|
+
* exactly the ambiguity that shared `target`s created, arriving through the
|
|
806
|
+
* field that replaced them. Enforced here rather than left to the validator
|
|
807
|
+
* because a graph that cannot answer "has this task landed?" is not a graph
|
|
808
|
+
* the loop may run at all.
|
|
809
|
+
*/
|
|
810
|
+
graph.tasks.forEach((task, index) => {
|
|
811
|
+
const isGenerationStep = task.target.kind === BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP;
|
|
812
|
+
if (isGenerationStep && task.produces.length > 0) {
|
|
813
|
+
context.addIssue({
|
|
814
|
+
code: 'custom',
|
|
815
|
+
message: `build task "${task.taskRef}" is a companion generation step and must declare no products; its landing is the generation step's own condition`,
|
|
816
|
+
path: ['tasks', index, 'produces'],
|
|
817
|
+
});
|
|
818
|
+
}
|
|
819
|
+
});
|
|
820
|
+
const productOwners = new Map<string, string>();
|
|
821
|
+
graph.tasks.forEach((task, index) => {
|
|
822
|
+
task.produces.forEach((product, productIndex) => {
|
|
823
|
+
buildPlanTaskProductIdentities(product).forEach((identity) => {
|
|
824
|
+
const owner = productOwners.get(identity);
|
|
825
|
+
if (owner !== undefined) {
|
|
826
|
+
context.addIssue({
|
|
827
|
+
code: 'custom',
|
|
828
|
+
message: `build task "${task.taskRef}" claims the same artifact as "${owner}" (${identity}); an artifact is produced by exactly one task`,
|
|
829
|
+
path: ['tasks', index, 'produces', productIndex],
|
|
830
|
+
});
|
|
831
|
+
return;
|
|
832
|
+
}
|
|
833
|
+
productOwners.set(identity, task.taskRef);
|
|
834
|
+
});
|
|
835
|
+
});
|
|
836
|
+
});
|
|
189
837
|
graph.tasks.forEach((task, index) => {
|
|
190
838
|
task.prerequisiteTaskRefs.forEach((prerequisite, prerequisiteIndex) => {
|
|
191
839
|
if (prerequisite === task.taskRef) {
|
|
@@ -216,7 +864,7 @@ Most of the D4 dispatch contract is **runner mechanism**, not prose you re-imple
|
|
|
216
864
|
the runner composes the context pack, opens a coding session with the agent over the
|
|
217
865
|
Agent Client Protocol and sends one prompt turn, answers the agent's permission
|
|
218
866
|
requests within the declared ceiling, captures the change-set, runs the verify hook,
|
|
219
|
-
holds the single-flight lock
|
|
867
|
+
holds the single-flight lock and applies its configured execution limits. Your method here is the **declarative recipe** the runner interprets —
|
|
220
868
|
*which* task to dispatch next, *when* it is authorized, and *how* its outcome is
|
|
221
869
|
judged. Do not hand-compose a dispatch prompt or drive git yourself; let the runner
|
|
222
870
|
own composition and change-set capture.
|
|
@@ -226,8 +874,8 @@ own composition and change-set capture.
|
|
|
226
874
|
This playbook is **idempotent** and, on a re-run, *advances the loop by one task*.
|
|
227
875
|
Before dispatching anything:
|
|
228
876
|
|
|
229
|
-
1. Read the current journey state and scope
|
|
230
|
-
|
|
877
|
+
1. Read the current journey state and scope from what this run is given — the loaded
|
|
878
|
+
specifications and the workspace sections of your brief — and do not re-derive it. Confirm the **build plan** is present
|
|
231
879
|
and approved, and confirm the **foundation** ran. For each build-plan task,
|
|
232
880
|
determine its dispatch state from its task row — **not yet dispatched**,
|
|
233
881
|
**dispatched-and-succeeded** (a captured change-set + a passed verify), or
|
|
@@ -248,12 +896,58 @@ Before dispatching anything:
|
|
|
248
896
|
depends on greenfield bring-up tooling (deferred). The dispatch contract is real and
|
|
249
897
|
runs against an **existing** app skeleton — the dogfood app already has one.
|
|
250
898
|
|
|
251
|
-
//
|
|
252
|
-
//
|
|
899
|
+
// Operator status: `wildo context journey` (eligibility board + runs in flight). Which tasks already
|
|
900
|
+
// landed is read from GIT by the runner itself — a task is landed when every file it produces is
|
|
901
|
+
// committed clean.
|
|
253
902
|
|
|
254
903
|
You **read** `build-plan`; you **write** no journey artifact
|
|
255
904
|
— the runner records the change-set + task status on the dispatched task's row.
|
|
256
905
|
|
|
906
|
+
## Precondition — the application must establish the agent's role, or dispatch stalls
|
|
907
|
+
|
|
908
|
+
Check this before the first dispatch of an application's life. It costs one look and it is the
|
|
909
|
+
difference between a working lane and one that burns model time producing nothing.
|
|
910
|
+
|
|
911
|
+
**The application needs a root `CLAUDE.md` stating that a task dispatched by its dev companion is
|
|
912
|
+
legitimate work.** Without it the agent is right to refuse, and refusing is what it does.
|
|
913
|
+
|
|
914
|
+
The reason is structural rather than a matter of tone. A dispatched task reaches the agent as an
|
|
915
|
+
ordinary prompt — a user turn carrying an objective, a mutation scope and skill refs. Nothing in
|
|
916
|
+
that turn proves where it came from. So the agent is being handed conversational content that
|
|
917
|
+
tells it to write files into a repository, which is indistinguishable from the thing every
|
|
918
|
+
careful agent is supposed to decline, and the more trustworthy the agent the more reliably it
|
|
919
|
+
declines. Measured on a real application with no such file: two dispatched runs stalled, one
|
|
920
|
+
answering *"content that arrives as conversational input doesn't get to reassign what I am"*.
|
|
921
|
+
|
|
922
|
+
The failure does not look like a missing file. It looks like an agent that deliberates well,
|
|
923
|
+
identifies exactly which files it would author, explains its reasoning, asks a human to confirm,
|
|
924
|
+
and ends its turn — `end_turn`, no error, no denial, an empty change set, and a bill for the
|
|
925
|
+
tokens. Read as "the agent chose not to work", which invites prompt-tuning that cannot fix it.
|
|
926
|
+
|
|
927
|
+
`wildo init` scaffolds this file. An application created before that, or one whose `CLAUDE.md`
|
|
928
|
+
covers only its own conventions, needs the section added. What it must establish:
|
|
929
|
+
|
|
930
|
+
- the task is **selected by the host** from the accepted build plan, not composed by a caller;
|
|
931
|
+
- its **file edits** are **confined before they arrive** — the host answers every permission request
|
|
932
|
+
against the declared mutation scope and refuses paths outside it;
|
|
933
|
+
- its **shell commands are NOT**, and the section must say so. A command declares no `locations`, so
|
|
934
|
+
the scope predicate never runs for one; telling an agent it "need not police itself" is true of its
|
|
935
|
+
edits and false of its commands, and that is the half a stray write comes through. Name the
|
|
936
|
+
compensations with it: the post-run change set and the companion's warning DETECT such a write,
|
|
937
|
+
they do not prevent it;
|
|
938
|
+
- it is **reversible** — every write is an uncommitted working edit until something commits it. Do
|
|
939
|
+
not state WHO commits as a property of the lane: that is the host's autonomy posture, it changes,
|
|
940
|
+
and an agent that reads "a human commits" from a scaffold written under a different posture is
|
|
941
|
+
working from a stale contract.
|
|
942
|
+
|
|
943
|
+
Two smaller things belong in the same section, because both were observed costing a run:
|
|
944
|
+
|
|
945
|
+
- **Say what `allowedPathPrefixes` are relative to.** The agent receives bare prefixes such as
|
|
946
|
+
`shared-lib/src/modules/<module>/` with no root, and cannot verify its own confinement against
|
|
947
|
+
them. One sentence naming the application root removes the ambiguity.
|
|
948
|
+
- **Do not name a task so it reads as a fixture.** An agent that concludes it is looking at a
|
|
949
|
+
smoke test will say so and stop. Name the task after the product change it makes.
|
|
950
|
+
|
|
257
951
|
## Step 1 — Select the next dispatchable task (single-flight)
|
|
258
952
|
|
|
259
953
|
Walk the build plan in its authored order and pick the **first** task that is not
|
|
@@ -284,33 +978,25 @@ empty build plan is the same: nothing to dispatch, stop.
|
|
|
284
978
|
those steps *concurrently* with coding runs at scale is the scale playbook's job —
|
|
285
979
|
here you simply run the ready one in its turn.
|
|
286
980
|
|
|
287
|
-
## Step 2 —
|
|
288
|
-
|
|
289
|
-
A coding
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
too (bounded by the run-count budget floor), rather than re-prompting per task. So
|
|
303
|
-
`approve_before` here means "the creator authorizes the **dispatch loop** before any
|
|
304
|
-
task mutates the workspace" — a real pre-mutation floor. A per-run, single-use gate
|
|
305
|
-
is a deferred runner posture; until it lands, the budget ceiling + the per-task
|
|
306
|
-
change-set capture + the verify gate are what bound the authorized loop.
|
|
307
|
-
- The floor still hard-gates regardless of preset: once the dispatch playbook's run
|
|
308
|
-
ceiling is reached, further dispatches are **refused** — that refusal is the
|
|
309
|
-
correct outcome; report it, do not work around it.
|
|
981
|
+
## Step 2 — Check the actual host authorization boundary
|
|
982
|
+
|
|
983
|
+
A coding dispatch writes the application workspace. Read its selected task, readiness,
|
|
984
|
+
mutation scope and the configured coding host's authorization policy before invoking it.
|
|
985
|
+
The single-flight mutation lock still applies to the current shared workspace.
|
|
986
|
+
|
|
987
|
+
The playbook's `approval` declaration and the journey autonomy presets express policy
|
|
988
|
+
intent. The current playbook runner does not interpret them as pre-dispatch gates,
|
|
989
|
+
automatic authorization, or a GUIDED/YOLO mapping. A declared `approve_before` does
|
|
990
|
+
not create a pending Authority Request, and no authority workflow exists to create one —
|
|
991
|
+
never invent one from an enum.
|
|
992
|
+
|
|
993
|
+
Likewise, do not infer enforced per-playbook or per-journey run ceilings from declared
|
|
994
|
+
budget fields. Respect the limits actually reported by the execution host. Inspect the
|
|
995
|
+
recorded changes and verification result after each task; no preset commits or accepts them.
|
|
310
996
|
|
|
311
997
|
## Step 3 — Dispatch the task through the coding-agent contract
|
|
312
998
|
|
|
313
|
-
|
|
999
|
+
The companion triggers the run (from a console, `wildo build run` or `/wildo:build`). The runner then performs the D4
|
|
314
1000
|
dispatch contract for you (you do not hand-assemble any of it):
|
|
315
1001
|
|
|
316
1002
|
1. **Context pack** — the runner composes the prompt: the task brief, the task's
|
|
@@ -332,7 +1018,7 @@ dispatch contract for you (you do not hand-assemble any of it):
|
|
|
332
1018
|
the run terminalises with its change-set intact instead of being killed — an
|
|
333
1019
|
operator who stops a run still needs to know what it had already written.
|
|
334
1020
|
- **Usage is reported.** Tokens and cost come back from the run itself rather than
|
|
335
|
-
being unavailable, which
|
|
1021
|
+
being unavailable, which lets the host report a terminal timeout instead of leaving the run ambiguous.
|
|
336
1022
|
3. **Change-set capture** — the runner captures a git worktree snapshot before and
|
|
337
1023
|
after the run and attributes each touched file (the run's own edit vs. an
|
|
338
1024
|
already-dirty parallel-session file vs. a file that appeared during the run),
|
|
@@ -340,8 +1026,9 @@ dispatch contract for you (you do not hand-assemble any of it):
|
|
|
340
1026
|
dirty-at-dispatch is the NORMAL state (parallel sessions), so the capture
|
|
341
1027
|
*attributes* rather than assuming the run had the tree to itself.
|
|
342
1028
|
|
|
343
|
-
//
|
|
344
|
-
//
|
|
1029
|
+
// The trigger is `wildo creation run <playbookRef>` or `wildo build run` (from a Claude Code session,
|
|
1030
|
+
// `/wildo:run` or `/wildo:build`), or the workbench; each reaches the companion with its local token.
|
|
1031
|
+
// The runner composes the typed context pack, runs one ACP prompt turn, and captures the change-set.
|
|
345
1032
|
|
|
346
1033
|
## Step 4 — Verify OUTSIDE the coding agent
|
|
347
1034
|
|
|
@@ -370,7 +1057,7 @@ so the agent cannot mark its own homework:
|
|
|
370
1057
|
## Step 5 — Record the result and apply the failure disposition
|
|
371
1058
|
|
|
372
1059
|
The runner records the change-set + the task's terminal status on the task row. On a
|
|
373
|
-
**failed or timed-out** run,
|
|
1060
|
+
**failed or timed-out** run, the current coding host retains its captured changes for inspection (the declaration describes this as **`keep_and_flag`**): the
|
|
374
1061
|
captured change-set is **kept and flagged for human triage** — never silently
|
|
375
1062
|
reverted, and never left as an un-recorded half-applied state. The change-set capture
|
|
376
1063
|
*is* the flag: it attributes exactly which files the run touched, so a human can
|
|
@@ -394,9 +1081,9 @@ resolved. This playbook does not auto-retry a failed task — automated retry /
|
|
|
394
1081
|
is a deferred build-loop-resilience concern, and human triage is the v1 disposition;
|
|
395
1082
|
here the loop simply surfaces the failure and stops advancing that dependency chain.
|
|
396
1083
|
|
|
397
|
-
Then **loop**: on the next run of this playbook,
|
|
398
|
-
just-dispatched task's outcome, and you select the next ready task
|
|
399
|
-
significant stretch of dispatches with a
|
|
1084
|
+
Then **loop**: on the next run of this playbook, the build plan's task records reflect the
|
|
1085
|
+
just-dispatched task's outcome (`wildo build tasks`), and you select the next ready task
|
|
1086
|
+
(Step 1). Close a significant stretch of dispatches with a progress summary — what was
|
|
400
1087
|
produced, which change-sets landed, what verify said, and any failed task left
|
|
401
1088
|
flagged for triage.
|
|
402
1089
|
|
|
@@ -410,7 +1097,7 @@ flagged for triage.
|
|
|
410
1097
|
- **Follow the plan's order.** If the build plan was refined upstream (a task added,
|
|
411
1098
|
an ordering corrected), respect the new order on the next selection — do not cache
|
|
412
1099
|
a stale work list across runs.
|
|
413
|
-
- **A
|
|
1100
|
+
- **A host execution refusal is a real stop.** When an actual execution limit is reported, stop dispatching
|
|
414
1101
|
and report what remains; do not do the coding work out-of-band to "finish the
|
|
415
1102
|
build" — that makes the journey's task history a lie.
|
|
416
1103
|
|
|
@@ -451,25 +1138,17 @@ authored by this playbook. That is deliberately not duplicated into a separate
|
|
|
451
1138
|
journey artifact family: the task row already *is* the dispatch record, and a second
|
|
452
1139
|
home for the same record would drift.
|
|
453
1140
|
|
|
454
|
-
|
|
455
|
-
|
|
1141
|
+
Dispatch uses the configured host's actual authorization boundary. The creator reviews
|
|
1142
|
+
the recorded change-set and verification outcome afterwards —
|
|
456
1143
|
one verified task at a time, until the build plan is fully dispatched.
|
|
457
1144
|
|
|
458
1145
|
## References
|
|
459
1146
|
|
|
460
|
-
-
|
|
461
|
-
|
|
462
|
-
see which tasks already dispatched.
|
|
463
|
-
- `.claude/skills/journey-approve/SKILL.md` — relay the exact pre-dispatch Authority Request
|
|
464
|
-
gate decision that authorizes the workspace-mutating dispatch (never self-approve).
|
|
465
|
-
- `.claude/skills/journey-run/SKILL.md` — trigger the dispatch and monitor it; the
|
|
466
|
-
runner composes the context pack, runs one prompt turn against the coding agent in
|
|
467
|
-
the app workspace, captures the change-set, and runs the verify hook.
|
|
468
|
-
- `.claude/skills/journey-report/SKILL.md` — summarize a stretch of dispatches:
|
|
469
|
-
what was produced, which change-sets landed, and what the verify gates said.
|
|
1147
|
+
- A playbook's declared `approval` and failure policy gate nothing on a leaf run; they are read only
|
|
1148
|
+
at a composite lane's boundary, where they frame a decision for the person and revert nothing.
|
|
470
1149
|
|
|
471
1150
|
## Reviewer checklist — `dispatch-outcome-sound`
|
|
472
1151
|
|
|
473
1152
|
Formerly authored as an `llm_judge` quality gate; the generic rubric-only gate kind was retired at the flexible-intelligence hard cut (judgment now runs only through a compiled Evaluation Treatment). The checklist itself is creator-facing review guidance and is kept here, verbatim (minus the retired runner's closing sentence, and with repository-specific wording made application-neutral):
|
|
474
1153
|
|
|
475
|
-
Judge whether ONE dispatched build-plan task ran soundly under the D4 dispatch contract — the trust-but-verify reviewer pass OUTSIDE the coding agent. Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) TASK ACCOMPLISHED — the change-set the run produced actually implements the dispatched task's target + stage (e.g. a schema task added the persisted shape; a ui-behavior task added field displays); a run whose change-set does not advance the task's stated target is a GAP (the dispatch produced nothing useful), and an empty change-set on a task that should have authored files is a GAP. (2) CHANGE-SET SCOPED TO THE TASK — the files touched belong to the task's target (its module / resource / stage) and the app workspace; edits sprawling into unrelated modules, Wildo package source outside the application workspace, or files no build-plan task owns are a CONCERN (scope creep the reviewer must flag).
|
|
1154
|
+
Judge whether ONE dispatched build-plan task ran soundly under the D4 dispatch contract — the trust-but-verify reviewer pass OUTSIDE the coding agent. Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) TASK ACCOMPLISHED — the change-set the run produced actually implements the dispatched task's target + stage (e.g. a schema task added the persisted shape; a ui-behavior task added field displays); a run whose change-set does not advance the task's stated target is a GAP (the dispatch produced nothing useful), and an empty change-set on a task that should have authored files is a GAP. (2) CHANGE-SET SCOPED TO THE TASK — the files touched belong to the task's target (its module / resource / stage) and the app workspace; edits sprawling into unrelated modules, Wildo package source outside the application workspace, or files no build-plan task owns are a CONCERN (scope creep the reviewer must flag). Files attributed BASELINE_DIRTY_AMBIGUOUS were already dirty and changed again during the run; this establishes uncertainty, not ownership by a parallel editor. Every changed path outside the declared scope — ambiguous or not, and including a parallel session's edits, which the capture cannot tell apart from the run's own — is RECORDED on the result as `outOfScopePaths`; nothing refuses the run for it. Treat each as a CONCERN and resolve its authorship during review, never as a GAP by itself. Committed-window entries and recognized concurrent host-lane paths are classified separately and left off that list. (3) VERIFY RAN + PASSED — the deterministic verify gate (typecheck) ran OUTSIDE the coding agent after the run and passed; a run recorded as succeeded whose typecheck the reviewer cannot confirm passed is a CONCERN, and a run whose typecheck FAILED but was recorded succeeded is a GAP. (4) ATTRIBUTION CLEAN (the single-flight signal) — the run's edits are cleanly attributable to it in the captured change-set (files classed RUN_EXCLUSIVE or APPEARED_DURING_RUN), consistent with the single-flight lock having held for this dispatch. A change-set the capture could NOT cleanly attribute to the run — dominated by BASELINE_DIRTY_AMBIGUOUS overlap, or captured across a HEAD that moved mid-run — is a CONCERN the reviewer must resolve by hand before accepting the run, not a clean pass (single-flight is a hard runner floor, so this invariant reads the attribution the run actually recorded rather than re-proving the lock). (5) FAILURE DISPOSITION CORRECT — a failed/timed-out run's captured change-set is KEPT + FLAGGED for human triage (keep_and_flag), never silently reverted nor silently left as an un-recorded half-applied state; a failed run with no recorded change-set flag is a GAP (F-5 workspace-safety violation). (6) BOUNDARY DISCIPLINE — the dispatch stays at single-task depth: it dispatches ONE task, captures + verifies + records it, and applies onFailure. It does NOT re-decompose the plan (the build-decompose playbook owns the task graph), does NOT run MANY coding agents concurrently / design a concurrency scheduler / interleave the companion generation steps at scale (the scale playbook), and does NOT itself author schemas / fields / code (the coding agent does that at dispatch time). Evidence of re-decomposition, multi-agent scale orchestration, or the dispatcher authoring code itself is a CONCERN (scope creep out of the single-flight dispatch lane). (The checklist is declarative: nothing executes it; the current host's deterministic checks apply; the approval enum alone adds no gate.)
|