@wildo-ai/framework-knowledge 1.1.3 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +349 -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/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -73,7 +73,8 @@ File: `backend-api/src/modules/<module>/addons/flows-actors/*.ts`. The system mu
|
|
|
73
73
|
be `kind: ACTOR` with an actor whose `executionMode` is `AGENTIC` and a bound
|
|
74
74
|
`agentRef`. If it renders an in-app chat, it already qualifies — build it via
|
|
75
75
|
`flows-actors-chat-assistant`. Verify what will be advertised:
|
|
76
|
-
|
|
76
|
+
(There is no live introspection query for A2A exposure yet — verify against the agent/flow
|
|
77
|
+
declarations in `shared-lib` themselves.)
|
|
77
78
|
|
|
78
79
|
### Step 2: Enable external auth (OIDC provider + OAuth client)
|
|
79
80
|
External agents get a token from YOUR app's OIDC provider. For **user-delegated**
|
|
@@ -107,12 +108,14 @@ description, URL and **skill subset**.
|
|
|
107
108
|
Declare them on `ApplicationInitializationConfig.resourceServerInstances` in your
|
|
108
109
|
backend's initialization config — the same place named MCP servers are declared:
|
|
109
110
|
|
|
110
|
-
<!-- TIER C WAIVER: Tier A rejected
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
references/framework-named-a2a-agents-contract.md
|
|
111
|
+
<!-- TIER C WAIVER: Tier A was rejected for this app-root wiring illustration because the real
|
|
112
|
+
reference bootstrap combines named MCP and A2A entries and uses reference-application actor
|
|
113
|
+
names; copying that bootstrap would teach unrelated setup rather than this adapted declaration.
|
|
114
|
+
Tier B was rejected because a separate engine example would duplicate this application-owned
|
|
115
|
+
wiring without adding an executable engine consumer. The shared configuration contract is
|
|
116
|
+
already extracted in references/framework-named-a2a-agents-contract.md. This short adapted
|
|
117
|
+
literal is checked against the existing concierge declaration in the reference application's
|
|
118
|
+
backend bootstrap; it does not imply that named A2A support is absent there. -->
|
|
116
119
|
|
|
117
120
|
```ts
|
|
118
121
|
import { ResourceServerKind, type ResourceServerInstance } from '@wildo-ai/saas-models';
|
|
@@ -223,8 +226,8 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
223
226
|
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
224
227
|
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
225
228
|
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
226
|
-
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
227
|
-
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted.
|
|
229
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first — pass `id` when the user already gave one, or a searchQuery naming its title — then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
230
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. Read its outcome and health notes before answering: only a healthy nothing-matched result permits saying the search found no matching passages. Report unavailable or incomplete retrieval honestly; never turn missing sources into a claim that information does not exist.',
|
|
228
231
|
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
229
232
|
],
|
|
230
233
|
},
|
|
@@ -287,7 +290,8 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
287
290
|
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
288
291
|
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
289
292
|
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
290
|
-
//
|
|
293
|
+
// factory itself, which authorizes the dispatched operation before dispatching it,
|
|
294
|
+
// so there is no privilege escalation through a tool.
|
|
291
295
|
functionTools: [
|
|
292
296
|
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
293
297
|
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
@@ -359,9 +363,11 @@ An external agent then discovers and calls it over plain HTTP (no app code):
|
|
|
359
363
|
# 1. Discover
|
|
360
364
|
curl https://your-app.example.com/api/v1/a2a/.well-known/agent-card.json
|
|
361
365
|
|
|
362
|
-
# 2.
|
|
366
|
+
# 2. Request the exact audience from the discovered card.url (use the named URL for a named agent).
|
|
367
|
+
# The following URL illustrates the default agent; credentials are placeholders.
|
|
363
368
|
curl -X POST https://your-app.example.com/api/v1/oauth/token \
|
|
364
|
-
-d grant_type=client_credentials -d client_id=oc_org_… -d client_secret=…
|
|
369
|
+
-d grant_type=client_credentials -d client_id=oc_org_… -d client_secret=… \
|
|
370
|
+
--data-urlencode resource=https://your-app.example.com/api/v1/a2a
|
|
365
371
|
|
|
366
372
|
# 3. Converse (JSON-RPC message/send); skillId omitted → the single exposed skill
|
|
367
373
|
curl -X POST https://your-app.example.com/api/v1/a2a \
|
|
@@ -372,21 +378,23 @@ curl -X POST https://your-app.example.com/api/v1/a2a \
|
|
|
372
378
|
|
|
373
379
|
## Tasks: when a turn becomes addressable
|
|
374
380
|
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
response:
|
|
381
|
+
A completed blocking turn returns a reply without a task row. A task makes work addressable
|
|
382
|
+
beyond the original request; conversation history and task status are separate records.
|
|
378
383
|
|
|
379
|
-
|
|
|
384
|
+
| Request or outcome | What it gets back | Task lifetime |
|
|
380
385
|
|---|---|---|
|
|
381
|
-
|
|
|
382
|
-
| `configuration.blocking: false` |
|
|
383
|
-
|
|
|
386
|
+
| Blocking `message/send` completes | A reply `Message` with conversation context | No task for that reply |
|
|
387
|
+
| `configuration.blocking: false` | A `Task` with its own ID | Work continues independently of the request once the task is opened |
|
|
388
|
+
| Direct `message/stream` completes | Message frames and the final reply | No background task; disconnect during generation aborts the turn |
|
|
389
|
+
| Send or stream pauses for approval | A `Task` in `input-required`; a stream returns it in its terminal frame | The task reports the pause; the human decision uses the application's approval channel |
|
|
384
390
|
|
|
385
|
-
|
|
386
|
-
|
|
391
|
+
These are the supported 0.2.5 request/state spellings. Other supported dialects use the corresponding
|
|
392
|
+
projected names. If nonblocking task creation fails, the transport falls back to a blocking reply;
|
|
393
|
+
check the result kind before using its ID as a task handle. An approval pause whose task cannot be
|
|
394
|
+
created returns an error instead. Approval does not grant additional operation permissions.
|
|
387
395
|
|
|
388
|
-
|
|
389
|
-
the
|
|
396
|
+
Reattaching a stream to an existing task is different from starting a direct message stream:
|
|
397
|
+
disconnecting the subscription does not cancel the underlying task.
|
|
390
398
|
|
|
391
399
|
Once a task exists the client can `tasks/get` it and `tasks/cancel` it. Two behaviours
|
|
392
400
|
worth knowing because they surprise people:
|
|
@@ -416,6 +424,7 @@ whether a tool requires approval (see the HITL guidance).
|
|
|
416
424
|
|
|
417
425
|
## References
|
|
418
426
|
|
|
427
|
+
- `references/framework-a2a-token-budget-api.md` — capping what external agent callers spend: declare the allowance with CEILING semantics, and why the budget is per tenant while the throttle is per principal
|
|
419
428
|
- `references/framework-flows-actors-a2a-contract.md` — source-backed: the served
|
|
420
429
|
`A2A_AgentCard` / `A2A_Skill` discovery contract external agents consume.
|
|
421
430
|
- `references/framework-named-a2a-agents-contract.md` — source-backed: the
|
|
@@ -443,7 +452,7 @@ whether a tool requires approval (see the HITL guidance).
|
|
|
443
452
|
`rg "actorSystemRefs: \[\s*\]" backend-api/src` returns nothing.
|
|
444
453
|
- [ ] **Named agents only** — each named card advertises ONLY its subset, and its `url` is its own
|
|
445
454
|
audience: `curl …/a2a/<ref>/.well-known/agent-card.json` shows `"url": ".../a2a/<ref>"` and
|
|
446
|
-
|
|
455
|
+
the declared subset of the default card. That subset may equal the default when it selects every eligible system.
|
|
447
456
|
- [ ] **Named agents only** — an undeclared ref is fail-closed, never the default card:
|
|
448
457
|
`curl -o /dev/null -w '%{http_code}' …/a2a/ghost/.well-known/agent-card.json` returns `404`.
|
|
449
458
|
|
package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md
ADDED
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Framework A2A Token Budget API
|
|
2
|
+
|
|
3
|
+
Capping what external agent callers may SPEND on a tenant's behalf.
|
|
4
|
+
|
|
5
|
+
Read it before exposing an agent to callers you do not control — exposure is the easy half, and this
|
|
6
|
+
is the one that decides what a runaway caller costs.
|
|
7
|
+
|
|
8
|
+
## What you declare, and what you do not
|
|
9
|
+
|
|
10
|
+
Declare the allowance as a numeric **limit feature** granted by a billing product. That is all. The
|
|
11
|
+
transport resolves it live from the plan, so an upgrade or downgrade takes effect immediately with no
|
|
12
|
+
copy to keep in sync, and the burst throttle beside it needs no declaration at all.
|
|
13
|
+
|
|
14
|
+
## ⚠️ Declare the limit with `CEILING` semantics
|
|
15
|
+
|
|
16
|
+
This is a consumption cap. Under the default `FLOOR`, an unlimited default absorbs every finite plan
|
|
17
|
+
grant and **the cap silently never engages** — the same trap the feature-builder guidance records,
|
|
18
|
+
and this is the surface where it costs money.
|
|
19
|
+
|
|
20
|
+
There is a second silent path to the same place: if the feature read fails, resolution degrades to
|
|
21
|
+
definition DEFAULTS, and for this ceiling the default is unlimited. So a features-subsystem problem
|
|
22
|
+
removes the cap rather than erroring. That branch is made loud in feature resolution rather than
|
|
23
|
+
here, because this service cannot tell it apart from "the tenant genuinely has no budget".
|
|
24
|
+
|
|
25
|
+
## Two scopes that are easy to conflate
|
|
26
|
+
|
|
27
|
+
| | scope | what it caps |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| token budget | per **TENANT** | tokens per budget period, denying further turns once exhausted (HTTP 402) |
|
|
30
|
+
| burst throttle | per **PRINCIPAL** | turns per minute |
|
|
31
|
+
|
|
32
|
+
An organization holding several machine credentials therefore gets that many throttle windows against
|
|
33
|
+
one shared budget.
|
|
34
|
+
|
|
35
|
+
The period is a UTC calendar month — deliberately NOT the tenant's billing window, which would cost a
|
|
36
|
+
billing-account lookup on every turn.
|
|
37
|
+
|
|
38
|
+
## The overage is not "one turn"
|
|
39
|
+
|
|
40
|
+
Token usage is known only AFTER a turn completes, and recording is fire-and-forget, so every turn
|
|
41
|
+
already in flight when the allowance is reached passes the gate on the same reading. The real bound is
|
|
42
|
+
the concurrency the burst throttle permits × the size of those turns. Bounded and self-correcting on
|
|
43
|
+
the next turn — but do not describe it to a customer as a single-turn guarantee.
|
|
44
|
+
|
|
45
|
+
## Failure policy, split by what can be proven
|
|
46
|
+
|
|
47
|
+
- Allowance resolution fails → **DENY**. The transport returns HTTP 503 before dispatch. A read failure cannot establish that the tenant has no cap. A successfully resolved absent or unlimited allowance remains permitted; that is different from an unavailable allowance.
|
|
48
|
+
- A budget IS configured and consumption is unreadable → **DENY**. A cap demonstrably exists and the
|
|
49
|
+
tenant cannot be proven under it.
|
|
50
|
+
|
|
51
|
+
## A2A Token Budget
|
|
52
|
+
|
|
53
|
+
## Import Origins
|
|
54
|
+
|
|
55
|
+
- `@wildo-ai/saas-backend-lib`
|
|
56
|
+
|
|
57
|
+
## Source Excerpts
|
|
58
|
+
|
|
59
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
60
|
+
|
|
61
|
+
```typescript
|
|
62
|
+
*
|
|
63
|
+
* Capping what external agent callers may SPEND on a tenant's behalf.
|
|
64
|
+
*
|
|
65
|
+
* An application declares the allowance as a numeric LIMIT on a billing product, and nothing else:
|
|
66
|
+
* the transport resolves it live from the plan, so an upgrade or downgrade takes effect immediately
|
|
67
|
+
* with no copy to keep in sync. The burst throttle beside it needs no declaration at all.
|
|
68
|
+
*
|
|
69
|
+
* ⚠️ **Declare it with `CEILING` semantics.** This is a consumption cap, and under the default
|
|
70
|
+
* `FLOOR` an unlimited default absorbs every finite plan grant — so the cap silently never engages.
|
|
71
|
+
* That is the same trap the limit builders record, and this is the surface where it costs money.
|
|
72
|
+
*
|
|
73
|
+
* Two scopes, and they are not the same one: the BUDGET is per TENANT, the burst throttle is per
|
|
74
|
+
* PRINCIPAL. An organization holding several machine credentials therefore gets that many throttle
|
|
75
|
+
* windows against one shared budget.
|
|
76
|
+
*
|
|
77
|
+
* Per-tenant LLM **token budget** for the inbound A2A transport — the sustained cost control
|
|
78
|
+
* that complements the per-principal BURST throttle (`external-turn-rate-limit`). The burst
|
|
79
|
+
* throttle caps turns-per-minute; this caps tokens **per budget period** against the allowance the
|
|
80
|
+
* tenant's plan grants, and DENIES further turns once exhausted. The period is a UTC calendar
|
|
81
|
+
* month in v1 (see {@link A2ATokenBudgetBackendService.currentPeriodKey}) — deliberately NOT the
|
|
82
|
+
* tenant's billing window, which would cost a billing-account lookup on every turn.
|
|
83
|
+
*
|
|
84
|
+
* ## Two halves, deliberately separated
|
|
85
|
+
*
|
|
86
|
+
* - **Allowance** (the cap) is NOT stored here — it is resolved live from the billing plan via
|
|
87
|
+
* `FeatureResolution.resolveForScope(...).limits[{@link A2A_TOKEN_BUDGET_FEATURE_ID}]`, so a plan
|
|
88
|
+
* upgrade/downgrade takes effect immediately with no copy to keep in sync.
|
|
89
|
+
* - **Consumption** is accumulated in the `a2aTokenBudgetState` polymorphic SINGLETON (exactly one
|
|
90
|
+
* row per tenant; the period lives inside the row and is rolled in place). One row per tenant
|
|
91
|
+
* makes double-counting structurally impossible.
|
|
92
|
+
*
|
|
93
|
+
* ## Error policy (two distinct axes — do not conflate)
|
|
94
|
+
*
|
|
95
|
+
* The BUDGET SEMANTIC is fail-closed: exhausted allowance ⇒ hard deny (HTTP 402 at the transport),
|
|
96
|
+
* never a soft warning. The ERROR policy is split by what we can actually prove:
|
|
97
|
+
*
|
|
98
|
+
* - **Allowance resolution fails** → DENY with `ALLOWANCE_UNVERIFIABLE`. An unreadable
|
|
99
|
+
* allowance is not proof that the tenant has no cap. The transport returns HTTP 503 and no turn
|
|
100
|
+
* is dispatched. Once resolution recovers, the next request checks the actual allowance again.
|
|
101
|
+
* Successfully resolved absent or explicitly unlimited allowances still permit the turn.
|
|
102
|
+
* - **A budget IS configured but consumption is unreadable** → DENY
|
|
103
|
+
* ({@link A2ATokenBudgetDenialReason.CONSUMPTION_UNVERIFIABLE}). Here a cap demonstrably exists and
|
|
104
|
+
* we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
|
|
105
|
+
* to fail closed precisely because the counter lives in the application's primary datastore: if
|
|
106
|
+
* that is unreachable the application is down anyway, so this can never be the *sole* cause of an
|
|
107
|
+
* outage (unlike a Redis blip, which is why the burst throttle fails OPEN instead).
|
|
108
|
+
*
|
|
109
|
+
* ## Overage tolerance
|
|
110
|
+
*
|
|
111
|
+
* Token usage is only known AFTER a turn completes, so the gate compares ALREADY-ACCUMULATED
|
|
112
|
+
* consumption against the allowance — chosen over pre-charging an estimate, which would need a
|
|
113
|
+
* refund/reconcile path on every turn.
|
|
114
|
+
*
|
|
115
|
+
* The overage this admits is NOT "one turn": recording is fire-and-forget and the response returns
|
|
116
|
+
* before it lands, so every turn already in flight when the allowance is reached passes the gate on
|
|
117
|
+
* the same stale reading. The real bound is therefore the concurrency the burst throttle permits ×
|
|
118
|
+
* the size of those turns. That is acceptable for a spend cap (it is bounded and self-correcting on
|
|
119
|
+
* the next turn) but it must not be described as a single-turn guarantee.
|
|
120
|
+
*
|
|
121
|
+
```
|
|
@@ -102,9 +102,10 @@ export interface A2A_AgentCard {
|
|
|
102
102
|
|
|
103
103
|
## The A2A task surface (`tasks/get` / `tasks/cancel`)
|
|
104
104
|
|
|
105
|
-
Read this when an external agent needs to start work it will come back for.
|
|
106
|
-
|
|
107
|
-
|
|
105
|
+
Read this when an external agent needs to start work it will come back for. A turn that pauses
|
|
106
|
+
for human approval also becomes a task: it reaches `input-required`, persists the decision it is
|
|
107
|
+
waiting on, and leaves that state once its execution moves on. Both paths into a task are live,
|
|
108
|
+
so an integration you build now can encounter either.
|
|
108
109
|
|
|
109
110
|
The key thing to understand is **when a task exists at all** — most turns never create
|
|
110
111
|
one, and that is deliberate rather than a gap.
|
|
@@ -96,8 +96,8 @@ reference file.
|
|
|
96
96
|
|
|
97
97
|
### Step 4: Register the frontend view + launcher
|
|
98
98
|
Add a `FlowsActorsViewDefinition` to the module's `flowsActorsViews` with
|
|
99
|
-
`isAddressable: true`, `
|
|
100
|
-
(`'
|
|
99
|
+
`isAddressable: true`, `systemRef: '<systemRef>'`, and a `layoutPreset`
|
|
100
|
+
(use `'Default'` for the standard chat-first host). Add a
|
|
101
101
|
`LauncherItemTargetKind.VIEW` sidebar item with `viewRef: '<view ref>'`. See
|
|
102
102
|
`references/framework-flows-actors-view-api.md`.
|
|
103
103
|
|
|
@@ -178,8 +178,8 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
178
178
|
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
179
179
|
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
180
180
|
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
181
|
-
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
182
|
-
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted.
|
|
181
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first — pass `id` when the user already gave one, or a searchQuery naming its title — then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
182
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. Read its outcome and health notes before answering: only a healthy nothing-matched result permits saying the search found no matching passages. Report unavailable or incomplete retrieval honestly; never turn missing sources into a claim that information does not exist.',
|
|
183
183
|
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
184
184
|
],
|
|
185
185
|
},
|
|
@@ -242,7 +242,8 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
242
242
|
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
243
243
|
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
244
244
|
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
245
|
-
//
|
|
245
|
+
// factory itself, which authorizes the dispatched operation before dispatching it,
|
|
246
|
+
// so there is no privilege escalation through a tool.
|
|
246
247
|
functionTools: [
|
|
247
248
|
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
248
249
|
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
@@ -310,6 +311,7 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
310
311
|
|
|
311
312
|
## References
|
|
312
313
|
|
|
314
|
+
- `references/framework-tool-dispatch-obligations-api.md` — grounding an agent on resource operations, and the two controller-tier gates a HAND-WRITTEN tool must call itself
|
|
313
315
|
- `references/framework-flows-actors-tool-api.md` — source contracts for
|
|
314
316
|
`resourceReadTool(...)`, `resourceWriteTool(...)`, and the `FunctionTool` shape
|
|
315
317
|
(grounding + action tools).
|
|
@@ -322,7 +324,7 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
322
324
|
registered `functionTool` (a `resourceReadTool` produces `resource.<type>.read`).
|
|
323
325
|
- [ ] The ActorSystem sets `visibility: FRONTEND` (else the view can't list it).
|
|
324
326
|
- [ ] The actor's `agentRef` matches the authored agent's `ref`.
|
|
325
|
-
- [ ] The view's `
|
|
327
|
+
- [ ] The view's `systemRef` equals the ActorSystem `ref`; the launcher's
|
|
326
328
|
`viewRef` matches the view `ref`.
|
|
327
329
|
- [ ] Agent `operationKey` is `CHAT_COMPLETION` and its `providerRef` is a
|
|
328
330
|
registered provider.
|
|
@@ -333,7 +335,7 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
333
335
|
|---|---|
|
|
334
336
|
| functionRefs ↔ functionTools | `rg "functionRefs|resourceReadTool|functionRef:" backend-api/src/modules/*/addons/flows-actors` |
|
|
335
337
|
| system is frontend-visible | `rg "visibility:\s*FlowActorSystem_Visibility.FRONTEND" backend-api/src/modules` |
|
|
336
|
-
| view ↔ system ↔ launcher refs align | `rg "
|
|
338
|
+
| view ↔ system ↔ launcher refs align | `rg "systemRef|viewRef:|ref:\s*'" frontend/src/modules/*/app-level-views frontend/src/modules/*/app-shell.module.frontend.ts` |
|
|
337
339
|
|
|
338
340
|
## Common Rationalizations
|
|
339
341
|
|
|
@@ -353,7 +355,7 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
353
355
|
with the visibility grep).
|
|
354
356
|
- An agent `functionRef` with no registered `functionTool` (or vice-versa) →
|
|
355
357
|
dangling tool (catch with the functionRefs ↔ functionTools grep).
|
|
356
|
-
- A launcher `viewRef` or view `
|
|
358
|
+
- A launcher `viewRef` or view `systemRef` that names a non-existent view/system
|
|
357
359
|
→ dead navigation (catch with the ref-alignment grep).
|
|
358
360
|
|
|
359
361
|
## Related Skills
|
package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md
CHANGED
|
@@ -88,8 +88,8 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
88
88
|
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
89
89
|
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
90
90
|
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
91
|
-
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
92
|
-
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted.
|
|
91
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first — pass `id` when the user already gave one, or a searchQuery naming its title — then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
92
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. Read its outcome and health notes before answering: only a healthy nothing-matched result permits saying the search found no matching passages. Report unavailable or incomplete retrieval honestly; never turn missing sources into a claim that information does not exist.',
|
|
93
93
|
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
94
94
|
],
|
|
95
95
|
},
|
|
@@ -152,7 +152,8 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
152
152
|
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
153
153
|
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
154
154
|
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
155
|
-
//
|
|
155
|
+
// factory itself, which authorizes the dispatched operation before dispatching it,
|
|
156
|
+
// so there is no privilege escalation through a tool.
|
|
156
157
|
functionTools: [
|
|
157
158
|
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
158
159
|
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
@@ -221,6 +222,6 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
221
222
|
The matching **frontend** side (authored in the app module's
|
|
222
223
|
`app-level-views` + `app-shell.module.frontend.ts`) adds one
|
|
223
224
|
`FlowsActorsViewDefinition` — `{ ref: 'todo-assistant-view', isAddressable: true,
|
|
224
|
-
|
|
225
|
+
systemRef: 'todo-assistant', layoutPreset: 'Default', … }` — and a
|
|
225
226
|
`LauncherItemTargetKind.VIEW` sidebar item with `viewRef: 'todo-assistant-view'`.
|
|
226
227
|
That surfaces the assistant at `/flows-actors/todo-assistant-view`.
|
|
@@ -11,7 +11,7 @@ Read this when authoring Step 3 (grounding). It surfaces:
|
|
|
11
11
|
`functionRef` defaults to `resource.<resourceType>.<op>` (e.g. `resource.todos.create`).
|
|
12
12
|
You MUST supply `options.inputSchema` — the model-facing field contract — because a
|
|
13
13
|
write tool's arguments are resource-specific (unlike the read tool's fixed
|
|
14
|
-
`{ searchQuery, limit }`). Keep the schema to fields the model should legitimately
|
|
14
|
+
`{ id, searchQuery, limit }` — `id` reads ONE record through its READ operation; a `searchQuery` matches record text and never an id). Keep the schema to fields the model should legitimately
|
|
15
15
|
set: owner FKs and server-set fields are EC-injected, never model arguments. For
|
|
16
16
|
`UPDATE`, include the record `id` in the schema. Both factories run the operation as
|
|
17
17
|
the calling user under a rebuilt `ExecutionContext`, so the resource's own
|
|
@@ -40,14 +40,32 @@ All import from `@wildo-ai/saas-backend-lib`.
|
|
|
40
40
|
* it per resource an agent should be able to read (e.g. `resourceReadTool(TODOS)`),
|
|
41
41
|
* making any registered resource agent-readable without hand-writing a tool.
|
|
42
42
|
*
|
|
43
|
-
* The tool
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
43
|
+
* The tool dispatches the resource's PUBLIC, URL-bearing default LIST / SEARCH — the same
|
|
44
|
+
* operation a REST client reaches — under a user `ExecutionContext` rebuilt from the caller's
|
|
45
|
+
* socket auth, and applies that operation's own declared `roles` ACL through
|
|
46
|
+
* `AuthorizationsBackendService.authorizeInController` before dispatching it. So the framework's
|
|
47
|
+
* contextual filter AND the role ACL apply exactly as for the user's own request. (The role gate
|
|
48
|
+
* is named explicitly because it does NOT come free with the service path: the service tier
|
|
49
|
+
* applies tenancy and the operation pipeline and no role check, so a tool that merely dispatched
|
|
50
|
+
* would run with the ACL unread — which is what this factory did until 2026-09-08.) A resource
|
|
51
|
+
* that declares no URL-bearing default for the operation is REFUSED rather than served through its
|
|
52
|
+
* route-less internal variant. WHO the caller is is NEVER taken
|
|
53
|
+
* from the model — only the record `id`, `searchQuery` and `limit` args are. Its `functionRef`
|
|
47
54
|
* defaults to `resource.<resourceType>.read` — reference that exact string from
|
|
48
55
|
* your agent's `capabilities.tools.functionRefs`. Import path:
|
|
49
56
|
* `@wildo-ai/saas-backend-lib`.
|
|
50
57
|
*
|
|
58
|
+
* **Looking up one record by its id.** Pass `id` to read ONE record through the resource's
|
|
59
|
+
* URL-bearing default READ — the same operation a REST client reaches — authorized as a row
|
|
60
|
+
* call under the same role ACL and contextual filter. A record that does not exist and a record
|
|
61
|
+
* the caller may not see both answer an empty `data`, deliberately alike, so a lookup never tells
|
|
62
|
+
* a caller that a record they cannot see exists. When `id` is given, `searchQuery` is ignored.
|
|
63
|
+
* A `searchQuery` matches a resource's searchable TEXT and never an id: an agent told to
|
|
64
|
+
* "resolve the id" of a record the user already identified by id must pass it as `id`, because a
|
|
65
|
+
* search for an id finds nothing and reads, to the model and then to the user, as "no such
|
|
66
|
+
* record". A resource that declares no URL-bearing READ is refused, as for any operation it does
|
|
67
|
+
* not expose.
|
|
68
|
+
*
|
|
51
69
|
* @param resourceType the resource to expose (any registered `ResourceType`).
|
|
52
70
|
* @param options optional `functionRef` / `description` / `defaultLimit` / `maxLimit` overrides.
|
|
53
71
|
* @example
|
|
@@ -75,10 +93,23 @@ export function resourceReadTool(
|
|
|
75
93
|
* Produces a {@link FunctionTool} that lets an agent CREATE or UPDATE ONE resource
|
|
76
94
|
* type **as the calling user**, under the caller's own `ExecutionContext` rebuilt
|
|
77
95
|
* from their verified socket auth — no `systemAccessPolicy` bypass, and identity is
|
|
78
|
-
* NEVER taken from the model.
|
|
79
|
-
*
|
|
80
|
-
*
|
|
81
|
-
*
|
|
96
|
+
* NEVER taken from the model. It dispatches the resource's PUBLIC, URL-bearing default CREATE /
|
|
97
|
+
* UPDATE — the same operation a REST client reaches, with the same request DTO validating the
|
|
98
|
+
* model's arguments and the same prefix / postfix side effects — and applies that operation's own
|
|
99
|
+
* `accessControl` (roles + parent scope, plus per-row access on UPDATE) through
|
|
100
|
+
* `AuthorizationsBackendService.authorizeInController` before the write. Authorization is therefore
|
|
101
|
+
* **fail-closed**: a caller lacking the operation's role gets a thrown authz error, not a silent
|
|
102
|
+
* write.
|
|
103
|
+
*
|
|
104
|
+
* Both halves of that are load-bearing and neither came free, so do not simplify them away. The
|
|
105
|
+
* service tier applies tenancy and the operation pipeline and NO role check, and the service
|
|
106
|
+
* layer's own default resolver PREFERS a route-less `INTERNAL_CALL` variant over the public one —
|
|
107
|
+
* so before 2026-09-08 this factory dispatched a different operation from the one it advertises,
|
|
108
|
+
* with the ACL unread. On `organizations` CREATE that combination created ownerless tenants.
|
|
109
|
+
*
|
|
110
|
+
* A resource that declares no URL-bearing default for the operation is REFUSED rather than written
|
|
111
|
+
* through its internal variant. So is an operation that requires an Idempotency-Key: the tool has no key
|
|
112
|
+
* to send, so it would be refused on every call — write a dedicated tool that passes one. Owner FKs and
|
|
82
113
|
* other server-set fields are EC-injected / `excludeFromCreate`, so the model can
|
|
83
114
|
* never spoof ownership through the tool arguments.
|
|
84
115
|
*
|
|
@@ -149,6 +180,12 @@ export interface FunctionToolExecutionContext {
|
|
|
149
180
|
auth: SocketAuthResult;
|
|
150
181
|
/** Active organization scope for the call, when applicable. */
|
|
151
182
|
organizationId?: string;
|
|
183
|
+
/**
|
|
184
|
+
* The conversational execution (the thread) this call is a turn of, when the tool runs inside
|
|
185
|
+
* one. A tool that starts work elsewhere — a run, a task — stamps it onto that work so the thread
|
|
186
|
+
* can list what it started; the engine supplies it and reads nothing back from it.
|
|
187
|
+
*/
|
|
188
|
+
executionId?: string;
|
|
152
189
|
/** Backend services the tool may use. */
|
|
153
190
|
services: FunctionToolExecutionServices;
|
|
154
191
|
}
|
|
@@ -5,8 +5,8 @@ contribution shape:
|
|
|
5
5
|
|
|
6
6
|
- `FlowsActorsViewDefinition` — the authoring shape for a standalone flows-actors
|
|
7
7
|
view (`flowsActorsViews` entry). An addressable one routes at `/flows-actors/:ref`;
|
|
8
|
-
`
|
|
9
|
-
|
|
8
|
+
`systemRef` names one ActorSystem to expose. Use `layoutPreset: 'Default'`
|
|
9
|
+
for the standard chat-first host; the declaration does not add an adjacent graph. Import type from `@wildo-ai/saas-frontend-lib/companion`.
|
|
10
10
|
- The backend module contribution `flowsActors` — where `flowActorSystemsFactoryMap`,
|
|
11
11
|
`agents`, and **`functionTools`** are registered. (The `functionTools` field is
|
|
12
12
|
the one you populate with `resourceReadTool(...)` instances.)
|
|
@@ -25,13 +25,16 @@ contribution shape:
|
|
|
25
25
|
* module's `flowsActorsViews` (an app-level-views contribution); an addressable
|
|
26
26
|
* one routes at `/flows-actors/:ref` and is surfaced by a launcher item
|
|
27
27
|
* (`LauncherItemTargetKind.VIEW`, `viewRef: <ref>`). The engine `FlowsActorsView`
|
|
28
|
-
* host renders
|
|
28
|
+
* host renders streaming chat with execution and approval controls for the referenced system.
|
|
29
29
|
*
|
|
30
30
|
* Import type from `@wildo-ai/saas-frontend-lib/companion`.
|
|
31
31
|
*
|
|
32
32
|
* @property ref unique view id (used in the `/flows-actors/:ref` URL).
|
|
33
|
-
* @property
|
|
34
|
-
*
|
|
33
|
+
* @property systemRef the registered flow/actor system ref to expose. ONE per view: a view
|
|
34
|
+
* hosting several assistants would need a switcher, and hosting several
|
|
35
|
+
* means declaring several views.
|
|
36
|
+
* @property layoutPreset configured preset name; use 'Default' for the standard chat-first host.
|
|
37
|
+
* This field does not itself compose a graph beside the chat.
|
|
35
38
|
* @property isAddressable set `true` to give the view its own URL/route.
|
|
36
39
|
* @property primaryScope scope whose context is injected for access/navigation.
|
|
37
40
|
*/
|
|
@@ -43,7 +46,7 @@ export interface FlowsActorsViewDefinition {
|
|
|
43
46
|
isAddressable: boolean;
|
|
44
47
|
operationLike: CoreResourceOperation;
|
|
45
48
|
primaryScope: ResourcePrimaryScope;
|
|
46
|
-
|
|
49
|
+
systemRef: string;
|
|
47
50
|
layoutPreset: string;
|
|
48
51
|
/** Required features for this view — gates navigation + route access */
|
|
49
52
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
@@ -120,7 +123,7 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
120
123
|
* Aggregated by {@link mergeBackendDomainModules} into a single
|
|
121
124
|
* `Record<string, DataSeedScopeResolver>` and threaded through
|
|
122
125
|
* `ApplicationInitializationConfig.dataSeedScopeResolvers`. The
|
|
123
|
-
* data-seeding bootstrap (`
|
|
126
|
+
* data-seeding bootstrap (`wireDataSeedingDeclarations`) hands
|
|
124
127
|
* the merged map to
|
|
125
128
|
* {@link DataSeedScopeResolverRegistryBackendService.registerResolvers}
|
|
126
129
|
* once per boot.
|
|
@@ -133,6 +136,30 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
133
136
|
dataSeedScopeResolvers?: Record<string, DataSeedScopeResolver>;
|
|
134
137
|
}
|
|
135
138
|
|
|
139
|
+
/**
|
|
140
|
+
* Merge every module's backend contributions into one.
|
|
141
|
+
*
|
|
142
|
+
* ⚠️ **The fields do NOT all treat a cross-module duplicate the same way, and the difference is
|
|
143
|
+
* silent.** Three of them reject a duplicate at merge time with a `CONFIGURATION` error naming both
|
|
144
|
+
* contributors — `dataSeedScopeResolvers`, `pdfTemplateBindings` and `chartDefinitions`. Two of them
|
|
145
|
+
* do not:
|
|
146
|
+
*
|
|
147
|
+
* | field | duplicate across two modules |
|
|
148
|
+
* |---|---|
|
|
149
|
+
* | `resourceConfigurations` | **last module wins, silently** |
|
|
150
|
+
* | `resourceFieldIdentifiers` | **last module wins, silently** |
|
|
151
|
+
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` | rejected, naming both modules |
|
|
152
|
+
* | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
|
|
153
|
+
*
|
|
154
|
+
* Do not generalise the rejection to the whole object. Two modules declaring the same resource
|
|
155
|
+
* identifier produce no error and no warning: whichever is later in the registry array replaces the
|
|
156
|
+
* earlier one entirely, and the application boots. That shadowing is what lets an application layer
|
|
157
|
+
* its own module over the engine's, so it cannot be made an error — which is exactly why an
|
|
158
|
+
* ACCIDENTAL collision is invisible.
|
|
159
|
+
*
|
|
160
|
+
* If a resource behaves as though its configuration were somebody else's, check for a second module
|
|
161
|
+
* declaring the same identifier before looking anywhere else.
|
|
162
|
+
*/
|
|
136
163
|
export function mergeBackendDomainModules(
|
|
137
164
|
...modules: BackendDomainModule[]
|
|
138
165
|
): BackendDomainModule {
|