@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md
CHANGED
|
@@ -20,7 +20,7 @@ Per-primitive UI parameter surfaces (string, number, enum, etc.).
|
|
|
20
20
|
*
|
|
21
21
|
* They belong to the frontend resource behavior layer, not to shared resource
|
|
22
22
|
* schemas. In application code, they are typically authored in files like:
|
|
23
|
-
* `
|
|
23
|
+
* `frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
24
24
|
*
|
|
25
25
|
* The shared schema establishes structural meaning (`isSummaryField`,
|
|
26
26
|
* `isForeignKey`, `excludeFromUpdate`, ...). These UI parameter types control
|
|
@@ -63,7 +63,16 @@ export interface BooleanUIParams {
|
|
|
63
63
|
export interface StringUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
64
64
|
/** Display renderer. TEXT | TRUNCATE | MULTILINE | MARKDOWN | COLOR | LINK | EMAIL | BADGE | COPY | SECRET. */
|
|
65
65
|
displayMode?: StringDisplayMode;
|
|
66
|
-
/**
|
|
66
|
+
/**
|
|
67
|
+
* Max characters of the value to show (TRUNCATE displayMode only). Beyond it the value is cut
|
|
68
|
+
* and an ellipsis marks that more exists; the full value stays reachable as the element's
|
|
69
|
+
* `title`.
|
|
70
|
+
*
|
|
71
|
+
* This is a CHARACTER cap and it composes with — rather than replaces — the width cap TRUNCATE
|
|
72
|
+
* already applies through CSS. A value is clipped by whichever of the two is shorter, so the
|
|
73
|
+
* cap holds on a wide screen where the container would have had room, which is the point of
|
|
74
|
+
* declaring it. Leave it unset to keep width as the only axis.
|
|
75
|
+
*/
|
|
67
76
|
truncateLength?: number;
|
|
68
77
|
/**
|
|
69
78
|
* SECRET displayMode only: render the value revealed (not masked) on first
|
|
@@ -130,6 +139,17 @@ export interface EnumUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
|
130
139
|
export interface EnumUIEditParams extends PrimitiveUIBaseEditParams {
|
|
131
140
|
/** Edit control. SELECT | RADIO | RADIO_ICON_ONLY | TOGGLE | TOGGLE_ICON_ONLY | CARD | CARD_ICON_ONLY | COMBOBOX. */
|
|
132
141
|
editMode?: EnumEditMode;
|
|
142
|
+
/**
|
|
143
|
+
* How this enum is chosen when the FIELD IS AN ARRAY of it (`z.array(z.enum(X))`).
|
|
144
|
+
*
|
|
145
|
+
* A separate key from `editMode`, not a reinterpretation of it: the two vocabularies answer
|
|
146
|
+
* different questions and share no member meaning. Declared on the ELEMENT rather than on the
|
|
147
|
+
* array because every other per-value presentation decision — `values`, `defaultIcon`,
|
|
148
|
+
* `defaultColor` — is declared here too, and splitting them would put half an enum's appearance
|
|
149
|
+
* in `arrayUI()`, which is otherwise about arrayness (sorting, add mode, item framing) and is
|
|
150
|
+
* shared with arrays of things that are not enums at all.
|
|
151
|
+
*/
|
|
152
|
+
multipleEditMode?: EnumMultipleEditMode;
|
|
133
153
|
/** Direction of radio/toggle/checkbox group. Renamed from `layout`. */
|
|
134
154
|
editDirection?: LayoutDirection;
|
|
135
155
|
/** Number of grid columns for radio/toggle/card groups. Renamed from `columns`. */
|
|
@@ -152,7 +172,32 @@ export interface EnumUIParams {
|
|
|
152
172
|
// DATE / DATETIME / TIME UI
|
|
153
173
|
//------------------------------------------------------------------------------------------------
|
|
154
174
|
|
|
155
|
-
|
|
175
|
+
/**
|
|
176
|
+
* How a date or datetime value is PHRASED. The sibling of `StringDisplayMode` and
|
|
177
|
+
* `NumberDisplayMode` for the temporal primitives.
|
|
178
|
+
*
|
|
179
|
+
* Without it every date in every Wildo application reads identically: a `createdAt` on an audit
|
|
180
|
+
* row and a `dueDate` on a work item are the same pixels, because the only available rendering
|
|
181
|
+
* was the regional absolute format. The distinction is not cosmetic — a deadline is understood
|
|
182
|
+
* against NOW, and a record of when something happened is understood against the calendar.
|
|
183
|
+
*
|
|
184
|
+
* `AUTO` is the one to reach for on a field that is both at different times: a due date is a
|
|
185
|
+
* deadline this week and a historical fact next quarter.
|
|
186
|
+
*/
|
|
187
|
+
export const DateDisplayMode = {
|
|
188
|
+
/** The regional absolute format — what every date rendered as before this vocabulary existed. */
|
|
189
|
+
ABSOLUTE: 'absolute',
|
|
190
|
+
/** Phrased against now: "tomorrow", "in 3 days", "2 months ago". Always relative, at any distance. */
|
|
191
|
+
RELATIVE: 'relative',
|
|
192
|
+
/** Relative while the value is near now, absolute once it is not. The near window is a week. */
|
|
193
|
+
AUTO: 'auto',
|
|
194
|
+
} as const;
|
|
195
|
+
export type DateDisplayMode = typeof DateDisplayMode[keyof typeof DateDisplayMode];
|
|
196
|
+
|
|
197
|
+
export interface DateUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
198
|
+
/** How the value is phrased. ABSOLUTE (default) | RELATIVE | AUTO. */
|
|
199
|
+
displayMode?: DateDisplayMode;
|
|
200
|
+
}
|
|
156
201
|
export type DateUIEditParams = PrimitiveUIBaseEditParams;
|
|
157
202
|
export interface DateUIParams {
|
|
158
203
|
display?: DateUIDisplayParams;
|
|
@@ -160,7 +205,16 @@ export interface DateUIParams {
|
|
|
160
205
|
edit?: DateUIEditParams;
|
|
161
206
|
}
|
|
162
207
|
|
|
163
|
-
export
|
|
208
|
+
export interface DateTimeUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
209
|
+
/**
|
|
210
|
+
* How the value is phrased. ABSOLUTE (default) | RELATIVE | AUTO.
|
|
211
|
+
*
|
|
212
|
+
* A datetime's relative phrasing resolves finer than a date's — "in 20 minutes", "3 hours ago"
|
|
213
|
+
* — because the value carries a time of day to be precise about. Beyond a day it falls back to
|
|
214
|
+
* the same calendar units a date uses.
|
|
215
|
+
*/
|
|
216
|
+
displayMode?: DateDisplayMode;
|
|
217
|
+
}
|
|
164
218
|
export type DateTimeUIEditParams = PrimitiveUIBaseEditParams;
|
|
165
219
|
export interface DateTimeUIParams {
|
|
166
220
|
display?: DateTimeUIDisplayParams;
|
|
@@ -168,6 +222,15 @@ export interface DateTimeUIParams {
|
|
|
168
222
|
edit?: DateTimeUIEditParams;
|
|
169
223
|
}
|
|
170
224
|
|
|
225
|
+
/**
|
|
226
|
+
* DELIBERATELY has no `displayMode`, and this is a statement rather than an omission.
|
|
227
|
+
*
|
|
228
|
+
* A time-of-day carries no date, so "relative to now" has no answer: is `09:30` this morning,
|
|
229
|
+
* tomorrow morning, or the opening hour of a shop that never happens on any particular day? Any
|
|
230
|
+
* relative phrasing would have to ASSUME a date the value does not hold, and would be confidently
|
|
231
|
+
* wrong on exactly the fields — opening hours, schedules, recurring slots — that `z.time()` exists
|
|
232
|
+
* for. A field that wants a relative phrasing is carrying a datetime and should say so.
|
|
233
|
+
*/
|
|
171
234
|
export type TimeUIDisplayParams = PrimitiveUIBaseDisplayParams;
|
|
172
235
|
export type TimeUIEditParams = PrimitiveUIBaseEditParams;
|
|
173
236
|
export interface TimeUIParams {
|
|
@@ -329,6 +392,36 @@ export interface ForeignKeyUIDisplayParams extends PrimitiveUIBaseDisplayParams
|
|
|
329
392
|
linkable?: boolean;
|
|
330
393
|
/** Override the preset used to display the referenced resource summary. */
|
|
331
394
|
displayPresetOverride?: string;
|
|
395
|
+
/**
|
|
396
|
+
* A SIBLING field on the SAME record holding a readable copy of the referenced row's label —
|
|
397
|
+
* used when the reference itself cannot be resolved, INSTEAD of printing the raw id.
|
|
398
|
+
*
|
|
399
|
+
* ## Why a raw id is not an acceptable fallback
|
|
400
|
+
*
|
|
401
|
+
* `ForeignKeyDisplayMode.LABEL` is the default and resolves the referenced row's label. When that
|
|
402
|
+
* resolution yields nothing the renderer had one option left: print the foreign key. Measured
|
|
403
|
+
* 2026-09-19 on the Settings hub's member directory — three of four rows showed
|
|
404
|
+
* `6aaba6b3a2d3b6b0ad61f33e` in the USER column, because those people are invited and have no
|
|
405
|
+
* `USER_PROFILE` for a label to come from. The fourth, a real user, resolved.
|
|
406
|
+
*
|
|
407
|
+
* The readable value was on the row the whole time. `organizationMembers.userEmail` is a
|
|
408
|
+
* denormalized immutable copy of the linked user's email whose own docstring says it exists so "a
|
|
409
|
+
* membership row can be read without resolving the user" — exactly this case — and it is
|
|
410
|
+
* `.isHidden({ display: true })` precisely BECAUSE "the user-facing email is surfaced by resolving
|
|
411
|
+
* the `userId` reference". When that resolution fails, the design's own premise fails with it and
|
|
412
|
+
* nothing picks the copy up.
|
|
413
|
+
*
|
|
414
|
+
* ## Why this is declared rather than derived
|
|
415
|
+
*
|
|
416
|
+
* Nothing in the schema says "this field is a readable copy of that reference". A convention
|
|
417
|
+
* guessed from the name (`userId` → `userEmail`) would be wrong the first time a resource spells
|
|
418
|
+
* it differently, and silently. So the relationship is NAMED by the one author who knows it, and
|
|
419
|
+
* omitting it keeps today's behaviour exactly.
|
|
420
|
+
*
|
|
421
|
+
* Read from the record being displayed; a missing or empty sibling falls through to the id as
|
|
422
|
+
* before, so this can never render less than it does now.
|
|
423
|
+
*/
|
|
424
|
+
labelFallbackField?: string;
|
|
332
425
|
}
|
|
333
426
|
|
|
334
427
|
export interface ForeignKeyUIEditParams extends PrimitiveUIBaseEditParams {
|
|
@@ -354,11 +447,42 @@ export interface ForeignKeyUIParams {
|
|
|
354
447
|
// ARRAY UI
|
|
355
448
|
//------------------------------------------------------------------------------------------------
|
|
356
449
|
|
|
450
|
+
/**
|
|
451
|
+
* List marker treatment for a PRIMITIVE array's display items.
|
|
452
|
+
*
|
|
453
|
+
* Its own enum rather than a new `DisplayDirection` member on purpose: direction answers "which
|
|
454
|
+
* axis do items flow on", marker style answers "does each item announce itself as one of several" —
|
|
455
|
+
* merging them would make `BULLETS × horizontal` an unrepresentable-but-meaningful combination and
|
|
456
|
+
* overload an enum that alignment code also reads.
|
|
457
|
+
*/
|
|
458
|
+
export enum ArrayListStyle {
|
|
459
|
+
/** Bare stacked values — the historical default. */
|
|
460
|
+
PLAIN = 'plain',
|
|
461
|
+
/** A real bulleted list. For enumerations a reader SCANS — alternatives, consequences, principles — where bare stacked lines read as one run-on paragraph. */
|
|
462
|
+
BULLETS = 'bullets',
|
|
463
|
+
/**
|
|
464
|
+
* A RULED list: one hairline between entries, none above the first or below the last.
|
|
465
|
+
*
|
|
466
|
+
* For OBJECT entries a reader compares — an ICP after an ICP, a persona after a persona — where
|
|
467
|
+
* spacing alone stops saying where one ends. It is the alternative to framing each entry as a
|
|
468
|
+
* card, and the reason to prefer it is compounding chrome: inside a section that is already a
|
|
469
|
+
* bounded region, a card per entry is a third frame around content that has two. Unlike
|
|
470
|
+
* {@link ArrayListStyle.BULLETS}, which is for primitive lines, this is for entries.
|
|
471
|
+
*/
|
|
472
|
+
SEPARATED = 'separated',
|
|
473
|
+
}
|
|
474
|
+
|
|
357
475
|
export interface ArrayUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
358
476
|
/** Direction for rendering items in display context. */
|
|
359
477
|
displayMode?: DisplayDirection;
|
|
360
478
|
/** Max items shown in display (rest truncated). */
|
|
361
479
|
maxItems?: number;
|
|
480
|
+
/**
|
|
481
|
+
* Marker treatment for PRIMITIVE items (see {@link ArrayListStyle}). No effect on object arrays —
|
|
482
|
+
* their items are cards/rows, not list lines — and no effect on horizontal flow, where markers
|
|
483
|
+
* have no line to anchor to.
|
|
484
|
+
*/
|
|
485
|
+
listStyle?: ArrayListStyle;
|
|
362
486
|
}
|
|
363
487
|
|
|
364
488
|
/**
|
|
@@ -449,6 +573,18 @@ export interface ObjectUIDisplayParams extends PrimitiveUIBaseDisplayParams {
|
|
|
449
573
|
displayMode?: DisplayDirection;
|
|
450
574
|
/** Max properties shown in display (rest truncated). */
|
|
451
575
|
maxItems?: number;
|
|
576
|
+
/**
|
|
577
|
+
* The member that IS this object's headline when the object renders as a unit (a nested object
|
|
578
|
+
* block, an array item card): it renders FIRST, label hidden, with title emphasis; the remaining
|
|
579
|
+
* members follow in schema order.
|
|
580
|
+
*
|
|
581
|
+
* Explicit rather than detected: "the first string field" guesses wrong the moment a stable
|
|
582
|
+
* identifier precedes the human statement in the schema — exactly the shape ref-addressable
|
|
583
|
+
* entries have (`ref` first, `statement` second), where detection would headline the machine key.
|
|
584
|
+
* Names a member that does not exist → ignored, so a schema rename degrades to the old uniform
|
|
585
|
+
* rendering instead of crashing the display.
|
|
586
|
+
*/
|
|
587
|
+
primaryField?: string;
|
|
452
588
|
}
|
|
453
589
|
|
|
454
590
|
export type ObjectUIEditParams = PrimitiveUIBaseEditParams;
|
|
@@ -22,6 +22,9 @@ export interface PrimitiveUIBaseDisplayParams {
|
|
|
22
22
|
/** Chrome layout mode for the field wrapper in display context. */
|
|
23
23
|
chromeMode?: ResponsiveAware<DisplayChromeMode>;
|
|
24
24
|
|
|
25
|
+
/** Label styling, orthogonal to `chromeMode` (which decides LAYOUT). See `DisplayLabelStyle`. */
|
|
26
|
+
labelStyle?: DisplayLabelStyle;
|
|
27
|
+
|
|
25
28
|
/** Force-hide specific chrome sub-elements in display context. Plain object = all breakpoints. */
|
|
26
29
|
forceHide?: ResponsiveAware<ForceHideDisplayConfig>;
|
|
27
30
|
|
|
@@ -102,6 +102,51 @@ export type LayoutTemplate = React.ComponentType;
|
|
|
102
102
|
* companion validation. Omit `edit` / `display` / `summary` individually to keep the
|
|
103
103
|
* auto-generated default for that context only.
|
|
104
104
|
*/
|
|
105
|
+
/**
|
|
106
|
+
* How a layout decides which of its fields may be edited IN PLACE on the READ surface.
|
|
107
|
+
*
|
|
108
|
+
* ## Why this is a layout decision and not only a per-field one
|
|
109
|
+
*
|
|
110
|
+
* Inline edit was per-field only: a field became editable in place by declaring
|
|
111
|
+
* `{primitive}UI.display.inlineEditable`. That is right for an ordinary resource, where editing a
|
|
112
|
+
* row is an occasional act and a READ page is mostly for reading.
|
|
113
|
+
*
|
|
114
|
+
* It is the wrong default for a SETTINGS layout, and the Settings hub measured the cost. A settings
|
|
115
|
+
* pane is a list of DECISIONS an operator came to take, so a read-only rendering of a policy is not
|
|
116
|
+
* a conservative choice — it is a pane that cannot do its job. Measured 2026-09-19 on the running
|
|
117
|
+
* dogfood application: `organizationSsoConfig` declares 24 fields across seven sections, including
|
|
118
|
+
* `enforcement.requireSSO` and `enforcement.allowPasswordFallback`, and NOT ONE declared
|
|
119
|
+
* `inlineEditable`. Every boolean therefore rendered through `BooleanDisplayMode.CHECKMARK` — a
|
|
120
|
+
* read-only ✓ or ✕ glyph, where ✕ is also indistinguishable from a remove affordance — and the only
|
|
121
|
+
* way to change a policy was a pencil that flipped the entire pane into a form.
|
|
122
|
+
*
|
|
123
|
+
* The per-field remedy is to write `.inlineEditable()` on all 24, and on every field added to any
|
|
124
|
+
* settings schema afterwards. That is a hand-kept list of somebody else's population: correct on the
|
|
125
|
+
* day it is written and silently incomplete forever after, because nothing goes red when the
|
|
126
|
+
* twenty-fifth field is added without it.
|
|
127
|
+
*
|
|
128
|
+
* So the layout — which already knows it is a settings surface, because it sets
|
|
129
|
+
* `defaultChromeMode: { display: SETTINGS_ROW }` — declares it once, and the set is DERIVED over
|
|
130
|
+
* the layout's fields rather than enumerated.
|
|
131
|
+
*/
|
|
132
|
+
export enum ResourceLayoutInlineEditDefault {
|
|
133
|
+
/**
|
|
134
|
+
* No default. Only a field carrying `{primitive}UI.display.inlineEditable` is editable in place.
|
|
135
|
+
* This is the system default and the correct choice for an ordinary resource READ page.
|
|
136
|
+
*/
|
|
137
|
+
NONE = 'none',
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Every WRITABLE field in this layout is editable in place, unless it declines.
|
|
141
|
+
*
|
|
142
|
+
* Eligibility is `isEligibleForLayoutDefaultInlineEdit` in `@wildo-ai/zod-decorators` — not the
|
|
143
|
+
* primary key, not `.excludeFromUpdate()`, not `.isHidden()`, and not an explicit
|
|
144
|
+
* `inlineEditable: false`. A field declaring `inlineEditable` with PARAMS still wins: the default
|
|
145
|
+
* decides WHETHER, the decorator decides HOW.
|
|
146
|
+
*/
|
|
147
|
+
WRITABLE_FIELDS = 'writable-fields',
|
|
148
|
+
}
|
|
149
|
+
|
|
105
150
|
export interface ResourceLayoutConfig {
|
|
106
151
|
|
|
107
152
|
/**
|
|
@@ -111,6 +156,87 @@ export interface ResourceLayoutConfig {
|
|
|
111
156
|
*/
|
|
112
157
|
refs?: LayoutRefManifest;
|
|
113
158
|
|
|
159
|
+
/**
|
|
160
|
+
* Whether this layout's READ surface offers its writable fields for in-place editing without
|
|
161
|
+
* each one declaring `inlineEditable` for itself. See {@link ResourceLayoutInlineEditDefault}.
|
|
162
|
+
*
|
|
163
|
+
* Renderers read:
|
|
164
|
+
* `{primitive}UI.display.inlineEditable ?? (layout.defaultInlineEdit === WRITABLE_FIELDS && eligible)`
|
|
165
|
+
*
|
|
166
|
+
* Defaults to {@link ResourceLayoutInlineEditDefault.NONE}, so no existing resource changes
|
|
167
|
+
* behaviour by this field being added. Turning it on is the settings-surface opt-in, and it pairs
|
|
168
|
+
* with `defaultChromeMode.display: SETTINGS_ROW` — the row geometry that gives the control
|
|
169
|
+
* somewhere to sit.
|
|
170
|
+
*
|
|
171
|
+
* **This does not bypass authorization.** `canInlineEdit` on the display context still requires a
|
|
172
|
+
* usable UPDATE path (an RMM, an `onInlineEdit`, or a real UPDATE operation the caller may
|
|
173
|
+
* perform), so a layout that turns this on for a reader who cannot write still renders read-only.
|
|
174
|
+
*/
|
|
175
|
+
defaultInlineEdit?: ResourceLayoutInlineEditDefault;
|
|
176
|
+
|
|
177
|
+
/**
|
|
178
|
+
* How an EMPTY field renders on this layout's read surface, overriding the surface policy.
|
|
179
|
+
*
|
|
180
|
+
* ## Why a layout may outrank the surface here
|
|
181
|
+
*
|
|
182
|
+
* `AutoEmptyValue` is declared per SURFACE VARIANT — BASE, RAISED, OVERLAY and INSET all default
|
|
183
|
+
* to `em-dash`. That is a sensible default for a surface, which knows nothing about the fields it
|
|
184
|
+
* happens to contain: in a dense table or a summary card a dash is exactly right, because the
|
|
185
|
+
* reader is scanning and the row's meaning comes from its neighbours.
|
|
186
|
+
*
|
|
187
|
+
* A settings pane is the opposite case. Its rows ARE the content, an operator reads one at a time
|
|
188
|
+
* to decide something, and an em dash there is an answer that refuses to say which of four things
|
|
189
|
+
* it means — a field awaiting their input, a list with no members, or a computed value nothing has
|
|
190
|
+
* produced yet (see `DisplayEmptyReason`). `placeholder` renders the reason's own words instead:
|
|
191
|
+
* "No value", "None yet", "Not available".
|
|
192
|
+
*
|
|
193
|
+
* Declared on the LAYOUT because that is the thing that knows it is a settings surface — it is
|
|
194
|
+
* already saying so with `defaultChromeMode.display: SETTINGS_ROW` and `defaultInlineEdit` — and
|
|
195
|
+
* because a per-field declaration would be a hand-kept list that goes silently incomplete the
|
|
196
|
+
* first time a field is added without it.
|
|
197
|
+
*
|
|
198
|
+
* ## What it costs, stated plainly
|
|
199
|
+
*
|
|
200
|
+
* It outranks the resolved surface policy, and this seam cannot distinguish a variant's DEFAULT
|
|
201
|
+
* from a deliberate per-surface `policyOverride` — both arrive as the same resolved value. So a
|
|
202
|
+
* layout that sets this wins over both. That is what a settings layout wants and it is why the
|
|
203
|
+
* field exists; a layout with no opinion omits it and every surface keeps its own policy exactly
|
|
204
|
+
* as before.
|
|
205
|
+
*/
|
|
206
|
+
defaultEmptyValue?: AutoEmptyValue;
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* The container mode this layout's DISPLAY sections adopt when they declare none of their own.
|
|
210
|
+
*
|
|
211
|
+
* ## What it is for
|
|
212
|
+
*
|
|
213
|
+
* A section's `appearance` is a per-section prop, and the container modes — `VERTICAL_TABS`,
|
|
214
|
+
* `TABS`, `ACCORDION`, `GRID` — are not really per-section decisions at all. Grouping keys on
|
|
215
|
+
* `(mode, its mode-specific props)` over CONSECUTIVE siblings, so a set of sections becomes one
|
|
216
|
+
* container only when every member declares the same mode with the same props and nothing
|
|
217
|
+
* separates them. Declared per section that is an agreement N authors must keep; one that slips
|
|
218
|
+
* does not fail, it silently renders TWO rails, or one rail and a stray bare section.
|
|
219
|
+
*
|
|
220
|
+
* So the declaration belongs where the decision does: the layout knows it is a settings pane with
|
|
221
|
+
* seven groups of fields, and says it once. A section that declares its own `appearance` still
|
|
222
|
+
* wins — this is the fallback, not an override.
|
|
223
|
+
*
|
|
224
|
+
* ## Why DISPLAY only, in the name
|
|
225
|
+
*
|
|
226
|
+
* `defaultChromeMode` carries display / summary / edit keys, and a bare `defaultSectionAppearance`
|
|
227
|
+
* would read as covering the same three while covering one. An edit form's section grouping is a
|
|
228
|
+
* different question — a wizard's steps, a form's save boundaries — and nothing asks for it yet.
|
|
229
|
+
* The name says which surface it governs so the answer is not assumed.
|
|
230
|
+
*
|
|
231
|
+
* ## It also decides how much ROOM the pane is given
|
|
232
|
+
*
|
|
233
|
+
* A navigation container mode puts a second vertical rail inside the pane, and the Settings Hub
|
|
234
|
+
* reads this to widen its frame accordingly — see `settingsSectionNeedsWideFrame`. That is the
|
|
235
|
+
* reason this is a layout DECLARATION rather than seven JSX props: a prop inside a template is
|
|
236
|
+
* invisible to anything that has to size the surface around it.
|
|
237
|
+
*/
|
|
238
|
+
defaultDisplaySectionAppearance?: ContainerSectionMode;
|
|
239
|
+
|
|
114
240
|
/**
|
|
115
241
|
* Default chrome mode for fields in each context.
|
|
116
242
|
* Used when a field's `{primitive}UI.{context}.chromeMode` is not set.
|
|
@@ -150,7 +276,7 @@ export interface ResourceLayoutConfig {
|
|
|
150
276
|
* greyed (`disabledActionHandling`), keyed by {@link ResourceOperationDisplayMode}.
|
|
151
277
|
* Omit a view (or a field) to inherit the framework default
|
|
152
278
|
* ({@link DEFAULT_ACTION_DISCLOSURE}): SUMMARY = { max 3, hide-disabled },
|
|
153
|
-
* DETAIL = { unlimited,
|
|
279
|
+
* DETAIL = { unlimited, show-disabled — each explains why it cannot run }.
|
|
154
280
|
*
|
|
155
281
|
* @example
|
|
156
282
|
* // A busy list keeps just one action inline; the detail view spells them all out.
|
|
@@ -277,6 +403,18 @@ export interface ResourceHeaderTitleProps {
|
|
|
277
403
|
* The record's name, rendered with the page-header typography the default
|
|
278
404
|
* (template-less) header uses — so authoring a header template is visually
|
|
279
405
|
* neutral for the title itself and only adds what the template places around it.
|
|
406
|
+
*
|
|
407
|
+
* ## It is an `h1`, and the level is not cosmetic
|
|
408
|
+
*
|
|
409
|
+
* This IS the page's title — the record's name on a record page, the collection's on a listing — and
|
|
410
|
+
* there is exactly one per surface, so it owns the top of the document outline. It was an `h2` until
|
|
411
|
+
* 2026-09-09, which left generated screens with NO level-one heading at all: the first accessibility
|
|
412
|
+
* audit ever run against a live stack reported `page-has-heading-one` on the collection listing,
|
|
413
|
+
* where this element was the only heading on the page (#533).
|
|
414
|
+
*
|
|
415
|
+
* The classes are unchanged, so nothing moves visually — `text-xl` still sets the size. A heading
|
|
416
|
+
* level is the document's structure, not its appearance, and the two are deliberately decoupled here
|
|
417
|
+
* exactly as the design system does elsewhere.
|
|
280
418
|
*/
|
|
281
419
|
export function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): React.JSX.Element | null {
|
|
282
420
|
const header = useOptionalResourceHeaderContext();
|
|
@@ -286,7 +424,13 @@ export function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): Re
|
|
|
286
424
|
if (header?.titleMountTracker) header.titleMountTracker.titleMounted = true;
|
|
287
425
|
|
|
288
426
|
const title = header?.title;
|
|
289
|
-
if (!title)
|
|
427
|
+
if (!title) {
|
|
428
|
+
// A name that is on its way reserves its line, so its arrival moves nothing beneath the header;
|
|
429
|
+
// a surface with no name at all still renders nothing. `h-7` is `text-xl`'s own line box.
|
|
430
|
+
return header?.titlePending
|
|
431
|
+
? <Skeleton className="h-7 w-48 max-w-full" aria-hidden="true" data-resource-header-title-pending="true" />
|
|
432
|
+
: null;
|
|
433
|
+
}
|
|
290
434
|
|
|
291
435
|
return (
|
|
292
436
|
// `min-w-0` + truncate so a long record name shrinks instead of pushing the
|
|
@@ -294,9 +438,15 @@ export function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): Re
|
|
|
294
438
|
// only the space it needs, which is what keeps an authored badge HUGGING the
|
|
295
439
|
// name rather than being flung to the far end of the row (the same
|
|
296
440
|
// composition lesson recorded on `SummaryTitle`).
|
|
297
|
-
|
|
298
|
-
{
|
|
299
|
-
|
|
441
|
+
header?.hostProvidesHeading ? (
|
|
442
|
+
<h2 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>
|
|
443
|
+
{title}
|
|
444
|
+
</h2>
|
|
445
|
+
) : (
|
|
446
|
+
<h1 className={cn('min-w-0 truncate text-xl font-semibold text-foreground', className)}>
|
|
447
|
+
{title}
|
|
448
|
+
</h1>
|
|
449
|
+
)
|
|
300
450
|
);
|
|
301
451
|
}
|
|
302
452
|
```
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
# Deciding a resource's surfaces — read, form, summary, header
|
|
2
|
+
|
|
3
|
+
Read this for Step 7 of the skill: every resource decides how it is read and how it is
|
|
4
|
+
written, and states the decision. It covers:
|
|
5
|
+
|
|
6
|
+
- the four surfaces and the question each one answers;
|
|
7
|
+
- how to decide when no sibling resource exists yet to mirror;
|
|
8
|
+
- when a section earns its place, and why the default is FEWER sections;
|
|
9
|
+
- deciding field chrome instead of inheriting it;
|
|
10
|
+
- a rejected, over-separated layout beside the accepted one.
|
|
11
|
+
|
|
12
|
+
## Why this is a decision and not a fallback
|
|
13
|
+
|
|
14
|
+
With no template, the framework renders every surface as a flat list of the schema's fields
|
|
15
|
+
in declaration order, with default chrome. Sometimes that is the right answer. It is only
|
|
16
|
+
right when someone decided it: the order in which the schema was typed is not an argument
|
|
17
|
+
about what a reader looks at first.
|
|
18
|
+
|
|
19
|
+
So each surface ends in one of two stated outcomes:
|
|
20
|
+
|
|
21
|
+
- **a template**, with the reason it exists; or
|
|
22
|
+
- **the default**, with the reason the default already says what the surface must say.
|
|
23
|
+
|
|
24
|
+
Both are legitimate. What is not legitimate is a surface nobody thought about. The statement
|
|
25
|
+
goes in the JSDoc at the top of the `*.ui-behavior.tsx` file, where the next person to open
|
|
26
|
+
it will read it before changing anything.
|
|
27
|
+
|
|
28
|
+
## The four surfaces
|
|
29
|
+
|
|
30
|
+
| Surface | Where | The question it answers |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| Read | `layout.display` | Someone opened this record. What do they need to see, and in what order? |
|
|
33
|
+
| Form | `layout.edit` | Someone is creating or changing it. What do they write, and what do they write together? |
|
|
34
|
+
| Summary | `layout.summary` | The record appears in a list, a card or a foreign-key popover. What tells it apart from its neighbours? |
|
|
35
|
+
| Header | `layout.header` | What sits beside the record's name — usually its status. |
|
|
36
|
+
|
|
37
|
+
## Deciding without a sibling to mirror
|
|
38
|
+
|
|
39
|
+
In a mature application, mirroring a sibling resource keeps the product consistent. In a new
|
|
40
|
+
application the first resource has no sibling, so derive the decision from the resource
|
|
41
|
+
itself:
|
|
42
|
+
|
|
43
|
+
1. **Identity.** What names this record? That is `getFrontendResourceLabel`. Everything else
|
|
44
|
+
on the read surface is read in its light.
|
|
45
|
+
2. **Standing.** Does it have a status or a lifecycle? If so, the status belongs next to the
|
|
46
|
+
name: in the header, or in the summary's title line. A status buried among other fields
|
|
47
|
+
is a status nobody sees.
|
|
48
|
+
3. **Time.** Are some fields written once and others revisited often? Are some read as a
|
|
49
|
+
progression (set, then active, then achieved)? That, and only that, is a reason to split
|
|
50
|
+
a surface into sections.
|
|
51
|
+
4. **Relations.** Which related records does a reader of this record actually need to see
|
|
52
|
+
here? Placing children is its own step (7b); choose deliberately.
|
|
53
|
+
5. **Summary.** Among records of this type, what distinguishes two with similar names? Put
|
|
54
|
+
that one qualifier in the summary's meta line, and nothing more.
|
|
55
|
+
|
|
56
|
+
## When a section earns its place
|
|
57
|
+
|
|
58
|
+
**The default is ONE surface with no named sections.** A section must pass at least one of
|
|
59
|
+
these tests:
|
|
60
|
+
|
|
61
|
+
- **Different time.** Its fields are written or read at a different moment from the rest,
|
|
62
|
+
for example a goal's prose (once) and its standing (weekly).
|
|
63
|
+
- **Different reader.** Another person, or the same person in another role, reads it.
|
|
64
|
+
- **A progression.** The sections are one fact at several points in its life, and a
|
|
65
|
+
timeline shows that.
|
|
66
|
+
- **Independent use.** A reader opens or collapses it on its own, and hiding it saves them
|
|
67
|
+
real scrolling.
|
|
68
|
+
|
|
69
|
+
These are not reasons:
|
|
70
|
+
|
|
71
|
+
- the fields are of the same TYPE ("Dates", "Numbers", "Metadata");
|
|
72
|
+
- the surface "looks empty" with one group;
|
|
73
|
+
- a section holds one or two fields — that is a heading over a sentence;
|
|
74
|
+
- symmetry with another surface — the read and form surfaces answer different questions.
|
|
75
|
+
|
|
76
|
+
Every named `<Section>` also costs three places: the JSX name, the `layout.refs.sections`
|
|
77
|
+
entry and a documented specification slot with `textSlots` (see
|
|
78
|
+
`framework-resource-layout-templates-api.md`). If you would not pay that for this section,
|
|
79
|
+
it has not earned its place.
|
|
80
|
+
|
|
81
|
+
## Chrome is part of the same decision
|
|
82
|
+
|
|
83
|
+
Deciding a surface includes how its fields present. For each field, state the choice or
|
|
84
|
+
state why the default fits:
|
|
85
|
+
|
|
86
|
+
| Field kind | Decide | Common considered answer |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| Enum with a lifecycle | `display.displayMode`, a per-value color | `BADGE` with semantic variants; a deliberate stop is not colored as an error |
|
|
89
|
+
| Name / title | whether it is prose or identity | identity: shown by the header title, not repeated as a field |
|
|
90
|
+
| Long-form text | markdown or plain | `MARKDOWN` display with `MARKDOWN` edit for authored content |
|
|
91
|
+
| Foreign key | label or summary card | `LABEL` in dense places, `SUMMARY` where the reader chooses between candidates |
|
|
92
|
+
| Timestamps | whether a reader needs them at all | often only on the read surface, relative, near the end |
|
|
93
|
+
| Settings-like resource | `layout.defaultChromeMode.edit` | `SETTINGS_ROW` for preferences, `STACKED` for authored content |
|
|
94
|
+
|
|
95
|
+
"Left to the framework default" is a valid entry in this table when you can say why the
|
|
96
|
+
default fits the field.
|
|
97
|
+
|
|
98
|
+
## A rejected layout, and the accepted one
|
|
99
|
+
|
|
100
|
+
A `team` resource: a name, a description, a status, an owner, and its members as a related
|
|
101
|
+
collection.
|
|
102
|
+
|
|
103
|
+
**Rejected — separated because the fields exist, not because a reader needs it:**
|
|
104
|
+
|
|
105
|
+
```tsx
|
|
106
|
+
// TIER C WAIVER: a deliberately WRONG layout, shown so it can be rejected. It exists nowhere
|
|
107
|
+
// in any application, and anchoring it as a real example would present it as a pattern.
|
|
108
|
+
display: () => (
|
|
109
|
+
<DisplayLayout>
|
|
110
|
+
<Section name="identity"><DisplayField name="name" /></Section>
|
|
111
|
+
<Section name="details"><DisplayField name="description" /></Section>
|
|
112
|
+
<Section name="status"><DisplayField name="status" /></Section>
|
|
113
|
+
<Section name="ownership"><DisplayField name="ownerUserId" /></Section>
|
|
114
|
+
<Section name="dates">
|
|
115
|
+
<DisplayField name="createdAt" />
|
|
116
|
+
<DisplayField name="updatedAt" />
|
|
117
|
+
</Section>
|
|
118
|
+
</DisplayLayout>
|
|
119
|
+
),
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Why it fails: five headings for six fields, so a reader scans headings instead of reading
|
|
123
|
+
the record. `name` repeats the header title, so it reads as a second fact. The status sits
|
|
124
|
+
in its own box instead of beside the name. None of the five sections passes a test above,
|
|
125
|
+
and each one owes a `layout.refs` entry and a specification slot.
|
|
126
|
+
|
|
127
|
+
**Accepted — the same fields, decided:**
|
|
128
|
+
|
|
129
|
+
```tsx
|
|
130
|
+
// TIER C WAIVER: the accepted half of the comparison above; the pair is the lesson, and the
|
|
131
|
+
// rejected half cannot be anchored to real code.
|
|
132
|
+
/**
|
|
133
|
+
* Team — resource UI behavior.
|
|
134
|
+
*
|
|
135
|
+
* Read surface: one group. A team is read as a whole: what it is for, who owns it, who is in
|
|
136
|
+
* it. No field is read at a different time from the others, so no section earns a heading.
|
|
137
|
+
* The name is the header title, and the status stands beside it where it is seen first.
|
|
138
|
+
* Form surface: the framework default. Its declaration order (name, description, owner) is
|
|
139
|
+
* already the order in which a team is written. Summary: the framework default. Team names are
|
|
140
|
+
* unique within an organization, so the name alone tells two teams apart.
|
|
141
|
+
*/
|
|
142
|
+
layout: {
|
|
143
|
+
header: () => (
|
|
144
|
+
<div className="flex min-w-0 flex-wrap items-center gap-field">
|
|
145
|
+
<ResourceHeaderTitle />
|
|
146
|
+
<DisplayField name="status" hideLabel hideDescription className="w-auto" />
|
|
147
|
+
</div>
|
|
148
|
+
),
|
|
149
|
+
display: () => (
|
|
150
|
+
<DisplayLayout>
|
|
151
|
+
<DisplayField name="description" />
|
|
152
|
+
<DisplayField name="ownerUserId" />
|
|
153
|
+
<RelatedResourceSections targets={[R.TEAM_MEMBERS]} />
|
|
154
|
+
</DisplayLayout>
|
|
155
|
+
),
|
|
156
|
+
},
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Look up the exact props of `ResourceHeaderTitle`, `RelatedResourceSections` and the summary
|
|
160
|
+
parts in `framework-resource-layout-templates-api.md` and
|
|
161
|
+
`framework-related-resource-embeds-api.md`. The sketch shows the decision; it is not a
|
|
162
|
+
contract.
|
|
163
|
+
|
|
164
|
+
The accepted version has fewer containers, and each choice in it has a stated reason. The
|
|
165
|
+
form surface was kept deliberately, and the JSDoc says why.
|
|
@@ -123,10 +123,18 @@ specific resource row. The triggering row's `_id` is the natural
|
|
|
123
123
|
| Mode | Re-run safe? | Touches existing rows? | Required fields | Pick when … |
|
|
124
124
|
|------------|--------------|--------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
125
125
|
| `LAZY` | Yes | No | `lazyAccess`, `entry()` | "Default X appears the first time the user opens Y" |
|
|
126
|
-
| `ADDITIVE` | Yes | Yes — full payload re-stamped
|
|
126
|
+
| `ADDITIVE` | Yes | Yes — full payload re-stamped, unless `existingRowTreatment: FILL_MISSING_DEFAULTS` | none beyond the base | "New rows shipped in vN+1 should appear; existing rows are re-stamped from the declared payload" |
|
|
127
127
|
| `UPGRADE` | Yes | Yes — only `managedFields` | `managedFields[]` (non-empty), optional `migrators.fromVersion[n]` | "Re-deploy the framework-owned subject line, keep user-edited body" |
|
|
128
128
|
| `SYNC` | Yes | Yes — controlled by `onOrphan` | `onOrphan` (`DELETE` / `DEPRECATE` / `REPORT`), `managedFields[]` | "Closed enum materialized as rows; declaration is the source of truth" |
|
|
129
129
|
|
|
130
|
+
**A seed that CREATES a row a person owns afterwards must not re-stamp it.** A configuration
|
|
131
|
+
singleton seeded as `{ enforcement: {}, domains: {} }` means "let the schema fill these", but a
|
|
132
|
+
re-applied `ADDITIVE` payload replaces each whole stored block — so every pass resets whatever an
|
|
133
|
+
administrator saved. Declare `existingRowTreatment: DataSeedExistingRowTreatment.FILL_MISSING_DEFAULTS`
|
|
134
|
+
on such a seed: it inserts when the row is absent and, on an existing row, assigns only the leaves the
|
|
135
|
+
row is missing. On a `RESOURCE_LIFECYCLE` seed it also repairs the rows it created earlier, once per
|
|
136
|
+
seed `version`, at application boot. The field is `ADDITIVE`-only; the factory rejects it elsewhere.
|
|
137
|
+
|
|
130
138
|
The §3.6 matrix rejects illegal cells at factory time:
|
|
131
139
|
|
|
132
140
|
| | `ON_APP_INIT` | `ON_APP_VERSION_UPGRADE` | `ON_SCHEDULED_REFRESH` / `ON_MANUAL_TRIGGER` | `RESOURCE_LIFECYCLE` | `LAZY_ACCESS` |
|
|
@@ -116,6 +116,10 @@ export enum DataSeedMode {
|
|
|
116
116
|
* omitted for LAZY (factory auto-injects from `lazyAccess`).
|
|
117
117
|
* - `lazyAccess` — required for LAZY, FORBIDDEN otherwise.
|
|
118
118
|
* - `onOrphan` — required for SYNC, forbidden otherwise.
|
|
119
|
+
* - `existingRowTreatment` — ADDITIVE only. Declare `FILL_MISSING_DEFAULTS`
|
|
120
|
+
* when the seed CREATES a row a person owns afterwards (a config
|
|
121
|
+
* singleton): the default re-applies the declared payload on every pass,
|
|
122
|
+
* which replaces whole stored blocks.
|
|
119
123
|
* - `renames` — optional rename ledger; each `rename.field` MUST be a
|
|
120
124
|
* business-key field and `rename.to` MUST appear as a declared
|
|
121
125
|
* business-key value (F-3 + F-10).
|