@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
|
@@ -87,5 +87,24 @@ export interface FrameworkKnowledgeSkillSummary {
|
|
|
87
87
|
* Sorted by name so a brief built twice from one artifact is byte-identical.
|
|
88
88
|
*/
|
|
89
89
|
export declare function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[];
|
|
90
|
+
/**
|
|
91
|
+
* One compiled skill's BODY — the `SKILL.md` a method means when it says "follow the `X` skill".
|
|
92
|
+
*
|
|
93
|
+
* Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:
|
|
94
|
+
* that projection is for CHOOSING between skills and carries one line each, and a method that has
|
|
95
|
+
* already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods
|
|
96
|
+
* instructed their model to follow a named skill "for the exact field contracts" while only its
|
|
97
|
+
* purpose line ever reached the brief (#1435).
|
|
98
|
+
*
|
|
99
|
+
* The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those
|
|
100
|
+
* are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs
|
|
101
|
+
* them, and a structured generation cannot open anything — inlining them would put tens of
|
|
102
|
+
* kilobytes of material nobody asked for into every brief. What the body says about them stays
|
|
103
|
+
* true for the coding agent that later executes the work.
|
|
104
|
+
*
|
|
105
|
+
* `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than
|
|
106
|
+
* rendering an empty section that reads like a skill with nothing in it.
|
|
107
|
+
*/
|
|
108
|
+
export declare function readFrameworkKnowledgeSkillBody(skillName: string): string | null;
|
|
90
109
|
export declare function getFrameworkKnowledgeSkillsIndex(): string | null;
|
|
91
110
|
//# sourceMappingURL=framework-knowledge.loader.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yCAAyC,EAEzC,sDAAsD,EACtD,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAE1B,uCAAuC,EACvC,oCAAoC,EACpC,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwC,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAsFxH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,qCAAqC,IAAI,8BAA8B,CAAC,0BAA0B,CAAC,CAalH;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAE1E;AAED,wBAAgB,gCAAgC,IAAI,oCAAoC,EAAE,CAEzF;AAED,wBAAgB,+BAA+B,IAAI,4BAA4B,CAE9E;AAED,wBAAgB,4BAA4B,IAAI,iCAAiC,EAAE,CAElF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAyB1F;AAED,wBAAgB,6BAA6B,CAAC,aAAa,SAAS,8BAA8B,EAChG,YAAY,EAAE,aAAa,GAC1B,6BAA6B,CAAC,aAAa,CAAC,CAE9C;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,uCAAuC,EAAE,CAK3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAmD5F;AAED,4EAA4E;AAC5E,wBAAgB,6CAA6C,IAAI,sDAAsD,EAAE,CAGxH;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,yCAAyC,GAAG,IAAI,CA0B5I;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sDAAsD,CACpE,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,8BAA8B,CAAC,OAAO,CAAC,GAAG,IAAI,CAWhD;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,IAAI,8BAA8B,EAAE,CAsBvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhF;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAQhE"}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { existsSync, readFileSync, readdirSync } from 'node:fs';
|
|
2
2
|
import { isAbsolute, normalize, resolve } from 'node:path';
|
|
3
3
|
import { fileURLToPath } from 'node:url';
|
|
4
|
-
import { describeCaughtError } from '@wildo-ai/saas-backend-lib';
|
|
5
4
|
import { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';
|
|
5
|
+
import { describeCaughtError } from '@wildo-ai/saas-models';
|
|
6
6
|
/**
|
|
7
7
|
* This package is intentionally consumed from compiled `dist/esm`.
|
|
8
8
|
* Resolving relative to `import.meta.url` keeps local package-preview and
|
|
@@ -46,6 +46,23 @@ function readBinaryKnowledgeAsset(relativePath) {
|
|
|
46
46
|
assertKnowledgeAssetExists(assetPath, relativePath);
|
|
47
47
|
return readFileSync(assetPath);
|
|
48
48
|
}
|
|
49
|
+
/**
|
|
50
|
+
* The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.
|
|
51
|
+
*
|
|
52
|
+
* `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from
|
|
53
|
+
* the backend library. The backend library's copy was imported here twice — before #1412, and again by
|
|
54
|
+
* the #1518 sweep that made the helper mandatory at every catch — and each time that one import made
|
|
55
|
+
* this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency
|
|
56
|
+
* (everything else this package takes from it is an erased `import type` in the playbook definitions),
|
|
57
|
+
* a devDependency is not installed for a consumer of the published package, and a VALUE import on a
|
|
58
|
+
* public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`
|
|
59
|
+
* pins it.
|
|
60
|
+
*
|
|
61
|
+
* The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native
|
|
62
|
+
* `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to
|
|
63
|
+
* cover a call into the engine: put that call behind its own catch in a package allowed to depend on
|
|
64
|
+
* the engine at runtime.
|
|
65
|
+
*/
|
|
49
66
|
function parseJsonKnowledgeBytes(bytes, relativePath) {
|
|
50
67
|
try {
|
|
51
68
|
return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
|
|
@@ -280,6 +297,35 @@ export function listFrameworkKnowledgeSkillSummaries() {
|
|
|
280
297
|
}
|
|
281
298
|
return summaries.sort((left, right) => left.name.localeCompare(right.name));
|
|
282
299
|
}
|
|
300
|
+
/**
|
|
301
|
+
* One compiled skill's BODY — the `SKILL.md` a method means when it says "follow the `X` skill".
|
|
302
|
+
*
|
|
303
|
+
* Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:
|
|
304
|
+
* that projection is for CHOOSING between skills and carries one line each, and a method that has
|
|
305
|
+
* already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods
|
|
306
|
+
* instructed their model to follow a named skill "for the exact field contracts" while only its
|
|
307
|
+
* purpose line ever reached the brief (#1435).
|
|
308
|
+
*
|
|
309
|
+
* The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those
|
|
310
|
+
* are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs
|
|
311
|
+
* them, and a structured generation cannot open anything — inlining them would put tens of
|
|
312
|
+
* kilobytes of material nobody asked for into every brief. What the body says about them stays
|
|
313
|
+
* true for the coding agent that later executes the work.
|
|
314
|
+
*
|
|
315
|
+
* `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than
|
|
316
|
+
* rendering an empty section that reads like a skill with nothing in it.
|
|
317
|
+
*/
|
|
318
|
+
export function readFrameworkKnowledgeSkillBody(skillName) {
|
|
319
|
+
// A name is a folder, so anything path-shaped would escape the skills directory. Refused rather
|
|
320
|
+
// than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.
|
|
321
|
+
if (!/^[a-z0-9-]+$/u.test(skillName))
|
|
322
|
+
return null;
|
|
323
|
+
const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;
|
|
324
|
+
const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;
|
|
325
|
+
if (!existsSync(resolveKnowledgeAssetPath(skillPath)))
|
|
326
|
+
return null;
|
|
327
|
+
return readTextKnowledgeAsset(skillPath);
|
|
328
|
+
}
|
|
283
329
|
export function getFrameworkKnowledgeSkillsIndex() {
|
|
284
330
|
const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;
|
|
285
331
|
if (!skillsIndexPath) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { describeCaughtError } from '@wildo-ai/saas-backend-lib';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
|
|
1
|
+
{"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\nimport { describeCaughtError } from '@wildo-ai/saas-models';\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\n/**\n * The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.\n *\n * `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from\n * the backend library. The backend library's copy was imported here twice — before #1412, and again by\n * the #1518 sweep that made the helper mandatory at every catch — and each time that one import made\n * this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency\n * (everything else this package takes from it is an erased `import type` in the playbook definitions),\n * a devDependency is not installed for a consumer of the published package, and a VALUE import on a\n * public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`\n * pins it.\n *\n * The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native\n * `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to\n * cover a call into the engine: put that call behind its own catch in a package allowed to depend on\n * the engine at runtime.\n */\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\n/**\n * One compiled skill's BODY — the `SKILL.md` a method means when it says \"follow the `X` skill\".\n *\n * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:\n * that projection is for CHOOSING between skills and carries one line each, and a method that has\n * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods\n * instructed their model to follow a named skill \"for the exact field contracts\" while only its\n * purpose line ever reached the brief (#1435).\n *\n * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those\n * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs\n * them, and a structured generation cannot open anything — inlining them would put tens of\n * kilobytes of material nobody asked for into every brief. What the body says about them stays\n * true for the coding agent that later executes the work.\n *\n * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than\n * rendering an empty section that reads like a skill with nothing in it.\n */\nexport function readFrameworkKnowledgeSkillBody(skillName: string): string | null {\n // A name is a folder, so anything path-shaped would escape the skills directory. Refused rather\n // than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.\n if (!/^[a-z0-9-]+$/u.test(skillName)) return null;\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) return null;\n return readTextKnowledgeAsset(skillPath);\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
|
|
1
|
+
{"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
|
package/dist/esm/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC"}
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
*/
|
|
19
19
|
export declare const playbookDefinition: {
|
|
20
20
|
readonly ref: "bottom_up.assemble-verify";
|
|
21
|
-
readonly version: "0.3.
|
|
21
|
+
readonly version: "0.3.1";
|
|
22
22
|
readonly phase: "bottom_up";
|
|
23
23
|
readonly intent: "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.";
|
|
24
24
|
readonly preconditions: readonly [{
|
|
@@ -32,7 +32,7 @@ export declare const playbookDefinition: {
|
|
|
32
32
|
}];
|
|
33
33
|
readonly outputs: readonly [];
|
|
34
34
|
readonly method: {
|
|
35
|
-
readonly skillRefs: readonly ["
|
|
35
|
+
readonly skillRefs: readonly ["application-database-migrations"];
|
|
36
36
|
};
|
|
37
37
|
readonly executor: "deterministic_cli";
|
|
38
38
|
readonly approval: "approve_result";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CAiCrB,CAAC"}
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
*/
|
|
19
19
|
export const playbookDefinition = {
|
|
20
20
|
"ref": "bottom_up.assemble-verify",
|
|
21
|
-
"version": "0.3.
|
|
21
|
+
"version": "0.3.1",
|
|
22
22
|
"phase": "bottom_up",
|
|
23
23
|
"intent": "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.",
|
|
24
24
|
"preconditions": [
|
|
@@ -30,9 +30,6 @@ export const playbookDefinition = {
|
|
|
30
30
|
"outputs": [],
|
|
31
31
|
"method": {
|
|
32
32
|
"skillRefs": [
|
|
33
|
-
"journey-status",
|
|
34
|
-
"journey-report",
|
|
35
|
-
"journey-approve",
|
|
36
33
|
"application-database-migrations"
|
|
37
34
|
]
|
|
38
35
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,uoEAAuoE;IACjpE,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;KACtE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,YAAY,EAAE;KAC3B;IACD,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE;QACR,WAAW,EAAE;YACX,iCAAiC;SAClC;KACF;IACD,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B;;;;;;;OAOG;IACH,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,OAAO;KACzB;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for topic 7 — the app-wide assemble/verify step.\n *\n * REBUILT rather than restored (issue #147). A playbook of this ref existed from\n * 2026-07-10 and was deleted on 2026-08-25 with the app-creation digest\n * demolition; the question it asked went with it, even though answering \"does\n * the built application assemble?\" needs no digests. Restoring it verbatim was\n * rejected: it declared the retired `COMPOSITE` executor, depended on two\n * families the demolition removed (`foundation-manifest`, `build-verification`),\n * and its method was explicit that NONE of its checks were actually run by the\n * runner — `// TODO CLI COMMAND:` placeholders and \"companion affordances that\n * do not exist yet\".\n *\n * What is different now is that the checks RUN. `DETERMINISTIC_CLI` is honoured\n * by the runtime as of #147, and the check refs below resolve through the same\n * closed `APPLICATION_CODING_TASK_VERIFICATION_CATALOG` a coding task uses, so\n * an unknown ref is refused rather than silently skipped.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.assemble-verify\",\n \"version\": \"0.3.1\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.\",\n \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"build-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"build-plan\" }\n ],\n \"outputs\": [],\n \"method\": {\n \"skillRefs\": [\n \"application-database-migrations\"\n ]\n },\n \"executor\": \"deterministic_cli\",\n \"approval\": \"approve_result\",\n /*\n * Token and model-call ceilings are OMITTED, not zeroed.\n *\n * Every field here is optional, and this tier makes no model calls at all — it runs typechecks in\n * a subprocess. Declaring `maxModelCalls: 0` is rejected by the schema (positive only), and\n * declaring `1` to satisfy it would state a ceiling nobody chose for a resource that is never\n * consumed. What IS bounded is wall-clock and how many times the step may run.\n */\n \"budget\": {\n \"maxRuns\": 40,\n \"maxDurationMs\": 3600000\n },\n \"onFailure\": \"keep_and_flag\",\n} as const;\n"]}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { MetaWorkflow_ApprovalPolicy, MetaWorkflow_EvaluationVerdict, MetaWorkflow_FailurePolicy, MetaWorkflow_PredicateKind } from '@wildo-ai/saas-models/meta-workflows';
|
|
2
|
+
import { MetaWorkflow_InputRender, MetaWorkflow_Phase } from '@wildo-ai/saas-specifications/application-creation';
|
|
3
|
+
/**
|
|
4
|
+
* The BUILD LANE — from an accepted conception to a built, verified application and its maturity
|
|
5
|
+
* reading (#1501, epic #1506).
|
|
6
|
+
*
|
|
7
|
+
* Until this existed `build-decompose`, `build-dispatch` and `assemble-verify` were driven by hand or
|
|
8
|
+
* by `dispatch_next`: a task that could not land was re-offered until the loop guard stopped it, a
|
|
9
|
+
* coherence GAP found after the build had no way back to conception, and the lane ended on four
|
|
10
|
+
* typechecks with no reading of what was built against what was required. This lane runs the three
|
|
11
|
+
* as one choreography — decompose, then dispatch until the plan is exhausted, then assemble — and it
|
|
12
|
+
* will end on the maturity reading (#1496): a stage against the requirements, never a "done".
|
|
13
|
+
*
|
|
14
|
+
* ## The lane's OWN gate is the conception lane's output
|
|
15
|
+
*
|
|
16
|
+
* READINESS on the placement plan, which is the last family the conception lane lands and the one
|
|
17
|
+
* the decomposer only EXPECTS on its own (`artifact_expected`, so a standalone decompose may run
|
|
18
|
+
* without it — which is how an application came to have no navigation, #1265 R-6). Gating the lane
|
|
19
|
+
* at READINESS is what makes "the decomposer cannot start before placement has landed" true for a
|
|
20
|
+
* build driven through the lane: the leaf keeps its own sequencing gate and its own explicit-run
|
|
21
|
+
* door, and the lane will not open until placement is on record. The domain plan is declared for the
|
|
22
|
+
* same reason, and both are declared as inputs (audit rule 24).
|
|
23
|
+
*
|
|
24
|
+
* ## The dispatch LOOP is the child being re-offered, on purpose
|
|
25
|
+
*
|
|
26
|
+
* `build-dispatch` is a `CODING_AGENT` step: one run dispatches ONE ready task (a coding run, or a
|
|
27
|
+
* companion-owned generation step — labels, logo, emails, seeds — routed by the task's own target
|
|
28
|
+
* kind), waits for it, and reports. It lands no family, so the runtime never marks it delivered and
|
|
29
|
+
* offers it again every round: that IS the loop. The plan's readiness is re-derived from git each
|
|
30
|
+
* time, so a task accepted between two rounds unblocks its dependents without anyone re-planning.
|
|
31
|
+
*
|
|
32
|
+
* ## How the lane SEES its own work, and where it ends
|
|
33
|
+
*
|
|
34
|
+
* Both halves were measured missing on this lane's first live run and both are now built (#1501):
|
|
35
|
+
*
|
|
36
|
+
* - **A dispatch child reports what it did**, as a step value under `dispatch:<ref>` — the task, its
|
|
37
|
+
* kind, how its coding run settled, and how much of the plan is left. Before that a child which
|
|
38
|
+
* lands no family returned nothing into the run's scope, so the round history carried the objective
|
|
39
|
+
* and no outcome: over twenty live rounds the selector narrated task names it could not have seen
|
|
40
|
+
* and finally instructed the child to "inspect the recorded D4 outcome for the immediately preceding
|
|
41
|
+
* dispatch" — the composite asking to be told what it should have been handed.
|
|
42
|
+
* - **An exhausted plan withholds dispatch** rather than failing it. `BUILD_PLAN_EXHAUSTED` is the
|
|
43
|
+
* twin of `NOTHING_TO_DECOMPOSE` one step down the same plan, and READINESS where that one is
|
|
44
|
+
* SEQUENCING: re-decomposing a finished plan succeeds, dispatching one cannot, and only READINESS
|
|
45
|
+
* ends the loop inside an explicitly-run lane, where sequencing is bypassed. So the round that
|
|
46
|
+
* used to re-offer a dispatch that threw now offers `assemble-verify`, and the lane ends there.
|
|
47
|
+
* - **A plan whose every ready task is stuck withholds dispatch too.** `BUILD_PLAN_BLOCKED_ON_STUCK_TASKS`
|
|
48
|
+
* is exhaustion's twin for "tasks remain, and none that is ready can run": the dispatcher refuses
|
|
49
|
+
* before starting one, so the lane stops offering it and says which tasks hold it, instead of
|
|
50
|
+
* failing a dispatch every round (#1547).
|
|
51
|
+
*
|
|
52
|
+
* What is still a report rather than a route: a task that cannot land (parked on a question, or
|
|
53
|
+
* refused) re-opens `bottom_up.build-decompose` in refine mode only once a verdict routes (#1498),
|
|
54
|
+
* and that declaration belongs on a revise child rather than on this lane.
|
|
55
|
+
*
|
|
56
|
+
* ## `build-scale` is admitted, and today it runs as a dispatch
|
|
57
|
+
*
|
|
58
|
+
* Admitted in c6a1a235 (#1273) because nothing else could ever reach it. This section used to argue
|
|
59
|
+
* the opposite, and it was left standing beside that admission — a lane saying two things at once.
|
|
60
|
+
* What is true now: `build-scale` declares the same executor as `build-dispatch` and runs through
|
|
61
|
+
* the same single-flight branch, one ready task per run. The wave its method describes does not
|
|
62
|
+
* exist yet (the runtime says so where it reports a dispatch, and `remainingReadyTaskRefs` keeps a
|
|
63
|
+
* scale run from reading as a wave it never ran). #1528 owns building it. Until then the method
|
|
64
|
+
* tells the selector to prefer `build-dispatch`, so the two names do not compete for one act.
|
|
65
|
+
*
|
|
66
|
+
* ## The lane ENDS on the maturity reading (#1496, admitted 2026-09-22 when its leaf landed)
|
|
67
|
+
*
|
|
68
|
+
* `bottom_up.assemble-verify` answers whether what was built ASSEMBLES — four typechecks and a
|
|
69
|
+
* migration probe, its own method saying it "does not boot the application, run its test suite".
|
|
70
|
+
* `bottom_up.maturity-reading` answers the question that makes the lane worth running: which of the
|
|
71
|
+
* application's own requirements are addressed, by what evidence, and what STAGE that puts it at.
|
|
72
|
+
*
|
|
73
|
+
* Paul, 2026-09-22: *"there are no 'Done' for an app, there are a measurement face to requirements,
|
|
74
|
+
* with some stage … this measurement should be evolutive."* So the lane's closing decision is read
|
|
75
|
+
* against the reading, and a run that stops short of it has not finished — which is why it is listed
|
|
76
|
+
* FIRST in `admits`, where the trap check puts the closing move.
|
|
77
|
+
*
|
|
78
|
+
* **Only this lane admits it, deliberately.** Its own gate is `artifact_exists: requirements`, so it
|
|
79
|
+
* could be offered far earlier — and a reading of an application nobody has conceived says "nothing is
|
|
80
|
+
* addressed", which is true and worth nothing. A second admitter would also let one root run land the
|
|
81
|
+
* same reading twice from the same inputs, because a nested lane's delivered set is its own. The root's
|
|
82
|
+
* ending is the boundary decision READ AGAINST whatever reading is on record, not a second reading.
|
|
83
|
+
*
|
|
84
|
+
* The surface lanes' work (UX #1493, website #1492, documentation #1494, integration #1495) feeds the
|
|
85
|
+
* same task graph through DECOMPOSITION rather than through new children here — their plans are the
|
|
86
|
+
* conception lane's, and the decomposer declares all of them as inputs.
|
|
87
|
+
*
|
|
88
|
+
* ## Loop-back — declared when the mechanism exists
|
|
89
|
+
*
|
|
90
|
+
* | signal | re-opens | how, once it can |
|
|
91
|
+
* |---|---|---|
|
|
92
|
+
* | a task that cannot land (parked, refused, failed twice) | `bottom_up.build-decompose` in refine mode | verdict routing (#1498) on the dispatch report |
|
|
93
|
+
* | a coherence GAP naming a module or relationship | `bottom_up.domain-plan`, through the root | the root routes it to the conception lane (#1503, after #1497) |
|
|
94
|
+
* | a domain plan or placement newer than the landed build plan | `bottom_up.build-decompose` | ALREADY WORKS — the decompose completion gate re-opens on any newer upstream commit |
|
|
95
|
+
*/
|
|
96
|
+
export declare const playbookDefinition: {
|
|
97
|
+
ref: string;
|
|
98
|
+
version: string;
|
|
99
|
+
phase: MetaWorkflow_Phase.BOTTOM_UP;
|
|
100
|
+
intent: string;
|
|
101
|
+
preconditions: {
|
|
102
|
+
kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID;
|
|
103
|
+
selector: {
|
|
104
|
+
family: string;
|
|
105
|
+
};
|
|
106
|
+
}[];
|
|
107
|
+
inputs: {
|
|
108
|
+
family: string;
|
|
109
|
+
render: MetaWorkflow_InputRender.MAP;
|
|
110
|
+
}[];
|
|
111
|
+
outputs: any[];
|
|
112
|
+
stepOutputs: {
|
|
113
|
+
ref: string;
|
|
114
|
+
condensation: string;
|
|
115
|
+
}[];
|
|
116
|
+
method: {
|
|
117
|
+
skillRefs: any[];
|
|
118
|
+
choreography: {
|
|
119
|
+
admits: string[];
|
|
120
|
+
maximumIterations: number;
|
|
121
|
+
maximumLanesPerIteration: number;
|
|
122
|
+
maximumDurationMs: number;
|
|
123
|
+
reopenOnVerdict: {
|
|
124
|
+
whenVerdictOf: string;
|
|
125
|
+
criterionRef: string;
|
|
126
|
+
verdicts: MetaWorkflow_EvaluationVerdict.GAP[];
|
|
127
|
+
reopen: string[];
|
|
128
|
+
}[];
|
|
129
|
+
};
|
|
130
|
+
};
|
|
131
|
+
approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT;
|
|
132
|
+
budget: {};
|
|
133
|
+
onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG;
|
|
134
|
+
};
|
|
135
|
+
//# sourceMappingURL=playbook.definition.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.build/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkH9B,CAAC"}
|