@wildo-ai/framework-knowledge 1.1.9 → 1.1.11
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 +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- 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 +543 -80
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.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.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
- 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 +138 -21
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
- 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 +89 -9
- 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 +6 -5
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +6 -4
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- 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 +8 -4
- 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 +28 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- 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 +14 -6
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
- 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 +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +34 -7
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- 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 +14 -6
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- 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 +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +15 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
- 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/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +76 -7
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +107 -2
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +84 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +561 -23
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
- package/dist/knowledge/references/zod.factories.code.md +18 -8
- package/dist/knowledge/references/zod.factories.duration.md +23 -13
- package/dist/knowledge/references/zod.factories.money.md +24 -14
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2854 -246
- package/dist/knowledge/registries/playbooks.json +57 -36
- package/dist/knowledge/registries/source-tags.json +8863 -4569
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +63 -34
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17305 -8263
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
|
@@ -274,6 +274,14 @@ and ignore the rest.
|
|
|
274
274
|
|
|
275
275
|
## `document:public.privacy-notice` — thirteen concerns
|
|
276
276
|
|
|
277
|
+
**Write for the audience the brief names.** The definition line in your brief says `audiences:`, and the
|
|
278
|
+
value is derived from the application's line, never chosen by you. `PUBLIC_GENERAL` is the notice every
|
|
279
|
+
customer-facing application publishes. `WORKFORCE` means one organization owns the application and its
|
|
280
|
+
users are that organization's staff (an internal tool): the brief then carries a section saying how that
|
|
281
|
+
reader changes the scope, the purposes and bases, the recipients and the delivery of the notice. Follow
|
|
282
|
+
it, and still take every basis and every recipient from the facts: the audience changes how you word
|
|
283
|
+
what was declared, never what was declared.
|
|
284
|
+
|
|
277
285
|
### Concern: operator identity
|
|
278
286
|
|
|
279
287
|
**Asserts** — who legally operates the service: entity name, registered address, contact route for
|
|
@@ -390,7 +398,8 @@ cannot say what an erasure does to them. Where the facts also report a category
|
|
|
390
398
|
origin, say what IS established alongside it.
|
|
391
399
|
`NEEDS_CONFIGURATION` for every resource that does not.
|
|
392
400
|
|
|
393
|
-
**What closes it** — the application's own authors declaring `retentionPolicy
|
|
401
|
+
**What closes it** — the application's own authors declaring `retentionPolicy`, with the `dataSubjectPolicy` the
|
|
402
|
+
factory requires beside it, on the resource. Name
|
|
394
403
|
the resources individually: the remedy is per-resource, and a count is not actionable.
|
|
395
404
|
|
|
396
405
|
|
|
@@ -423,6 +432,15 @@ declares none, or when the facts section lists OUTSTANDING fields.
|
|
|
423
432
|
provenance, or a credential marker — so the missing category is an omission, not a judgement.
|
|
424
433
|
Name the field and its basis. Do not guess what it contains.
|
|
425
434
|
|
|
435
|
+
**A CONDITIONAL category is stated with its condition, never flattened.** A field may declare that
|
|
436
|
+
it is personal data only under a condition — `described-party-is-a-natural-person` marks the name,
|
|
437
|
+
number or address of the PARTY a row describes (a customer organization, an account, a supplier).
|
|
438
|
+
That party may be an individual, such as a sole trader, whose details are personal data, or a
|
|
439
|
+
company, whose details are not, because GDPR Recital 14 excludes only legal persons. The facts
|
|
440
|
+
section lists these apart from the categories held on every row. State them as held "where the
|
|
441
|
+
customer is an individual (for example a sole trader)". Never state them as held about every
|
|
442
|
+
customer, and never leave them out: either sentence is false about some customers.
|
|
443
|
+
|
|
426
444
|
**Say WHICH special category, not that there is one.** A `special-category:*` value is Art. 9 data
|
|
427
445
|
and carries a lawful-basis condition of its own beyond Art. 6; `criminal-offence` is Art. 10, a
|
|
428
446
|
separate article with a different condition. "We process special category data" is not a disclosure —
|
|
@@ -539,7 +557,24 @@ a backup-and-restore inventory must protect (issue #8).
|
|
|
539
557
|
**The `retention-rules` fact is COMPUTED from both** — the declared periods with their reasons and
|
|
540
558
|
mechanisms, the classes with no period, each resource's declared erasure treatment, the resources
|
|
541
559
|
declaring none, and the resources bound to no retention class.
|
|
542
|
-
You never declare it.
|
|
560
|
+
You never declare it.
|
|
561
|
+
|
|
562
|
+
**State what an account holder's erasure DOES, not what a resource declares.** A declared treatment is
|
|
563
|
+
what an impersonalization of the rows WOULD do; whether a person's erasure runs one depends on the edges
|
|
564
|
+
it walks and on the framework's own erasure steps. So each treatment carries `accountHolderErasure`:
|
|
565
|
+
`erasedAsTheSubject` (the person's own account rows, scrubbed by their declared mode), the `dispositions`
|
|
566
|
+
the erasure applies to rows below them (`delete`, `impersonalize_and_retain`,
|
|
567
|
+
`restricted_under_statutory_retention`), the `severerTreatments` its steps apply to rows off those edges
|
|
568
|
+
(an id removed, a membership impersonalized, an invoice's document links removed), and
|
|
569
|
+
`rowsKeptAsTheyAre` when it runs nothing. Two lists name the gaps a notice drafted from declarations
|
|
570
|
+
would get wrong: `keptAsTheyAreByAnAccountHoldersErasure` (never describe them as scrubbed by a person's
|
|
571
|
+
erasure: billing records are the usual case, kept whole as business records) and
|
|
572
|
+
`changedByAnAccountHoldersErasureWithoutDeclaredTreatment` (changed or deleted although they declare
|
|
573
|
+
nothing). The scope is an ACCOUNT HOLDER's erasure: a record of a person without an account (a CRM
|
|
574
|
+
contact, a lead) is erased as its own subject, and that erasure applies its declared mode, so say both
|
|
575
|
+
when such a record is in the first list. A tenant's deletion is a separate mechanism, not described
|
|
576
|
+
here. When `accountHolderErasure` is absent the execution could not be derived; say only what is
|
|
577
|
+
declared, worded as a declaration. It is absent when no schedule is declared, because a treatment alone would read as
|
|
543
578
|
the whole answer.
|
|
544
579
|
|
|
545
580
|
**Completeness** — `DERIVED` for the treatment, and for each retention class the application HAS
|
|
@@ -732,26 +767,65 @@ knowing it stays put.
|
|
|
732
767
|
**Asserts** — where the application uses AI, on what data, and whether any of it decides something
|
|
733
768
|
about a person.
|
|
734
769
|
|
|
735
|
-
**Derives from
|
|
736
|
-
|
|
737
|
-
use
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
770
|
+
**Derives from — the computed fact `ai-use-inventory`.** Nobody declares it: the runtime computes it
|
|
771
|
+
from the application's AI-use declarations whenever facts are read, so it never goes stale the day an
|
|
772
|
+
agent is added. Per AI use of the CONTRACTED SERVICE, at the capability (`aiUsePosture`) or on the agent
|
|
773
|
+
that runs it (`aiUse`), it states:
|
|
774
|
+
|
|
775
|
+
- the purpose, the use `domain`, and the `consequence` — `NO_DECISION` / `ASSISTS_HUMAN_DECISION` /
|
|
776
|
+
`DECIDES_AUTONOMOUSLY`;
|
|
777
|
+
- the human review: the declared arrangement, or `derivedFromApprovalGates` where every tool the agent
|
|
778
|
+
can change something with waits for a person's approval (`ungatedWriteToolRefs` lists any that do not).
|
|
779
|
+
When `unresolvedToolRefs` is non-empty the derived review covers only the tools the reading could see:
|
|
780
|
+
say so, and do not present the gates as covering the agent's every action;
|
|
781
|
+
- the providers that serve it, with the legal entity and processing regions the processor register
|
|
782
|
+
establishes (`onProcessorRegister: false` means the register does not name it — say so).
|
|
783
|
+
|
|
784
|
+
Its gaps are part of the answer, never a reason to stay silent: `undeclaredCapabilities` and
|
|
785
|
+
`undeclaredAgentRefs` (AI the service runs with no declared use), `domainOwedRefs`, and
|
|
786
|
+
`invalidDeclarations`. State each as not yet established.
|
|
787
|
+
|
|
788
|
+
**The regulatory reading follows jurisdiction.** `regulatoryScope` says which: `EU_AI_ACT` — each use
|
|
789
|
+
carries an `aiActReading` with its CANDIDATE class; `NO_AI_REGULATION_REACHES` — no AI regulation the
|
|
790
|
+
framework reads applies where the application operates, so describe no use in the AI Act's terms;
|
|
791
|
+
`JURISDICTION_NOT_DECLARED` — the application declares no operating jurisdiction, so the class is owed. Under `EU_AI_ACT`, a `HIGH_RISK_CANDIDATE` or `PROHIBITED_PRACTICE_CANDIDATE` carries
|
|
792
|
+
`notSupportedYet: true` and is listed in `highRiskCandidateRefs` / `prohibitedPracticeCandidateRefs`:
|
|
793
|
+
state it as a candidate and as not supported yet, never as compliant, and never leave it out.
|
|
794
|
+
|
|
795
|
+
**Not applicable is an answer.** When no AI capability reaches the contracted service the fact is
|
|
796
|
+
NOT_APPLICABLE, and its reason says so — the service performs no AI processing, a positive, checkable
|
|
797
|
+
statement. Capabilities that serve only the build (`AI_CODING_AGENT`, or one offered only by the
|
|
798
|
+
companion scope) are named there and in `authoringOnlyCapabilities`, outside this document: do not deny
|
|
799
|
+
they exist, and do not describe them as a feature of the service.
|
|
800
|
+
|
|
801
|
+
**When the fact is absent** the declarations could not be read. Mark the clause owed; do not describe
|
|
802
|
+
the application's AI from the brief or from memory.
|
|
803
|
+
|
|
804
|
+
**Whether the guardrails RAN is a second fact** — `ai-content-guardrails`, computed from the records the
|
|
805
|
+
evidence plane collected (runtime evidence, not a declaration). Per agent of the contracted service it
|
|
806
|
+
states what the agent DECLARES (its personal-data treatment, prompt-injection screening, output
|
|
807
|
+
moderation) and, per guardrail, an `observation`: `RAN` (at least one recorded verdict in the window),
|
|
808
|
+
`NO_RUN_RECORDED` (the agent has records and none carries a verdict — screening has nothing to judge on a
|
|
809
|
+
call that read no tool result) or `NO_OPERATION_RECORDED` (the window holds no record of the agent; not
|
|
810
|
+
"never called", since a call whose record failed to write is counted in `callsWithoutOperationRecord` for
|
|
811
|
+
no agent). `RAN` is not "runs on every call". State two things, as of the fact's window: the calls the
|
|
812
|
+
guardrail was ACTIVE on (`treatedOperations`, `screenedOperations` or `moderatedOperations` of the agent's
|
|
813
|
+
`operations`), and what it JUDGED (`fieldsWithheld`, `screenedResults`, `judgedOutputs`). Active is not
|
|
814
|
+
judged: screening switched on for a call that read no tool result judged nothing, and the observation then
|
|
815
|
+
reads `NO_RUN_RECORDED`. Say it ran only where the observation reads `RAN`. The guardrail audit-event counts beside it
|
|
816
|
+
count outcomes (content quarantined, output withheld, a failed check), application-wide, not per agent; a
|
|
817
|
+
quiet audit trail is never evidence that a guardrail ran. A count is stated only when its `standing` is
|
|
818
|
+
`COUNTED`: `UNCONTROLLED` (the collector's control found no row of any kind in the window) and
|
|
819
|
+
`NOT_COLLECTED` carry `null`, which is never zero. When the fact is absent the records were not collected: say
|
|
820
|
+
the guardrails' operation is not yet evidenced, never that they are not enforced. An organization's agent
|
|
821
|
+
policy can tighten a guardrail at run time; a run it switched on shows here as `RAN` on an agent that
|
|
822
|
+
declares none.
|
|
823
|
+
|
|
824
|
+
**Completeness** — `DERIVED` for what the facts state; `NEEDS_DECISION` per use listed undeclared or with
|
|
825
|
+
its domain owed. Never `NEEDS_FRAMEWORK`: the framework provides the declaration, so an undeclared posture
|
|
826
|
+
is an unanswered question rather than an unaskable one.
|
|
753
827
|
|
|
754
|
-
**An
|
|
828
|
+
**An undeclared AI use is not a harmless one.** This is the one concern where silence is more
|
|
755
829
|
dangerous than elsewhere: a notice describing AI use and saying nothing about consequence does not read
|
|
756
830
|
as "unknown", it reads as "nothing significant happens here" — which is the exemption, claimed for
|
|
757
831
|
free. State the gap explicitly.
|
|
@@ -891,9 +965,10 @@ operator's responsibilities and the customer's lies.
|
|
|
891
965
|
**Derives from** — the `ORGANIZATIONS` engine capability, the organization scoping applied to every
|
|
892
966
|
tenant-scoped resource, and the cross-tenant admission rules. Ordinary tenant crossings must be
|
|
893
967
|
declared and carry a usable access grant. The application audit viewer is a separate policy surface:
|
|
894
|
-
it
|
|
895
|
-
`
|
|
896
|
-
|
|
968
|
+
it follows `auditTrail.applicationReadAccess`, which defaults by the application's shape:
|
|
969
|
+
`AuditApplicationReadAccess.INDEPENDENT_APPROVAL` where the parties of one of its relationship kinds are independent of its operator, role-based
|
|
970
|
+
access (the super-administrator or the read-only audit-evidence reader) otherwise. Under independent approval a
|
|
971
|
+
machine reader needs a second-signed grant bound to its own credential. Both modes retain cross-tenant read observations;
|
|
897
972
|
role-based access neither implies anonymized records nor supplies an approval that never occurred.
|
|
898
973
|
|
|
899
974
|
**Completeness** — `DERIVED`.
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
],
|
|
26
26
|
"stepOutputs": [],
|
|
27
27
|
"method": {
|
|
28
|
-
"guidance": "# Compliance document candidate method\n\nYou are drafting ONE governed document for this application, from what the application has already\ndeclared. Follow the `compliance-document-authoring` skill for the rules — its full text is in your\nbrief, under \"The skills this method tells you to FOLLOW\", because this step has no tools and cannot\nopen a file. This method says which document, what shape, and what the two closed vocabularies are.\n\n## Choose the document, from the two this lane may draft\n\n`documentRef` must be one of six and the contract refuses anything else, but only two of the six are\nYOURS. The four internal `governance.*` documents belong to `refinement.governance-document-candidate`,\nwhich ships their blueprints; drafting one here would mean writing a document whose obligations you were\nnever given.\n\n| `documentRef` | what it is | drafted by |\n|---|---|---|\n| `document:public.privacy-notice` | what personal data the application holds and what happens to it | **this lane** |\n| `document:public.service-terms` | the commercial and service relationship | **this lane** |\n| `document:governance.scope-system-description` | what the system IS, for an assurance reader | `refinement.governance-document-candidate` |\n| `document:governance.roles-responsibilities` | who is accountable for what | `refinement.governance-document-candidate` |\n| `document:governance.program-handbook` | how the governance program runs | `refinement.governance-document-candidate` |\n| `document:governance.document-record-control` | how governed documents are themselves controlled | `refinement.governance-document-candidate` |\n\n**Draft a document this application does not already hold.** The run tells you which those are: the\nbrief opens with what the application has already drafted, listing each document it may produce here\nas ALREADY DRAFTED or not yet drafted. Drafts are keyed by `documentRef`, so drafting one that is\nalready there REPLACES it — right when that draft is wrong, and a wasted run when it is not.\n\n**A held draft marked ALREADY DRAFTED, and WRONG comes before everything below.** The brief marks a held\ndraft that cites facts this application no longer declares, and names them. Nothing else corrects it: the\nlanding checks only the document a run writes, so a draft written before the facts were regenerated keeps\nits dead citations until a run redrafts that document. Redraft it against the facts that exist, and cite\nnone of the named ones.\n\nWhere several remain, the **privacy notice** comes first: it is the one every application holding\npersonal data needs. Where none remains, the honest reason to draft again is that a held draft is\nwrong — say which one and why in your own reasoning, rather than redrafting the first on the list.\n\nThis paragraph used to read \"draft the privacy notice unless the run tells you otherwise\", at a time\nwhen no run told it anything. Measured against a real application on 2026-09-16: with its privacy\nnotice already drafted, two consecutive runs meant to produce the service terms drafted the notice\nagain and replaced it, and the application finished each run holding exactly what it started with.\nThe second sentence was stale as well — it said the privacy notice was \"the only one whose facts the\ncurrent derivation supplies\", which stopped being true once the fact-declaring playbook began\ndeclaring the account, billing and AI facts the service terms rest on.\n\nNaming a document outside this set is not a smaller decision than it looks. Each of the six has a\nconcern composition the framework measures a draft against, so a seventh name is a document nobody can\nstate the gaps in — and stating the gaps is the whole point.\n\n## One section per concern, and SAY which concern\n\nEvery section carries `concernRef`, from the closed compliance-concern vocabulary. **The composition\nfor each document is inlined at the end of this method** — one entry per concern, saying what it\nasserts, what in the application it derives from, what state it usually reaches, and what closes it\nwhen it cannot. Draft one section per concern, in the order given, and produce **every** one:\na concern nothing can answer becomes a section with a marked clause, never a missing heading.\n\nThose entries are the difference between a draft that states its gaps and one that guesses at them.\nWhere a concern's entry names an issue number as the remedy, say so in `incompleteness.closedBy` —\n`#89`, `#91` — because a numbered issue is a remedy a reader can open, and \"application configuration\nowner\" is not.\n\nUse `concernRef: null` only for a section that genuinely answers no concern: a preamble, a contact\nblock. It is not a way past a concern you found hard. A concern you cannot establish gets a SECTION,\nwith a clause marked incomplete — which is the mechanism this whole document exists around.\n\nThe value must be the concern's exact name. A near miss (`retention` for `retention-and-deletion`) is\nworse than a null: it reports the concern as unaddressed while the document addresses it.\n\n\n## And SAY which required parts the section supplies\n\nEvery section also carries `satisfiesSectionRefs`: the refs, from the document definition rendered in\nyour brief, that this section actually addresses. This is a different question from `concernRef` and\nboth are answered — the concern says what compliance TOPIC the section is about, the satisfied refs\nsay what part of THIS document it supplies.\n\nYou are asked for the join because you are the only reader that holds both. The concern set is one\nflat vocabulary spanning every document type; the required parts are defined per document, and the\nsame concern does not sit under the same heading in a privacy notice and a governance handbook. A\nmapping written once in the framework would have to pick one answer and be wrong somewhere.\n\n- A section may claim several refs, and several sections may claim one between them.\n- A section that answers no required part — a preamble, a contact block — answers `null`. Not an\n empty list: `null` and `[]` would be two spellings of one state, and the contract refuses the second.\n- **Claim honestly.** A required ref nobody claims is reported as a part the document may not address,\n which is a true and useful finding. Claiming one you did not address hides that, and nothing\n downstream reads your prose to catch it.\n\nDo NOT adopt the definition's refs as your own `sectionRef` values. Your section set is the concern\nrule above; these are a claim you attach to it, not names you take.\n\n**Clauses carry the same claim**, as `satisfiesClauseRefs`, and answer `null` the same way. Your brief\nlists the blueprint's clauses under each section, each marked REQUIRED or CONDITIONAL; name the ones\nyour clause supplies.\n\nBoth keys were ASKED FOR HERE and absent from the strict contract you answer until 2026-09-02, so a\ndraft that followed this section could not parse and every landed document claimed nothing. If you\nare reading a document produced before then, its empty coverage is that defect and not a finding\nabout the document.\n\n- Several of your clauses may supply one blueprint clause between them, and one clause may supply\n several.\n- A clause supplying none — a transition, a heading gloss — claims none.\n- **Only the clauses marked REQUIRED are owed.** A CONDITIONAL clause is supplied when its condition\n holds and correctly omitted otherwise, so leaving one unclaimed is not a gap.\n\nThis is the anchor a clause did not previously have. A fact is named by the catalog and a section\ncarries its concern, so both survive a redraft; a clause was named freely and joined to nothing, which\nis why a reviewer who approved one could not find it in the next revision.\n## What a clause may say\n\nThe rule is ASSERT versus MARK, and the skill states it in full. In short: a clause may say \"this is\nnot yet established\"; it may not say something untrue.\n\n- `DERIVED` — established by a fact this application has declared. Cite it in `factRefs`. A `DERIVED`\n clause citing a fact the facts file does not declare is REFUSED before the write.\n\n **This is decided against the facts file as it stands NOW, not against any earlier draft.** You are\n producing the whole document from what the application currently declares, so a concern the facts\n answer today is `DERIVED` today — even if a previous version of this document marked it incomplete\n and is still in the tree. Re-running this playbook is how a document that went stale is repaired,\n and it only repairs anything if the re-draft is willing to close a mark.\n\n **Never fold a declared fact into a marked clause.** When one concern has a declared half and a\n missing half — retention periods declared while retention enforcement is not evidenced, a\n processor register that names most recipients while some providers have no recorded identity —\n write TWO clauses: a `DERIVED` clause stating what is declared, and a separate marked clause naming\n what is missing. A clause is marked as a whole, so one clause carrying both states nothing: every\n clause citing the declared fact is then incomplete, and the standing coherence report correctly\n records that the document mentions the fact without stating it. A redraft that marked its retention\n and recipients clauses because each also carried a gap stopped stating two facts the previous draft\n had stated.\n\n **A fact the application declared NOT APPLICABLE is a fact, and a clause may rest on it.** *\"No\n external analytics provider is configured\"* is `DERIVED`, not incomplete: the application settled the\n question and recorded the answer. Marking such a concern incomplete says the application does not\n know something it does know, which is as wrong as overstating. What is refused is citing a fact the\n facts file does not declare AT ALL.\n- `NEEDS_FRAMEWORK` / `NEEDS_DECISION` / `NEEDS_CONFIGURATION` — mark it, and say in `incompleteness`\n what is missing and who closes it. Four distinct suppliers, four distinct remedies; do not merge them.\n\n **When what is missing is a FACT, name it in `incompleteness.awaitingFactRefs`.** The skill argues\n this in full; the short version is that a marked clause asserts an ABSENCE in the application's own\n configuration, and that assertion goes false the moment someone declares the thing — silently, since\n nothing about the document changes. The awaited ref is what lets generation, landing and the\n standing coherence report all say the clause has gone stale. A clause that awaits nothing rots\n unobserved, and one already has.\n\n **`NEEDS_DECISION` and `NEEDS_FRAMEWORK` are the pair most easily confused, and the difference is\n the REMEDY.** `NEEDS_DECISION` means a surface exists and nobody filled it in — the reader goes and\n answers. `NEEDS_FRAMEWORK` means there is NOWHERE to record the answer; telling a reader to decide\n is telling them to write into a void.\n\n Measured on 2026-08-30, a produced notice marked operator identity `NEEDS_DECISION` when no surface\n for it existed at all, beside retention periods marked identically and genuinely just unfilled. Two\n remedies, rendered the same, and a reader could act on neither.\n\n **So every incomplete clause must NAME THE SURFACE its answer goes to**, or say plainly that none\n exists. A gap with a named surface is a task; a gap without one is a request for work nobody has\n scoped. The fragment you are working from names the surface where there is one — carry it into\n `incompleteness` rather than leaving the reader to find it.\n\n **`closedBy` must name WHO can reach that surface, and an ENGINE resource is not the application\n author's to edit.** `retentionPolicy`, `systemAccessPolicy.exportSubject` and `.dataCategories()`\n on an engine resource live in engine source. Writing \"application authors must declare\n `retentionPolicy` for each affected engine resource\" hands the reader a task they cannot perform —\n and a produced notice said exactly that, for 83 resources, in the same confident register as the\n remedies that ARE actionable. An unreachable remedy is worse than an unnamed one: it looks like\n work, gets scheduled, and fails when someone tries it.\n\n Where the closer is the FRAMEWORK, say so plainly — \"the framework must declare these on its own\n resources\" — and keep it separate from what this application owes.\n\nNever fill an unresolved fact, infer a legal decision, or describe the draft as approved, compliant,\nlegally valid, released or published. Locale and jurisdiction are review inputs; leaving them\nunresolved is a legitimate answer and never a reason not to draft.\n\n**And the mirror of that, which matters just as much: a missing approval never stops you.** Approval\nhappens at the END and is a human commit; a downstream release can be composed and MARKED\n`UNAPPROVED`. So the absence of one is a STATE to record, never a reason to produce nothing and never\nan outcome to report as blocked. The two failures are symmetric — claiming an approval that did not\nhappen, and refusing to act because it has not happened yet — and a compliance workflow standing in\nfront of the application-creation mechanism is the second one.\n\n## The refs you write, and their exact shape\n\nEvery `…Ref` field is a **namespaced ref**: `namespace:slug`, both halves lowercase, words joined by\nhyphens. `clause:retention-duration-not-declared` is one; `clause:Retention Duration` is not, and a\nwhole draft is rejected for a single malformed one. Ref ARRAYS are arrays of those strings — never\nobjects, never `{ ref: … }`.\n\nPer clause, all three ref arrays are required. Two of them may be empty, but **not both of the\nfirst two at once** — a clause that names no fact and no policy is sourced by nothing and is\nrejected:\n\n- `factRefs` — the facts this clause rests on, exactly as the facts file declares them. It may be\n EMPTY for a clause that establishes nothing (a marked clause often does).\n- `sourcePolicyRefs` — the application POLICY AREA the statement is sourced from, and nothing else.\n Every entry must be in the `policy:` namespace (`policy:retention`, `policy:recipients`,\n `policy:security-controls`); any other namespace is rejected outright. **Do NOT put a fact\n authority here.** A clause resting on declared facts already cites its authorities through\n `factRefs`, which resolves them — repeating them here duplicates the citation beside it and\n resolves to nothing. So this array is EMPTY for a fact-backed clause, and carries a policy area\n for a clause that is sourced from a policy rather than from a fact.\n- `claimGuardRefs` — at least one: what this clause must NOT be read as claiming. These are the\n boundaries you are already holding — `claim-guard:no-legal-applicability-claim`,\n `claim-guard:no-invented-retention-period`, `claim-guard:known-fact-only`. Name the ones that apply\n to this clause; do not repeat the same guard on every clause out of habit. You do not name the\n CATALOG's guard for the material: it is added for you from the blueprint clauses this clause\n `satisfiesClauseRefs`, so a clause that says what it satisfies is checked against it automatically.\n\n`evidenceRefs` is **`null` on every clause of a public document**, and that is not a gap to work around.\nIt cites a judged run from this application's own assurance repository — self-attested internal\nevidence — and a public notice may carry none, whatever the run says: a reader of one cannot weigh an\noperator's judgement of its own product, and any citation here is refused before the draft becomes a\nfile. That evidence belongs to the internal governance documents, which\n`refinement.governance-document-candidate` draws. Where you would have leaned on a measurement, say\nwhat is CONFIGURED or DECLARED, or MARK the statement.\n\n**The same holds when a FACT is phrased as behaviour, and that is where drafts go wrong.** The facts\nyou cite describe the product in the present tense — *\"the running application reaches\"*, *\"the\nframework sets\"*, *\"acceptance joins the member\"*, *\"kept 30 days, then erased\"* — which is accurate\nfor a fact and is an operating claim in a public notice. Do not carry the verb across: restate each as\na declaration (*\"the configuration enables\"*, *\"the framework declares\"*, *\"the configured membership\nmodel admits\"*, *\"the declared period is 30 days, after which the data is due for erasure\"*). The\njudge reads every clause of a public document for exactly this, and a sentence copied from a fact is\nthe one it finds.\n\n`reviewChecklistRefs` needs at least one (`review-checklist:<slug>`) — what a human must confirm before\nthis draft is worth anything. `limitationRefs` may be empty, but rarely should be: it is where you say\nwhat the document does NOT cover, in your own words as the drafter, rather than leaving the reader to\ndiscover it.\n\n## You do not compose the release — and a release nobody approved is marked UNAPPROVED\n\nYou draft the candidate. You do NOT author its release, and that is a boundary rather than an\nomission: almost everything a release carries is DERIVED from the accepted document definition — the\ndocument's class, who it addresses, which channels may carry it, which interactions it permits — and\na model restating those would create five ways to disagree with the catalog, invisibly. The rest\n(which declared variant, when it takes effect) is a composition over families you are not holding.\n\nA human declares a release DECISION in the application's\n`specifications/src/document-releases/compositions.ts`, and `wildo config document-releases` composes\neach decision not yet recorded — your candidate plus the declared variant and release policy — and\nrecords the finished release, text included. Nothing records a release because you landed a draft: an\napplication with no decision holds no release yet, which is a valid state and not yours to fix from\nthis playbook. Until a public document (privacy notice, service terms) has a release, its public page\nshows your latest draft, marked as a draft — so what you mark as not established is what a reader sees.\nWhat matters for your work is what composition produces when it runs: a release carrying\n`approvalState`, and one nobody has approved is `UNAPPROVED` and exists anyway.\n\n**Which is why a missing approval never changes what you do here.** Draft the document completely,\nmark every statement you cannot establish, and let the release be composed and marked. Waiting for an\napproval before drafting — or describing a draft as approved to get past the gate — are the two\nsymmetric failures, and the first is a compliance workflow standing in front of the mechanism that\nbuilds the application.\n\n## Where the draft goes\n\nIt lands as a FILE in the application's specifications package, as an ordinary working edit. It is\naccepted by a commit and by nothing else; who makes that commit is the host's autonomy posture, and\nonly a PERSON's commit is an approval. Landing is not approval, release or publication — and neither is\na commit the development companion authors under the YOLO posture.\n\n\n---\n\n# The compositions\n\nEach of the following is one document's full concern list. Use the one matching your `documentRef`\nand ignore the rest.\n\n## `document:public.privacy-notice` — thirteen concerns\n\n### Concern: operator identity\n\n**Asserts** — who legally operates the service: entity name, registered address, contact route for\ndata-protection questions, and a representative where one is required.\n\n**Derives from** — `operatorComplianceIdentity` in `wildo.saas.config.ts`: the legal entity, its\nregistered address, the privacy contact route, and an Art. 27 representative where one is required.\n\nThe VALUE is never derivable — a legal entity is a fact about the world, not a property of a codebase.\nWhat the framework provides is the PLACE to record it, and until 2026-08-30 it did not: this fragment\nsaid \"no engine change would close it\", which was right about derivation and wrong about the home.\nThe consequence was concrete. A landing REPLACES the produced document on every run, so an operator\nwho answered by editing the document lost the answer at the next regeneration — the answer has to live\nin the application or it does not survive.\n\n**Completeness** — `DERIVED` when the identity is declared; `NEEDS_DECISION` when it is not.\n\n⚠️ `NEEDS_DECISION`, not `NEEDS_FRAMEWORK`, and the distinction is load-bearing now that the surface\nexists. `NEEDS_FRAMEWORK` means there is nowhere to record the answer; `NEEDS_DECISION` means there is\nand nobody has. They have different remedies — build something, versus fill something in — and a\nreader who cannot tell them apart cannot act on either. Say which surface the answer goes to.\n\n**What closes it** — the operator declaring `operatorComplianceIdentity`. It is cheap and it can be\nfilled in later without redrafting anything around it, which is the reason it is not a blocker.\n\n**Never infer it.** Not from the application name, not from a domain, not from another application,\nnot from model memory. A published legal document naming the wrong entity is worse than one that says\nthe entity is not yet recorded — the first misdirects a person exercising a right, the second tells\nthem the document is incomplete.\n\n**Every document needs this fragment**, which makes it the clearest demonstration of why producing\nwith gaps beats blocking: the whole document set would be unproducible until one form is filled in.\n\n\n### Concern: legal basis and controller/processor role\n\n**Asserts** — the lawful basis for each processing purpose, and whether the operator acts as\ncontroller or processor for it.\n\n**Derives from** — `operatorComplianceIdentity.lawfulBases` and `.roleAllocations` in\n`wildo.saas.config.ts`.\n\nThe DETERMINATIONS are never derivable — both are legal conclusions about the operator's own\narrangements, and the framework can show WHAT is processed and BY WHICH MECHANISM without establishing\nunder which basis or in which role. What it now provides is where to record the conclusion, so that a\nregeneration reproduces it instead of destroying it.\n\n**The role is a LIST, not a field, and the produced notice said so before the surface existed:**\n*\"This notice therefore does not assign a single legal role to all data processed in a workspace.\"* A\nB2B SaaS is typically a processor for the records its customers put in and a controller for its\naccount holders' own data, simultaneously. `roleAllocations` carries one role per population, and a\ndocument that collapses them into one is wrong about both.\n\n**The `lawful-bases` fact is COMPUTED from `lawfulBases`** — every purpose, its basis and, for\nlegitimate interests, the assessment. You never declare it: a restatement would be a second copy of the\noperator's decision that nothing compares with the first. Absent bases leave the fact absent.\n\n**Give each purpose a stable `purposeRef`** (`account-security`) when a recipient serves it. A vendor\nnames the purposes it serves in `providerComplianceChoices.<ref>.purposeRefs`, and the recipients fact\njoins the two. The prose `purpose` can then be reworded without breaking the link; a ref naming no\ndeclared purpose is reported, never refused.\n\n**`LEGITIMATE_INTERESTS` cannot be declared without its assessment** — the schema refuses it. It is\nthe only Art. 6(1) basis whose lawfulness depends on a balancing test, so the bare claim asserts a\nconclusion nobody reached.\n\n**Completeness** — `DERIVED` when declared; `NEEDS_DECISION` when not. Never `NEEDS_FRAMEWORK`: there\nis a surface, so the remedy is to fill it in, not to build something. Name the surface when reporting\nthe gap.\n\n**What closes it** — the operator determining, per purpose, the basis and the role, ideally with\ncounsel, and declaring them in `operatorComplianceIdentity`. The tenancy fragment describes the SHAPE this usually takes in a B2B SaaS — processor for\nthe data a customer stores about its own people, controller for the data the operator holds about\naccount holders — but describing the common shape is not the same as determining this operator's, and\nthe produced document must not present the first as the second.\n\n**This is the fragment most likely to be filled in by a confident guess**, because the shape is\nfamiliar and the sentence is easy to write. Resist it. A basis stated in a published notice is a\nposition the operator has taken; a basis that was never determined is a position nobody can defend.\n\n\n### Concern: personal data held\n\n**Asserts** — which of the application's own records are about identifiable people, and which hold no\npersonal data of their own.\n\n**Derives from** — each resource's `retentionPolicy.mode` (`ErasureRetentionMode`, in\n`@wildo-ai/saas-models`), read for every resource the application declares:\n\n| declaration | what the document may state |\n|---|---|\n| `RETAIN_AND_IMPERSONALIZE` | this record holds personal data; the fields marked `.impersonalizeWith()` are what is scrubbed on erasure |\n| `RETAIN_ONLY` | this record holds **no personal data of its own** — a positive, factory-enforced statement, because declaring a scrub treatment under this mode fails at config build |\n| absent | the application has not said |\n\nRead `dataSubjectPolicy.kind` for the SESSION question only. `NO_PRINCIPAL` is equally true of an\ninvoice and of a CRM contact, so it never tells you whether a record is about a person — the\nretention mode does.\n\n**Completeness** — `DERIVED` for every resource that declares a retention policy.\n\n**An erasure-coverage gap does NOT license a claim about whether personal data is held.** The two are\ndifferent axes and the facts report them separately: `retentionPolicy` answers *what happens to this\nrow on erasure*, while a field's `.dataCategories()` answers *what kind of data is in it*. A resource\ncan declare the second and not the first, and 48 of the engine's 85 do.\n\nSo writing \"N resources have no declared erasure treatment, so this notice cannot establish whether\nthey hold personal data\" is an over-reach, and it contradicts the data-categories section of the same\ndocument — which enumerates categories drawn from those very resources. It was produced twice on\n2026-08-30 before this paragraph existed.\n\nState the gap as what it is: those resources have not declared an erasure TREATMENT, so a notice\ncannot say what an erasure does to them. Where the facts also report a category coverage for the same\norigin, say what IS established alongside it.\n`NEEDS_CONFIGURATION` for every resource that does not.\n\n**What closes it** — the application's own authors declaring `retentionPolicy` on the resource. Name\nthe resources individually: the remedy is per-resource, and a count is not actionable.\n\n\n### Concern: data categories\n\n**Asserts** — which CATEGORIES of personal data are held: identity, contact details, credentials,\nfinancial, usage, location, user content, professional, and any GDPR Art. 9 special-category or\nArt. 10 criminal-offence data.\n\n**Derives from** — each field's `.dataCategories()` declaration, reported per resource and unioned\nacross the application in the compliance-primary-facts section. One category is DERIVED rather than\ndeclared: `credentials`, from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, which are\nmarkers the author already wrote.\n\n**Nothing is derived from a field NAME.** `email`, `phone` and `dateOfBirth` are suggestive while\n`notes` is not, so a category list assembled by pattern-matching identifiers is a guess presented as\nan inventory — and its failure mode is silent, because whatever the guess misses is simply not\ndisclosed. The declaration exists so that never happens.\n\n**Completeness** — `DERIVED` when the application declares categories; `NEEDS_CONFIGURATION` when it\ndeclares none, or when the facts section lists OUTSTANDING fields.\n\n**The two gaps are different and must not be written the same way.**\n\n- A resource that declares no category at all may genuinely hold no personal data. Nothing\n distinguishes \"considered and not applicable\" from \"never asked\", so state that the question is\n unanswered — never that the application holds no personal data.\n- A field the facts section lists as OUTSTANDING is a provable omission. The application already\n declared that field personal by another door — an erasure scrub treatment, a portability\n provenance, or a credential marker — so the missing category is an omission, not a judgement.\n Name the field and its basis. Do not guess what it contains.\n\n**Say WHICH special category, not that there is one.** A `special-category:*` value is Art. 9 data\nand carries a lawful-basis condition of its own beyond Art. 6; `criminal-offence` is Art. 10, a\nseparate article with a different condition. \"We process special category data\" is not a disclosure —\nthe enum names the kind precisely so a notice can.\n\n**Do NOT point at `Compliance_DataClassification`.** It exists, it is a four-level SENSITIVITY ladder\n(public / internal / confidential / restricted) applied only to flows-actors configuration, and it\nanswers \"how protected must this be\" rather than \"what kind of personal data is this\". Using it here\nwould produce a notice describing protection levels where a reader expects data types. It is named\nexplicitly because it is a near-miss a reader will otherwise find and assume answers this concern.\n\n\n### Concern: consent and preferences\n\n**Asserts** — what the application asks consent for, at what granularity, and what a person's choice\nactually controls.\n\n**Derives from**\n\n- `ConsentPurpose` (`@wildo-ai/saas-models`): `ANALYTICS` · `MARKETING` — a SET of purposes, each\n granted or not on its own. There is no ordering: agreeing to marketing says nothing about analytics.\n- per-person `privacy.consentedPurposes` — the purposes each person granted, empty until they grant\n one — and `privacy.consentDecidedAt`, stamped by the server when they decide. An empty set WITH an\n instant is \"declined everything\"; no instant is \"never asked\". A notice must not state the second\n as the first.\n- `analytics.requiresConsent` (default `true`) — whether the application's analytics rest on\n `ANALYTICS`. It governs analytics alone, never use of the service.\n- the visitor tier: a marketing website keeps a visitor's decision in their browser and starts a\n consent-based provider (product analytics) only once its purpose is granted.\n\n- `operatorComplianceIdentity.serviceConsentRequirement` (`wildo.saas.config.ts`) — what a person\n must agree to in order to use the service AT ALL, and what that gate covers.\n\n**An empty `requiredPurposes` is a POSITIVE answer and the usual one.** The operator declaring that nothing is gated on\nconsent has answered the question; a document must state it as settled rather than treating it as an\nabsence. ABSENT is the different case — nobody was asked — and the brief distinguishes the two.\n\n**A consent GATE is not a lawful BASIS.** For most B2B SaaS the basis for core processing is CONTRACT:\na person uses the product because their employer signed for it. A notice that reads a gate as a basis\nstates that their data is processed on consent they could withdraw, which is wrong about the single\nmost consequential thing in the document. The basis is declared per purpose in `lawfulBases`.\n\n**Completeness** — `DERIVED` for the analytics gate, each person's granted purposes, and the\nservice-wide requirement once declared — which the application ENFORCES: until the required purposes are\ngranted, the backend refuses every operation the person initiates — API and MCP operations, queued work,\nWebSocket reads and subscriptions, agent tools, retrieval, charts and analytics, A2A task reads, and A2A or\nWebSocket conversations, including resuming one after an approval — except their own profile and preferences,\nwhere they record the consent, and cancelling an A2A task they already started (signing in and out stay open;\nupdates the server pushes on its own are not held back), and the web\napplication withholds its pages; `NEEDS_DECISION` naming `serviceConsentRequirement` when it is not.\n\nThis was `NEEDS_FRAMEWORK` until 2026-08-30, correctly: there was nowhere to record the answer. Issue\n#139 built the surface, so the remedy changed from \"someone must build this\" to \"fill this in\" — a\ndifferent party and a different task, which is why the two states are never interchangeable.\n\n**Say the thing readers get wrong.** Consent is one lawful basis among several, and it is not the one\nmost B2B processing rests on. **Never write that all processing rests on consent, and never write\nthat accepting terms supplies a lawful basis** — accepting a contract is a different basis with\ndifferent consequences, and conflating them is the single most common defect in a generated privacy\nnotice. Which basis applies is a `NEEDS_DECISION`; see the legal-basis fragment.\n\n\n### Concern: retention and deletion\n\n**Asserts** — what happens to a record when its subject is erased, and how long records are kept.\n\nTwo questions, and the framework answers both — the second only for the resources bound to a class.\n\n**Derives from (the HOW — answerable)** — each resource's `retentionPolicy.mode`:\n`RETAIN_AND_IMPERSONALIZE` keeps the row, freezes it, hides it from normal reads and scrubs the fields\nmarked `.impersonalizeWith()`; `RETAIN_ONLY` keeps and freezes a row that holds no personal data of\nits own. Reading the per-field treatments tells the document exactly WHICH values are destroyed and\nwhich survive, which is a genuinely strong statement most notices cannot make.\n\n**Records a statute keeps survive an erasure RESTRICTED, and the request still completes.** A resource\nbound to `BUSINESS_RECORDS` declares `retentionPolicy.statutoryRetention`: the GDPR Art. 17(3)(b) ground\n(`LEGAL_OBLIGATION`) and the statute in the operator's words. An erasure erases everything else, keeps\nthose rows retained and hidden from any other processing until their statutory period ends, and lists\neach one with its ground and end date — which is what the notice must say: that some records are kept\nbecause the law requires it, which law, and that they are deleted when the period ends. The\n`retention-rules` fact names these resources and their statute under each erasure treatment. Never write\nthat an erasure is refused or delayed because of them.\n\n**Derives from (the HOW LONG)** — the application's `dataRetention` schedule, declared in its config\nover five data classes: `RESOURCE_DATA` (its records), `FILES` (uploaded bytes), `AUDIT_LOGS` (the\ntamper-evident trail, kept longest and for a different reason — it is the evidence an operator may\nlawfully retain under GDPR Art. 17(3)), `OPERATIONAL_LOGS`, and `BUSINESS_RECORDS` (records a statute\nrequires to be kept for a minimum period). Each declared class carries a period in days AND the\noperator's stated reason for it.\n\n**Enforced where a resource is BOUND** — a resource declares `retentionBinding: { retentionClass,\nstartPoint }`, and the retention sweep deletes its rows once the period has passed since the start point\n(the account closing, the record closing, its creation, the end of its calendar year). The period is\ncounted from when the record stops being needed, so a live record is never deleted for its age. The\n`retention-rules` fact names, per class, the resources bound to it and the MECHANISMS that act on it:\n`RETENTION_CLASS_SWEEP`, `FILES_CLEANUP` (file bytes after their row is gone), `AUDIT_ARCHIVAL`. An EMPTY\nmechanism list means nothing is even wired to enforce the class — say exactly that. `AUDIT_ARCHIVAL` means the audit\ntrail is archived after the period and is NEVER deleted: do not write that audit records are deleted.\nThe fact also names the resources bound to no class — kept until erased, because nobody decided otherwise.\n\n**Whether a period IS enforced is a different fact** — `retention-enforcement`, computed from the records the\nretention sweep writes on every run (runtime evidence, not a declaration). Per declared class it reads\n`ENFORCED` (every bound resource shows a recent completed or deferred run), `DECLARED` (a period nothing has\nyet been shown to apply) or `FAILING` (the latest run of a bound resource failed). Say a period is enforced\nONLY where it reads `ENFORCED`, and as of its `observedAt` — and only for the resources bound to the class:\n`mechanismsNotEvidencedByTheseRecords` names what the records cannot see (the audit trail's archival, the files\ncleanup), so never write that the audit trail's or the files' retention is evidenced by this fact. A mechanism in `retention-rules` says the sweep\nWILL act; only this fact says it did. When the fact is absent the records were not collected: say enforcement\nis not yet evidenced, never that it is not happening.\n\nThe classes are the STORES on purpose: the same declaration answers what a notice must state and what\na backup-and-restore inventory must protect (issue #8).\n\n**The `retention-rules` fact is COMPUTED from both** — the declared periods with their reasons and\nmechanisms, the classes with no period, each resource's declared erasure treatment, the resources\ndeclaring none, and the resources bound to no retention class.\nYou never declare it. It is absent when no schedule is declared, because a treatment alone would read as\nthe whole answer.\n\n**Completeness** — `DERIVED` for the treatment, and for each retention class the application HAS\ndeclared. `NEEDS_DECISION` for each class it has not: the mechanism exists, so what is missing is an\noperator's decision rather than an engine change. Do not let the derivable half hide the missing one —\na statement about erasure mechanics reads to a reader as an answer about retention, so both go in the\nsame breath.\n\n**What closes it** — the operator deciding a period, and saying why. Not a framework change: issue #89\ndelivered the declaration surface, so an undeclared class is now an unanswered question rather than an\nunaskable one.\n\n**An UNDECLARED class is not \"kept indefinitely\" and not \"deleted immediately\".** It is a decision\nnobody has taken, and the document must say exactly that.\n\n**A legal hold suspends every deletion of its scope** — the retention sweep, an erasure, the tenant purge,\nfile bytes — until the tier that placed it releases it (`legalHolds`). The notice may say that data is kept\nbeyond its period while a legal claim, an investigation or a legal obligation requires it, and that it is\ndeleted once that ends. Never write that a hold expires, and never name a matter.\n\n**Never write a placeholder period.** \"Typically 12 months\" in a published notice is a commitment\nnobody made and nothing enforces.\n\n\n### Concern: recipients and processors\n\n**Asserts** — who else receives personal data, in what role, and where they process it.\n\n**Derives from (who receives)** — the RECIPIENT POPULATION, which your brief renders under *\"Who\nRECEIVES data, by whose account reaches them\"*. It is computed by `computeRecipientPopulation`\n(`@wildo-ai/saas-specifications/application-creation`) from the configuration and a scan of the\napplication's source, and the privacy notice's recipients fact and the assurance evidence read the SAME\npopulation, so none of them can disagree with the others. Every provider declared under a runtime scope\n(`backend`, `frontendServices.<service>`, `minions.<minion>`, `workers.<worker>`) and every\n`systemsOfRecord` instance lands in exactly ONE of four classes:\n\n| Class | What it means | What the document does with it |\n| --- | --- | --- |\n| **OPERATOR-RUN** | an explicit `SELF_HOSTED` compliance choice | processing under the operator's own control — never a recipient |\n| **OPERATOR SUB-PROCESSOR** | some data path spends the APPLICATION's own account (an engine capability, a wired capability role, a typed client, a browser operation, a system of record) | the operator's recipient; it belongs in the processor register |\n| **TENANT RECIPIENT** | reachable ONLY through a customer's or a person's own connected account | the customer's own vendor, reached at the customer's instruction. Never the operator's sub-processor; you may say a customer can connect its own account |\n| **DECLARED, NO DATA PATH** | configured, and nothing in the application reaches it | receives nothing. Never name it as a recipient; the gap is the declaration itself |\n\nAn engine capability is ONE data path, not the definition of a recipient: a catalogue vendor called\nthrough its typed client receives data with no capability at all, and a vendor declared \"to exercise the\nloading chain\" with nothing calling it receives nothing. The tenant class matters most when the operator\nis a PROCESSOR for the data: listing a customer's own vendor as its sub-processor states an engagement the\noperator never made. The function and its limits are in the `compliance-document-authoring` skill's\n`references/framework-recipient-population.md`.\n\n**Derives from (the identities)** — the application's PROCESSOR REGISTER, which your brief renders\nunder *\"Who else processes personal data\"*. Per entry: the processor's **legal entity**, the\n**regions** it processes in, and its own **subprocessors** with their regions.\n\n**The register holds two kinds of entry and the brief labels them differently — say which.** A\nCONFIGURED PROVIDER entry joins to the application's composition, so it can be checked against it: a\nclaim about a provider the application does not configure is detectable, and a configured provider\nwith no entry is reported as UNDECLARED. An AUTHORED entry — a hosting company, a CDN, a support desk\n— joins to nothing, because no configuration mentions it. The framework can neither confirm it nor\nnotice its absence.\n\nBoth kinds of declared relationship can belong in the notice when their role is established. What\nmust not happen is presenting the second with the authority of the first: an authored entry is the operator's word, and a document that reads\nas though the framework verified it overstates what anyone checked.\n\n**A SELF-HOSTED provider is not a recipient either, and this is the second way to get the section\nwrong.** The brief's *\"Who RUNS each bound provider\"* block splits the members the OPERATOR answers\nfor (operator sub-processors and operator-run) three ways:\nTHIRD-PARTY RECIPIENTS (vendor-hosted, so data reaches a third party — enumerate these with their\nregion), OPERATOR-RUN (self-hosted, so no third party receives anything — state them as processing\nunder the operator's own control, never as recipients), and UNANSWERED.\n\nAn UNANSWERED provider is bound to a runtime with no declared deployment model. **Do not assume\nvendor-hosted.** It looks like the cautious reading and it is not: it publishes that a person's data\ngoes to a third party when nobody said so. Report it as not established, and name the surface —\n`providerComplianceChoices` in `wildo.saas.config.ts`.\n\n**A provider PROFILE is not a recipient.** The brief separates providers BOUND TO A RUNTIME — backend,\ncompanion, workers, minions, a frontend service, which can process the application's data — from\nprovider profiles with no runtime binding. A profile says how to reach a provider; build-time tooling\nlives there, and a coding agent operating on the workspace receives no customer records. Never name a\nprofile-only provider as a recipient. Naming one reads as caution and is a false statement about\nsomebody's data, exactly like omitting a real one.\n\nThe section joins the register to the OPERATOR SUB-PROCESSORS of the recipient population, so it tells\nyou these different things and they are not interchangeable:\n\n- a candidate WITH an entry — its declared identity and regions are available. Establish its\n deployment role before presenting it as a recipient.\n- a candidate listed **UNDECLARED** — a runtime binding has no matching processor entry. Name its\n configured function and unresolved declarations; an unanswered deployment choice remains unknown,\n not automatically vendor-hosted. `NEEDS_DECISION`, resolved by the operator.\n- a provider entry listed **STALE** — no data path reaches it from this operator any more.\n Reconcile the declaration and deployment choice; this check alone does not establish its actual\n historical processing or that all external data has been removed.\n- a provider entry listed **REGISTERED TENANT RECIPIENT** — the register names, as the operator's\n sub-processor, a vendor reached only through customers' own accounts. That entry is a false\n statement about who engaged the vendor; do not publish it as one of the operator's processors.\n\n**Completeness** — `DERIVED` per provider that is declared, `NEEDS_DECISION` per provider that is not.\nNot `NEEDS_FRAMEWORK` any more: issue #88 delivered the declaration surface, so an undeclared processor\nis an unanswered question rather than an unaskable one.\n\n**Never infer a region from a vendor's brand.** \"It is a US company\" is not a processing location, and\na transfer statement built on it is a claim about somebody's data made from a guess.\n\n**Distinguish the register declaration from its reconciliation.**\n\n| Observed state | What it establishes | What the document may say |\n| --- | --- | --- |\n| Register absent | No processor declaration was supplied | The operator has not established the register; do not infer recipients or their absence |\n| Register present with `processors: []` | The operator declares no processors | Report that declaration, then check it against runtime-bound recipient candidates; it is not independent proof that nobody receives data |\n| Recipient candidates have no matching entries, including with an empty register | The composition and declarations leave named questions unresolved | Identify the configured functions and outstanding deployment, identity or location decisions without inventing third parties |\n\nReconcile only operator sub-processors. Exclude operator-run, tenant-recipient, unreached and\nprofile-only providers; keep unanswered deployment choices visible as unanswered. `registerEstablishesNoProcessorRecipients`\nanswers the declaration question; `undeclaredProcessorRefs` answers candidate coverage. A true answer to\nthe first does not erase gaps returned by the second.\n\nName third-party recipients only when their role is established. An empty register does not justify\nan unconditional statement that third parties provide email, storage or payments. Equally, do not\nomit unresolved candidate questions and thereby imply that absence was verified. Authored recipients\nremain operator declarations whose completeness cannot be inferred from runtime bindings.\n\n\n### Concern: international transfers\n\n**Asserts** — whether personal data leaves its origin jurisdiction, to where, and under which transfer\nmechanism.\n\n**Derives from** — the processor register's regions, at BOTH levels: each declared processor and\neach processor's own subprocessors. Your brief renders them under *\"Personal data reaches processors\nin: …\"*.\n\nBoth levels, because the chain is what makes a transfer statement hard. An operator in France using a\nFrench vendor that runs on a US cloud HAS a transfer, and reading only the vendor's region misses it.\n\n**The question has three inputs, and the framework derives only one of them.** Where declared\nprocessors process is declared. Which jurisdiction is the ORIGIN is `operatingJurisdictions`. Which\nMECHANISM makes a given transfer lawful is a legal determination with a shelf life — adequacy decisions\nmove by court ruling — so the framework never computes it: the operator RECORDS it, per register entry,\nas a `transferDetermination`:\n\n- `NO_TRANSFER`, with the reason none of the entry's regions lies outside the origin jurisdictions —\n regions are free text, so this comparison is the operator's and never the framework's;\n- `TRANSFER`, with one safeguard per origin jurisdiction: the GDPR Chapter V mechanism\n (`ADEQUACY_DECISION`, `STANDARD_CONTRACTUAL_CLAUSES`, `BINDING_CORPORATE_RULES`,\n `APPROVED_CODE_OF_CONDUCT`, `APPROVED_CERTIFICATION`, or a `DEROGATION` naming its Art. 49 ground) and\n the instrument a reader could look up.\n\nThe determination sits on the ENTRY because the processor's own contract binds its onward transfers to\nits subprocessors; reaching the processor is the transfer the operator answers for.\n\n**The `international-transfers` fact is COMPUTED from those determinations** — you never declare it.\nIt carries each determined entry, the origin jurisdictions, `undeterminedRecipients` — a register entry\nwith no determination, or a configured provider the register does not establish — `safeguardGaps`:\na declared origin a TRANSFER names no safeguard for — and `operatorHostingRegions`: where the operator's\nOWN infrastructure holds the data (`operatorComplianceIdentity.hostingRegions`), or `null` when the\noperator has not declared it. State a `null` as the operator's hosting location not yet being declared;\nit never means the data is held nowhere, and it never supports \"no international transfer\".\n\n**Completeness** — do not round any state up.\n\n| the register | what you may state | completeness |\n|---|---|---|\n| ABSENT | nothing — where data lands is unknown, and the fact is absent | `NEEDS_CONFIGURATION` |\n| a recipient in `undeterminedRecipients` | that its transfer position is not determined; never fold it into \"no transfer\" | `NEEDS_DECISION` for that recipient |\n| declares NO processor | no personal data reaches a third party, so none is transferred THROUGH one | `DERIVED`, with the residual stated |\n| a determined entry | its transfer with the safeguard per jurisdiction, or NO_TRANSFER as such | `DERIVED`; a `safeguardGaps` entry is stated as a transfer with no safeguard recorded for that jurisdiction |\n\n**The residual is not optional wording.** \"No processor receives personal data\" establishes nothing\nabout the operator's OWN processing — its infrastructure, its staff, its own establishment. A document\nthat says \"we do not transfer data internationally\" on the strength of an empty register has answered\na larger question than it was asked.\n\n**What closes an undetermined entry** — the operator researching the vendor's data processing\nagreement and recording what it relies on, per origin jurisdiction. A vendor's DPA usually names it:\nstandard contractual clauses for EU data, the UK Addendum to them for UK data, and sometimes a\ncertification under an adequacy framework beside them. Record what the contract says, not what is\ntypical.\n\n**\"We do not transfer data internationally\" is a claim, not a default.** It may be true, and it is\ncitable when an application has declared it as a fact — but it must never be produced because nothing\nsaid otherwise. Absence of a region declaration means the region is unknown, which is the opposite of\nknowing it stays put.\n\n\n### Concern: automated decisions and AI\n\n**Asserts** — where the application uses AI, on what data, and whether any of it decides something\nabout a person.\n\n**Derives from (partial)** — the AI capabilities the application has a provider configured for:\n`AI_LLM`, `AI_EMBEDDINGS`, `AI_DOCUMENT_EXTRACTION`, `AI_CODING_AGENT`. That establishes that AI is in\nuse and for what function.\n\n**Not derivable** — whether any of it produces a **decision with a legal or similarly significant\neffect** on a person, and whether a human reviews it. Nothing in the framework declares consequence or\nhuman-review posture, and neither can be inferred from a capability being enabled.\n\n**Derives from (the consequence)** — the AI POSTURE section of your brief, per ENABLED AI capability:\nwhat it is used for, whether it `NO_DECISION` / `ASSISTS_HUMAN_DECISION` / `DECIDES_AUTONOMOUSLY`, and —\nwhere it decides anything — how a person obtains human intervention.\n\nAn application enabling NO AI capability gets a plain statement to that effect: it performs no AI\nprocessing of personal data. That is a positive, checkable answer, not a gap.\n\n**Completeness** — `DERIVED` per capability with a declared posture; `NEEDS_DECISION` per capability\nlisted OUTSTANDING. Not `NEEDS_FRAMEWORK` any more: issue #92 delivered the declaration, so an\nundeclared posture is an unanswered question rather than an unaskable one.\n\n**An OUTSTANDING capability is not a harmless one.** This is the one concern where silence is more\ndangerous than elsewhere: a notice describing AI use and saying nothing about consequence does not read\nas \"unknown\", it reads as \"nothing significant happens here\" — which is the exemption, claimed for\nfree. State the gap explicitly.\n\n**Why the distinction carries weight.** Automated decision-making with significant effects attracts\nspecific obligations — information about the logic, and a right to human intervention. A generated\nnotice must not silently claim the exemption by describing AI use without addressing consequence. The\nhonest statement says AI is used for these functions, and that whether any of it decides something\nabout a person is not yet established.\n\n\n### Concern: analytics and tracking\n\n**Asserts** — what is observed about how people use the service, and what a person's consent controls.\n\n**Derives from (partial)** — the observability and analytics capabilities the application has\nconfigured (`FRONTEND_PRODUCT_ANALYTICS`, `LLM_OBSERVABILITY`, `OBSERVABILITY_TELEMETRY`), together\nwith the consent posture: `analytics.requiresConsent` and each person's `privacy.consentedPurposes` make\n`ConsentPurpose.ANALYTICS` a real, enforced boundary rather than a stated intention — in the application,\nwhere a product-analytics provider starts only on the signed-in person's grant and is stopped on\nwithdrawal or sign-out, and on the marketing website, where one does not start until a visitor grants it.\nA consent-based provider must be stoppable in the page, so none is loaded as a `<script>` tag.\n\n**Derives from (the inventory)** — the CLIENT STORAGE section of your brief: each cookie and storage\nkey, its mechanism, purpose, necessity and lifetime, split by who sets it.\n\nThe FRAMEWORK's own entries are listed first and belong in every application's table — the cookies\n`__wildo_refresh` and `__wildo_anon_session`, strictly necessary, with lifetimes taken from the\napplication's session configuration, and the website's `__wildo_website_consent` storage key, strictly\nnecessary because it is what makes a visitor's refusal hold. **No application authored these and every application sets them**, so a table\nbuilt only from what the application declared would omit the session cookie, which is the entry a\nvisitor is most certain to have.\n\nThen, per frontend surface: its declared entries, an explicit \"sets nothing of its own\", or\nUNINVENTORIED.\n\n**UNINVENTORIED is not \"sets nothing\".** The first says nobody catalogued that surface; the second is a\npositive statement. Writing the second from the first tells a visitor they are tracked by less than they\nare, which is the under-reporting direction a notice must never fail in.\n\n**Completeness** — `DERIVED` for the capability and consent posture, and for each surface that IS\ninventoried; `NEEDS_DECISION` per uninventoried surface. Not `NEEDS_FRAMEWORK` any more: issue #91\ndelivered the declaration surface, so an uninventoried surface is an unanswered question rather than an\nunaskable one.\n\nSay both halves: which analytics are in use and what consent gates them (strong, derived, enforced), and\nwhat the table still lacks — naming the surfaces, not the concern.\n\n\n### Concern: subject rights\n\n**Asserts** — which request mechanisms the application configures, what they select and what their\nresults establish. A configured mechanism does not establish that a particular request was fulfilled.\n\n**Derives from**\n\n- `SubjectExportPurpose.ACCESS_ART_15` and `PORTABILITY_ART_20` — two selections over the declared\n subject relationships. Access includes eligible owned rows and non-owned rows referring to the\n subject. Portability applies narrower relationship and field-provenance selection. Neither is an\n unrestricted recursive export of everything reachable from an account.\n- Each participating resource's `systemAccessPolicy.exportSubject` — an explicit disclosure choice,\n checked before collection. Missing and forbidden are different decisions:\n\n| Declaration | Runtime result | Meaning for the request |\n| --- | --- | --- |\n| Absent on a participating resource | Refuses collection | A required disclosure decision is unanswered; no silently incomplete bundle is returned |\n| `ALLOWED` | Passes this disclosure gate | Relationship selection, system-read admission, field security and purpose-specific checks still apply |\n| `FORBIDDEN` on a dependent resource | Excludes that resource and records the reason | A deliberate exclusion; do not change it to ALLOWED merely to remove a reported omission |\n| `FORBIDDEN` on the subject's own resource | Refuses the bundle | The subject cannot be omitted from its own export |\n\n- `portabilityPolicy.defaultProvenance` and per-field `.portabilityProvenance(...)` — the field\n declaration overrides the resource default. `SUBJECT_PROVIDED` and `OBSERVED` values are eligible\n for portability; `DERIVED` values are excluded and reported. Unresolved provenance refuses\n portability collection rather than silently dropping fields. Explicitly forbidden resources do\n not need portability provenance for this export because their rows are not collected. Access uses\n its separate field selection; backend-only and write-only fields remain withheld.\n- Erasure: `eraseSubjectAsSystem(resourceType, rowIds)`, invoked by the application's verified request\n workflow. A contact or lead without a login can still be a data subject. Retention, relationship\n treatments and account linkage are separate declarations; inspect the receipt before claiming\n completion, including dependent execution, session resolution and incomplete external effects.\n\n**The rights a notice states are COMPUTED, in the `rights-and-complaint-route` fact.** Which rights\napply, and where a person may complain, are the law of the regime each `operatingJurisdictions` entry\nfalls under, conditioned on the declared lawful bases: portability only for purposes resting on consent\nor contract, objection only for public task or legitimate interests, withdrawal of consent only where\nconsent is the basis. The channel is `privacyContact`; the verification step is the operator's\n`subjectRequestIdentityVerification`; who answers comes from `roleAllocations` — the operator for data it\ncontrols, the customer (with the operator forwarding and assisting) for data it processes on a\ncustomer's behalf. Two regimes are known: the EU GDPR and the UK's. Their rights match article for article but their\ncomplaint routes do not — since 19 June 2026 a UK notice names a complaint to the operator itself\n(Data Protection Act 2018 s.164A, acknowledged within 30 days) and to the Information Commissioner\n(s.165(2)), and never GDPR Art. 77. State each regime's route from the fact, not from memory. A\njurisdiction no known regime reaches is named in `jurisdictionsWithoutKnownRegime`: state that its\nrights are not established here, never borrow another regime's words for it.\n\n**Completeness** — derive the configured posture from actual resource declarations and the selected\nrelationships. Describe an unresolved declaration as a configuration refusal, an explicit exclusion\nas an exclusion, and an observed request outcome from its report. Declarations alone are not runtime\nproof that a right has been fulfilled.\n\n**What resolves a missing declaration** — the owning resource explicitly declares ALLOWED or FORBIDDEN\naccording to its intended disclosure policy. Portability additionally needs a valid resource default\nor field-level provenance for the fields it would collect. Do not ask a notice author to replace a\nmissing product declaration with a free-text promise.\n\n**Never state** that an undeclared participating resource is merely omitted while the remainder is\nexported. The runtime refuses collection. Preserve deliberate exclusions and explain their recorded\nreasons; the application's request workflow owns verification, protected delivery and any necessary\nfollow-up.\n\n\n### Concern: data exit\n\n**Asserts** — what a customer gets back when they leave, in what form, and what happens to what\nremains.\n\n**Derives from** — `SubjectExportPurpose.PORTABILITY_ART_20` and the resources declaring\n`exportSubject`; the account-closure path; and each resource's `retentionPolicy.mode`, which decides\nwhether a record is removed or **retained and impersonalized** on erasure.\n\n**Completeness** — `DERIVED` for the mechanism.\n\n**Retained-and-impersonalized is the part a reader must not be surprised by**, and the part a\ngenerated document most often gets wrong by omission. A retained row is kept, frozen, hidden from\nnormal reads and reachable only through an audited privileged path — it is not deleted. Say so. A\nnotice that implies everything is erased, when financial and audit records are lawfully retained with\ntheir personal fields scrubbed, is inaccurate in the direction that damages trust when discovered.\n\n**How LONG anything is retained is not derivable** — see the retention-and-deletion fragment.\n\n\n### Concern: tenancy model\n\n**Asserts** — that customer data is separated per organization, and where the boundary between the\noperator's responsibilities and the customer's lies.\n\n**Derives from** — the `ORGANIZATIONS` engine capability, the organization scoping applied to every\ntenant-scoped resource, and the cross-tenant admission rules. Ordinary tenant crossings must be\ndeclared and carry a usable access grant. The application audit viewer is a separate policy surface:\nit defaults to role-based access (the super-administrator or the read-only audit-evidence reader), with\n`auditTrail.applicationReadAccess` optionally set to `AuditApplicationReadAccess.INDEPENDENT_APPROVAL`, under\nwhich a machine reader needs a second-signed grant bound to its own credential. Both modes retain cross-tenant read observations;\nrole-based access neither implies anonymized records nor supplies an approval that never occurred.\n\n**Completeness** — `DERIVED`.\n\n**This fragment is where shared responsibility is described, and it must never be flattened.** In a\nB2B SaaS the operator is a PROCESSOR for the data a customer stores about its own people, and a\nCONTROLLER for the data it holds about the customer's users as account holders. Those are different\nroles with different duties over the same database. Say which is which; do not pick one and apply it\nto everything.\n\n**The attribution has a home now.** `operatorComplianceIdentity.roleAllocations` in\n`wildo.saas.config.ts` carries one role per population of data — PROCESSOR for the records a customer\nstores about its own people, CONTROLLER for the account data of the people who administer them. It is\na LIST for exactly the reason this fragment gives: those are different roles over the same database,\nand a single field would force one of them to be wrong.\n\nWhere the attribution is not established, that is a `NEEDS_DECISION` — never a guess — and the\nsurface to name is `roleAllocations`. Not `NEEDS_FRAMEWORK`: there is somewhere to write the answer,\nso the remedy is to fill it in rather than to build something. See the legal-basis fragment.\n\n\n## `document:public.service-terms` — six concerns\n\n### Concern: service scope\n\n**Asserts** — what the service actually is: the modules it runs, the resources it manages, and the\nsurfaces it exposes.\n\n**Derives from** — the application's declared modules and their resources, and the surfaces it builds\n(application, API, public website, technical documentation).\n\n**Completeness** — `DERIVED`.\n\n**Derive it; do not describe the product from its marketing.** Scope in a governed document is the\nboundary of what the statements around it apply to, so an aspirational description silently widens\nevery other clause. The declared modules are the honest boundary, and a capability the application\ndoes not run does not belong here even if it is on the roadmap.\n\n\n### Concern: commercial terms\n\n**Asserts** — what is sold, how it is charged, and what happens on renewal, change and cancellation.\n\n**Derives from** — the application's billing declarations\n(`saas-models` → `billing/billing-enums.shared.schemas.ts`): `ProductType`, `BillingTiming`,\n`ProrationBehavior`, `TaxCalculationMode`, plus the declared products and any usage metering.\n\n**Completeness** — `DERIVED` where billing is configured; `NEEDS_CONFIGURATION` where the application\ndeclares no products, in which case say that the commercial terms are not yet established rather than\ndescribing a plan nobody has authored.\n\n**Keep consumer and business audiences apart.** Consumer pre-contract obligations (withdrawal\nperiods, pre-contractual information) apply only when a declared audience includes consumers. A terms\ndocument that blends both into one ambiguous set is worse than one that states which audience it is\nfor — so read the declared audience before writing a single clause about cancellation rights.\n\n\n### Concern: governing law and liability\n\n**Asserts** — which law governs the agreement, where disputes are heard, and how liability is limited.\n\n**Derives from** — nothing. These are negotiated commercial and legal positions.\n\n**Completeness** — `NEEDS_DECISION`.\n\n**What closes it** — the operator deciding, with counsel. Note that liability limits interact with\nthe declared audience: consumer-facing terms cannot limit liability as freely as business-to-business\nones, so this fragment cannot be settled before the commercial-terms fragment establishes who the\nterms are for.\n\n**Never produce a liability clause from a template.** A limitation of liability that was copied\nrather than decided is either unenforceable or committing the operator to something nobody agreed —\nand unlike most gaps in a produced document, this one is not discovered until it matters.\n",
|
|
28
|
+
"guidance": "# Compliance document candidate method\n\nYou are drafting ONE governed document for this application, from what the application has already\ndeclared. Follow the `compliance-document-authoring` skill for the rules — its full text is in your\nbrief, under \"The skills this method tells you to FOLLOW\", because this step has no tools and cannot\nopen a file. This method says which document, what shape, and what the two closed vocabularies are.\n\n## Choose the document, from the two this lane may draft\n\n`documentRef` must be one of six and the contract refuses anything else, but only two of the six are\nYOURS. The four internal `governance.*` documents belong to `refinement.governance-document-candidate`,\nwhich ships their blueprints; drafting one here would mean writing a document whose obligations you were\nnever given.\n\n| `documentRef` | what it is | drafted by |\n|---|---|---|\n| `document:public.privacy-notice` | what personal data the application holds and what happens to it | **this lane** |\n| `document:public.service-terms` | the commercial and service relationship | **this lane** |\n| `document:governance.scope-system-description` | what the system IS, for an assurance reader | `refinement.governance-document-candidate` |\n| `document:governance.roles-responsibilities` | who is accountable for what | `refinement.governance-document-candidate` |\n| `document:governance.program-handbook` | how the governance program runs | `refinement.governance-document-candidate` |\n| `document:governance.document-record-control` | how governed documents are themselves controlled | `refinement.governance-document-candidate` |\n\n**Draft a document this application does not already hold.** The run tells you which those are: the\nbrief opens with what the application has already drafted, listing each document it may produce here\nas ALREADY DRAFTED or not yet drafted. Drafts are keyed by `documentRef`, so drafting one that is\nalready there REPLACES it — right when that draft is wrong, and a wasted run when it is not.\n\n**A held draft marked ALREADY DRAFTED, and WRONG comes before everything below.** The brief marks a held\ndraft that cites facts this application no longer declares, and names them. Nothing else corrects it: the\nlanding checks only the document a run writes, so a draft written before the facts were regenerated keeps\nits dead citations until a run redrafts that document. Redraft it against the facts that exist, and cite\nnone of the named ones.\n\nWhere several remain, the **privacy notice** comes first: it is the one every application holding\npersonal data needs. Where none remains, the honest reason to draft again is that a held draft is\nwrong — say which one and why in your own reasoning, rather than redrafting the first on the list.\n\nThis paragraph used to read \"draft the privacy notice unless the run tells you otherwise\", at a time\nwhen no run told it anything. Measured against a real application on 2026-09-16: with its privacy\nnotice already drafted, two consecutive runs meant to produce the service terms drafted the notice\nagain and replaced it, and the application finished each run holding exactly what it started with.\nThe second sentence was stale as well — it said the privacy notice was \"the only one whose facts the\ncurrent derivation supplies\", which stopped being true once the fact-declaring playbook began\ndeclaring the account, billing and AI facts the service terms rest on.\n\nNaming a document outside this set is not a smaller decision than it looks. Each of the six has a\nconcern composition the framework measures a draft against, so a seventh name is a document nobody can\nstate the gaps in — and stating the gaps is the whole point.\n\n## One section per concern, and SAY which concern\n\nEvery section carries `concernRef`, from the closed compliance-concern vocabulary. **The composition\nfor each document is inlined at the end of this method** — one entry per concern, saying what it\nasserts, what in the application it derives from, what state it usually reaches, and what closes it\nwhen it cannot. Draft one section per concern, in the order given, and produce **every** one:\na concern nothing can answer becomes a section with a marked clause, never a missing heading.\n\nThose entries are the difference between a draft that states its gaps and one that guesses at them.\nWhere a concern's entry names an issue number as the remedy, say so in `incompleteness.closedBy` —\n`#89`, `#91` — because a numbered issue is a remedy a reader can open, and \"application configuration\nowner\" is not.\n\nUse `concernRef: null` only for a section that genuinely answers no concern: a preamble, a contact\nblock. It is not a way past a concern you found hard. A concern you cannot establish gets a SECTION,\nwith a clause marked incomplete — which is the mechanism this whole document exists around.\n\nThe value must be the concern's exact name. A near miss (`retention` for `retention-and-deletion`) is\nworse than a null: it reports the concern as unaddressed while the document addresses it.\n\n\n## And SAY which required parts the section supplies\n\nEvery section also carries `satisfiesSectionRefs`: the refs, from the document definition rendered in\nyour brief, that this section actually addresses. This is a different question from `concernRef` and\nboth are answered — the concern says what compliance TOPIC the section is about, the satisfied refs\nsay what part of THIS document it supplies.\n\nYou are asked for the join because you are the only reader that holds both. The concern set is one\nflat vocabulary spanning every document type; the required parts are defined per document, and the\nsame concern does not sit under the same heading in a privacy notice and a governance handbook. A\nmapping written once in the framework would have to pick one answer and be wrong somewhere.\n\n- A section may claim several refs, and several sections may claim one between them.\n- A section that answers no required part — a preamble, a contact block — answers `null`. Not an\n empty list: `null` and `[]` would be two spellings of one state, and the contract refuses the second.\n- **Claim honestly.** A required ref nobody claims is reported as a part the document may not address,\n which is a true and useful finding. Claiming one you did not address hides that, and nothing\n downstream reads your prose to catch it.\n\nDo NOT adopt the definition's refs as your own `sectionRef` values. Your section set is the concern\nrule above; these are a claim you attach to it, not names you take.\n\n**Clauses carry the same claim**, as `satisfiesClauseRefs`, and answer `null` the same way. Your brief\nlists the blueprint's clauses under each section, each marked REQUIRED or CONDITIONAL; name the ones\nyour clause supplies.\n\nBoth keys were ASKED FOR HERE and absent from the strict contract you answer until 2026-09-02, so a\ndraft that followed this section could not parse and every landed document claimed nothing. If you\nare reading a document produced before then, its empty coverage is that defect and not a finding\nabout the document.\n\n- Several of your clauses may supply one blueprint clause between them, and one clause may supply\n several.\n- A clause supplying none — a transition, a heading gloss — claims none.\n- **Only the clauses marked REQUIRED are owed.** A CONDITIONAL clause is supplied when its condition\n holds and correctly omitted otherwise, so leaving one unclaimed is not a gap.\n\nThis is the anchor a clause did not previously have. A fact is named by the catalog and a section\ncarries its concern, so both survive a redraft; a clause was named freely and joined to nothing, which\nis why a reviewer who approved one could not find it in the next revision.\n## What a clause may say\n\nThe rule is ASSERT versus MARK, and the skill states it in full. In short: a clause may say \"this is\nnot yet established\"; it may not say something untrue.\n\n- `DERIVED` — established by a fact this application has declared. Cite it in `factRefs`. A `DERIVED`\n clause citing a fact the facts file does not declare is REFUSED before the write.\n\n **This is decided against the facts file as it stands NOW, not against any earlier draft.** You are\n producing the whole document from what the application currently declares, so a concern the facts\n answer today is `DERIVED` today — even if a previous version of this document marked it incomplete\n and is still in the tree. Re-running this playbook is how a document that went stale is repaired,\n and it only repairs anything if the re-draft is willing to close a mark.\n\n **Never fold a declared fact into a marked clause.** When one concern has a declared half and a\n missing half — retention periods declared while retention enforcement is not evidenced, a\n processor register that names most recipients while some providers have no recorded identity —\n write TWO clauses: a `DERIVED` clause stating what is declared, and a separate marked clause naming\n what is missing. A clause is marked as a whole, so one clause carrying both states nothing: every\n clause citing the declared fact is then incomplete, and the standing coherence report correctly\n records that the document mentions the fact without stating it. A redraft that marked its retention\n and recipients clauses because each also carried a gap stopped stating two facts the previous draft\n had stated.\n\n **A fact the application declared NOT APPLICABLE is a fact, and a clause may rest on it.** *\"No\n external analytics provider is configured\"* is `DERIVED`, not incomplete: the application settled the\n question and recorded the answer. Marking such a concern incomplete says the application does not\n know something it does know, which is as wrong as overstating. What is refused is citing a fact the\n facts file does not declare AT ALL.\n- `NEEDS_FRAMEWORK` / `NEEDS_DECISION` / `NEEDS_CONFIGURATION` — mark it, and say in `incompleteness`\n what is missing and who closes it. Four distinct suppliers, four distinct remedies; do not merge them.\n\n **When what is missing is a FACT, name it in `incompleteness.awaitingFactRefs`.** The skill argues\n this in full; the short version is that a marked clause asserts an ABSENCE in the application's own\n configuration, and that assertion goes false the moment someone declares the thing — silently, since\n nothing about the document changes. The awaited ref is what lets generation, landing and the\n standing coherence report all say the clause has gone stale. A clause that awaits nothing rots\n unobserved, and one already has.\n\n **`NEEDS_DECISION` and `NEEDS_FRAMEWORK` are the pair most easily confused, and the difference is\n the REMEDY.** `NEEDS_DECISION` means a surface exists and nobody filled it in — the reader goes and\n answers. `NEEDS_FRAMEWORK` means there is NOWHERE to record the answer; telling a reader to decide\n is telling them to write into a void.\n\n Measured on 2026-08-30, a produced notice marked operator identity `NEEDS_DECISION` when no surface\n for it existed at all, beside retention periods marked identically and genuinely just unfilled. Two\n remedies, rendered the same, and a reader could act on neither.\n\n **So every incomplete clause must NAME THE SURFACE its answer goes to**, or say plainly that none\n exists. A gap with a named surface is a task; a gap without one is a request for work nobody has\n scoped. The fragment you are working from names the surface where there is one — carry it into\n `incompleteness` rather than leaving the reader to find it.\n\n **`closedBy` must name WHO can reach that surface, and an ENGINE resource is not the application\n author's to edit.** `retentionPolicy`, `systemAccessPolicy.exportSubject` and `.dataCategories()`\n on an engine resource live in engine source. Writing \"application authors must declare\n `retentionPolicy` for each affected engine resource\" hands the reader a task they cannot perform —\n and a produced notice said exactly that, for 83 resources, in the same confident register as the\n remedies that ARE actionable. An unreachable remedy is worse than an unnamed one: it looks like\n work, gets scheduled, and fails when someone tries it.\n\n Where the closer is the FRAMEWORK, say so plainly — \"the framework must declare these on its own\n resources\" — and keep it separate from what this application owes.\n\nNever fill an unresolved fact, infer a legal decision, or describe the draft as approved, compliant,\nlegally valid, released or published. Locale and jurisdiction are review inputs; leaving them\nunresolved is a legitimate answer and never a reason not to draft.\n\n**And the mirror of that, which matters just as much: a missing approval never stops you.** Approval\nhappens at the END and is a human commit; a downstream release can be composed and MARKED\n`UNAPPROVED`. So the absence of one is a STATE to record, never a reason to produce nothing and never\nan outcome to report as blocked. The two failures are symmetric — claiming an approval that did not\nhappen, and refusing to act because it has not happened yet — and a compliance workflow standing in\nfront of the application-creation mechanism is the second one.\n\n## The refs you write, and their exact shape\n\nEvery `…Ref` field is a **namespaced ref**: `namespace:slug`, both halves lowercase, words joined by\nhyphens. `clause:retention-duration-not-declared` is one; `clause:Retention Duration` is not, and a\nwhole draft is rejected for a single malformed one. Ref ARRAYS are arrays of those strings — never\nobjects, never `{ ref: … }`.\n\nPer clause, all three ref arrays are required. Two of them may be empty, but **not both of the\nfirst two at once** — a clause that names no fact and no policy is sourced by nothing and is\nrejected:\n\n- `factRefs` — the facts this clause rests on, exactly as the facts file declares them. It may be\n EMPTY for a clause that establishes nothing (a marked clause often does).\n- `sourcePolicyRefs` — the application POLICY AREA the statement is sourced from, and nothing else.\n Every entry must be in the `policy:` namespace (`policy:retention`, `policy:recipients`,\n `policy:security-controls`); any other namespace is rejected outright. **Do NOT put a fact\n authority here.** A clause resting on declared facts already cites its authorities through\n `factRefs`, which resolves them — repeating them here duplicates the citation beside it and\n resolves to nothing. So this array is EMPTY for a fact-backed clause, and carries a policy area\n for a clause that is sourced from a policy rather than from a fact.\n- `claimGuardRefs` — at least one: what this clause must NOT be read as claiming. These are the\n boundaries you are already holding — `claim-guard:no-legal-applicability-claim`,\n `claim-guard:no-invented-retention-period`, `claim-guard:known-fact-only`. Name the ones that apply\n to this clause; do not repeat the same guard on every clause out of habit. You do not name the\n CATALOG's guard for the material: it is added for you from the blueprint clauses this clause\n `satisfiesClauseRefs`, so a clause that says what it satisfies is checked against it automatically.\n\n`evidenceRefs` is **`null` on every clause of a public document**, and that is not a gap to work around.\nIt cites a judged run from this application's own assurance repository — self-attested internal\nevidence — and a public notice may carry none, whatever the run says: a reader of one cannot weigh an\noperator's judgement of its own product, and any citation here is refused before the draft becomes a\nfile. That evidence belongs to the internal governance documents, which\n`refinement.governance-document-candidate` draws. Where you would have leaned on a measurement, say\nwhat is CONFIGURED or DECLARED, or MARK the statement.\n\n**The same holds when a FACT is phrased as behaviour, and that is where drafts go wrong.** The facts\nyou cite describe the product in the present tense — *\"the running application reaches\"*, *\"the\nframework sets\"*, *\"acceptance joins the member\"*, *\"kept 30 days, then erased\"* — which is accurate\nfor a fact and is an operating claim in a public notice. Do not carry the verb across: restate each as\na declaration (*\"the configuration enables\"*, *\"the framework declares\"*, *\"the configured membership\nmodel admits\"*, *\"the declared period is 30 days, after which the data is due for erasure\"*). The\njudge reads every clause of a public document for exactly this, and a sentence copied from a fact is\nthe one it finds.\n\n`reviewChecklistRefs` needs at least one (`review-checklist:<slug>`) — what a human must confirm before\nthis draft is worth anything. `limitationRefs` may be empty, but rarely should be: it is where you say\nwhat the document does NOT cover, in your own words as the drafter, rather than leaving the reader to\ndiscover it.\n\n## You do not compose the release — and a release nobody approved is marked UNAPPROVED\n\nYou draft the candidate. You do NOT author its release, and that is a boundary rather than an\nomission: almost everything a release carries is DERIVED from the accepted document definition — the\ndocument's class, who it addresses, which channels may carry it, which interactions it permits — and\na model restating those would create five ways to disagree with the catalog, invisibly. The rest\n(which declared variant, when it takes effect) is a composition over families you are not holding.\n\nA human declares a release DECISION in the application's\n`specifications/src/document-releases/compositions.ts`, and `wildo config document-releases` composes\neach decision not yet recorded — your candidate plus the declared variant and release policy — and\nrecords the finished release, text included. Nothing records a release because you landed a draft: an\napplication with no decision holds no release yet, which is a valid state and not yours to fix from\nthis playbook. Until a public document (privacy notice, service terms) has a release, its public page\nshows your latest draft, marked as a draft — so what you mark as not established is what a reader sees.\nWhat matters for your work is what composition produces when it runs: a release carrying\n`approvalState`, and one nobody has approved is `UNAPPROVED` and exists anyway.\n\n**Which is why a missing approval never changes what you do here.** Draft the document completely,\nmark every statement you cannot establish, and let the release be composed and marked. Waiting for an\napproval before drafting — or describing a draft as approved to get past the gate — are the two\nsymmetric failures, and the first is a compliance workflow standing in front of the mechanism that\nbuilds the application.\n\n## Where the draft goes\n\nIt lands as a FILE in the application's specifications package, as an ordinary working edit. It is\naccepted by a commit and by nothing else; who makes that commit is the host's autonomy posture, and\nonly a PERSON's commit is an approval. Landing is not approval, release or publication — and neither is\na commit the development companion authors under the YOLO posture.\n\n\n---\n\n# The compositions\n\nEach of the following is one document's full concern list. Use the one matching your `documentRef`\nand ignore the rest.\n\n## `document:public.privacy-notice` — thirteen concerns\n\n**Write for the audience the brief names.** The definition line in your brief says `audiences:`, and the\nvalue is derived from the application's line, never chosen by you. `PUBLIC_GENERAL` is the notice every\ncustomer-facing application publishes. `WORKFORCE` means one organization owns the application and its\nusers are that organization's staff (an internal tool): the brief then carries a section saying how that\nreader changes the scope, the purposes and bases, the recipients and the delivery of the notice. Follow\nit, and still take every basis and every recipient from the facts: the audience changes how you word\nwhat was declared, never what was declared.\n\n### Concern: operator identity\n\n**Asserts** — who legally operates the service: entity name, registered address, contact route for\ndata-protection questions, and a representative where one is required.\n\n**Derives from** — `operatorComplianceIdentity` in `wildo.saas.config.ts`: the legal entity, its\nregistered address, the privacy contact route, and an Art. 27 representative where one is required.\n\nThe VALUE is never derivable — a legal entity is a fact about the world, not a property of a codebase.\nWhat the framework provides is the PLACE to record it, and until 2026-08-30 it did not: this fragment\nsaid \"no engine change would close it\", which was right about derivation and wrong about the home.\nThe consequence was concrete. A landing REPLACES the produced document on every run, so an operator\nwho answered by editing the document lost the answer at the next regeneration — the answer has to live\nin the application or it does not survive.\n\n**Completeness** — `DERIVED` when the identity is declared; `NEEDS_DECISION` when it is not.\n\n⚠️ `NEEDS_DECISION`, not `NEEDS_FRAMEWORK`, and the distinction is load-bearing now that the surface\nexists. `NEEDS_FRAMEWORK` means there is nowhere to record the answer; `NEEDS_DECISION` means there is\nand nobody has. They have different remedies — build something, versus fill something in — and a\nreader who cannot tell them apart cannot act on either. Say which surface the answer goes to.\n\n**What closes it** — the operator declaring `operatorComplianceIdentity`. It is cheap and it can be\nfilled in later without redrafting anything around it, which is the reason it is not a blocker.\n\n**Never infer it.** Not from the application name, not from a domain, not from another application,\nnot from model memory. A published legal document naming the wrong entity is worse than one that says\nthe entity is not yet recorded — the first misdirects a person exercising a right, the second tells\nthem the document is incomplete.\n\n**Every document needs this fragment**, which makes it the clearest demonstration of why producing\nwith gaps beats blocking: the whole document set would be unproducible until one form is filled in.\n\n\n### Concern: legal basis and controller/processor role\n\n**Asserts** — the lawful basis for each processing purpose, and whether the operator acts as\ncontroller or processor for it.\n\n**Derives from** — `operatorComplianceIdentity.lawfulBases` and `.roleAllocations` in\n`wildo.saas.config.ts`.\n\nThe DETERMINATIONS are never derivable — both are legal conclusions about the operator's own\narrangements, and the framework can show WHAT is processed and BY WHICH MECHANISM without establishing\nunder which basis or in which role. What it now provides is where to record the conclusion, so that a\nregeneration reproduces it instead of destroying it.\n\n**The role is a LIST, not a field, and the produced notice said so before the surface existed:**\n*\"This notice therefore does not assign a single legal role to all data processed in a workspace.\"* A\nB2B SaaS is typically a processor for the records its customers put in and a controller for its\naccount holders' own data, simultaneously. `roleAllocations` carries one role per population, and a\ndocument that collapses them into one is wrong about both.\n\n**The `lawful-bases` fact is COMPUTED from `lawfulBases`** — every purpose, its basis and, for\nlegitimate interests, the assessment. You never declare it: a restatement would be a second copy of the\noperator's decision that nothing compares with the first. Absent bases leave the fact absent.\n\n**Give each purpose a stable `purposeRef`** (`account-security`) when a recipient serves it. A vendor\nnames the purposes it serves in `providerComplianceChoices.<ref>.purposeRefs`, and the recipients fact\njoins the two. The prose `purpose` can then be reworded without breaking the link; a ref naming no\ndeclared purpose is reported, never refused.\n\n**`LEGITIMATE_INTERESTS` cannot be declared without its assessment** — the schema refuses it. It is\nthe only Art. 6(1) basis whose lawfulness depends on a balancing test, so the bare claim asserts a\nconclusion nobody reached.\n\n**Completeness** — `DERIVED` when declared; `NEEDS_DECISION` when not. Never `NEEDS_FRAMEWORK`: there\nis a surface, so the remedy is to fill it in, not to build something. Name the surface when reporting\nthe gap.\n\n**What closes it** — the operator determining, per purpose, the basis and the role, ideally with\ncounsel, and declaring them in `operatorComplianceIdentity`. The tenancy fragment describes the SHAPE this usually takes in a B2B SaaS — processor for\nthe data a customer stores about its own people, controller for the data the operator holds about\naccount holders — but describing the common shape is not the same as determining this operator's, and\nthe produced document must not present the first as the second.\n\n**This is the fragment most likely to be filled in by a confident guess**, because the shape is\nfamiliar and the sentence is easy to write. Resist it. A basis stated in a published notice is a\nposition the operator has taken; a basis that was never determined is a position nobody can defend.\n\n\n### Concern: personal data held\n\n**Asserts** — which of the application's own records are about identifiable people, and which hold no\npersonal data of their own.\n\n**Derives from** — each resource's `retentionPolicy.mode` (`ErasureRetentionMode`, in\n`@wildo-ai/saas-models`), read for every resource the application declares:\n\n| declaration | what the document may state |\n|---|---|\n| `RETAIN_AND_IMPERSONALIZE` | this record holds personal data; the fields marked `.impersonalizeWith()` are what is scrubbed on erasure |\n| `RETAIN_ONLY` | this record holds **no personal data of its own** — a positive, factory-enforced statement, because declaring a scrub treatment under this mode fails at config build |\n| absent | the application has not said |\n\nRead `dataSubjectPolicy.kind` for the SESSION question only. `NO_PRINCIPAL` is equally true of an\ninvoice and of a CRM contact, so it never tells you whether a record is about a person — the\nretention mode does.\n\n**Completeness** — `DERIVED` for every resource that declares a retention policy.\n\n**An erasure-coverage gap does NOT license a claim about whether personal data is held.** The two are\ndifferent axes and the facts report them separately: `retentionPolicy` answers *what happens to this\nrow on erasure*, while a field's `.dataCategories()` answers *what kind of data is in it*. A resource\ncan declare the second and not the first, and 48 of the engine's 85 do.\n\nSo writing \"N resources have no declared erasure treatment, so this notice cannot establish whether\nthey hold personal data\" is an over-reach, and it contradicts the data-categories section of the same\ndocument — which enumerates categories drawn from those very resources. It was produced twice on\n2026-08-30 before this paragraph existed.\n\nState the gap as what it is: those resources have not declared an erasure TREATMENT, so a notice\ncannot say what an erasure does to them. Where the facts also report a category coverage for the same\norigin, say what IS established alongside it.\n`NEEDS_CONFIGURATION` for every resource that does not.\n\n**What closes it** — the application's own authors declaring `retentionPolicy`, with the `dataSubjectPolicy` the\nfactory requires beside it, on the resource. Name\nthe resources individually: the remedy is per-resource, and a count is not actionable.\n\n\n### Concern: data categories\n\n**Asserts** — which CATEGORIES of personal data are held: identity, contact details, credentials,\nfinancial, usage, location, user content, professional, and any GDPR Art. 9 special-category or\nArt. 10 criminal-offence data.\n\n**Derives from** — each field's `.dataCategories()` declaration, reported per resource and unioned\nacross the application in the compliance-primary-facts section. One category is DERIVED rather than\ndeclared: `credentials`, from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, which are\nmarkers the author already wrote.\n\n**Nothing is derived from a field NAME.** `email`, `phone` and `dateOfBirth` are suggestive while\n`notes` is not, so a category list assembled by pattern-matching identifiers is a guess presented as\nan inventory — and its failure mode is silent, because whatever the guess misses is simply not\ndisclosed. The declaration exists so that never happens.\n\n**Completeness** — `DERIVED` when the application declares categories; `NEEDS_CONFIGURATION` when it\ndeclares none, or when the facts section lists OUTSTANDING fields.\n\n**The two gaps are different and must not be written the same way.**\n\n- A resource that declares no category at all may genuinely hold no personal data. Nothing\n distinguishes \"considered and not applicable\" from \"never asked\", so state that the question is\n unanswered — never that the application holds no personal data.\n- A field the facts section lists as OUTSTANDING is a provable omission. The application already\n declared that field personal by another door — an erasure scrub treatment, a portability\n provenance, or a credential marker — so the missing category is an omission, not a judgement.\n Name the field and its basis. Do not guess what it contains.\n\n**A CONDITIONAL category is stated with its condition, never flattened.** A field may declare that\nit is personal data only under a condition — `described-party-is-a-natural-person` marks the name,\nnumber or address of the PARTY a row describes (a customer organization, an account, a supplier).\nThat party may be an individual, such as a sole trader, whose details are personal data, or a\ncompany, whose details are not, because GDPR Recital 14 excludes only legal persons. The facts\nsection lists these apart from the categories held on every row. State them as held \"where the\ncustomer is an individual (for example a sole trader)\". Never state them as held about every\ncustomer, and never leave them out: either sentence is false about some customers.\n\n**Say WHICH special category, not that there is one.** A `special-category:*` value is Art. 9 data\nand carries a lawful-basis condition of its own beyond Art. 6; `criminal-offence` is Art. 10, a\nseparate article with a different condition. \"We process special category data\" is not a disclosure —\nthe enum names the kind precisely so a notice can.\n\n**Do NOT point at `Compliance_DataClassification`.** It exists, it is a four-level SENSITIVITY ladder\n(public / internal / confidential / restricted) applied only to flows-actors configuration, and it\nanswers \"how protected must this be\" rather than \"what kind of personal data is this\". Using it here\nwould produce a notice describing protection levels where a reader expects data types. It is named\nexplicitly because it is a near-miss a reader will otherwise find and assume answers this concern.\n\n\n### Concern: consent and preferences\n\n**Asserts** — what the application asks consent for, at what granularity, and what a person's choice\nactually controls.\n\n**Derives from**\n\n- `ConsentPurpose` (`@wildo-ai/saas-models`): `ANALYTICS` · `MARKETING` — a SET of purposes, each\n granted or not on its own. There is no ordering: agreeing to marketing says nothing about analytics.\n- per-person `privacy.consentedPurposes` — the purposes each person granted, empty until they grant\n one — and `privacy.consentDecidedAt`, stamped by the server when they decide. An empty set WITH an\n instant is \"declined everything\"; no instant is \"never asked\". A notice must not state the second\n as the first.\n- `analytics.requiresConsent` (default `true`) — whether the application's analytics rest on\n `ANALYTICS`. It governs analytics alone, never use of the service.\n- the visitor tier: a marketing website keeps a visitor's decision in their browser and starts a\n consent-based provider (product analytics) only once its purpose is granted.\n\n- `operatorComplianceIdentity.serviceConsentRequirement` (`wildo.saas.config.ts`) — what a person\n must agree to in order to use the service AT ALL, and what that gate covers.\n\n**An empty `requiredPurposes` is a POSITIVE answer and the usual one.** The operator declaring that nothing is gated on\nconsent has answered the question; a document must state it as settled rather than treating it as an\nabsence. ABSENT is the different case — nobody was asked — and the brief distinguishes the two.\n\n**A consent GATE is not a lawful BASIS.** For most B2B SaaS the basis for core processing is CONTRACT:\na person uses the product because their employer signed for it. A notice that reads a gate as a basis\nstates that their data is processed on consent they could withdraw, which is wrong about the single\nmost consequential thing in the document. The basis is declared per purpose in `lawfulBases`.\n\n**Completeness** — `DERIVED` for the analytics gate, each person's granted purposes, and the\nservice-wide requirement once declared — which the application ENFORCES: until the required purposes are\ngranted, the backend refuses every operation the person initiates — API and MCP operations, queued work,\nWebSocket reads and subscriptions, agent tools, retrieval, charts and analytics, A2A task reads, and A2A or\nWebSocket conversations, including resuming one after an approval — except their own profile and preferences,\nwhere they record the consent, and cancelling an A2A task they already started (signing in and out stay open;\nupdates the server pushes on its own are not held back), and the web\napplication withholds its pages; `NEEDS_DECISION` naming `serviceConsentRequirement` when it is not.\n\nThis was `NEEDS_FRAMEWORK` until 2026-08-30, correctly: there was nowhere to record the answer. Issue\n#139 built the surface, so the remedy changed from \"someone must build this\" to \"fill this in\" — a\ndifferent party and a different task, which is why the two states are never interchangeable.\n\n**Say the thing readers get wrong.** Consent is one lawful basis among several, and it is not the one\nmost B2B processing rests on. **Never write that all processing rests on consent, and never write\nthat accepting terms supplies a lawful basis** — accepting a contract is a different basis with\ndifferent consequences, and conflating them is the single most common defect in a generated privacy\nnotice. Which basis applies is a `NEEDS_DECISION`; see the legal-basis fragment.\n\n\n### Concern: retention and deletion\n\n**Asserts** — what happens to a record when its subject is erased, and how long records are kept.\n\nTwo questions, and the framework answers both — the second only for the resources bound to a class.\n\n**Derives from (the HOW — answerable)** — each resource's `retentionPolicy.mode`:\n`RETAIN_AND_IMPERSONALIZE` keeps the row, freezes it, hides it from normal reads and scrubs the fields\nmarked `.impersonalizeWith()`; `RETAIN_ONLY` keeps and freezes a row that holds no personal data of\nits own. Reading the per-field treatments tells the document exactly WHICH values are destroyed and\nwhich survive, which is a genuinely strong statement most notices cannot make.\n\n**Records a statute keeps survive an erasure RESTRICTED, and the request still completes.** A resource\nbound to `BUSINESS_RECORDS` declares `retentionPolicy.statutoryRetention`: the GDPR Art. 17(3)(b) ground\n(`LEGAL_OBLIGATION`) and the statute in the operator's words. An erasure erases everything else, keeps\nthose rows retained and hidden from any other processing until their statutory period ends, and lists\neach one with its ground and end date — which is what the notice must say: that some records are kept\nbecause the law requires it, which law, and that they are deleted when the period ends. The\n`retention-rules` fact names these resources and their statute under each erasure treatment. Never write\nthat an erasure is refused or delayed because of them.\n\n**Derives from (the HOW LONG)** — the application's `dataRetention` schedule, declared in its config\nover five data classes: `RESOURCE_DATA` (its records), `FILES` (uploaded bytes), `AUDIT_LOGS` (the\ntamper-evident trail, kept longest and for a different reason — it is the evidence an operator may\nlawfully retain under GDPR Art. 17(3)), `OPERATIONAL_LOGS`, and `BUSINESS_RECORDS` (records a statute\nrequires to be kept for a minimum period). Each declared class carries a period in days AND the\noperator's stated reason for it.\n\n**Enforced where a resource is BOUND** — a resource declares `retentionBinding: { retentionClass,\nstartPoint }`, and the retention sweep deletes its rows once the period has passed since the start point\n(the account closing, the record closing, its creation, the end of its calendar year). The period is\ncounted from when the record stops being needed, so a live record is never deleted for its age. The\n`retention-rules` fact names, per class, the resources bound to it and the MECHANISMS that act on it:\n`RETENTION_CLASS_SWEEP`, `FILES_CLEANUP` (file bytes after their row is gone), `AUDIT_ARCHIVAL`. An EMPTY\nmechanism list means nothing is even wired to enforce the class — say exactly that. `AUDIT_ARCHIVAL` means the audit\ntrail is archived after the period and is NEVER deleted: do not write that audit records are deleted.\nThe fact also names the resources bound to no class — kept until erased, because nobody decided otherwise.\n\n**Whether a period IS enforced is a different fact** — `retention-enforcement`, computed from the records the\nretention sweep writes on every run (runtime evidence, not a declaration). Per declared class it reads\n`ENFORCED` (every bound resource shows a recent completed or deferred run), `DECLARED` (a period nothing has\nyet been shown to apply) or `FAILING` (the latest run of a bound resource failed). Say a period is enforced\nONLY where it reads `ENFORCED`, and as of its `observedAt` — and only for the resources bound to the class:\n`mechanismsNotEvidencedByTheseRecords` names what the records cannot see (the audit trail's archival, the files\ncleanup), so never write that the audit trail's or the files' retention is evidenced by this fact. A mechanism in `retention-rules` says the sweep\nWILL act; only this fact says it did. When the fact is absent the records were not collected: say enforcement\nis not yet evidenced, never that it is not happening.\n\nThe classes are the STORES on purpose: the same declaration answers what a notice must state and what\na backup-and-restore inventory must protect (issue #8).\n\n**The `retention-rules` fact is COMPUTED from both** — the declared periods with their reasons and\nmechanisms, the classes with no period, each resource's declared erasure treatment, the resources\ndeclaring none, and the resources bound to no retention class.\nYou never declare it.\n\n**State what an account holder's erasure DOES, not what a resource declares.** A declared treatment is\nwhat an impersonalization of the rows WOULD do; whether a person's erasure runs one depends on the edges\nit walks and on the framework's own erasure steps. So each treatment carries `accountHolderErasure`:\n`erasedAsTheSubject` (the person's own account rows, scrubbed by their declared mode), the `dispositions`\nthe erasure applies to rows below them (`delete`, `impersonalize_and_retain`,\n`restricted_under_statutory_retention`), the `severerTreatments` its steps apply to rows off those edges\n(an id removed, a membership impersonalized, an invoice's document links removed), and\n`rowsKeptAsTheyAre` when it runs nothing. Two lists name the gaps a notice drafted from declarations\nwould get wrong: `keptAsTheyAreByAnAccountHoldersErasure` (never describe them as scrubbed by a person's\nerasure: billing records are the usual case, kept whole as business records) and\n`changedByAnAccountHoldersErasureWithoutDeclaredTreatment` (changed or deleted although they declare\nnothing). The scope is an ACCOUNT HOLDER's erasure: a record of a person without an account (a CRM\ncontact, a lead) is erased as its own subject, and that erasure applies its declared mode, so say both\nwhen such a record is in the first list. A tenant's deletion is a separate mechanism, not described\nhere. When `accountHolderErasure` is absent the execution could not be derived; say only what is\ndeclared, worded as a declaration. It is absent when no schedule is declared, because a treatment alone would read as\nthe whole answer.\n\n**Completeness** — `DERIVED` for the treatment, and for each retention class the application HAS\ndeclared. `NEEDS_DECISION` for each class it has not: the mechanism exists, so what is missing is an\noperator's decision rather than an engine change. Do not let the derivable half hide the missing one —\na statement about erasure mechanics reads to a reader as an answer about retention, so both go in the\nsame breath.\n\n**What closes it** — the operator deciding a period, and saying why. Not a framework change: issue #89\ndelivered the declaration surface, so an undeclared class is now an unanswered question rather than an\nunaskable one.\n\n**An UNDECLARED class is not \"kept indefinitely\" and not \"deleted immediately\".** It is a decision\nnobody has taken, and the document must say exactly that.\n\n**A legal hold suspends every deletion of its scope** — the retention sweep, an erasure, the tenant purge,\nfile bytes — until the tier that placed it releases it (`legalHolds`). The notice may say that data is kept\nbeyond its period while a legal claim, an investigation or a legal obligation requires it, and that it is\ndeleted once that ends. Never write that a hold expires, and never name a matter.\n\n**Never write a placeholder period.** \"Typically 12 months\" in a published notice is a commitment\nnobody made and nothing enforces.\n\n\n### Concern: recipients and processors\n\n**Asserts** — who else receives personal data, in what role, and where they process it.\n\n**Derives from (who receives)** — the RECIPIENT POPULATION, which your brief renders under *\"Who\nRECEIVES data, by whose account reaches them\"*. It is computed by `computeRecipientPopulation`\n(`@wildo-ai/saas-specifications/application-creation`) from the configuration and a scan of the\napplication's source, and the privacy notice's recipients fact and the assurance evidence read the SAME\npopulation, so none of them can disagree with the others. Every provider declared under a runtime scope\n(`backend`, `frontendServices.<service>`, `minions.<minion>`, `workers.<worker>`) and every\n`systemsOfRecord` instance lands in exactly ONE of four classes:\n\n| Class | What it means | What the document does with it |\n| --- | --- | --- |\n| **OPERATOR-RUN** | an explicit `SELF_HOSTED` compliance choice | processing under the operator's own control — never a recipient |\n| **OPERATOR SUB-PROCESSOR** | some data path spends the APPLICATION's own account (an engine capability, a wired capability role, a typed client, a browser operation, a system of record) | the operator's recipient; it belongs in the processor register |\n| **TENANT RECIPIENT** | reachable ONLY through a customer's or a person's own connected account | the customer's own vendor, reached at the customer's instruction. Never the operator's sub-processor; you may say a customer can connect its own account |\n| **DECLARED, NO DATA PATH** | configured, and nothing in the application reaches it | receives nothing. Never name it as a recipient; the gap is the declaration itself |\n\nAn engine capability is ONE data path, not the definition of a recipient: a catalogue vendor called\nthrough its typed client receives data with no capability at all, and a vendor declared \"to exercise the\nloading chain\" with nothing calling it receives nothing. The tenant class matters most when the operator\nis a PROCESSOR for the data: listing a customer's own vendor as its sub-processor states an engagement the\noperator never made. The function and its limits are in the `compliance-document-authoring` skill's\n`references/framework-recipient-population.md`.\n\n**Derives from (the identities)** — the application's PROCESSOR REGISTER, which your brief renders\nunder *\"Who else processes personal data\"*. Per entry: the processor's **legal entity**, the\n**regions** it processes in, and its own **subprocessors** with their regions.\n\n**The register holds two kinds of entry and the brief labels them differently — say which.** A\nCONFIGURED PROVIDER entry joins to the application's composition, so it can be checked against it: a\nclaim about a provider the application does not configure is detectable, and a configured provider\nwith no entry is reported as UNDECLARED. An AUTHORED entry — a hosting company, a CDN, a support desk\n— joins to nothing, because no configuration mentions it. The framework can neither confirm it nor\nnotice its absence.\n\nBoth kinds of declared relationship can belong in the notice when their role is established. What\nmust not happen is presenting the second with the authority of the first: an authored entry is the operator's word, and a document that reads\nas though the framework verified it overstates what anyone checked.\n\n**A SELF-HOSTED provider is not a recipient either, and this is the second way to get the section\nwrong.** The brief's *\"Who RUNS each bound provider\"* block splits the members the OPERATOR answers\nfor (operator sub-processors and operator-run) three ways:\nTHIRD-PARTY RECIPIENTS (vendor-hosted, so data reaches a third party — enumerate these with their\nregion), OPERATOR-RUN (self-hosted, so no third party receives anything — state them as processing\nunder the operator's own control, never as recipients), and UNANSWERED.\n\nAn UNANSWERED provider is bound to a runtime with no declared deployment model. **Do not assume\nvendor-hosted.** It looks like the cautious reading and it is not: it publishes that a person's data\ngoes to a third party when nobody said so. Report it as not established, and name the surface —\n`providerComplianceChoices` in `wildo.saas.config.ts`.\n\n**A provider PROFILE is not a recipient.** The brief separates providers BOUND TO A RUNTIME — backend,\ncompanion, workers, minions, a frontend service, which can process the application's data — from\nprovider profiles with no runtime binding. A profile says how to reach a provider; build-time tooling\nlives there, and a coding agent operating on the workspace receives no customer records. Never name a\nprofile-only provider as a recipient. Naming one reads as caution and is a false statement about\nsomebody's data, exactly like omitting a real one.\n\nThe section joins the register to the OPERATOR SUB-PROCESSORS of the recipient population, so it tells\nyou these different things and they are not interchangeable:\n\n- a candidate WITH an entry — its declared identity and regions are available. Establish its\n deployment role before presenting it as a recipient.\n- a candidate listed **UNDECLARED** — a runtime binding has no matching processor entry. Name its\n configured function and unresolved declarations; an unanswered deployment choice remains unknown,\n not automatically vendor-hosted. `NEEDS_DECISION`, resolved by the operator.\n- a provider entry listed **STALE** — no data path reaches it from this operator any more.\n Reconcile the declaration and deployment choice; this check alone does not establish its actual\n historical processing or that all external data has been removed.\n- a provider entry listed **REGISTERED TENANT RECIPIENT** — the register names, as the operator's\n sub-processor, a vendor reached only through customers' own accounts. That entry is a false\n statement about who engaged the vendor; do not publish it as one of the operator's processors.\n\n**Completeness** — `DERIVED` per provider that is declared, `NEEDS_DECISION` per provider that is not.\nNot `NEEDS_FRAMEWORK` any more: issue #88 delivered the declaration surface, so an undeclared processor\nis an unanswered question rather than an unaskable one.\n\n**Never infer a region from a vendor's brand.** \"It is a US company\" is not a processing location, and\na transfer statement built on it is a claim about somebody's data made from a guess.\n\n**Distinguish the register declaration from its reconciliation.**\n\n| Observed state | What it establishes | What the document may say |\n| --- | --- | --- |\n| Register absent | No processor declaration was supplied | The operator has not established the register; do not infer recipients or their absence |\n| Register present with `processors: []` | The operator declares no processors | Report that declaration, then check it against runtime-bound recipient candidates; it is not independent proof that nobody receives data |\n| Recipient candidates have no matching entries, including with an empty register | The composition and declarations leave named questions unresolved | Identify the configured functions and outstanding deployment, identity or location decisions without inventing third parties |\n\nReconcile only operator sub-processors. Exclude operator-run, tenant-recipient, unreached and\nprofile-only providers; keep unanswered deployment choices visible as unanswered. `registerEstablishesNoProcessorRecipients`\nanswers the declaration question; `undeclaredProcessorRefs` answers candidate coverage. A true answer to\nthe first does not erase gaps returned by the second.\n\nName third-party recipients only when their role is established. An empty register does not justify\nan unconditional statement that third parties provide email, storage or payments. Equally, do not\nomit unresolved candidate questions and thereby imply that absence was verified. Authored recipients\nremain operator declarations whose completeness cannot be inferred from runtime bindings.\n\n\n### Concern: international transfers\n\n**Asserts** — whether personal data leaves its origin jurisdiction, to where, and under which transfer\nmechanism.\n\n**Derives from** — the processor register's regions, at BOTH levels: each declared processor and\neach processor's own subprocessors. Your brief renders them under *\"Personal data reaches processors\nin: …\"*.\n\nBoth levels, because the chain is what makes a transfer statement hard. An operator in France using a\nFrench vendor that runs on a US cloud HAS a transfer, and reading only the vendor's region misses it.\n\n**The question has three inputs, and the framework derives only one of them.** Where declared\nprocessors process is declared. Which jurisdiction is the ORIGIN is `operatingJurisdictions`. Which\nMECHANISM makes a given transfer lawful is a legal determination with a shelf life — adequacy decisions\nmove by court ruling — so the framework never computes it: the operator RECORDS it, per register entry,\nas a `transferDetermination`:\n\n- `NO_TRANSFER`, with the reason none of the entry's regions lies outside the origin jurisdictions —\n regions are free text, so this comparison is the operator's and never the framework's;\n- `TRANSFER`, with one safeguard per origin jurisdiction: the GDPR Chapter V mechanism\n (`ADEQUACY_DECISION`, `STANDARD_CONTRACTUAL_CLAUSES`, `BINDING_CORPORATE_RULES`,\n `APPROVED_CODE_OF_CONDUCT`, `APPROVED_CERTIFICATION`, or a `DEROGATION` naming its Art. 49 ground) and\n the instrument a reader could look up.\n\nThe determination sits on the ENTRY because the processor's own contract binds its onward transfers to\nits subprocessors; reaching the processor is the transfer the operator answers for.\n\n**The `international-transfers` fact is COMPUTED from those determinations** — you never declare it.\nIt carries each determined entry, the origin jurisdictions, `undeterminedRecipients` — a register entry\nwith no determination, or a configured provider the register does not establish — `safeguardGaps`:\na declared origin a TRANSFER names no safeguard for — and `operatorHostingRegions`: where the operator's\nOWN infrastructure holds the data (`operatorComplianceIdentity.hostingRegions`), or `null` when the\noperator has not declared it. State a `null` as the operator's hosting location not yet being declared;\nit never means the data is held nowhere, and it never supports \"no international transfer\".\n\n**Completeness** — do not round any state up.\n\n| the register | what you may state | completeness |\n|---|---|---|\n| ABSENT | nothing — where data lands is unknown, and the fact is absent | `NEEDS_CONFIGURATION` |\n| a recipient in `undeterminedRecipients` | that its transfer position is not determined; never fold it into \"no transfer\" | `NEEDS_DECISION` for that recipient |\n| declares NO processor | no personal data reaches a third party, so none is transferred THROUGH one | `DERIVED`, with the residual stated |\n| a determined entry | its transfer with the safeguard per jurisdiction, or NO_TRANSFER as such | `DERIVED`; a `safeguardGaps` entry is stated as a transfer with no safeguard recorded for that jurisdiction |\n\n**The residual is not optional wording.** \"No processor receives personal data\" establishes nothing\nabout the operator's OWN processing — its infrastructure, its staff, its own establishment. A document\nthat says \"we do not transfer data internationally\" on the strength of an empty register has answered\na larger question than it was asked.\n\n**What closes an undetermined entry** — the operator researching the vendor's data processing\nagreement and recording what it relies on, per origin jurisdiction. A vendor's DPA usually names it:\nstandard contractual clauses for EU data, the UK Addendum to them for UK data, and sometimes a\ncertification under an adequacy framework beside them. Record what the contract says, not what is\ntypical.\n\n**\"We do not transfer data internationally\" is a claim, not a default.** It may be true, and it is\ncitable when an application has declared it as a fact — but it must never be produced because nothing\nsaid otherwise. Absence of a region declaration means the region is unknown, which is the opposite of\nknowing it stays put.\n\n\n### Concern: automated decisions and AI\n\n**Asserts** — where the application uses AI, on what data, and whether any of it decides something\nabout a person.\n\n**Derives from — the computed fact `ai-use-inventory`.** Nobody declares it: the runtime computes it\nfrom the application's AI-use declarations whenever facts are read, so it never goes stale the day an\nagent is added. Per AI use of the CONTRACTED SERVICE, at the capability (`aiUsePosture`) or on the agent\nthat runs it (`aiUse`), it states:\n\n- the purpose, the use `domain`, and the `consequence` — `NO_DECISION` / `ASSISTS_HUMAN_DECISION` /\n `DECIDES_AUTONOMOUSLY`;\n- the human review: the declared arrangement, or `derivedFromApprovalGates` where every tool the agent\n can change something with waits for a person's approval (`ungatedWriteToolRefs` lists any that do not).\n When `unresolvedToolRefs` is non-empty the derived review covers only the tools the reading could see:\n say so, and do not present the gates as covering the agent's every action;\n- the providers that serve it, with the legal entity and processing regions the processor register\n establishes (`onProcessorRegister: false` means the register does not name it — say so).\n\nIts gaps are part of the answer, never a reason to stay silent: `undeclaredCapabilities` and\n`undeclaredAgentRefs` (AI the service runs with no declared use), `domainOwedRefs`, and\n`invalidDeclarations`. State each as not yet established.\n\n**The regulatory reading follows jurisdiction.** `regulatoryScope` says which: `EU_AI_ACT` — each use\ncarries an `aiActReading` with its CANDIDATE class; `NO_AI_REGULATION_REACHES` — no AI regulation the\nframework reads applies where the application operates, so describe no use in the AI Act's terms;\n`JURISDICTION_NOT_DECLARED` — the application declares no operating jurisdiction, so the class is owed. Under `EU_AI_ACT`, a `HIGH_RISK_CANDIDATE` or `PROHIBITED_PRACTICE_CANDIDATE` carries\n`notSupportedYet: true` and is listed in `highRiskCandidateRefs` / `prohibitedPracticeCandidateRefs`:\nstate it as a candidate and as not supported yet, never as compliant, and never leave it out.\n\n**Not applicable is an answer.** When no AI capability reaches the contracted service the fact is\nNOT_APPLICABLE, and its reason says so — the service performs no AI processing, a positive, checkable\nstatement. Capabilities that serve only the build (`AI_CODING_AGENT`, or one offered only by the\ncompanion scope) are named there and in `authoringOnlyCapabilities`, outside this document: do not deny\nthey exist, and do not describe them as a feature of the service.\n\n**When the fact is absent** the declarations could not be read. Mark the clause owed; do not describe\nthe application's AI from the brief or from memory.\n\n**Whether the guardrails RAN is a second fact** — `ai-content-guardrails`, computed from the records the\nevidence plane collected (runtime evidence, not a declaration). Per agent of the contracted service it\nstates what the agent DECLARES (its personal-data treatment, prompt-injection screening, output\nmoderation) and, per guardrail, an `observation`: `RAN` (at least one recorded verdict in the window),\n`NO_RUN_RECORDED` (the agent has records and none carries a verdict — screening has nothing to judge on a\ncall that read no tool result) or `NO_OPERATION_RECORDED` (the window holds no record of the agent; not\n\"never called\", since a call whose record failed to write is counted in `callsWithoutOperationRecord` for\nno agent). `RAN` is not \"runs on every call\". State two things, as of the fact's window: the calls the\nguardrail was ACTIVE on (`treatedOperations`, `screenedOperations` or `moderatedOperations` of the agent's\n`operations`), and what it JUDGED (`fieldsWithheld`, `screenedResults`, `judgedOutputs`). Active is not\njudged: screening switched on for a call that read no tool result judged nothing, and the observation then\nreads `NO_RUN_RECORDED`. Say it ran only where the observation reads `RAN`. The guardrail audit-event counts beside it\ncount outcomes (content quarantined, output withheld, a failed check), application-wide, not per agent; a\nquiet audit trail is never evidence that a guardrail ran. A count is stated only when its `standing` is\n`COUNTED`: `UNCONTROLLED` (the collector's control found no row of any kind in the window) and\n`NOT_COLLECTED` carry `null`, which is never zero. When the fact is absent the records were not collected: say\nthe guardrails' operation is not yet evidenced, never that they are not enforced. An organization's agent\npolicy can tighten a guardrail at run time; a run it switched on shows here as `RAN` on an agent that\ndeclares none.\n\n**Completeness** — `DERIVED` for what the facts state; `NEEDS_DECISION` per use listed undeclared or with\nits domain owed. Never `NEEDS_FRAMEWORK`: the framework provides the declaration, so an undeclared posture\nis an unanswered question rather than an unaskable one.\n\n**An undeclared AI use is not a harmless one.** This is the one concern where silence is more\ndangerous than elsewhere: a notice describing AI use and saying nothing about consequence does not read\nas \"unknown\", it reads as \"nothing significant happens here\" — which is the exemption, claimed for\nfree. State the gap explicitly.\n\n**Why the distinction carries weight.** Automated decision-making with significant effects attracts\nspecific obligations — information about the logic, and a right to human intervention. A generated\nnotice must not silently claim the exemption by describing AI use without addressing consequence. The\nhonest statement says AI is used for these functions, and that whether any of it decides something\nabout a person is not yet established.\n\n\n### Concern: analytics and tracking\n\n**Asserts** — what is observed about how people use the service, and what a person's consent controls.\n\n**Derives from (partial)** — the observability and analytics capabilities the application has\nconfigured (`FRONTEND_PRODUCT_ANALYTICS`, `LLM_OBSERVABILITY`, `OBSERVABILITY_TELEMETRY`), together\nwith the consent posture: `analytics.requiresConsent` and each person's `privacy.consentedPurposes` make\n`ConsentPurpose.ANALYTICS` a real, enforced boundary rather than a stated intention — in the application,\nwhere a product-analytics provider starts only on the signed-in person's grant and is stopped on\nwithdrawal or sign-out, and on the marketing website, where one does not start until a visitor grants it.\nA consent-based provider must be stoppable in the page, so none is loaded as a `<script>` tag.\n\n**Derives from (the inventory)** — the CLIENT STORAGE section of your brief: each cookie and storage\nkey, its mechanism, purpose, necessity and lifetime, split by who sets it.\n\nThe FRAMEWORK's own entries are listed first and belong in every application's table — the cookies\n`__wildo_refresh` and `__wildo_anon_session`, strictly necessary, with lifetimes taken from the\napplication's session configuration, and the website's `__wildo_website_consent` storage key, strictly\nnecessary because it is what makes a visitor's refusal hold. **No application authored these and every application sets them**, so a table\nbuilt only from what the application declared would omit the session cookie, which is the entry a\nvisitor is most certain to have.\n\nThen, per frontend surface: its declared entries, an explicit \"sets nothing of its own\", or\nUNINVENTORIED.\n\n**UNINVENTORIED is not \"sets nothing\".** The first says nobody catalogued that surface; the second is a\npositive statement. Writing the second from the first tells a visitor they are tracked by less than they\nare, which is the under-reporting direction a notice must never fail in.\n\n**Completeness** — `DERIVED` for the capability and consent posture, and for each surface that IS\ninventoried; `NEEDS_DECISION` per uninventoried surface. Not `NEEDS_FRAMEWORK` any more: issue #91\ndelivered the declaration surface, so an uninventoried surface is an unanswered question rather than an\nunaskable one.\n\nSay both halves: which analytics are in use and what consent gates them (strong, derived, enforced), and\nwhat the table still lacks — naming the surfaces, not the concern.\n\n\n### Concern: subject rights\n\n**Asserts** — which request mechanisms the application configures, what they select and what their\nresults establish. A configured mechanism does not establish that a particular request was fulfilled.\n\n**Derives from**\n\n- `SubjectExportPurpose.ACCESS_ART_15` and `PORTABILITY_ART_20` — two selections over the declared\n subject relationships. Access includes eligible owned rows and non-owned rows referring to the\n subject. Portability applies narrower relationship and field-provenance selection. Neither is an\n unrestricted recursive export of everything reachable from an account.\n- Each participating resource's `systemAccessPolicy.exportSubject` — an explicit disclosure choice,\n checked before collection. Missing and forbidden are different decisions:\n\n| Declaration | Runtime result | Meaning for the request |\n| --- | --- | --- |\n| Absent on a participating resource | Refuses collection | A required disclosure decision is unanswered; no silently incomplete bundle is returned |\n| `ALLOWED` | Passes this disclosure gate | Relationship selection, system-read admission, field security and purpose-specific checks still apply |\n| `FORBIDDEN` on a dependent resource | Excludes that resource and records the reason | A deliberate exclusion; do not change it to ALLOWED merely to remove a reported omission |\n| `FORBIDDEN` on the subject's own resource | Refuses the bundle | The subject cannot be omitted from its own export |\n\n- `portabilityPolicy.defaultProvenance` and per-field `.portabilityProvenance(...)` — the field\n declaration overrides the resource default. `SUBJECT_PROVIDED` and `OBSERVED` values are eligible\n for portability; `DERIVED` values are excluded and reported. Unresolved provenance refuses\n portability collection rather than silently dropping fields. Explicitly forbidden resources do\n not need portability provenance for this export because their rows are not collected. Access uses\n its separate field selection; backend-only and write-only fields remain withheld.\n- Erasure: `eraseSubjectAsSystem(resourceType, rowIds)`, invoked by the application's verified request\n workflow. A contact or lead without a login can still be a data subject. Retention, relationship\n treatments and account linkage are separate declarations; inspect the receipt before claiming\n completion, including dependent execution, session resolution and incomplete external effects.\n\n**The rights a notice states are COMPUTED, in the `rights-and-complaint-route` fact.** Which rights\napply, and where a person may complain, are the law of the regime each `operatingJurisdictions` entry\nfalls under, conditioned on the declared lawful bases: portability only for purposes resting on consent\nor contract, objection only for public task or legitimate interests, withdrawal of consent only where\nconsent is the basis. The channel is `privacyContact`; the verification step is the operator's\n`subjectRequestIdentityVerification`; who answers comes from `roleAllocations` — the operator for data it\ncontrols, the customer (with the operator forwarding and assisting) for data it processes on a\ncustomer's behalf. Two regimes are known: the EU GDPR and the UK's. Their rights match article for article but their\ncomplaint routes do not — since 19 June 2026 a UK notice names a complaint to the operator itself\n(Data Protection Act 2018 s.164A, acknowledged within 30 days) and to the Information Commissioner\n(s.165(2)), and never GDPR Art. 77. State each regime's route from the fact, not from memory. A\njurisdiction no known regime reaches is named in `jurisdictionsWithoutKnownRegime`: state that its\nrights are not established here, never borrow another regime's words for it.\n\n**Completeness** — derive the configured posture from actual resource declarations and the selected\nrelationships. Describe an unresolved declaration as a configuration refusal, an explicit exclusion\nas an exclusion, and an observed request outcome from its report. Declarations alone are not runtime\nproof that a right has been fulfilled.\n\n**What resolves a missing declaration** — the owning resource explicitly declares ALLOWED or FORBIDDEN\naccording to its intended disclosure policy. Portability additionally needs a valid resource default\nor field-level provenance for the fields it would collect. Do not ask a notice author to replace a\nmissing product declaration with a free-text promise.\n\n**Never state** that an undeclared participating resource is merely omitted while the remainder is\nexported. The runtime refuses collection. Preserve deliberate exclusions and explain their recorded\nreasons; the application's request workflow owns verification, protected delivery and any necessary\nfollow-up.\n\n\n### Concern: data exit\n\n**Asserts** — what a customer gets back when they leave, in what form, and what happens to what\nremains.\n\n**Derives from** — `SubjectExportPurpose.PORTABILITY_ART_20` and the resources declaring\n`exportSubject`; the account-closure path; and each resource's `retentionPolicy.mode`, which decides\nwhether a record is removed or **retained and impersonalized** on erasure.\n\n**Completeness** — `DERIVED` for the mechanism.\n\n**Retained-and-impersonalized is the part a reader must not be surprised by**, and the part a\ngenerated document most often gets wrong by omission. A retained row is kept, frozen, hidden from\nnormal reads and reachable only through an audited privileged path — it is not deleted. Say so. A\nnotice that implies everything is erased, when financial and audit records are lawfully retained with\ntheir personal fields scrubbed, is inaccurate in the direction that damages trust when discovered.\n\n**How LONG anything is retained is not derivable** — see the retention-and-deletion fragment.\n\n\n### Concern: tenancy model\n\n**Asserts** — that customer data is separated per organization, and where the boundary between the\noperator's responsibilities and the customer's lies.\n\n**Derives from** — the `ORGANIZATIONS` engine capability, the organization scoping applied to every\ntenant-scoped resource, and the cross-tenant admission rules. Ordinary tenant crossings must be\ndeclared and carry a usable access grant. The application audit viewer is a separate policy surface:\nit follows `auditTrail.applicationReadAccess`, which defaults by the application's shape:\n`AuditApplicationReadAccess.INDEPENDENT_APPROVAL` where the parties of one of its relationship kinds are independent of its operator, role-based\naccess (the super-administrator or the read-only audit-evidence reader) otherwise. Under independent approval a\nmachine reader needs a second-signed grant bound to its own credential. Both modes retain cross-tenant read observations;\nrole-based access neither implies anonymized records nor supplies an approval that never occurred.\n\n**Completeness** — `DERIVED`.\n\n**This fragment is where shared responsibility is described, and it must never be flattened.** In a\nB2B SaaS the operator is a PROCESSOR for the data a customer stores about its own people, and a\nCONTROLLER for the data it holds about the customer's users as account holders. Those are different\nroles with different duties over the same database. Say which is which; do not pick one and apply it\nto everything.\n\n**The attribution has a home now.** `operatorComplianceIdentity.roleAllocations` in\n`wildo.saas.config.ts` carries one role per population of data — PROCESSOR for the records a customer\nstores about its own people, CONTROLLER for the account data of the people who administer them. It is\na LIST for exactly the reason this fragment gives: those are different roles over the same database,\nand a single field would force one of them to be wrong.\n\nWhere the attribution is not established, that is a `NEEDS_DECISION` — never a guess — and the\nsurface to name is `roleAllocations`. Not `NEEDS_FRAMEWORK`: there is somewhere to write the answer,\nso the remedy is to fill it in rather than to build something. See the legal-basis fragment.\n\n\n## `document:public.service-terms` — six concerns\n\n### Concern: service scope\n\n**Asserts** — what the service actually is: the modules it runs, the resources it manages, and the\nsurfaces it exposes.\n\n**Derives from** — the application's declared modules and their resources, and the surfaces it builds\n(application, API, public website, technical documentation).\n\n**Completeness** — `DERIVED`.\n\n**Derive it; do not describe the product from its marketing.** Scope in a governed document is the\nboundary of what the statements around it apply to, so an aspirational description silently widens\nevery other clause. The declared modules are the honest boundary, and a capability the application\ndoes not run does not belong here even if it is on the roadmap.\n\n\n### Concern: commercial terms\n\n**Asserts** — what is sold, how it is charged, and what happens on renewal, change and cancellation.\n\n**Derives from** — the application's billing declarations\n(`saas-models` → `billing/billing-enums.shared.schemas.ts`): `ProductType`, `BillingTiming`,\n`ProrationBehavior`, `TaxCalculationMode`, plus the declared products and any usage metering.\n\n**Completeness** — `DERIVED` where billing is configured; `NEEDS_CONFIGURATION` where the application\ndeclares no products, in which case say that the commercial terms are not yet established rather than\ndescribing a plan nobody has authored.\n\n**Keep consumer and business audiences apart.** Consumer pre-contract obligations (withdrawal\nperiods, pre-contractual information) apply only when a declared audience includes consumers. A terms\ndocument that blends both into one ambiguous set is worse than one that states which audience it is\nfor — so read the declared audience before writing a single clause about cancellation rights.\n\n\n### Concern: governing law and liability\n\n**Asserts** — which law governs the agreement, where disputes are heard, and how liability is limited.\n\n**Derives from** — nothing. These are negotiated commercial and legal positions.\n\n**Completeness** — `NEEDS_DECISION`.\n\n**What closes it** — the operator deciding, with counsel. Note that liability limits interact with\nthe declared audience: consumer-facing terms cannot limit liability as freely as business-to-business\nones, so this fragment cannot be settled before the commercial-terms fragment establishes who the\nterms are for.\n\n**Never produce a liability clause from a template.** A limitation of liability that was copied\nrather than decided is either unenforceable or committing the operator to something nobody agreed —\nand unlike most gaps in a produced document, this one is not discovered until it matters.\n",
|
|
29
29
|
"skillRefs": [
|
|
30
30
|
"compliance-document-authoring"
|
|
31
31
|
],
|
|
@@ -85,7 +85,8 @@ Work through this list and declare a fact for each one you can answer:
|
|
|
85
85
|
| whether retained data stays reachable, and audited | `systemAccessPolicy.seeRetained` per resource |
|
|
86
86
|
| who else can see the data inside the application | the domain model — roles, membership, sharing |
|
|
87
87
|
| which third parties receive data, WHO they are and WHERE they process | the PROCESSOR REGISTER section — declared entries, plus the providers it lists UNDECLARED |
|
|
88
|
-
| whether the application makes automated decisions or uses AI | the AI
|
|
88
|
+
| whether the application makes automated decisions or uses AI | the `## Automated decisions and AI` section — per AI capability of the contracted service, then `Agents declaring their use`, `OUTSTANDING agents` (or `Agents: NOT READ`) and the regulatory reading: the declared use, its domain and class, its human review (derived from approval gates where every write is gated) |
|
|
89
|
+
| what each agent's model provider receives, and what is screened or moderated | the same section's `Content guardrails each agent DECLARES` list — the personal-data treatment, prompt-injection screening and output moderation each agent declares |
|
|
89
90
|
| what analytics or tracking runs, and what is stored in a browser | the declared capabilities + the CLIENT STORAGE section (framework entries, then per surface) |
|
|
90
91
|
| what consent the application asks for | the declared capabilities + the domain plan |
|
|
91
92
|
| how organizations are separated from each other | the domain model and the tenancy declarations |
|
|
@@ -94,7 +95,7 @@ Work through this list and declare a fact for each one you can answer:
|
|
|
94
95
|
|
|
95
96
|
The sections above are yours alone. The pass that drafts the document reads the `document-facts` FILE
|
|
96
97
|
and nothing else — it never sees the resource declarations, the retention schedule, the processor
|
|
97
|
-
register, the AI
|
|
98
|
+
register, the AI uses and agents or the client-storage inventory. **A gap you notice and do not write down is a
|
|
98
99
|
gap that disappears**, and the document then states the half that was answered as though it were the
|
|
99
100
|
whole.
|
|
100
101
|
|
|
@@ -119,11 +120,26 @@ the remedy is an operator deciding, not the framework growing a mechanism. Never
|
|
|
119
120
|
application has not declared, and never soften an absent one into "as long as necessary": that is a
|
|
120
121
|
commitment nobody made and nothing enforces.
|
|
121
122
|
|
|
123
|
+
**Agents are AI uses one by one.** Declare a fact per agent of the contracted service — or one fact listing
|
|
124
|
+
them, each by ref — stating its declared use, whether it decides anything about a person and who reviews it,
|
|
125
|
+
and what its model is sent in place of personal data. An agent listed OUTSTANDING, a guardrail "not declared"
|
|
126
|
+
and a field NOT READ are gaps: record each as such, never as "the agent decides nothing" or "nothing is
|
|
127
|
+
sent". State a guardrail as what the agent DECLARES: an organization can tighten it at run time, and a fact
|
|
128
|
+
must not claim the tightening happened.
|
|
129
|
+
|
|
122
130
|
**An absent capability is a fact, not a silence.** If no analytics provider is configured, that is
|
|
123
131
|
`KNOWN`: *"no external analytics provider is configured"*. If no AI capability is declared, say so. These
|
|
124
132
|
are the answers that let a notice state something true instead of confessing ignorance about a decision
|
|
125
133
|
the application already made — and the composition section in your brief lists them exactly.
|
|
126
134
|
|
|
135
|
+
**Not built yet is not "none".** When your brief says NOT BUILT YET, the build has not yet produced the
|
|
136
|
+
application's own resources, and their absence is a stage of the build, not a decision. Write that the
|
|
137
|
+
application's own data is not yet established. Never write "zero resources", "holds no personal data" or
|
|
138
|
+
"declares nothing" for data that does not exist yet. These facts are dated by the code they were read
|
|
139
|
+
from: once the build commits its resources, configuration or roles, they go stale and are derived again.
|
|
140
|
+
An earlier run wrote "zero personal-data resources" and "no billing" an hour before the build declared
|
|
141
|
+
both, and those sentences stayed in the file.
|
|
142
|
+
|
|
127
143
|
**Declare mechanism facts per RESOURCE where the resources differ.** "All eight application resources
|
|
128
144
|
declare a subject-export mode" is a usable fact; "the application supports exports" is not, because a
|
|
129
145
|
reader cannot tell which records it covers.
|
|
@@ -185,6 +201,15 @@ Derive the fact SET from the regimes, then answer each one from the application'
|
|
|
185
201
|
configurations first. Where the regime implies a fact the application has not settled, that is an
|
|
186
202
|
absence: record nothing, and let the document state the gap in place.
|
|
187
203
|
|
|
204
|
+
## Who the privacy notice addresses
|
|
205
|
+
|
|
206
|
+
The facts brief says so when it matters. On an application one organization owns (an internal tool),
|
|
207
|
+
the privacy notice is addressed to that organization's STAFF, not to the public, and the brief carries
|
|
208
|
+
a paragraph saying so. Word the facts you declare for that reader: processing purposes and data
|
|
209
|
+
categories in terms of what the application records about staff as they work in it. The lawful bases
|
|
210
|
+
and the recipients stay computed from the operator's declarations, as below; the audience never makes
|
|
211
|
+
them yours to declare. Where the brief says nothing about the audience, the notice is the public one.
|
|
212
|
+
|
|
188
213
|
## Scope: one operator, deliberately
|
|
189
214
|
|
|
190
215
|
Every fact you write is attributed to one application-operator governance scope. The family can carry
|
|
@@ -237,7 +262,17 @@ declarations every time the facts are read:
|
|
|
237
262
|
- `retention-enforcement` is computed from the retention-enforcement records the evidence plane
|
|
238
263
|
collected;
|
|
239
264
|
- `system-of-record-sources` is computed from the resources bound to, or copied from, a declared
|
|
240
|
-
system of record, and the purposes their bindings link
|
|
265
|
+
system of record, and the purposes their bindings link;
|
|
266
|
+
- `ai-use-inventory` is computed from the AI-use declarations — each capability's `aiUsePosture` and
|
|
267
|
+
each agent's own `aiUse` — scoped to the contracted service and joined to the providers serving each
|
|
268
|
+
use and the processor register;
|
|
269
|
+
- `ai-content-guardrails` is computed from the agent-operation records and guardrail audit events the
|
|
270
|
+
evidence plane collected: per agent, the guardrails it declares, the recorded calls each was active
|
|
271
|
+
on and what each judged.
|
|
272
|
+
|
|
273
|
+
The AI facts replace the AI half of the service terms' AI question. What is left of
|
|
274
|
+
`ai-features-and-content-use` (whether customer content trains or improves a model) is a decision a
|
|
275
|
+
person records, so it is not yours to declare either.
|
|
241
276
|
|
|
242
277
|
This list is a convenience. The brief's "do not declare" heading is the authority.
|
|
243
278
|
|