@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +547 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +12659 -4142
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -41,6 +41,256 @@ export enum AssuranceProgramProofStage {
|
|
|
41
41
|
ASSESSED = "ASSESSED",
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
+
/**
|
|
45
|
+
* WHERE the evidence for one demand lives — and therefore what kind of query a collector must write.
|
|
46
|
+
*
|
|
47
|
+
* Routing a collector is the member set's ONLY job, so it discriminates on the one axis a collector
|
|
48
|
+
* cares about: **can one query, written once, serve every application?** A vocabulary that cannot
|
|
49
|
+
* answer that has to be supplemented out of band, which puts the discrimination somewhere less
|
|
50
|
+
* visible than the vocabulary itself.
|
|
51
|
+
*
|
|
52
|
+
* Settled on #384 from FIVE paper bodies (`__evidence-plane-slice__/`), after two of them found
|
|
53
|
+
* evidence that no member covered. The rejected alternative is recorded because it is the one that
|
|
54
|
+
* looks right: widening `EMITTED` to "any durable execution/event record" absorbs both cases with no
|
|
55
|
+
* new member — and also absorbs every product row in every application, so the member comes to mean
|
|
56
|
+
* "somewhere durable" and stops discriminating. What ships is that widening BOUNDED BY OWNER, plus
|
|
57
|
+
* the member the bound makes necessary.
|
|
58
|
+
*/
|
|
59
|
+
export enum AssuranceEvidenceHome {
|
|
60
|
+
/** The committed specification IS the evidence. Uniform across applications; one query. */
|
|
61
|
+
DECLARED = "DECLARED",
|
|
62
|
+
/**
|
|
63
|
+
* An ENGINE-owned durable record class — the audit trail, or a batch execution record. Uniform
|
|
64
|
+
* across applications because the engine authors the store, so one query serves all.
|
|
65
|
+
*
|
|
66
|
+
* Widened from "an audit-row class" by `retention-window-declaration`, on the grounds that a sweep
|
|
67
|
+
* whose control emits no auditable event by design (a database TTL deletes silently) is evidenced
|
|
68
|
+
* by "the sweep's execution record".
|
|
69
|
+
*
|
|
70
|
+
* The original batch-record premise was withdrawn in 2026-09-10. Scheduled application
|
|
71
|
+
* receipts now create job-execution records before invoking the batch, with defined successful
|
|
72
|
+
* results retained separately. These operational records have bounded retention: 30 days for
|
|
73
|
+
* execution history and 24 hours for output payloads. They do not establish coverage for a longer
|
|
74
|
+
* assurance period. Sweep-continuity clauses still require period-covering retained evidence;
|
|
75
|
+
* the existence of a recent job row alone does not justify changing their evidence home.
|
|
76
|
+
*
|
|
77
|
+
* The member's meaning is therefore back to what it says above — a store a collector can query.
|
|
78
|
+
*
|
|
79
|
+
* **A STORE, always.** If a collector cannot query it for a window, it is not this — see
|
|
80
|
+
* {@link AssuranceEvidenceHome.OBSERVED} for a driven result and the note there about log lines.
|
|
81
|
+
* An audit row produced BY driving an action is still this, at the `VERIFICATION` plane.
|
|
82
|
+
*/
|
|
83
|
+
EMITTED = "EMITTED",
|
|
84
|
+
/**
|
|
85
|
+
* An APPLICATION-authored durable record — a product resource row.
|
|
86
|
+
*
|
|
87
|
+
* Distinct from `EMITTED` because the schema, the status vocabulary and the operation refs are that
|
|
88
|
+
* application's own, so a collector can only query it against that application's specification.
|
|
89
|
+
* Found by `subject-erasure-execution-record`, whose entire intake/withdrawal/execution evidence is
|
|
90
|
+
* an application resource row and for which no audit member exists at all.
|
|
91
|
+
*/
|
|
92
|
+
APPLICATION_RECORDED = "APPLICATION_RECORDED",
|
|
93
|
+
/**
|
|
94
|
+
* A DRIVEN result: a scenario outcome, a refusal, an enumeration. Reproducible on demand, and
|
|
95
|
+
* stored nowhere.
|
|
96
|
+
*
|
|
97
|
+
* Added 2026-09-10 after a six-batch review of all 51 bodies, in which FOUR reviewers
|
|
98
|
+
* independently reported the same thing: `EMITTED` was carrying **56 of 156 clauses** whose
|
|
99
|
+
* evidence is a driven token, a driven refusal or a call-site enumeration — none of which is
|
|
100
|
+
* "an ENGINE-owned durable record class". Authors reached for the nearest member because no
|
|
101
|
+
* accurate one existed, and it became the file's dominant convention.
|
|
102
|
+
*
|
|
103
|
+
* **The distinction is operational, not taxonomic.** The home tells a COLLECTOR what to do:
|
|
104
|
+
* `EMITTED` means *query this store for the window*; `OBSERVED` means *drive this and record what
|
|
105
|
+
* happened*. Collapsing them makes the field stop answering the one question it exists for — which
|
|
106
|
+
* is why widening `EMITTED`'s definition was considered and rejected.
|
|
107
|
+
*
|
|
108
|
+
* `plane` is NOT a substitute. It says WHERE a control runs, and `VERIFICATION` is compatible with
|
|
109
|
+
* both readings: an audit row produced by driving an action is `EMITTED` at the `VERIFICATION`
|
|
110
|
+
* plane, because the artifact is still a queryable row. Every one of the 56 reclassified clauses
|
|
111
|
+
* was checked for exactly that and none carried `requiredAuditEventMembers` — they name no store
|
|
112
|
+
* because there is none.
|
|
113
|
+
*
|
|
114
|
+
* NOT `UNPRODUCED`: an observation the framework can produce on demand is available evidence, and
|
|
115
|
+
* `UNPRODUCED` carries no severity. NOT `PERFORMED`: nobody supplies it as a host artifact — the
|
|
116
|
+
* running system produces it when driven.
|
|
117
|
+
*
|
|
118
|
+
* **A LOG LINE is neither this nor `EMITTED`.** It is reproducible only if you were already
|
|
119
|
+
* watching, and it lives in no store the framework owns; judge those per clause as `UNPRODUCED`,
|
|
120
|
+
* or `PERFORMED` against a host-supplied archive.
|
|
121
|
+
*/
|
|
122
|
+
OBSERVED = "OBSERVED",
|
|
123
|
+
/**
|
|
124
|
+
* An artifact the HOST supplies, because the framework owns no store for it.
|
|
125
|
+
*
|
|
126
|
+
* Two shapes, and the defining property is where a collector must go rather than who made it:
|
|
127
|
+
* - a HUMAN ACT — a privileged-access review, an operator sign-off. Nothing in the running
|
|
128
|
+
* system produces it, which was this member's original and only meaning;
|
|
129
|
+
* - TELEMETRY the running system emits into a store the host owns and retains — a structured
|
|
130
|
+
* log line, a metric counter. The framework produces the signal and keeps none of it.
|
|
131
|
+
*
|
|
132
|
+
* The second shape was added 2026-09-10, in the same review that produced
|
|
133
|
+
* {@link AssuranceEvidenceHome.OBSERVED}, and it is a SMALLER correction than that one: no member
|
|
134
|
+
* is added, and the widening follows from what the home is for. Several clauses had been reading
|
|
135
|
+
* `EMITTED` — "an ENGINE-owned durable record class" — off a Pino line or a boot log, which sends
|
|
136
|
+
* a collector to query a store that does not exist. `UNPRODUCED` is equally wrong for them,
|
|
137
|
+
* because the signal IS produced and carries real fields; calling it unproduced retires a working
|
|
138
|
+
* control from examination and assigns it no severity.
|
|
139
|
+
*
|
|
140
|
+
* **What this costs, and it must be said in every clause that uses it:** a host archive has a
|
|
141
|
+
* retention window nobody in the framework decided, and an operational one at that. So a clause
|
|
142
|
+
* homed here can be evidenced for the period the host happens to keep, and no longer. If that is
|
|
143
|
+
* unacceptable for a given obligation, the answer is to give the control a record class — not to
|
|
144
|
+
* re-home the clause.
|
|
145
|
+
*/
|
|
146
|
+
PERFORMED = "PERFORMED",
|
|
147
|
+
/**
|
|
148
|
+
* Authored, and nothing produces it — a VALUE, never an absence.
|
|
149
|
+
*
|
|
150
|
+
* It carries no severity against an application: a demand nothing can evidence is a framework gap,
|
|
151
|
+
* and raising it against every application forever is noise rather than a finding.
|
|
152
|
+
*/
|
|
153
|
+
UNPRODUCED = "UNPRODUCED",
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* WHERE the control runs, and therefore what evidence about it can ever exist.
|
|
158
|
+
*
|
|
159
|
+
* Kept separate from the home because a multi-clause intent routinely spans both axes independently,
|
|
160
|
+
* and flattening them lets a reviewer accept a declaration as proof of a runtime property — the
|
|
161
|
+
* error `selected-processor-declaration` was written to prevent, where one clause is a committed
|
|
162
|
+
* selection and its sibling is a claim about behaviour under no selection.
|
|
163
|
+
*/
|
|
164
|
+
export enum AssuranceEvidenceExecutionPlane {
|
|
165
|
+
/** Can evidence that a control is DECLARED or CONFIGURED. Never that it operated. */
|
|
166
|
+
META_APPLICATION = "META_APPLICATION",
|
|
167
|
+
/** Can evidence that a control OPERATES when driven. Attests the build it ran against. */
|
|
168
|
+
VERIFICATION = "VERIFICATION",
|
|
169
|
+
/** Can evidence that a control operated over a period — the only plane that can. */
|
|
170
|
+
PRODUCTION = "PRODUCTION",
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/**
|
|
174
|
+
* The outcome of judging ONE evidence demand against what was collected.
|
|
175
|
+
*
|
|
176
|
+
* ## Why this is an enum and not the five strings it replaces
|
|
177
|
+
*
|
|
178
|
+
* These five values already governed the plane — every one of the 51 requirement bodies instructs a
|
|
179
|
+
* judge to "record `insufficient_evidence` for that clause" or "record `not_applicable_as_configured`
|
|
180
|
+
* and stop" — and they lived only as PROSE inside those instruction sentences. Nowhere could a
|
|
181
|
+
* collector emit one, a reviewer branch on one, or a reader learn how two of them differ. That is
|
|
182
|
+
* the case the closed-vocabulary rule exists for: a bare `"observation"` cannot carry who sets it or
|
|
183
|
+
* why it is not a `NONCONFORMITY`, and this can.
|
|
184
|
+
*
|
|
185
|
+
* Distinct from {@link AssuranceProgramFindingKind} (`GAP` / `EXCEPTION`), which classifies what an
|
|
186
|
+
* accepted PROGRAMME declares about its own coverage. This classifies what one judgement RUN
|
|
187
|
+
* concluded about one demand. Merging them would put "the programme admits it does not cover this"
|
|
188
|
+
* and "the evidence for this run was never gathered" in one field.
|
|
189
|
+
*
|
|
190
|
+
* ## One of these is DERIVED, and the other four are judgements
|
|
191
|
+
*
|
|
192
|
+
* {@link AssuranceEvidenceJudgementVerdict.NOT_APPLICABLE_AS_CONFIGURED} is resolvable from
|
|
193
|
+
* configuration alone, before a single row is collected, by the same
|
|
194
|
+
* `deriveExpectationCapabilityApplicability` that validates a programme. The other four require
|
|
195
|
+
* evidence in hand. Keeping that asymmetry visible here is the whole lesson of #302 stage 1, which
|
|
196
|
+
* spent TWO full collection rounds evidencing a demand whose attesting capability the application
|
|
197
|
+
* had never enabled, and whose closing note reads: *"A demand's applicability is decided by the
|
|
198
|
+
* application's enabled capabilities, BEFORE any evidence is collected."*
|
|
199
|
+
*/
|
|
200
|
+
export enum AssuranceEvidenceJudgementVerdict {
|
|
201
|
+
/** The evidence was gathered and satisfies every clause of the demand. */
|
|
202
|
+
CONFORMANT = "CONFORMANT",
|
|
203
|
+
/**
|
|
204
|
+
* Something worth recording that is NOT a failure against the demand as written.
|
|
205
|
+
*
|
|
206
|
+
* The weakest verdict that still asserts the evidence was sufficient to conclude, which is why it
|
|
207
|
+
* is the one most easily reached for. #302 stage 1's author verdict was `OBSERVATION` and an
|
|
208
|
+
* independent judge overturned it to `INSUFFICIENT_EVIDENCE` on the ground that a clause had been
|
|
209
|
+
* passed on counts rather than on attribution — so prefer the verdict below when a clause was not
|
|
210
|
+
* actually evidenced.
|
|
211
|
+
*/
|
|
212
|
+
OBSERVATION = "OBSERVATION",
|
|
213
|
+
/** The control does not do what the demand requires, and the evidence shows it. */
|
|
214
|
+
NONCONFORMITY = "NONCONFORMITY",
|
|
215
|
+
/**
|
|
216
|
+
* The demand may or may not be met; the evidence needed to decide was not obtained.
|
|
217
|
+
*
|
|
218
|
+
* **Never a pass, and never inherited across clauses.** The bodies state the rule they enforce:
|
|
219
|
+
* *"Record any clause not run as insufficient_evidence for that clause; never let a NOT RUN clause
|
|
220
|
+
* pass on its siblings' evidence."* A multi-clause demand with one unevidenced clause is this,
|
|
221
|
+
* not {@link AssuranceEvidenceJudgementVerdict.CONFORMANT}.
|
|
222
|
+
*/
|
|
223
|
+
INSUFFICIENT_EVIDENCE = "INSUFFICIENT_EVIDENCE",
|
|
224
|
+
/**
|
|
225
|
+
* The application does not enable the capability the authority basis names as attesting this
|
|
226
|
+
* objective, so the demand cannot be evidenced for it — and nothing is broken.
|
|
227
|
+
*
|
|
228
|
+
* DERIVED, not judged: resolvable from the application's own declared `engineCapabilities` in
|
|
229
|
+
* `wildo.saas.config.ts`, before any collection — no evidence, and no judgement, is needed to
|
|
230
|
+
* reach it. A collector that resolves it FIRST stops rather than gathering evidence for a demand
|
|
231
|
+
* that was never applicable.
|
|
232
|
+
*
|
|
233
|
+
* Distinct from {@link AssuranceEvidenceJudgementVerdict.NONCONFORMITY} in the direction that
|
|
234
|
+
* matters: a control the application never claimed is not a control the application fails.
|
|
235
|
+
*/
|
|
236
|
+
NOT_APPLICABLE_AS_CONFIGURED = "NOT_APPLICABLE_AS_CONFIGURED",
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
* How much a NONCONFORMITY is worth — the severity axis #299 decided and #297 recorded as flat until
|
|
241
|
+
* it existed.
|
|
242
|
+
*
|
|
243
|
+
* ## It grades one verdict, and only one
|
|
244
|
+
*
|
|
245
|
+
* A finding opens on a nonconformity and on nothing else, so this is the only verdict a severity can
|
|
246
|
+
* apply to. {@link AssuranceEvidenceJudgementVerdict.OBSERVATION} is not a milder nonconformity — it
|
|
247
|
+
* asserts the demand is NOT failed — and giving it a severity would make the two comparable on a
|
|
248
|
+
* scale they do not share. `INSUFFICIENT_EVIDENCE` is likewise not a mild failure but an absence of
|
|
249
|
+
* evidence, and grading it would put a number on how badly we failed to look.
|
|
250
|
+
*
|
|
251
|
+
* ## Two members, because the bodies already speak in two
|
|
252
|
+
*
|
|
253
|
+
* Measured across all 58 requirement bodies that carry `severityGuidance`: MAJOR 157 times, MINOR 4,
|
|
254
|
+
* and OBSERVATION 37 — the last being the verdict rather than a grade. So the vocabulary is not
|
|
255
|
+
* invented here; it is the one the authored guidance has used since #296, given a runtime home so
|
|
256
|
+
* something other than a reader can act on it.
|
|
257
|
+
*
|
|
258
|
+
* No CRITICAL, deliberately: no body's guidance reaches for one, and a member with no author is a
|
|
259
|
+
* member a judge would have to decide the meaning of.
|
|
260
|
+
*
|
|
261
|
+
* ## What a severity IS, and the arithmetic it must never become
|
|
262
|
+
*
|
|
263
|
+
* It is the demand body's own statement of what this failure EXPOSES — "a contradicted absence claim
|
|
264
|
+
* is a MAJOR: the application states in committed configuration that it does not take an exposure the
|
|
265
|
+
* derivation finds present, and that statement is the kind a reader relies on". That is severity
|
|
266
|
+
* following evidenced risk, which is what #299 decided and what
|
|
267
|
+
* `severityGuidance`'s own JSDoc asks for: "severity follows evidenced risk rather than wording
|
|
268
|
+
* intensity".
|
|
269
|
+
*
|
|
270
|
+
* It is NOT a product of the risk register's bands. `ApplicationRiskRegisterSchema` refuses that
|
|
271
|
+
* multiplication for the reason Layer 1 refuses a score — two judgements multiplied into a third is
|
|
272
|
+
* the number a reader trusts without checking — and reintroducing it here, one layer over, would
|
|
273
|
+
* defeat the refusal rather than respect it.
|
|
274
|
+
*
|
|
275
|
+
* assurance-control: WILDO.RISK.TREATMENT_DECLARED — a recorded failure carries what it exposes, not
|
|
276
|
+
* only that it occurred.
|
|
277
|
+
*/
|
|
278
|
+
export enum AssuranceFindingSeverity {
|
|
279
|
+
/**
|
|
280
|
+
* The control does not operate, or the application states something a reader would rely on that
|
|
281
|
+
* the evidence contradicts.
|
|
282
|
+
*/
|
|
283
|
+
MAJOR = "MAJOR",
|
|
284
|
+
/**
|
|
285
|
+
* The control operates and something around it is owed — an undeclared decision nobody has taken
|
|
286
|
+
* yet, a record that exists in a weaker form than the demand asks for.
|
|
287
|
+
*
|
|
288
|
+
* Honest states live here. The bodies use it for exactly that: "an undeclared signal is a MINOR on
|
|
289
|
+
* its own — nobody has decided yet, which is an honest state".
|
|
290
|
+
*/
|
|
291
|
+
MINOR = "MINOR",
|
|
292
|
+
}
|
|
293
|
+
|
|
44
294
|
export enum AssuranceProgramCapabilityKind {
|
|
45
295
|
ENGINE = "ENGINE",
|
|
46
296
|
PROVIDER = "PROVIDER",
|
|
@@ -149,7 +399,7 @@ const AssuranceProgramSourceRevisionIdentitySchema = z.strictObject({
|
|
|
149
399
|
* digested engine sources moved, including for purely additive changes that altered no control.
|
|
150
400
|
* Which BYTES an acceptance was made against is answered by the engine's committed git revision
|
|
151
401
|
* plus the commit that recorded the acceptance — both of which merge across branches, which a hash
|
|
152
|
-
* does not
|
|
402
|
+
* does not — git is the accepted state, so the evidence of acceptance is a commit.
|
|
153
403
|
*/
|
|
154
404
|
export const AssuranceProgramAuthorityBasisIdentitySchema = z.strictObject({
|
|
155
405
|
basisRef: AssuranceNamespacedRefSchema,
|
|
@@ -175,7 +425,12 @@ export type AssuranceProgramRoleAuthority = z.infer<typeof AssuranceProgramRoleA
|
|
|
175
425
|
|
|
176
426
|
/** Current role authority bound to one exact framework authority basis rather than its internal inventory. */
|
|
177
427
|
export const AssuranceProgramRoleAuthorityV2Schema = z.strictObject({
|
|
178
|
-
roleRef:
|
|
428
|
+
roleRef: AssuranceEntryKeySchema,
|
|
429
|
+
/**
|
|
430
|
+
* The role's NAME, as a reader meets it ("Application owner", "Control operator"). Optional because
|
|
431
|
+
* programmes landed before 2026-09-25 carry none — the role is then named by its `roleRef`.
|
|
432
|
+
*/
|
|
433
|
+
title: z.string().trim().min(1).optional(),
|
|
179
434
|
applicationRoleRef: z.string().trim().min(1),
|
|
180
435
|
definitionAuthority: AssuranceProgramAuthorityBasisIdentitySchema,
|
|
181
436
|
});
|
|
@@ -185,7 +440,7 @@ export type AssuranceProgramRoleAuthorityV2 = z.infer<typeof AssuranceProgramRol
|
|
|
185
440
|
export const AssuranceProgramCapabilityAuthoritySchema = z
|
|
186
441
|
.strictObject({
|
|
187
442
|
identity: AssuranceCapabilityIdentitySchema,
|
|
188
|
-
capabilityKind: z.enum(AssuranceProgramCapabilityKind),
|
|
443
|
+
capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
|
|
189
444
|
implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
190
445
|
implementationRevision: AssuranceProgramSourceRevisionIdentitySchema,
|
|
191
446
|
})
|
|
@@ -198,7 +453,7 @@ export type AssuranceProgramCapabilityAuthority = z.infer<typeof AssuranceProgra
|
|
|
198
453
|
export const AssuranceProgramCapabilityAuthorityV2Schema = z
|
|
199
454
|
.strictObject({
|
|
200
455
|
identity: AssuranceCapabilityIdentitySchema,
|
|
201
|
-
capabilityKind: z.enum(AssuranceProgramCapabilityKind),
|
|
456
|
+
capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
|
|
202
457
|
implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
203
458
|
implementationAuthority: AssuranceProgramAuthorityBasisIdentitySchema,
|
|
204
459
|
})
|
|
@@ -271,25 +526,368 @@ export const AssuranceProgramImplementationExpectationAuthoritySchema = z
|
|
|
271
526
|
})
|
|
272
527
|
.superRefine((authority, context) => addUniqueSortedIssue(authority.requiredCapabilityRefs, context, ["requiredCapabilityRefs"], "requiredCapabilityRefs"));
|
|
273
528
|
|
|
529
|
+
/**
|
|
530
|
+
* What one evidence demand actually ASKS FOR — the content behind an otherwise opaque
|
|
531
|
+
* `evidence-requirement:*` slug.
|
|
532
|
+
*
|
|
533
|
+
* Derived from the five paper bodies in `__evidence-plane-slice__/` rather than designed ahead of
|
|
534
|
+
* them (#302's whole premise: a schema error costs 1/49th here of what it costs after authoring at
|
|
535
|
+
* scale). The shape is what all five converged on, and the per-clause split is not decoration —
|
|
536
|
+
* three of the five carry clauses that do NOT share a home or a plane, and a single home per demand
|
|
537
|
+
* would have flattened exactly the distinction those bodies exist to record.
|
|
538
|
+
*/
|
|
539
|
+
export const AssuranceEvidenceRequirementClauseSchema = z.strictObject({
|
|
540
|
+
/** Stable within the body — `C1`, `C2` — so a finding can name the clause it failed. */
|
|
541
|
+
clauseRef: z.string().trim().regex(/^C[0-9]+$/u),
|
|
542
|
+
/** The obligation in the objective's own terms, one clause of its intent. */
|
|
543
|
+
obligation: z.string().trim().min(1),
|
|
544
|
+
home: z.enum(AssuranceEvidenceHome).systemEnum('AssuranceEvidenceHome'),
|
|
545
|
+
plane: z.enum(AssuranceEvidenceExecutionPlane).systemEnum('AssuranceEvidenceExecutionPlane'),
|
|
546
|
+
/**
|
|
547
|
+
* For an `EMITTED` clause whose store is the audit trail: the event members that satisfy it, DERIVED
|
|
548
|
+
* from `CoreAuditableEventType` rather than transcribed.
|
|
549
|
+
*
|
|
550
|
+
* Structured rather than named in prose, and the reason is the harness's own most error-prone step:
|
|
551
|
+
* *"before naming any audit member, check it has an EMITTER"*. A member that is declared but never
|
|
552
|
+
* emitted raises a MAJOR against a working control the first time its activity occurs — which the
|
|
553
|
+
* first drafted body did, with `USER_MFA_ENABLED`. As a typed array the members are checkable by a
|
|
554
|
+
* test instead of by an author's memory, and a collector reads the query off the demand rather than
|
|
555
|
+
* parsing English out of `minimumEvidence`.
|
|
556
|
+
*
|
|
557
|
+
* Optional because only an audit-trail-backed clause has them: an application resource row, a batch
|
|
558
|
+
* execution record and a host artifact are all `EMITTED` or otherwise without audit members.
|
|
559
|
+
*/
|
|
560
|
+
requiredAuditEventMembers: z.array(z.enum(CoreAuditableEventType)).min(1).optional(),
|
|
561
|
+
/**
|
|
562
|
+
* For an audit-trail-backed clause whose event TYPE carries several meanings: which rows of that
|
|
563
|
+
* type satisfy the clause, as one `eventData` field and the values that qualify.
|
|
564
|
+
*
|
|
565
|
+
* An event type is a closed vocabulary of KINDS; some kinds carry a second axis inside the row.
|
|
566
|
+
* `USER_PROVIDER_CREDENTIAL_DELETED` is one row shape for a revocation by its owner, an
|
|
567
|
+
* administrator's hard delete of the account, and a subject erasure, told apart by
|
|
568
|
+
* `eventData.reason`. Only the erasure is erasure evidence, and the requirement body said so in
|
|
569
|
+
* prose — which no collector reads. Counting by type alone over-counted the erasure clause with
|
|
570
|
+
* rows asserting that no erasure happened (#1087). The audit door filters by type, so the collector
|
|
571
|
+
* applies this predicate to every row it reads, and a measurement says how many rows of the type it
|
|
572
|
+
* set aside.
|
|
573
|
+
*
|
|
574
|
+
* Values are the member's own wire values (`ProviderCredentialDeletionReason.USER_ERASED`), named
|
|
575
|
+
* from the enum at the declaring site so the vocabulary stays with its source. Only meaningful
|
|
576
|
+
* beside `requiredAuditEventMembers`; a clause naming no event type has no rows to discriminate,
|
|
577
|
+
* and the refinement below refuses that pairing.
|
|
578
|
+
*/
|
|
579
|
+
requiredAuditEventDataMatch: z
|
|
580
|
+
.strictObject({
|
|
581
|
+
/** The `eventData` field the meaning rides on (`reason`). Top-level in `eventData`, no path. */
|
|
582
|
+
field: z.string().trim().min(1),
|
|
583
|
+
/** The values that satisfy the clause. A row whose field holds any other value is set aside, not counted. */
|
|
584
|
+
values: z.array(z.string().trim().min(1)).min(1),
|
|
585
|
+
})
|
|
586
|
+
.optional(),
|
|
587
|
+
/**
|
|
588
|
+
* For an audit-trail-backed clause: one `eventData` field whose DISTRIBUTION over the counted rows the
|
|
589
|
+
* collector reports beside the count — reported, never judged.
|
|
590
|
+
*
|
|
591
|
+
* Some clauses count rows whose meaning has a second, OUTCOME-shaped axis that no discriminator should
|
|
592
|
+
* filter on, because every value is evidence. The instance is the erasure clause's credential rows (#1711):
|
|
593
|
+
* each `USER_ERASED` row carries `vendorRevocation` — whether the vendor was told the grant is over
|
|
594
|
+
* (`revoked`), could not be (`not_declared`, `not_configured`), or did not answer (`unreachable`,
|
|
595
|
+
* `refused`). A `requiredAuditEventDataMatch` on it would DROP the rows that did not revoke, which are the
|
|
596
|
+
* ones a reviewer most needs to see; the count alone hides them inside a total. So the collector reads
|
|
597
|
+
* every counted row and states how many carry each value, and how many carry none (rows written before
|
|
598
|
+
* the field existed).
|
|
599
|
+
*
|
|
600
|
+
* Only meaningful beside `requiredAuditEventMembers` (refused otherwise, below). It forces an exhaustive
|
|
601
|
+
* read of the window, because a distribution is a property of row CONTENT that no server-side total
|
|
602
|
+
* expresses.
|
|
603
|
+
*/
|
|
604
|
+
reportedAuditEventDataDistribution: z
|
|
605
|
+
.strictObject({
|
|
606
|
+
/** The `eventData` field whose values are tallied (`vendorRevocation`). Top-level in `eventData`, no path. */
|
|
607
|
+
field: z.string().trim().min(1),
|
|
608
|
+
})
|
|
609
|
+
.optional(),
|
|
610
|
+
/**
|
|
611
|
+
* For an audit-trail-backed clause: one COUNT-shaped `eventData` field the collector SUMS over the counted rows
|
|
612
|
+
* and reports beside the count — reported, never judged (#1746).
|
|
613
|
+
*
|
|
614
|
+
* The distribution above suits an outcome with a few values; a count has as many values as it has sizes, and what
|
|
615
|
+
* a reviewer needs is the total. The instance is the erasure clause's pipeline runs: each
|
|
616
|
+
* `externalDataPipelineRun` read-through row carries `suppressedRows`, how many rows that run declined to re-import
|
|
617
|
+
* because an erasure suppressed their records. The row count says the runs happened; the sum says suppression held.
|
|
618
|
+
* A row carrying no number (written before the field existed) is counted apart, never as zero.
|
|
619
|
+
*
|
|
620
|
+
* Only meaningful beside `requiredAuditEventMembers` (refused otherwise, below), and it forces an exhaustive read of
|
|
621
|
+
* the window, for the same reason a distribution does.
|
|
622
|
+
*/
|
|
623
|
+
reportedAuditEventDataSum: z
|
|
624
|
+
.strictObject({
|
|
625
|
+
/** The numeric `eventData` field summed (`suppressedRows`). Top-level in `eventData`, no path. */
|
|
626
|
+
field: z.string().trim().min(1),
|
|
627
|
+
})
|
|
628
|
+
.optional(),
|
|
629
|
+
/**
|
|
630
|
+
* Why this home, stated as the reasoning that is NOT the proxy.
|
|
631
|
+
*
|
|
632
|
+
* Required, because both available proxies are wrong often enough to matter: the attesting
|
|
633
|
+
* capability misread `PRIVILEGED_REVIEW` as an audit row when it is a human act, and the ref's head
|
|
634
|
+
* noun misread `retention-window-declaration` as `DECLARED` when its clauses demand enforcement.
|
|
635
|
+
*/
|
|
636
|
+
/**
|
|
637
|
+
* What a row COUNT of the declared members cannot reach for this clause — present only when it cannot.
|
|
638
|
+
*
|
|
639
|
+
* The judge's EMITTED rule asks the audit trail one question: how many rows of these classes fell in the
|
|
640
|
+
* window. For an obligation that IS an existence claim — "issuance, refresh, rotation, revocation and
|
|
641
|
+
* expiry are explicit attributable transitions" — that count settles it, because each member is judged
|
|
642
|
+
* separately and all of them must have rows.
|
|
643
|
+
*
|
|
644
|
+
* It settles nothing for four other obligation shapes, and a count read as a verdict there OVERCLAIMS:
|
|
645
|
+
*
|
|
646
|
+
* | shape | why a count cannot reach it |
|
|
647
|
+
* |---|---|
|
|
648
|
+
* | the row must CARRY something | a count never opens a row, so "names the purpose, the subject and both withholding lists" is unread |
|
|
649
|
+
* | a DISJUNCTION | "audited OR refused" — rows evidence one branch and say nothing about what took the other |
|
|
650
|
+
* | a NEGATIVE or universal claim | "spent only for that principal" is about the rows that do NOT exist |
|
|
651
|
+
* | a property of the SYSTEM | "without the record itself becoming an availability risk" is not a property of any row |
|
|
652
|
+
*
|
|
653
|
+
* Declaring this does not weaken the clause; it stops the clause being reported as met on evidence that
|
|
654
|
+
* does not meet it. A member with rows and a declared limit is INSUFFICIENT_EVIDENCE rather than
|
|
655
|
+
* CONFORMANT, and `unreached` is the sentence a reader is given instead of a verdict. The zero-row
|
|
656
|
+
* readings are unaffected: a class that emitted nothing is still a nonconformity where activity is
|
|
657
|
+
* evidenced, and an observation where it is not — UNLESS the clause also declares `absenceUnreadable`.
|
|
658
|
+
*
|
|
659
|
+
* ABSENT means the obligation is an existence claim over the declared members. That is the common case
|
|
660
|
+
* and it is why this is an exception rather than a required field — but it is a CLAIM, so a clause
|
|
661
|
+
* asserting more than emission and declaring no limit here is a defect in the body, not a silence.
|
|
662
|
+
*/
|
|
663
|
+
emittedCountLimit: z
|
|
664
|
+
.strictObject({
|
|
665
|
+
/** What the obligation asks that a count of these rows does not establish. One sentence, in the clause's own terms. */
|
|
666
|
+
unreached: z.string().trim().min(1),
|
|
667
|
+
/**
|
|
668
|
+
* Why ZERO rows cannot be read as a quiet period on this clause, where that is so. Present, a member with no rows and
|
|
669
|
+
* no evidenced activity is INSUFFICIENT_EVIDENCE rather than an OBSERVATION.
|
|
670
|
+
*
|
|
671
|
+
* Rare, and it exists for one shape: an obligation whose failing outcome itself leaves no row. "Audited OR refused"
|
|
672
|
+
* on a runtime whose emission is fire-and-forget is the instance — the access that was neither audited nor refused is
|
|
673
|
+
* exactly as silent as a window with no access at all, so reading silence as quiet would pass the case the clause
|
|
674
|
+
* exists to catch. Added 2026-09-21 after the adversarial judge (#297) found `security-event-record` C2's severity
|
|
675
|
+
* guidance excusing every absent row; the rule-based judge, which cannot see a runtime profile, needed the body to
|
|
676
|
+
* SAY so rather than infer it.
|
|
677
|
+
*/
|
|
678
|
+
absenceUnreadable: z.string().trim().min(1).optional(),
|
|
679
|
+
})
|
|
680
|
+
.optional(),
|
|
681
|
+
homeRationale: z.string().trim().min(1),
|
|
682
|
+
}).superRefine((clause, context) => {
|
|
683
|
+
if (clause.emittedCountLimit && !clause.requiredAuditEventMembers) {
|
|
684
|
+
context.addIssue({
|
|
685
|
+
code: "custom",
|
|
686
|
+
path: ["emittedCountLimit"],
|
|
687
|
+
message: `clause ${clause.clauseRef} states what a row count does not reach but names no audit event type to count`,
|
|
688
|
+
});
|
|
689
|
+
}
|
|
690
|
+
if (clause.reportedAuditEventDataDistribution && !clause.requiredAuditEventMembers) {
|
|
691
|
+
context.addIssue({
|
|
692
|
+
code: "custom",
|
|
693
|
+
path: ["reportedAuditEventDataDistribution"],
|
|
694
|
+
message: `clause ${clause.clauseRef} reports the distribution of eventData.${clause.reportedAuditEventDataDistribution.field} but names no audit event type to read`,
|
|
695
|
+
});
|
|
696
|
+
}
|
|
697
|
+
if (clause.reportedAuditEventDataSum && !clause.requiredAuditEventMembers) {
|
|
698
|
+
context.addIssue({
|
|
699
|
+
code: "custom",
|
|
700
|
+
path: ["reportedAuditEventDataSum"],
|
|
701
|
+
message: `clause ${clause.clauseRef} sums eventData.${clause.reportedAuditEventDataSum.field} but names no audit event type to read`,
|
|
702
|
+
});
|
|
703
|
+
}
|
|
704
|
+
if (clause.requiredAuditEventDataMatch && !clause.requiredAuditEventMembers) {
|
|
705
|
+
context.addIssue({
|
|
706
|
+
code: "custom",
|
|
707
|
+
path: ["requiredAuditEventDataMatch"],
|
|
708
|
+
message: `clause ${clause.clauseRef} discriminates on eventData.${clause.requiredAuditEventDataMatch.field} but names no audit event type to read`,
|
|
709
|
+
});
|
|
710
|
+
}
|
|
711
|
+
});
|
|
712
|
+
|
|
713
|
+
/** @see AssuranceEvidenceRequirementClauseSchema */
|
|
714
|
+
export const AssuranceEvidenceRequirementBodySchema = z.strictObject({
|
|
715
|
+
schemaVersion: z.literal(1),
|
|
716
|
+
/**
|
|
717
|
+
* Whether the demand applies to THIS application at all, and how a judge decides.
|
|
718
|
+
*
|
|
719
|
+
* First field on purpose. `subject-erasure-execution-record` is majority application-owned, and an
|
|
720
|
+
* application that never built an erasure lane has not failed a control — it declared none. A body
|
|
721
|
+
* without this field invites a nonconformity against every application that does not implement it.
|
|
722
|
+
*/
|
|
723
|
+
applicability: z.string().trim().min(1),
|
|
724
|
+
clauses: z.array(AssuranceEvidenceRequirementClauseSchema).min(1),
|
|
725
|
+
/** The artifacts that, at minimum, satisfy the demand — named vocabulary members, never prose lists. */
|
|
726
|
+
minimumEvidence: z.string().trim().min(1),
|
|
727
|
+
/** Mechanical enough that two judges gather the same thing. */
|
|
728
|
+
verificationSteps: z.array(z.string().trim().min(1)).min(1),
|
|
729
|
+
/**
|
|
730
|
+
* What an absence or failure MEANS, so severity follows evidenced risk rather than wording
|
|
731
|
+
* intensity — and so a control that operated with a missing evidence export stays an OBSERVATION
|
|
732
|
+
* rather than becoming a nonconformity.
|
|
733
|
+
*/
|
|
734
|
+
severityGuidance: z.string().trim().min(1),
|
|
735
|
+
/** What the evidence does NOT prove, and what would make it stale. */
|
|
736
|
+
limits: z.string().trim().min(1),
|
|
737
|
+
});
|
|
738
|
+
|
|
739
|
+
export type AssuranceEvidenceRequirementBody = z.infer<typeof AssuranceEvidenceRequirementBodySchema>;
|
|
740
|
+
|
|
741
|
+
/**
|
|
742
|
+
* One stated evidence demand, paired with the body that says what would satisfy it.
|
|
743
|
+
*
|
|
744
|
+
* Paired rather than looked up, so a consumer reading an authority's pass conditions never has to decide
|
|
745
|
+
* which of several demands one body belongs to — the decision that went wrong, silently, the first time
|
|
746
|
+
* an authority stated two.
|
|
747
|
+
*/
|
|
748
|
+
export const AssuranceProgramEvidenceRequirementBodyEntrySchema = z.strictObject({
|
|
749
|
+
requirementRef: AssuranceNamespacedRefSchema,
|
|
750
|
+
body: AssuranceEvidenceRequirementBodySchema,
|
|
751
|
+
});
|
|
752
|
+
|
|
753
|
+
export type AssuranceProgramEvidenceRequirementBodyEntry = z.infer<typeof AssuranceProgramEvidenceRequirementBodyEntrySchema>;
|
|
754
|
+
|
|
274
755
|
export const AssuranceProgramEvidenceExpectationAuthoritySchema = z
|
|
275
756
|
.strictObject({
|
|
276
757
|
identity: AssuranceProgramExpectationIdentitySchema,
|
|
277
758
|
objective: AssuranceObjectiveIdentitySchema,
|
|
278
759
|
requiredStatementEvidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
760
|
+
/**
|
|
761
|
+
* ONE BODY PER STATED DEMAND, in the order of `requiredStatementEvidenceRefs` — since 2026-09-12.
|
|
762
|
+
*
|
|
763
|
+
* This was a single `body`, joined by `requiredStatementEvidenceRefs[0]`, on the premise that every
|
|
764
|
+
* authority states one demand. `4ac83c1f` gave `WILDO.ACCESS.LEAST_PRIVILEGE` a second —
|
|
765
|
+
* `authorization-decision-record` beside `operation-role-declaration` — and the new ref sorts FIRST.
|
|
766
|
+
* From that commit the authority named `evidence-expectation:operation-role-declaration` carried the
|
|
767
|
+
* three clauses of the refusal record, and its own five clauses reached the composed basis nowhere.
|
|
768
|
+
* Nothing reported it: the guard beside the composer asserted that A body was present and that a body
|
|
769
|
+
* existed for `[0]`, and both stayed true. Reproduced on the committed collection plan, which answered
|
|
770
|
+
* a request for `operation-role-declaration` with a plan for a different demand, under that name.
|
|
771
|
+
*
|
|
772
|
+
* The history this field inherits: the single `body` became REQUIRED on 2026-09-10, when the catalog
|
|
773
|
+
* completed at 51 of 51 (#296 / #302), because an optional body invited a binding that shipped with
|
|
774
|
+
* nothing a collector could act on. That reasoning carries over whole — `.min(1)` and the agreement
|
|
775
|
+
* refinement below make a demand without its own body unrepresentable, now for every demand rather
|
|
776
|
+
* than the first.
|
|
777
|
+
*
|
|
778
|
+
* The verification authority below pairs its bodies the same way, and differs in one deliberate
|
|
779
|
+
* respect: it may carry FEWER bodies than demands, because an application's own basis may extend it
|
|
780
|
+
* with demands whose bodies are not written yet.
|
|
781
|
+
*/
|
|
782
|
+
requirementBodies: z.array(AssuranceProgramEvidenceRequirementBodyEntrySchema).min(1),
|
|
279
783
|
})
|
|
280
|
-
.superRefine((authority, context) =>
|
|
281
|
-
addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs")
|
|
282
|
-
|
|
784
|
+
.superRefine((authority, context) => {
|
|
785
|
+
addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs");
|
|
786
|
+
const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
|
|
787
|
+
if (
|
|
788
|
+
pairedRequirementRefs.length !== authority.requiredStatementEvidenceRefs.length ||
|
|
789
|
+
pairedRequirementRefs.some((requirementRef, index) => requirementRef !== authority.requiredStatementEvidenceRefs[index])
|
|
790
|
+
) {
|
|
791
|
+
context.addIssue({
|
|
792
|
+
code: "custom",
|
|
793
|
+
message: "requirementBodies must pair exactly one body with each stated demand, in the order of requiredStatementEvidenceRefs",
|
|
794
|
+
path: ["requirementBodies"],
|
|
795
|
+
});
|
|
796
|
+
}
|
|
797
|
+
});
|
|
798
|
+
|
|
799
|
+
/**
|
|
800
|
+
* What a VERIFICATION demand actually asks someone to do.
|
|
801
|
+
*
|
|
802
|
+
* The verification plane was degenerate until 2026-09-08: `requiredStatementVerificationRefs` held the
|
|
803
|
+
* expectation's own ref in 50 of 50 bindings, so the demand said "to verify X, see X" and stated
|
|
804
|
+
* nothing a verifier could act on (#452). The evidence axis beside it was never degenerate, which is
|
|
805
|
+
* what made the defect specific to this tier rather than a modelling slip.
|
|
806
|
+
*
|
|
807
|
+
* Deliberately NOT a copy of {@link AssuranceEvidenceRequirementBodySchema}. They answer different
|
|
808
|
+
* questions and conflating them is how a verification demand becomes a second evidence list:
|
|
809
|
+
*
|
|
810
|
+
* - EVIDENCE asks *what artifact proves this ran* — a row, an export, a declaration.
|
|
811
|
+
* - VERIFICATION asks *what a person or a test DOES to establish the control holds*, and what that
|
|
812
|
+
* act cannot establish.
|
|
813
|
+
*
|
|
814
|
+
* `acceptableMethods` is the field that makes it a demand rather than prose: it is drawn from
|
|
815
|
+
* {@link AssuranceVerificationMethod}, so a body states which kinds of act satisfy it and an
|
|
816
|
+
* application's own `AssuranceVerificationExpectation.method` can be checked against it.
|
|
817
|
+
*/
|
|
818
|
+
export const AssuranceVerificationRequirementBodySchema = z.strictObject({
|
|
819
|
+
schemaVersion: z.literal(1),
|
|
820
|
+
/**
|
|
821
|
+
* Whether the demand applies to THIS application, and how a judge decides — first field for the
|
|
822
|
+
* same reason as on the evidence body: an application that declared no lane has not failed a
|
|
823
|
+
* control, and a body without this invites a nonconformity against everyone who did not build it.
|
|
824
|
+
*/
|
|
825
|
+
applicability: z.string().trim().min(1),
|
|
826
|
+
/** Which kinds of act satisfy the demand. Named vocabulary members, never prose. */
|
|
827
|
+
acceptableMethods: z.array(z.enum(AssuranceVerificationMethod).systemEnum('AssuranceVerificationMethod')).min(1),
|
|
828
|
+
/** Mechanical enough that two verifiers perform the same act and can disagree about the result. */
|
|
829
|
+
procedure: z.array(z.string().trim().min(1)).min(1),
|
|
830
|
+
/** What a PASS looks like, stated so it can be false. */
|
|
831
|
+
passCriteria: z.string().trim().min(1),
|
|
832
|
+
/**
|
|
833
|
+
* What this act does NOT establish. The counterpart of an application's `limitationRefs`, and the
|
|
834
|
+
* field that stops a verification being read as operating effectiveness.
|
|
835
|
+
*/
|
|
836
|
+
knownLimitations: z.string().trim().min(1),
|
|
837
|
+
/** What a failure MEANS, so severity follows evidenced risk rather than wording intensity. */
|
|
838
|
+
severityGuidance: z.string().trim().min(1),
|
|
839
|
+
});
|
|
840
|
+
|
|
841
|
+
export type AssuranceVerificationRequirementBody = z.infer<typeof AssuranceVerificationRequirementBodySchema>;
|
|
842
|
+
|
|
843
|
+
/**
|
|
844
|
+
* One stated verification demand, paired with the body that says what a verifier must do.
|
|
845
|
+
*
|
|
846
|
+
* The verification twin of `AssuranceProgramEvidenceRequirementBodyEntrySchema`: a body names its demand
|
|
847
|
+
* rather than being found by position, so no consumer has to decide which demand a body belongs to.
|
|
848
|
+
*/
|
|
849
|
+
export const AssuranceProgramVerificationRequirementBodyEntrySchema = z.strictObject({
|
|
850
|
+
requirementRef: AssuranceNamespacedRefSchema,
|
|
851
|
+
body: AssuranceVerificationRequirementBodySchema,
|
|
852
|
+
});
|
|
853
|
+
|
|
854
|
+
export type AssuranceProgramVerificationRequirementBodyEntry = z.infer<typeof AssuranceProgramVerificationRequirementBodyEntrySchema>;
|
|
283
855
|
|
|
284
856
|
export const AssuranceProgramVerificationExpectationAuthoritySchema = z
|
|
285
857
|
.strictObject({
|
|
286
858
|
identity: AssuranceProgramExpectationIdentitySchema,
|
|
287
859
|
objective: AssuranceObjectiveIdentitySchema,
|
|
288
860
|
requiredStatementVerificationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
861
|
+
/**
|
|
862
|
+
* The bodies AUTHORED so far, each naming the stated demand it belongs to — since 2026-09-12.
|
|
863
|
+
*
|
|
864
|
+
* This was one optional `body`, joined by `requiredStatementVerificationRefs[0]`. The evidence tier
|
|
865
|
+
* beside it had the same join and silently swapped a body the first time an authority stated two
|
|
866
|
+
* demands: the new ref sorted first and took over. No binding states two verification demands, so
|
|
867
|
+
* this tier never swapped — but a body that did not name its demand could not be checked against one.
|
|
868
|
+
*
|
|
869
|
+
* POSSIBLY EMPTY, and fewer entries than demands is legitimate — the reason the single body was
|
|
870
|
+
* optional carries over whole. An application's own basis may extend the model with demands whose
|
|
871
|
+
* bodies are not written yet, and a schema that refused that would refuse a partially-authored
|
|
872
|
+
* extension; completeness for the FRAMEWORK's basis is a test, not a schema rule. What the refinement
|
|
873
|
+
* below does refuse is a body attached to a demand this authority does not state, or two bodies for
|
|
874
|
+
* one demand.
|
|
875
|
+
*/
|
|
876
|
+
requirementBodies: z.array(AssuranceProgramVerificationRequirementBodyEntrySchema),
|
|
289
877
|
})
|
|
290
|
-
.superRefine((authority, context) =>
|
|
291
|
-
addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs")
|
|
292
|
-
|
|
878
|
+
.superRefine((authority, context) => {
|
|
879
|
+
addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs");
|
|
880
|
+
const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
|
|
881
|
+
addUniqueSortedIssue(pairedRequirementRefs, context, ["requirementBodies"], "requirementBodies requirementRefs");
|
|
882
|
+
const statedRequirementRefs = new Set<string>(authority.requiredStatementVerificationRefs);
|
|
883
|
+
if (pairedRequirementRefs.some((requirementRef) => !statedRequirementRefs.has(requirementRef))) {
|
|
884
|
+
context.addIssue({
|
|
885
|
+
code: "custom",
|
|
886
|
+
message: "every verification body names a demand this authority states in requiredStatementVerificationRefs",
|
|
887
|
+
path: ["requirementBodies"],
|
|
888
|
+
});
|
|
889
|
+
}
|
|
890
|
+
});
|
|
293
891
|
|
|
294
892
|
export const AssuranceProgramValidationAuthoritySnapshotSchema = z
|
|
295
893
|
.strictObject({
|
|
@@ -297,7 +895,7 @@ export const AssuranceProgramValidationAuthoritySnapshotSchema = z
|
|
|
297
895
|
snapshotRef: AssuranceNamespacedRefSchema,
|
|
298
896
|
snapshotVersion: z.number().int().positive(),
|
|
299
897
|
evaluatedAt: AssuranceIsoDateTimeSchema,
|
|
300
|
-
requestedSourceUses: z.array(z.enum(AssuranceSourceUse)).min(1),
|
|
898
|
+
requestedSourceUses: z.array(z.enum(AssuranceSourceUse).systemEnum('AssuranceSourceUse')).min(1),
|
|
301
899
|
sourceRegistry: AssuranceSourceRegistrySchema,
|
|
302
900
|
/** Optional only so retained pre-document-system snapshots stay parseable. */
|
|
303
901
|
documentAuthorityCatalog: AssuranceDocumentAuthorityCatalogSchema.optional(),
|
|
@@ -401,9 +999,9 @@ export type AssuranceProgramValidationAuthoritySnapshot = z.infer<typeof Assuran
|
|
|
401
999
|
export const AssuranceProgramSourceReferenceSchema = z.strictObject({
|
|
402
1000
|
identity: AssuranceSourceIdentitySchema,
|
|
403
1001
|
edition: z.string().trim().min(1),
|
|
404
|
-
authorityKind: z.enum(AssuranceSourceAuthorityKind),
|
|
1002
|
+
authorityKind: z.enum(AssuranceSourceAuthorityKind).systemEnum('AssuranceSourceAuthorityKind'),
|
|
405
1003
|
authorityName: z.string().trim().min(1),
|
|
406
|
-
lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus),
|
|
1004
|
+
lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus).systemEnum('AssuranceSourceLifecycleStatus'),
|
|
407
1005
|
rightsRef: AssuranceNamespacedRefSchema,
|
|
408
1006
|
rightsVersion: z.number().int().positive(),
|
|
409
1007
|
});
|
|
@@ -412,9 +1010,9 @@ export type AssuranceProgramSourceReference = z.infer<typeof AssuranceProgramSou
|
|
|
412
1010
|
/** Reusable application-level scope policy. Runtime resolution supplies actual tenant and assignee identities. */
|
|
413
1011
|
export const AssuranceProgramScopeSelectorSchema = z
|
|
414
1012
|
.strictObject({
|
|
415
|
-
scopeSelectorRef:
|
|
1013
|
+
scopeSelectorRef: AssuranceEntryKeySchema,
|
|
416
1014
|
scopeSelectorVersion: z.number().int().positive(),
|
|
417
|
-
kind: z.enum(AssuranceProgramScopeSelectorKind),
|
|
1015
|
+
kind: z.enum(AssuranceProgramScopeSelectorKind).systemEnum('AssuranceProgramScopeSelectorKind'),
|
|
418
1016
|
systemBoundaryRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
419
1017
|
organizationScopeRuleRefs: z.array(AssuranceNamespacedRefSchema),
|
|
420
1018
|
jurisdictionRefs: z.array(AssuranceNamespacedRefSchema),
|
|
@@ -437,11 +1035,11 @@ export type AssuranceProgramScopeSelector = z.infer<typeof AssuranceProgramScope
|
|
|
437
1035
|
|
|
438
1036
|
export const AssuranceProgramApplicabilityDecisionSchema = z
|
|
439
1037
|
.strictObject({
|
|
440
|
-
decisionRef:
|
|
1038
|
+
decisionRef: AssuranceEntryKeySchema,
|
|
441
1039
|
decisionVersion: z.number().int().positive(),
|
|
442
1040
|
source: AssuranceSourceIdentitySchema,
|
|
443
1041
|
scopeSelectorRef: AssuranceNamespacedRefSchema,
|
|
444
|
-
status: z.enum(AssuranceProgramApplicabilityStatus),
|
|
1042
|
+
status: z.enum(AssuranceProgramApplicabilityStatus).systemEnum('AssuranceProgramApplicabilityStatus'),
|
|
445
1043
|
basis: z.string().trim().min(1),
|
|
446
1044
|
authorityDecisionRef: AssuranceNamespacedRefSchema,
|
|
447
1045
|
effectiveFrom: AssuranceIsoDateSchema,
|
|
@@ -494,7 +1092,7 @@ export const AssuranceProgramControlObjectiveBindingSchema = z
|
|
|
494
1092
|
implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
495
1093
|
evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
496
1094
|
verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
497
|
-
requiredProofStage: z.enum(AssuranceProgramProofStage),
|
|
1095
|
+
requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
|
|
498
1096
|
})
|
|
499
1097
|
.superRefine((binding, context) => {
|
|
500
1098
|
addUniqueSortedIssue(binding.scopeSelectorRefs, context, ["scopeSelectorRefs"], "scopeSelectorRefs");
|
|
@@ -537,10 +1135,10 @@ export const AssuranceProgramSharedResponsibilityRuleIdentitySchema = z.strictOb
|
|
|
537
1135
|
export type AssuranceProgramSharedResponsibilityRuleIdentity = z.infer<typeof AssuranceProgramSharedResponsibilityRuleIdentitySchema>;
|
|
538
1136
|
|
|
539
1137
|
const AssuranceProgramSharedResponsibilityPrecedenceSchema = z.discriminatedUnion("mode", [
|
|
540
|
-
z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE) }),
|
|
1138
|
+
z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode') }),
|
|
541
1139
|
z.strictObject({
|
|
542
|
-
mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE),
|
|
543
|
-
precedenceActorKind: z.enum(AssuranceGovernanceActorKind),
|
|
1140
|
+
mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode'),
|
|
1141
|
+
precedenceActorKind: z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind'),
|
|
544
1142
|
}),
|
|
545
1143
|
]);
|
|
546
1144
|
|
|
@@ -550,10 +1148,10 @@ const AssuranceProgramSharedResponsibilityPrecedenceSchema = z.discriminatedUnio
|
|
|
550
1148
|
*/
|
|
551
1149
|
export const AssuranceProgramSharedResponsibilityRuleSchema = z
|
|
552
1150
|
.strictObject({
|
|
553
|
-
sharedResponsibilityRuleRef:
|
|
1151
|
+
sharedResponsibilityRuleRef: AssuranceEntryKeySchema,
|
|
554
1152
|
sharedResponsibilityRuleVersion: z.number().int().positive(),
|
|
555
1153
|
scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
556
|
-
governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(2),
|
|
1154
|
+
governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(2),
|
|
557
1155
|
accountableRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
558
1156
|
operatingRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
559
1157
|
evidenceProviderRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
@@ -584,11 +1182,11 @@ export type AssuranceProgramSharedResponsibilityRule = z.infer<typeof AssuranceP
|
|
|
584
1182
|
/** Exact human-reviewed coverage claim over one obligation and its complete cited source-requirement inventory. */
|
|
585
1183
|
export const AssuranceProgramObligationCoverageDecisionSchema = z
|
|
586
1184
|
.strictObject({
|
|
587
|
-
coverageDecisionRef:
|
|
1185
|
+
coverageDecisionRef: AssuranceEntryKeySchema,
|
|
588
1186
|
coverageDecisionVersion: z.number().int().positive(),
|
|
589
1187
|
obligation: AssuranceProgramObligationIdentitySchema,
|
|
590
1188
|
sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
|
|
591
|
-
reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition),
|
|
1189
|
+
reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition).systemEnum('AssuranceProgramObligationCoverageReviewDisposition'),
|
|
592
1190
|
reviewedByRoleRef: AssuranceNamespacedRefSchema,
|
|
593
1191
|
reviewedAt: AssuranceIsoDateTimeSchema,
|
|
594
1192
|
rationale: z.string().trim().min(1),
|
|
@@ -613,12 +1211,12 @@ const AssuranceProgramObligationApplicabilityDecisionCommonSchema = z.strictObje
|
|
|
613
1211
|
/** Outcome-level applicability. It cannot encode lifecycle activation, operating status or a compliance conclusion. */
|
|
614
1212
|
export const AssuranceProgramObligationApplicabilityDecisionSchema = z
|
|
615
1213
|
.discriminatedUnion("status", [
|
|
616
|
-
AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE) }),
|
|
1214
|
+
AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
|
|
617
1215
|
AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({
|
|
618
|
-
status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE),
|
|
1216
|
+
status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus'),
|
|
619
1217
|
evidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
620
1218
|
}),
|
|
621
|
-
AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED) }),
|
|
1219
|
+
AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
|
|
622
1220
|
])
|
|
623
1221
|
.superRefine((decision, context) => {
|
|
624
1222
|
addUniqueSortedIssue(decision.evidenceRefs, context, ["evidenceRefs"], "evidenceRefs");
|
|
@@ -629,11 +1227,11 @@ export type AssuranceProgramObligationApplicabilityDecision = z.infer<typeof Ass
|
|
|
629
1227
|
/** One source-neutral application obligation. External framework ids and protected source bytes remain outside this contract. */
|
|
630
1228
|
export const AssuranceProgramObligationEntrySchema = z
|
|
631
1229
|
.strictObject({
|
|
632
|
-
obligationRef:
|
|
1230
|
+
obligationRef: AssuranceEntryKeySchema,
|
|
633
1231
|
obligationVersion: z.number().int().positive(),
|
|
634
1232
|
objective: AssuranceObjectiveIdentitySchema,
|
|
635
1233
|
scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
636
|
-
governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(1),
|
|
1234
|
+
governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(1),
|
|
637
1235
|
sharedResponsibilityRule: AssuranceProgramSharedResponsibilityRuleIdentitySchema.optional(),
|
|
638
1236
|
sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
|
|
639
1237
|
sourceApplicabilityDecisionRefs: z.array(AssuranceProgramSourceApplicabilityDecisionIdentitySchema).min(1),
|
|
@@ -643,12 +1241,23 @@ export const AssuranceProgramObligationEntrySchema = z
|
|
|
643
1241
|
implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
644
1242
|
evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
645
1243
|
verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
|
|
646
|
-
requiredProofStage: z.enum(AssuranceProgramProofStage),
|
|
647
|
-
blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect),
|
|
1244
|
+
requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
|
|
1245
|
+
blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect).systemEnum('AssuranceProgramObligationBlockingEffect'),
|
|
648
1246
|
gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
|
|
649
1247
|
dependencyObligationRefs: z.array(AssuranceProgramObligationIdentitySchema),
|
|
650
1248
|
reviewOwnerRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
651
|
-
|
|
1249
|
+
/**
|
|
1250
|
+
* When this obligation is next reviewed, or ABSENT when no review schedule is committed.
|
|
1251
|
+
*
|
|
1252
|
+
* Optional since #647 decision C, and absence is a MARKED state rather than a gap: a programme
|
|
1253
|
+
* produced for an application that declares no periodic `assuranceReviewCadence` omits it on every
|
|
1254
|
+
* entry and carries a stamped `knownProgramLimitations` line saying no schedule is committed. It was
|
|
1255
|
+
* required, which meant an unscheduled programme could not be REPRESENTED at all — so the normalizer
|
|
1256
|
+
* refused, and a workflow fact (somebody committing to a schedule) stood in front of the mechanism.
|
|
1257
|
+
* An unfinished workflow MARKS; only an artifact that would be FALSE may refuse. Absent is never
|
|
1258
|
+
* "overdue" — the overdue check below skips it.
|
|
1259
|
+
*/
|
|
1260
|
+
reviewOn: AssuranceIsoDateSchema.optional(),
|
|
652
1261
|
reviewTriggerRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
653
1262
|
})
|
|
654
1263
|
.superRefine((entry, context) => {
|
|
@@ -695,7 +1304,13 @@ export const AssuranceProgramObligationEntrySchema = z
|
|
|
695
1304
|
});
|
|
696
1305
|
export type AssuranceProgramObligationEntry = z.infer<typeof AssuranceProgramObligationEntrySchema>;
|
|
697
1306
|
|
|
698
|
-
/**
|
|
1307
|
+
/**
|
|
1308
|
+
* Complete application obligation inventory. It is not the governed-document release register.
|
|
1309
|
+
*
|
|
1310
|
+
* It carried a digest until every digest was removed from the design (a digest chain cannot merge across branches) and the JSDoc went on calling it "content-addressed" afterwards. The
|
|
1311
|
+
* strict shape below is the whole truth: a ref, a version and the entries. Completeness is proven by `obligationCoverageDecisions` and the uniqueness refinement, not
|
|
1312
|
+
* by a hash. A test still named `registerWithoutDigest` is a leftover from when the field existed.
|
|
1313
|
+
*/
|
|
699
1314
|
export const AssuranceProgramObligationRegisterSchema = z
|
|
700
1315
|
.strictObject({
|
|
701
1316
|
schemaVersion: z.literal(1),
|
|
@@ -730,7 +1345,7 @@ export const AssuranceProgramSelectedOptionSchema = z.strictObject({
|
|
|
730
1345
|
|
|
731
1346
|
export const AssuranceProgramCapabilitySelectionSchema = z
|
|
732
1347
|
.strictObject({
|
|
733
|
-
capabilityKind: z.enum(AssuranceProgramCapabilityKind),
|
|
1348
|
+
capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
|
|
734
1349
|
capabilityRef: AssuranceNamespacedRefSchema,
|
|
735
1350
|
capabilityVersion: z.number().int().positive(),
|
|
736
1351
|
profileRef: AssuranceNamespacedRefSchema.optional(),
|
|
@@ -747,15 +1362,15 @@ export const AssuranceProgramCapabilitySelectionSchema = z
|
|
|
747
1362
|
|
|
748
1363
|
export const AssuranceProgramImplementationDecisionSchema = z
|
|
749
1364
|
.strictObject({
|
|
750
|
-
decisionRef:
|
|
1365
|
+
decisionRef: AssuranceEntryKeySchema,
|
|
751
1366
|
decisionVersion: z.number().int().positive(),
|
|
752
1367
|
objective: AssuranceObjectiveIdentitySchema,
|
|
753
1368
|
scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
754
|
-
resolution: z.enum(AssuranceProgramCapabilityResolution),
|
|
1369
|
+
resolution: z.enum(AssuranceProgramCapabilityResolution).systemEnum('AssuranceProgramCapabilityResolution'),
|
|
755
1370
|
capabilitySelections: z.array(AssuranceProgramCapabilitySelectionSchema),
|
|
756
1371
|
selectionAuthorityRef: AssuranceNamespacedRefSchema,
|
|
757
1372
|
knownLimitations: z.array(z.string().trim().min(1)),
|
|
758
|
-
gapDisposition: z.enum(AssuranceGapDisposition),
|
|
1373
|
+
gapDisposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
|
|
759
1374
|
gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
|
|
760
1375
|
})
|
|
761
1376
|
.superRefine((decision, context) => {
|
|
@@ -784,14 +1399,41 @@ export const AssuranceProgramImplementationDecisionSchema = z
|
|
|
784
1399
|
});
|
|
785
1400
|
if (decision.resolution === AssuranceProgramCapabilityResolution.UNSUPPORTED && decision.capabilitySelections.length > 0)
|
|
786
1401
|
context.addIssue({ code: "custom", message: "UNSUPPORTED resolution cannot select an implementation capability", path: ["capabilitySelections"] });
|
|
1402
|
+
/*
|
|
1403
|
+
* A HUMAN_OR_EXTERNAL resolution must SAY WHAT THE HUMAN DOES — and it may say so in prose,
|
|
1404
|
+
* because there is nothing for it to select.
|
|
1405
|
+
*
|
|
1406
|
+
* This required a `capabilitySelections` entry of kind `HUMAN_OR_EXTERNAL` until 2026-09-23
|
|
1407
|
+
* (#1273), and no producer could ever satisfy it. Measured: the authority basis declares 42
|
|
1408
|
+
* capabilities and every one is `ENGINE`; probed wide, `HUMAN_OR_EXTERNAL` appears in the whole
|
|
1409
|
+
* specifications tree only as these two enum members and this refusal. Inventing a ref does not
|
|
1410
|
+
* help either — the family separately refuses a selection with no declared authority
|
|
1411
|
+
* (`UNKNOWN_CAPABILITY`). So the requirement was doubly unsatisfiable, and it refused a producer
|
|
1412
|
+
* for being HONEST: on the first end-to-end journey run five obligations were correctly
|
|
1413
|
+
* classified as resolved by a human or external party and the programme was rejected three times
|
|
1414
|
+
* for it.
|
|
1415
|
+
*
|
|
1416
|
+
* The conflation underneath is worth naming, because it decides why the fix is not "add human
|
|
1417
|
+
* entries to the basis": `capabilitySelections` picks from the ENGINE capability basis, and a
|
|
1418
|
+
* human control ("the security officer reviews access quarterly") is operator-specific and can
|
|
1419
|
+
* never come from that basis. Two different kinds of thing were sharing one field.
|
|
1420
|
+
*
|
|
1421
|
+
* So the obligation moves to prose, which is where an operator control can actually be stated,
|
|
1422
|
+
* and the mechanism MARKS instead of refusing — `application-creation-directive.md`: if the
|
|
1423
|
+
* remedy is "author a commitment", it is a workflow, and a workflow never stands in front of the
|
|
1424
|
+
* mechanism. A selection of that kind stays LEGAL, so a future basis that does declare
|
|
1425
|
+
* human/external capabilities satisfies this with no change here.
|
|
1426
|
+
*/
|
|
787
1427
|
if (
|
|
788
1428
|
decision.resolution === AssuranceProgramCapabilityResolution.HUMAN_OR_EXTERNAL &&
|
|
789
|
-
!decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL)
|
|
1429
|
+
!decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL) &&
|
|
1430
|
+
decision.knownLimitations.length === 0
|
|
790
1431
|
)
|
|
791
1432
|
context.addIssue({
|
|
792
1433
|
code: "custom",
|
|
793
|
-
message:
|
|
794
|
-
|
|
1434
|
+
message:
|
|
1435
|
+
"HUMAN_OR_EXTERNAL resolution must state the human or external control — either a capability selection of that kind, or at least one knownLimitations entry describing what the human or external party does",
|
|
1436
|
+
path: ["knownLimitations"],
|
|
795
1437
|
});
|
|
796
1438
|
if (decision.gapDisposition === AssuranceGapDisposition.RESOLVED && decision.gapRefs.length > 0)
|
|
797
1439
|
context.addIssue({ code: "custom", message: "RESOLVED disposition cannot retain open gap refs", path: ["gapRefs"] });
|
|
@@ -845,9 +1487,9 @@ export type AssuranceProgramResponsibilityAssignment = z.infer<typeof AssuranceP
|
|
|
845
1487
|
|
|
846
1488
|
export const AssuranceProgramGapOrExceptionSchema = z
|
|
847
1489
|
.strictObject({
|
|
848
|
-
findingRef:
|
|
1490
|
+
findingRef: AssuranceEntryKeySchema,
|
|
849
1491
|
findingVersion: z.number().int().positive(),
|
|
850
|
-
kind: z.enum(AssuranceProgramFindingKind),
|
|
1492
|
+
kind: z.enum(AssuranceProgramFindingKind).systemEnum('AssuranceProgramFindingKind'),
|
|
851
1493
|
objective: AssuranceObjectiveIdentitySchema.optional(),
|
|
852
1494
|
source: AssuranceSourceIdentitySchema.optional(),
|
|
853
1495
|
scopeSelectorRef: AssuranceNamespacedRefSchema,
|
|
@@ -855,9 +1497,27 @@ export const AssuranceProgramGapOrExceptionSchema = z
|
|
|
855
1497
|
reason: z.string().trim().min(1),
|
|
856
1498
|
ownerRoleRef: AssuranceNamespacedRefSchema,
|
|
857
1499
|
compensatingControlRefs: z.array(AssuranceNamespacedRefSchema),
|
|
858
|
-
disposition: z.enum(AssuranceGapDisposition),
|
|
1500
|
+
disposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
|
|
859
1501
|
authorityDecisionRef: AssuranceNamespacedRefSchema.optional(),
|
|
860
|
-
|
|
1502
|
+
/**
|
|
1503
|
+
* When this finding is next revisited — DERIVED from the application's declared review cadence,
|
|
1504
|
+
* never answered.
|
|
1505
|
+
*
|
|
1506
|
+
* OPTIONAL, and absent exactly when the application commits to no periodic review (no
|
|
1507
|
+
* `assuranceReviewCadence`, or `AS_NEEDED`). The programme then carries
|
|
1508
|
+
* `UNSCHEDULED_REVIEW_LIMITATION`, so the absence is stated where every reader of the programme
|
|
1509
|
+
* meets it rather than being silent.
|
|
1510
|
+
*
|
|
1511
|
+
* This was REQUIRED until 2026-09-23 (#1273), and the requirement blocked the compliance lane for
|
|
1512
|
+
* every newly created application: nothing in the creation lane declares a cadence and no question
|
|
1513
|
+
* asks for one, so a run that honestly found a gap could not record it. The obligation register
|
|
1514
|
+
* beside it already marked rather than refused, and the generation module's own prose already said
|
|
1515
|
+
* the rule — "MARKED, never defaulted and never refused" — so this was that rule's one unvisited
|
|
1516
|
+
* site (`.claude/rules/invariant-call-site-enumeration.md`).
|
|
1517
|
+
*
|
|
1518
|
+
* Never DEFAULT it. Stamping a plausible date manufactures a commitment nobody made.
|
|
1519
|
+
*/
|
|
1520
|
+
reviewOn: AssuranceIsoDateSchema.optional(),
|
|
861
1521
|
expiresOn: AssuranceIsoDateSchema.optional(),
|
|
862
1522
|
reopenOnSourceChange: z.literal(true),
|
|
863
1523
|
reopenOnScopeChange: z.literal(true),
|
|
@@ -870,14 +1530,14 @@ export const AssuranceProgramGapOrExceptionSchema = z
|
|
|
870
1530
|
if (finding.disposition === AssuranceGapDisposition.RISK_ACCEPTED && !finding.authorityDecisionRef) {
|
|
871
1531
|
context.addIssue({ code: "custom", message: "risk acceptance requires an authority decision", path: ["authorityDecisionRef"] });
|
|
872
1532
|
}
|
|
873
|
-
if (finding.expiresOn && finding.reviewOn > finding.expiresOn) {
|
|
1533
|
+
if (finding.expiresOn && finding.reviewOn !== undefined && finding.reviewOn > finding.expiresOn) {
|
|
874
1534
|
context.addIssue({ code: "custom", message: "reviewOn cannot follow expiresOn", path: ["reviewOn"] });
|
|
875
1535
|
}
|
|
876
1536
|
});
|
|
877
1537
|
export type AssuranceProgramGapOrException = z.infer<typeof AssuranceProgramGapOrExceptionSchema>;
|
|
878
1538
|
|
|
879
1539
|
const AssuranceProgramDocumentationRequirementCommonSchema = z.strictObject({
|
|
880
|
-
requirementRef:
|
|
1540
|
+
requirementRef: AssuranceEntryKeySchema,
|
|
881
1541
|
requirementVersion: z.number().int().positive(),
|
|
882
1542
|
documentKindRef: AssuranceNamespacedRefSchema,
|
|
883
1543
|
documentRef: AssuranceNamespacedRefSchema,
|
|
@@ -893,7 +1553,7 @@ const AssuranceProgramDocumentationRequirementCommonSchema = z.strictObject({
|
|
|
893
1553
|
|
|
894
1554
|
/** Retained pre-document-authority shape. Parse/replay only; current application authoring uses v2. */
|
|
895
1555
|
export const AssuranceProgramDocumentationRequirementV1Schema = AssuranceProgramDocumentationRequirementCommonSchema.extend({
|
|
896
|
-
approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement),
|
|
1556
|
+
approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement).systemEnum('AssuranceProgramDocumentApprovalRequirement'),
|
|
897
1557
|
}).superRefine((requirement, context) => {
|
|
898
1558
|
addUniqueSortedIssue(requirement.requiredAcceptedFactRefs, context, ["requiredAcceptedFactRefs"], "requiredAcceptedFactRefs");
|
|
899
1559
|
addUniqueSortedIssue(requirement.requiredVariableRefs, context, ["requiredVariableRefs"], "requiredVariableRefs");
|
|
@@ -918,15 +1578,15 @@ export const AssuranceProgramDocumentationRequirementV2Schema = AssuranceProgram
|
|
|
918
1578
|
schemaVersion: z.literal(2),
|
|
919
1579
|
definition: GovernedDocumentDefinitionIdentitySchema,
|
|
920
1580
|
governanceScope: GovernedDocumentGovernanceScopeSchema,
|
|
921
|
-
applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus),
|
|
1581
|
+
applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus).systemEnum('GovernedDocumentApplicabilityStatus'),
|
|
922
1582
|
applicabilityRationale: z.string().trim().min(1),
|
|
923
1583
|
applicabilityDecidedByRef: AssuranceNamespacedRefSchema,
|
|
924
1584
|
applicabilityDecidedAt: AssuranceIsoDateTimeSchema,
|
|
925
1585
|
applicabilityDependencyRefs: z.array(AssuranceNamespacedRefSchema).min(1),
|
|
926
|
-
audienceKinds: z.array(z.enum(GovernedDocumentAudienceKind)).min(1),
|
|
927
|
-
requiredReviewKinds: z.array(z.enum(GovernedDocumentReviewKind)).min(1),
|
|
928
|
-
allowedInteractionKinds: z.array(z.enum(GovernedDocumentInteractionKind)),
|
|
929
|
-
publicationChannelKinds: z.array(z.enum(GovernedDocumentPublicationChannelKind)).min(1),
|
|
1586
|
+
audienceKinds: z.array(z.enum(GovernedDocumentAudienceKind).systemEnum('GovernedDocumentAudienceKind')).min(1),
|
|
1587
|
+
requiredReviewKinds: z.array(z.enum(GovernedDocumentReviewKind).systemEnum('GovernedDocumentReviewKind')).min(1),
|
|
1588
|
+
allowedInteractionKinds: z.array(z.enum(GovernedDocumentInteractionKind).systemEnum('GovernedDocumentInteractionKind')),
|
|
1589
|
+
publicationChannelKinds: z.array(z.enum(GovernedDocumentPublicationChannelKind).systemEnum('GovernedDocumentPublicationChannelKind')).min(1),
|
|
930
1590
|
}).superRefine((requirement, context) => {
|
|
931
1591
|
for (const [key, values] of [
|
|
932
1592
|
["requiredAcceptedFactRefs", requirement.requiredAcceptedFactRefs],
|
|
@@ -1002,6 +1662,18 @@ export enum AssuranceProgramSpecificationIssueKind {
|
|
|
1002
1662
|
* offer the claimed capability at all.
|
|
1003
1663
|
*/
|
|
1004
1664
|
HOST_CAPABILITY_IMPLEMENTATION_DRIFT = "HOST_CAPABILITY_IMPLEMENTATION_DRIFT",
|
|
1665
|
+
/**
|
|
1666
|
+
* The host still offers the accepted capability, under the same kind, but NO LONGER offers some of the
|
|
1667
|
+
* implementation refs the program accepted (#1750). The control is still present; what it is implemented by has
|
|
1668
|
+
* shrunk, so the named refs need a decision and re-acceptance. Distinct from `UNKNOWN_CAPABILITY`, which is
|
|
1669
|
+
* reserved for a host offering NONE of the accepted refs — a different implementation, not a narrowed one.
|
|
1670
|
+
*
|
|
1671
|
+
* A host that offers MORE refs than the program accepted is not divergence at all: a capability whose refs are a
|
|
1672
|
+
* vocabulary (every `CoreAuditableEventType`, for `capability:audit-events`) grows every time an unrelated
|
|
1673
|
+
* workstream adds a member, and treating growth as divergence made every accepted program read as having lost
|
|
1674
|
+
* the control — a refusal whose only remedy was to copy the enum into the program again.
|
|
1675
|
+
*/
|
|
1676
|
+
HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN = "HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN",
|
|
1005
1677
|
/** The host supplies a valid authority basis, but it is not the exact basis identity accepted by the v2/v3 program. */
|
|
1006
1678
|
HOST_AUTHORITY_BASIS_DRIFT = "HOST_AUTHORITY_BASIS_DRIFT",
|
|
1007
1679
|
/**
|
|
@@ -1034,11 +1706,30 @@ export enum AssuranceProgramSpecificationIssueKind {
|
|
|
1034
1706
|
UNKNOWN_APPLICABILITY_SOURCE = "UNKNOWN_APPLICABILITY_SOURCE",
|
|
1035
1707
|
UNKNOWN_BINDING_SOURCE = "UNKNOWN_BINDING_SOURCE",
|
|
1036
1708
|
/**
|
|
1037
|
-
* The host does not offer the claimed capability at all, offers it under a different capability kind, or
|
|
1038
|
-
*
|
|
1039
|
-
* present and unchanged except for its implementation revision, see
|
|
1709
|
+
* The host does not offer the claimed capability at all, offers it under a different capability kind, or offers
|
|
1710
|
+
* NONE of the implementation refs the program accepted. No host state makes the authored claim true. For a
|
|
1711
|
+
* capability that is present and unchanged except for its implementation revision, see
|
|
1712
|
+
* `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`; for one that kept some accepted refs and lost others, see
|
|
1713
|
+
* `HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN`.
|
|
1040
1714
|
*/
|
|
1041
1715
|
UNKNOWN_CAPABILITY = "UNKNOWN_CAPABILITY",
|
|
1716
|
+
/**
|
|
1717
|
+
* An expectation this program claims REQUIRES a capability the application's own configuration does
|
|
1718
|
+
* not make available, because the engine capability that carries it is not enabled.
|
|
1719
|
+
*
|
|
1720
|
+
* Distinct from `RELATIONSHIP_MISMATCH`, which reads as "the accepted statement forgot to bind
|
|
1721
|
+
* something", and from `UNKNOWN_CAPABILITY`, which is about a capability the program CLAIMS. Here
|
|
1722
|
+
* nothing was forgotten and nothing is claimed wrongly: the control simply cannot be attested with
|
|
1723
|
+
* this configuration, and no amount of re-authoring the statement changes that. Reported separately
|
|
1724
|
+
* because the two remedies are opposites — bind the capability, versus enable the engine capability
|
|
1725
|
+
* or stop claiming the objective.
|
|
1726
|
+
*
|
|
1727
|
+
* The issue carries the resulting applicability so the reader does not have to derive it: an
|
|
1728
|
+
* objective whose expectation required ONLY unavailable capabilities is `NOT_APPLICABLE`, while one
|
|
1729
|
+
* that also required an available capability is `UNDETERMINED` — the control operates and only the
|
|
1730
|
+
* capability attesting it is absent. See `deriveExpectationCapabilityApplicability`.
|
|
1731
|
+
*/
|
|
1732
|
+
REQUIRED_CAPABILITY_UNAVAILABLE = "REQUIRED_CAPABILITY_UNAVAILABLE",
|
|
1042
1733
|
UNKNOWN_DOCUMENT = "UNKNOWN_DOCUMENT",
|
|
1043
1734
|
UNKNOWN_DOCUMENT_SOURCE = "UNKNOWN_DOCUMENT_SOURCE",
|
|
1044
1735
|
UNKNOWN_FINDING = "UNKNOWN_FINDING",
|
|
@@ -1089,6 +1780,7 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
|
|
|
1089
1780
|
Record<AssuranceProgramSpecificationIssueKind, AssuranceProgramSpecificationIssueClass>
|
|
1090
1781
|
> = {
|
|
1091
1782
|
[AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
|
|
1783
|
+
[AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
|
|
1092
1784
|
[AssuranceProgramSpecificationIssueKind.HOST_AUTHORITY_BASIS_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
|
|
1093
1785
|
[AssuranceProgramSpecificationIssueKind.HOST_IMPLEMENTATION_ARTIFACT_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
|
|
1094
1786
|
[AssuranceProgramSpecificationIssueKind.AUTHORITY_SNAPSHOT_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.HOST_ATTESTATION_INVALID,
|
|
@@ -1108,6 +1800,12 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
|
|
|
1108
1800
|
[AssuranceProgramSpecificationIssueKind.OBLIGATION_GOVERNANCE_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
|
|
1109
1801
|
[AssuranceProgramSpecificationIssueKind.OBLIGATION_REGISTER_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
|
|
1110
1802
|
[AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
|
|
1803
|
+
/*
|
|
1804
|
+
* SPECIFICATION_DEFECT, and deliberately NOT host divergence: nothing has drifted and there is no
|
|
1805
|
+
* newer host state to re-accept. The program claims an objective this application's configuration
|
|
1806
|
+
* forecloses, which is a statement about the authored program rather than about the host moving.
|
|
1807
|
+
*/
|
|
1808
|
+
[AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
|
|
1111
1809
|
/*
|
|
1112
1810
|
* Deliberately a specification defect, not host attestation: the host record is internally sound and the program
|
|
1113
1811
|
* simply disagrees with it. That is equally consistent with a mis-transcribed reference and with host metadata
|
|
@@ -1139,6 +1837,50 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
|
|
|
1139
1837
|
[AssuranceProgramSpecificationIssueKind.UNKNOWN_VALIDATION_AUTHORITY]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
|
|
1140
1838
|
};
|
|
1141
1839
|
|
|
1840
|
+
/**
|
|
1841
|
+
* What an application's enabled capability set does to ONE expectation's demand.
|
|
1842
|
+
*
|
|
1843
|
+
* A capability an application has not enabled is filtered out of its authority snapshot, so an
|
|
1844
|
+
* expectation requiring it can never be satisfied there. The question this answers is what that
|
|
1845
|
+
* SHOULD mean, and the answer differs by whether the missing capability IS the control or merely
|
|
1846
|
+
* attests one:
|
|
1847
|
+
*
|
|
1848
|
+
* | required capabilities available | status | reading |
|
|
1849
|
+
* |---|---|---|
|
|
1850
|
+
* | all | `APPLICABLE` | nothing stands in the way |
|
|
1851
|
+
* | none | `NOT_APPLICABLE` | the absent capability IS the control; there is nothing to claim |
|
|
1852
|
+
* | some | `UNDETERMINED` | the control operates, and the capability that would ATTEST it is absent |
|
|
1853
|
+
*
|
|
1854
|
+
* The middle and last rows are the distinction that matters, and collapsing them is the trap. Treating
|
|
1855
|
+
* a partly-available expectation as `NOT_APPLICABLE` would let an application escape a control it
|
|
1856
|
+
* genuinely implements — a consent record is still written, an administrative floor still refuses —
|
|
1857
|
+
* merely by leaving the capability that reports those acts switched off. Treating it as `APPLICABLE`
|
|
1858
|
+
* would claim evidence nobody can produce. `UNDETERMINED` is the only one of the three that is true.
|
|
1859
|
+
*
|
|
1860
|
+
* Deliberately a pure function of two sets, so the same rule serves validation, program generation and
|
|
1861
|
+
* anything that wants to warn an application builder BEFORE a run: one rule, one place to read it.
|
|
1862
|
+
*/
|
|
1863
|
+
export function deriveExpectationCapabilityApplicability(input: {
|
|
1864
|
+
readonly requiredCapabilityRefs: readonly string[];
|
|
1865
|
+
readonly availableCapabilityRefs: ReadonlySet<string>;
|
|
1866
|
+
}): {
|
|
1867
|
+
readonly status: AssuranceProgramApplicabilityStatus;
|
|
1868
|
+
readonly unavailableCapabilityRefs: readonly string[];
|
|
1869
|
+
} {
|
|
1870
|
+
const unavailableCapabilityRefs = input.requiredCapabilityRefs.filter((capabilityRef) => !input.availableCapabilityRefs.has(capabilityRef));
|
|
1871
|
+
if (unavailableCapabilityRefs.length === 0) return { status: AssuranceProgramApplicabilityStatus.APPLICABLE, unavailableCapabilityRefs };
|
|
1872
|
+
/*
|
|
1873
|
+
* An expectation authority always declares at least one required capability (its schema sets
|
|
1874
|
+
* `.min(1)`), so "every required capability is unavailable" cannot be reached vacuously by an empty
|
|
1875
|
+
* demand — which would otherwise report NOT_APPLICABLE for an expectation that demanded nothing.
|
|
1876
|
+
*/
|
|
1877
|
+
const status =
|
|
1878
|
+
unavailableCapabilityRefs.length === input.requiredCapabilityRefs.length
|
|
1879
|
+
? AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
|
|
1880
|
+
: AssuranceProgramApplicabilityStatus.UNDETERMINED;
|
|
1881
|
+
return { status, unavailableCapabilityRefs };
|
|
1882
|
+
}
|
|
1883
|
+
|
|
1142
1884
|
/** Classifies one issue as a statement about the specification or about the host. */
|
|
1143
1885
|
export function classifyAssuranceProgramSpecificationIssue(issue: Pick<AssuranceProgramSpecificationIssue, "kind">): AssuranceProgramSpecificationIssueClass {
|
|
1144
1886
|
return ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND[issue.kind];
|
|
@@ -1213,7 +1955,16 @@ const AssuranceProgramV3CommonFieldsSchema = z.strictObject({
|
|
|
1213
1955
|
...AssuranceProgramCommonFieldsAfterObjectiveBindingsSchema.shape,
|
|
1214
1956
|
});
|
|
1215
1957
|
|
|
1216
|
-
/**
|
|
1958
|
+
/**
|
|
1959
|
+
* Historical source-revision-pinned program. Retained payloads remain parseable and replayable.
|
|
1960
|
+
*
|
|
1961
|
+
* This said "new authoring is forbidden by the repository pin checker" until 2026-09-01. **Nothing forbids it.** That checker was
|
|
1962
|
+
* `pnpm check:assurance-revision-pin`, removed on 2026-08-27 with the rest of the digest mechanism, and no successor exists — the
|
|
1963
|
+
* only assurance check in `package.json` is `check:assurance-control-boundary`, which is about marker source-neutrality.
|
|
1964
|
+
*
|
|
1965
|
+
* So v1 is discouraged by this comment and by nothing else. A safety claim standing on a removed mechanism is worse than no claim,
|
|
1966
|
+
* because a reader stops looking for the guard. Building one is #221; until it lands, "forbidden" means "please do not".
|
|
1967
|
+
*/
|
|
1217
1968
|
export const AssuranceProgramSpecificationV1Schema = z
|
|
1218
1969
|
.strictObject({
|
|
1219
1970
|
schemaVersion: z.literal(1),
|
|
@@ -1231,9 +1982,20 @@ export type AssuranceProgramSpecificationV1 = z.infer<typeof AssuranceProgramSpe
|
|
|
1231
1982
|
*
|
|
1232
1983
|
* Validation authorities currently carry one sealed basis snapshot. Accepting several authored bases would make
|
|
1233
1984
|
* every extra basis compare against the wrong inventory and could misclassify an unverified authority as tolerable
|
|
1234
|
-
* host drift. Multi-basis composition therefore requires a later schema version with basis-indexed snapshots.
|
|
1235
|
-
*
|
|
1236
|
-
*
|
|
1985
|
+
* host drift. Multi-basis composition therefore requires a later schema version with basis-indexed snapshots.
|
|
1986
|
+
*
|
|
1987
|
+
* This claimed a "repository checker" recognized v2 authoring "only through the serialized pre-v3 transition" until
|
|
1988
|
+
* 2026-09-01. There is no such checker — see the note on {@link AssuranceProgramSpecificationV1Schema}. The intent
|
|
1989
|
+
* stands and is worth keeping: after an application accepts v3, v2 should remain replayable rather than become a
|
|
1990
|
+
* second current authoring shape. It is an intent, not an enforced one (#221).
|
|
1991
|
+
*
|
|
1992
|
+
* Exactly one v2 programme exists today, in the framework's own reference application, and it is the only
|
|
1993
|
+
* assurance programme the framework ships an example of. Wonder CRM has none: what it carries is a PROCESSOR REGISTER, whose `schemaVersion: 1` belongs to
|
|
1994
|
+
* `ApplicationProcessorRegisterSchema` and must not be counted as a v1 programme.
|
|
1995
|
+
*
|
|
1996
|
+
* (An earlier revision named a `specifications/src/compliance/index.ts` register for the reference application, a
|
|
1997
|
+
* path it has never had — a processor register is authored under `specifications/src/processor-register/`. The
|
|
1998
|
+
* warning is kept because the confusion is real; the file-name half of it was not.)
|
|
1237
1999
|
*/
|
|
1238
2000
|
export const AssuranceProgramSpecificationV2Schema = z
|
|
1239
2001
|
.strictObject({
|
|
@@ -1249,7 +2011,7 @@ export type AssuranceProgramSpecificationV2 = z.infer<typeof AssuranceProgramSpe
|
|
|
1249
2011
|
|
|
1250
2012
|
/**
|
|
1251
2013
|
* Current application program. It preserves the v2 single-basis authority model while replacing the overlapping
|
|
1252
|
-
* control-objective-binding array with one complete
|
|
2014
|
+
* control-objective-binding array with one complete obligation register and its program-owned review
|
|
1253
2015
|
* records. Activation and operating/evidence truth remain deliberately unrepresentable.
|
|
1254
2016
|
*/
|
|
1255
2017
|
export const AssuranceProgramSpecificationV3Schema = z
|
|
@@ -2066,7 +2828,7 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2066
2828
|
* It is keyed on `basisRef@basisVersion`, the declared compatibility generation, so it fires when
|
|
2067
2829
|
* the framework's interpretation contract moves and stays quiet for byte movement that does not.
|
|
2068
2830
|
* (Five sibling checks here hashed the snapshot against its own material and were deleted
|
|
2069
|
-
* 2026-08-27
|
|
2831
|
+
* 2026-08-27: a hash of a thing against itself can only catch a producer that already computed it wrong.)
|
|
2070
2832
|
*/
|
|
2071
2833
|
if (program.schemaVersion !== 1) {
|
|
2072
2834
|
const snapshotBasis = { basisRef: snapshot.snapshotRef, basisVersion: snapshot.snapshotVersion };
|
|
@@ -2088,6 +2850,14 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2088
2850
|
const objectiveRecords = new Map(snapshot.objectiveCatalog.objectives.map((objective) => [versionedObjectiveKey(objective.identity), objective]));
|
|
2089
2851
|
const applicationRoleRefs = new Set<string>(snapshot.applicationRoleRefs);
|
|
2090
2852
|
const hostCapabilities = new Map(snapshot.capabilityAuthorities.map((authority) => [versionedCapabilityKey(authority.identity), authority]));
|
|
2853
|
+
/*
|
|
2854
|
+
* Ref-only, unlike `hostCapabilities` above, and the difference is load-bearing. An expectation
|
|
2855
|
+
* authority names the capabilities it REQUIRES without a version, so asking the versioned map would
|
|
2856
|
+
* report every requirement as unavailable the moment a capability's version moved — a configuration
|
|
2857
|
+
* diagnosis for what is really a version question, which `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`
|
|
2858
|
+
* already answers properly.
|
|
2859
|
+
*/
|
|
2860
|
+
const hostCapabilityRefs = new Set(snapshot.capabilityAuthorities.map((authority) => authority.identity.capabilityRef));
|
|
2091
2861
|
const hostArtifacts = new Set(snapshot.implementationArtifacts.map((artifact) => artifact.artifactRef));
|
|
2092
2862
|
const hostImplementationArtifactsByKind = new Map(snapshot.hostImplementationArtifacts.map((artifact) => [artifact.artifactKindRef, artifact]));
|
|
2093
2863
|
const sourceRequirementAuthorities = new Map(snapshot.sourceRequirementAuthorities.map((authority) => [versionedSourceRequirementKey(authority), authority]));
|
|
@@ -2212,7 +2982,7 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2212
2982
|
path: `obligationRegister.entries.${entryIndex}.applicability.decidedAt`,
|
|
2213
2983
|
message: `obligation applicability decision cannot predate its approved coverage review at ${coverageDecision.reviewedAt}`,
|
|
2214
2984
|
});
|
|
2215
|
-
if (entry.reviewOn < evaluatedOn)
|
|
2985
|
+
if (entry.reviewOn !== undefined && entry.reviewOn < evaluatedOn)
|
|
2216
2986
|
issues.push({
|
|
2217
2987
|
kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
|
|
2218
2988
|
path: `obligationRegister.entries.${entryIndex}.reviewOn`,
|
|
@@ -2280,8 +3050,15 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2280
3050
|
* bytes moved". The first can never be resolved by re-accepting; the second is resolved by exactly that.
|
|
2281
3051
|
* Identity, kind and implementation refs are checked first because a capability that fails any of them is not
|
|
2282
3052
|
* the accepted control at all — its revision is then irrelevant.
|
|
3053
|
+
*
|
|
3054
|
+
* Implementation refs are compared by CONTAINMENT, not equality (#1750): the host must still offer every ref the
|
|
3055
|
+
* program accepted. Refs the host ADDED are not divergence — a vocabulary-shaped capability grows whenever an
|
|
3056
|
+
* unrelated workstream adds a member. Refs it WITHDREW are divergence the operator must decide on, named. A host
|
|
3057
|
+
* offering none of them resolves the capability to a different implementation, which is not the accepted control.
|
|
2283
3058
|
*/
|
|
2284
|
-
|
|
3059
|
+
const hostRefs = new Set<string>(host?.implementationRefs ?? []);
|
|
3060
|
+
const withdrawnRefs = authority.implementationRefs.filter((ref) => !hostRefs.has(ref));
|
|
3061
|
+
if (!host || host.capabilityKind !== authority.capabilityKind || withdrawnRefs.length === authority.implementationRefs.length) {
|
|
2285
3062
|
issues.push({
|
|
2286
3063
|
kind: AssuranceProgramSpecificationIssueKind.UNKNOWN_CAPABILITY,
|
|
2287
3064
|
path: `capabilityAuthorities.${index}`,
|
|
@@ -2289,6 +3066,16 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2289
3066
|
});
|
|
2290
3067
|
return;
|
|
2291
3068
|
}
|
|
3069
|
+
if (withdrawnRefs.length > 0) {
|
|
3070
|
+
issues.push({
|
|
3071
|
+
kind: AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN,
|
|
3072
|
+
path: `capabilityAuthorities.${index}.implementationRefs`,
|
|
3073
|
+
// The withdrawn refs are part of the SUBJECT, not only the prose: tolerating the loss of one ref must not
|
|
3074
|
+
// tolerate a later, different loss under the same capability.
|
|
3075
|
+
subjectRef: `${key}#${withdrawnRefs.join(",")}`,
|
|
3076
|
+
message: `capability authority ${key} is still offered by the host, but no longer offers ${withdrawnRefs.length} implementation ref(s) the program accepted: ${withdrawnRefs.join(", ")}`,
|
|
3077
|
+
});
|
|
3078
|
+
}
|
|
2292
3079
|
const implementationIdentityMatches =
|
|
2293
3080
|
program.schemaVersion === 1
|
|
2294
3081
|
? sourceRevisionKey(host.implementationRevision) === sourceRevisionKey(authority.implementationRevision)
|
|
@@ -2486,7 +3273,8 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2486
3273
|
path: `gapsAndExceptions.${index}.expiresOn`,
|
|
2487
3274
|
message: `exception or risk acceptance expired before authority evaluation date ${evaluatedOn}`,
|
|
2488
3275
|
});
|
|
2489
|
-
|
|
3276
|
+
// An unscheduled review cannot be overdue. The programme's stamped limitation is what says so.
|
|
3277
|
+
if (finding.disposition !== AssuranceGapDisposition.RESOLVED && finding.reviewOn !== undefined && finding.reviewOn < evaluatedOn)
|
|
2490
3278
|
issues.push({
|
|
2491
3279
|
kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
|
|
2492
3280
|
path: `gapsAndExceptions.${index}.reviewOn`,
|
|
@@ -2571,7 +3359,33 @@ export const validateAssuranceProgramSpecification = (
|
|
|
2571
3359
|
const statementVerification = new Set(statement.verificationExpectations.map((expectation) => expectation.expectationRef));
|
|
2572
3360
|
binding.implementationExpectationRefs.forEach((identity) => {
|
|
2573
3361
|
const authority = implementationExpectationAuthorities.get(versionedExpectationKey(identity));
|
|
2574
|
-
if (authority
|
|
3362
|
+
if (!authority) return;
|
|
3363
|
+
/*
|
|
3364
|
+
* Ask WHY before reporting that the statement does not satisfy the expectation. A capability the
|
|
3365
|
+
* application's configuration withholds cannot be bound by any statement, so the generic mismatch
|
|
3366
|
+
* below would tell an author to fix something they cannot fix — and that misdirection is not
|
|
3367
|
+
* theoretical: it has already cost rounds of evidence collection against an objective whose
|
|
3368
|
+
* attesting capability was never available, answerable from configuration before any was gathered.
|
|
3369
|
+
*/
|
|
3370
|
+
const applicability = deriveExpectationCapabilityApplicability({
|
|
3371
|
+
requiredCapabilityRefs: authority.requiredCapabilityRefs,
|
|
3372
|
+
availableCapabilityRefs: hostCapabilityRefs,
|
|
3373
|
+
});
|
|
3374
|
+
if (applicability.status !== AssuranceProgramApplicabilityStatus.APPLICABLE) {
|
|
3375
|
+
issues.push({
|
|
3376
|
+
kind: AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE,
|
|
3377
|
+
path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,
|
|
3378
|
+
subjectRef: versionedExpectationKey(identity),
|
|
3379
|
+
message:
|
|
3380
|
+
`${versionedExpectationKey(identity)} requires ${applicability.unavailableCapabilityRefs.join(", ")}, which this ` +
|
|
3381
|
+
`application's configuration does not make available, so the objective is ${applicability.status}. ` +
|
|
3382
|
+
(applicability.status === AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
|
|
3383
|
+
? "Every capability it required is absent, so there is no control here to claim: enable the engine capability that carries them, or stop claiming this objective."
|
|
3384
|
+
: "The control itself still operates; only the capability that would attest it is absent, so whether the objective holds cannot be determined from this configuration."),
|
|
3385
|
+
});
|
|
3386
|
+
return;
|
|
3387
|
+
}
|
|
3388
|
+
if (authority.requiredCapabilityRefs.some((capabilityRef) => !statementCapabilities.has(capabilityRef)))
|
|
2575
3389
|
issues.push({
|
|
2576
3390
|
kind: AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH,
|
|
2577
3391
|
path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,
|