@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: resource-external-data
|
|
3
|
-
description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP").
|
|
3
|
+
description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP"), or edited on both sides ("sync both ways", "two-way sync with Odoo").
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -56,10 +56,10 @@ run.
|
|
|
56
56
|
|
|
57
57
|
- **The application owns the data** — that is an ordinary resource; use `resource-add-resource`.
|
|
58
58
|
- **You are adding a provider or credential**, not consuming data — that is provider configuration.
|
|
59
|
-
- **
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
59
|
+
- **Two pipelines over one resource.** Never declare an INBOUND and an OUTBOUND pipeline on the same
|
|
60
|
+
destination to get a two-way sync: each would overwrite the other's changes unseen. When the same rows
|
|
61
|
+
are edited on both sides, that is ONE `direction: BIDIRECTIONAL` pipeline (see "When both sides edit
|
|
62
|
+
the records" below).
|
|
63
63
|
|
|
64
64
|
## Workflow
|
|
65
65
|
|
|
@@ -111,12 +111,25 @@ The library describes **seven** vendors — `odoo`, `microsoft-dataverse`,
|
|
|
111
111
|
- **Your vendor is named** → use it. You get its real paging behaviour, its real credential kinds and
|
|
112
112
|
its partition field, all with the vendor's own documentation cited.
|
|
113
113
|
- **Your system speaks OData v4 and is not named** → use `odata`. A vendor-neutral facet: OData v4,
|
|
114
|
-
|
|
115
|
-
block carries the service root.
|
|
114
|
+
five credential kinds (a bearer key, HTTP Basic, the two OAuth client-credentials kinds, a client
|
|
115
|
+
certificate), conformant paging, no partition. The instance's address block carries the service root.
|
|
116
116
|
- **Neither** → the vendor has no facet, and that is the answer. Do not reach for `odata` because it
|
|
117
117
|
is the only one that parses: if the system is not OData v4, `odata` will fail at the first read,
|
|
118
118
|
further from the cause.
|
|
119
119
|
|
|
120
|
+
**A number an OData service serves that no number field can hold is never rounded.** OData v4 JSON
|
|
121
|
+
serves NaN and the infinities as the STRINGS `"INF"`, `"-INF"` and `"NaN"`. In a field your resource
|
|
122
|
+
declares as a number, a read-through refuses the read and names the property, because it cannot refuse
|
|
123
|
+
one record of a page. A pipeline rejects just that record and loads the rest. The same word in a text
|
|
124
|
+
field is only a word. A 64-bit integer or an exact decimal is asked for as a string
|
|
125
|
+
(`IEEE754Compatible=true`), so it arrives whole: in a number field, a value a number holds exactly
|
|
126
|
+
becomes that number, and one no number can hold (an integer past 2^53 − 1, a decimal of more than 15
|
|
127
|
+
significant digits) is refused in a read-through and rejected as one record in a pipeline. It is never
|
|
128
|
+
rounded. A pipeline applies the same rule to a number served as TEXT by any source, REST and Odoo
|
|
129
|
+
included: map the field to a string to keep such values. A declared action's answer is read the same
|
|
130
|
+
way against its `output` schema. A service that ignores the request and still sends JSON numbers cannot
|
|
131
|
+
be detected after parsing. For v2, which has more such values, see `references/odata-v2-sources.md`.
|
|
132
|
+
|
|
120
133
|
Two naming traps, both real: the Microsoft Web API is known under three provider
|
|
121
134
|
ids, and only **`microsoft-dataverse`** has a facet — `microsoft-dynamics-365` and
|
|
122
135
|
`microsoft-dynamics-crm` do not, and naming one is refused. And the SAP facet is **`sap-s4hana`**,
|
|
@@ -124,10 +137,15 @@ not `sap-s4hana-cloud`.
|
|
|
124
137
|
|
|
125
138
|
#### What each facet admits it cannot do
|
|
126
139
|
|
|
127
|
-
Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared
|
|
140
|
+
Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared. When your
|
|
141
|
+
application must DECIDE something from one of these limits (open onboarding writes or not, advertise sort keys or
|
|
142
|
+
not, pick an incremental mode), ask the engine rather than restating the list: see
|
|
143
|
+
`references/framework-system-of-record-capabilities-api.md`.
|
|
128
144
|
|
|
129
|
-
- **`sap-s4hana` — HTTP Basic
|
|
130
|
-
|
|
145
|
+
- **`sap-s4hana` — HTTP Basic or a client certificate.** Its communication user takes either, so the
|
|
146
|
+
instance must name the one it uses (`credential: { kind: SystemOfRecordCredentialKind.BASIC }` or
|
|
147
|
+
`MTLS_CLIENT_CERTIFICATE`); naming neither is refused at boot. A client certificate is presented in
|
|
148
|
+
the TLS handshake and needs an `https:` base URL.
|
|
131
149
|
- **`sap-s4hana` — OData v4 AND v2, one instance per service root.** SAP's most-used API
|
|
132
150
|
(`API_BUSINESS_PARTNER`, `/sap/opu/odata/sap/…`) is **v2**; declare `dialect: ODATA_V2` on the instance
|
|
133
151
|
AND the binding for it, and `ODATA` for a v4 root (`/sap/opu/odata4/…`). A system reached over both is
|
|
@@ -157,6 +175,10 @@ them:
|
|
|
157
175
|
|
|
158
176
|
- **`keyFields` order is the encoding order.** It is committed. Changing it later re-keys every row
|
|
159
177
|
identity, so decide it once and deliberately.
|
|
178
|
+
Declare each key field as the codec projects it — a number for an INTEGER key, a string or a date for a
|
|
179
|
+
DATETIME_ISO key, a string otherwise —
|
|
180
|
+
and `_id` as a plain string (it holds the synthesized id). A schema that rejects that form is refused
|
|
181
|
+
when the resource is defined, not left to fail every read.
|
|
160
182
|
- **`system`** — the declared instance the rows live in, by name. Not a provider: the instance is
|
|
161
183
|
declared under `systemsOfRecord` in `wildo.saas.config.ts`, and its address and credential come from
|
|
162
184
|
the environment under names derived from that name. A name the application does not declare is
|
|
@@ -164,18 +186,50 @@ them:
|
|
|
164
186
|
- **You do not declare tenancy.** Rows read out of a system of record are stamped with the
|
|
165
187
|
organization that owns the application, so the engine's per-row gate decides — nothing about your
|
|
166
188
|
tenants is pushed to a remote that has never heard of them.
|
|
167
|
-
- **`
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
189
|
+
- **`subjectRights`** — who answers data-subject requests about these rows. **Leave it out**, and the
|
|
190
|
+
system of record does: it decides what happens to its records' personal data and answers the people
|
|
191
|
+
they concern, under its own rules, and the application follows it (`HANDLED_AT_SOURCE`). An erasure
|
|
192
|
+
in the application then reports the resource as handled at the source, names the system, and never
|
|
193
|
+
stops for want of anything. That is the default because a system of record backs internal tools and
|
|
194
|
+
carries its own GDPR obligations; the application owns only what it keeps beyond or apart from the
|
|
195
|
+
source. Two other answers exist:
|
|
196
|
+
- `NO_SUBJECT_DATA` — the rows hold nothing about a person. CHECKED at startup: it is refused when
|
|
197
|
+
any field the system holds declares `.dataCategories()` (every field of a read-through resource;
|
|
198
|
+
the mapped fields of a pipeline, whichever way they travel). Settle it by fact: GDPR Recital 14's
|
|
199
|
+
exclusion covers only LEGAL persons, a record's "company" flag does not establish one (a sole trader
|
|
200
|
+
may be recorded as a company), and a named person's address on a company record is personal data.
|
|
201
|
+
A company's own name and number are personal data only where the company is a sole trader:
|
|
202
|
+
declare them with `{ personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON }`,
|
|
203
|
+
and the notice words them conditionally. They still count here, because some rows are a person's;
|
|
204
|
+
- `FORWARDED_TO_SOURCE` (read-through only) — besides the source's own handling, each erasure is
|
|
205
|
+
forwarded to the system through a declared operation, best effort: it never blocks the local
|
|
206
|
+
erasure, and a forward that fails still reports the resource as handled at the source, with the
|
|
207
|
+
failed steps listed (re-running the erasure retries them). Refused on a pipeline, which sends no delete.
|
|
208
|
+
- `OWNED_COPY` (inbound pipelines only) — the application keeps this copy BEYOND its source, so its
|
|
209
|
+
own erasure applies to it: the local rows are scrubbed or deleted as the resource's retention says,
|
|
210
|
+
and a suppression keeps the next pass from loading the person back. REQUIRED when the copy holds
|
|
211
|
+
something the source does not: a field about a person that callers write and no mapping fills (an
|
|
212
|
+
internal note on a client). The startup check refuses such a copy under any other posture.
|
|
213
|
+
|
|
214
|
+
Every other pipeline copy FOLLOWS its system of record: an erasure leaves its rows to the source
|
|
215
|
+
(nothing scrubbed, nothing suppressed; the receipt says the system answers for them), and the copy
|
|
216
|
+
removes what the source removes through its orphan policy, which must then be `DELETE` or
|
|
217
|
+
`IMPERSONALIZE` if it copies personal data. An outbound or two-way pipeline may send personal data:
|
|
218
|
+
the system receiving it answers requests about what it holds. Outbound rows are the application's
|
|
219
|
+
own and are erased as their resource declares; a two-way copy follows its source, and may not let
|
|
220
|
+
callers write personal data on rows born locally (`population: OPEN`).
|
|
221
|
+
|
|
222
|
+
One declaration is optional and belongs beside `subjectRights` whenever the rows hold personal data:
|
|
176
223
|
**`purposeRefs`**, the `purposeRef`s of `operatorComplianceIdentity.lawfulBases` this data is read for.
|
|
177
224
|
See "Which purpose the data serves" below.
|
|
178
225
|
|
|
226
|
+
**An unset remote field reads as unset.** A vendor spells "no value" its own way — OData and the REST
|
|
227
|
+
vendors send `null`, Odoo sends `false` for every unset field that is not a boolean — and the read-through
|
|
228
|
+
projects it as what YOUR field accepts: `null` for a `.nullable()` field, left out for an `.optional()` one,
|
|
229
|
+
and a real `false` kept for a field that accepts booleans. So declare every field some rows leave empty as
|
|
230
|
+
`.optional()` (or `.nullable()`), exactly as you would for a pipeline. A REQUIRED field the vendor serves
|
|
231
|
+
empty still fails the read, naming the field: that is the declaration and the ERP disagreeing, not noise.
|
|
232
|
+
|
|
179
233
|
**Writing rows back** — creating, updating or deleting ONE row of the remote system — is opened by
|
|
180
234
|
`writableVerbs` on the binding and performed by ordinary `CREATE` / `UPDATE` / `DELETE` operations.
|
|
181
235
|
Read `references/read-through-writes.md` before you open one: it owns the whole contract, and four
|
|
@@ -215,16 +269,30 @@ The four decisions that matter:
|
|
|
215
269
|
|
|
216
270
|
1. **`remoteKeyLocalField`** — a `.isBusinessKey()` STRING field holding the remote row's identity.
|
|
217
271
|
The sync merges on it, which is what makes re-running safe. (An OUTBOUND pipeline reverses this and
|
|
218
|
-
the next rule — see "When the application is the source".)
|
|
272
|
+
the next rule — see "When the application is the source".) Keep it a plain string: it stores the id
|
|
273
|
+
the key codec synthesizes (`"42"` for an INTEGER key), so a `z.uuid()` or a `.regex()` on it is refused
|
|
274
|
+
at startup when it would reject that form.
|
|
219
275
|
2. **`mapping`** — remote field → local field, plus constants for local fields with no remote source,
|
|
220
276
|
and DECLARED EXPRESSIONS for a value derived from remote fields (see "When a local value is derived"
|
|
221
277
|
below). It must NOT name your tenant field; see the next section.
|
|
222
278
|
3. **`population`** — `CLOSED` (every row comes from the pipeline; caller CREATE is refused) or
|
|
223
279
|
`OPEN` (users may also mint their own rows beside the synced ones).
|
|
224
280
|
4. **`orphanPolicy`** — what happens to a local row whose remote original disappeared: `DELETE`,
|
|
225
|
-
`DEPRECATE` or `
|
|
226
|
-
the whole pass. An unreadable identity skips reconciliation for every policy. `OPEN`
|
|
227
|
-
|
|
281
|
+
`DEPRECATE`, `REPORT` (the default) or `IMPERSONALIZE`. The final execution compares against all accepted source
|
|
282
|
+
keys from the whole pass. An unreadable identity skips reconciliation for every policy. An `OPEN` population runs
|
|
283
|
+
its declared policy too: only rows the pipeline loaded (or adopted) are ever orphan candidates, never a row a caller
|
|
284
|
+
created. A copy that FOLLOWS its system of record and copies personal data MUST declare `DELETE` or `IMPERSONALIZE`
|
|
285
|
+
— startup refuses `REPORT`, `DEPRECATE` or the default there, because the copy would keep a record the source
|
|
286
|
+
deleted. `DELETE` removes the row through its parent-delete lifecycle: rows on its `onParentDelete` edges are
|
|
287
|
+
deleted or scrubbed as each edge declares, and a `REFUSE_WHILE_CHILDREN_EXIST` edge keeps the orphan (the pass
|
|
288
|
+
reports it and retries).
|
|
289
|
+
`IMPERSONALIZE` is the one to choose when the copy holds personal data and other rows reference it: the
|
|
290
|
+
orphan's `.impersonalizeWith()` fields are scrubbed and the row is kept, hidden and immutable, so a record
|
|
291
|
+
erased at the source leaves your copy nothing about the person while the work that points at it survives.
|
|
292
|
+
It needs the destination to declare `retentionPolicy: { mode: RETAIN_AND_IMPERSONALIZE }` (refused at startup
|
|
293
|
+
otherwise), and on a following copy `.impersonalizeWith()` on every copied personal field, or that field would
|
|
294
|
+
survive the scrub. No erasure suppression is written, so a record the source restores under the same key loads
|
|
295
|
+
again as a new row. A legal hold suspends the scrub. An archived Odoo record is never an orphan.
|
|
228
296
|
|
|
229
297
|
### The destination's tenant is ENGINE-SUPPLIED, and the shape is not negotiable
|
|
230
298
|
|
|
@@ -268,6 +336,17 @@ last batch. Failed loads retain the previous checkpoint for retry. Identifiable
|
|
|
268
336
|
remain protected; an unreadable source identity skips orphan reconciliation for the pass,
|
|
269
337
|
including `REPORT`. Check `reconciliationStatus` as well as `loadStatus`.
|
|
270
338
|
|
|
339
|
+
A record whose value its local field cannot be stored as is a **rejected row**, not a failed run.
|
|
340
|
+
Examples: a non-numeric string mapped onto a `z.number()` field; onto a `z.date()`, anything but an
|
|
341
|
+
ISO date the calendar has (`2026-02-30` is refused, never stored as 2 March); onto a `z.boolean()`,
|
|
342
|
+
anything but a boolean, the numbers `1`/`0` or the words `true`/`false`/`1`/`0`/`yes`/`no`; onto a
|
|
343
|
+
`z.string()`, an array or an object (an Odoo many2one mapped as a plain field). The rejection names
|
|
344
|
+
the field, never the value, and the rest of the pass loads. Each kind accepts a defined set, the same
|
|
345
|
+
on MongoDB and PostgreSQL, so spellings both stores happen to read but no source serves (a hex
|
|
346
|
+
number, a lower-case ISO date) are refused too. A date or time served without an offset is stored as
|
|
347
|
+
UTC, and a fraction of a second is kept to milliseconds. Fix a rejection with a
|
|
348
|
+
coercion in the mapping, or map the field as a string, or leave it out.
|
|
349
|
+
|
|
271
350
|
Manual and scheduled runs share exclusive ownership per application and pipeline, including
|
|
272
351
|
across backend instances. A competing trigger reports `already-running` before reading the
|
|
273
352
|
pipeline checkpoint. Ownership covers destination writes, run state, membership history and
|
|
@@ -339,18 +418,27 @@ partitionKeyLocalField: 'odooCompanyRef',
|
|
|
339
418
|
```
|
|
340
419
|
|
|
341
420
|
Both must exist on the destination schema, be STRINGS, be optional or nullable,
|
|
342
|
-
and be `.excludeFromCreate().excludeFromUpdate()`.
|
|
421
|
+
and be `.excludeFromCreate().excludeFromUpdate()`. Keep the key column a plain
|
|
422
|
+
string: it holds the partition key as text (`"1"` for an Odoo company id, a
|
|
423
|
+
lowercased GUID), and a format, pattern or length rule that rejects that form is
|
|
424
|
+
refused at startup (not checked for a STRING partition codec, whose values vary). Nothing may map onto either —
|
|
343
425
|
the engine stamps them after your mapping, so a mapping entry would be inert.
|
|
344
426
|
Declaring one without the other is refused, and so is declaring them against an
|
|
345
427
|
unpartitioned source.
|
|
346
428
|
|
|
347
429
|
**Why two columns and not one.** The unit is what confines a caller. The remote
|
|
348
|
-
key
|
|
349
|
-
|
|
350
|
-
nothing about it says
|
|
351
|
-
stored
|
|
352
|
-
|
|
353
|
-
|
|
430
|
+
key is the partition that unit was derived from, and the derivation changes: when
|
|
431
|
+
an operator reassigns or un-assigns a partition, a previously-loaded row still
|
|
432
|
+
carries a valid unit id, and nothing about it says which partition it belongs to.
|
|
433
|
+
The stored key does, and the engine reads it on every query: a caller sees only
|
|
434
|
+
rows whose key is assigned to a unit, or unset (shared). So the rows loaded before
|
|
435
|
+
a partition was un-assigned, which keep their old unit because nothing re-stamps a
|
|
436
|
+
row that is no longer loaded, are read by nobody — organization-wide callers
|
|
437
|
+
included — until the partition is assigned again, when they reappear unchanged.
|
|
438
|
+
|
|
439
|
+
The key column is not what protects those rows from your `orphanPolicy`. A run
|
|
440
|
+
still extracts them and counts them as present, as the next section says, so an
|
|
441
|
+
un-assignment never deletes or scrubs them.
|
|
354
442
|
|
|
355
443
|
### What a run does with an unmapped partition
|
|
356
444
|
|
|
@@ -384,6 +472,21 @@ DELETIONS); OData v2 and REST sources run full passes.
|
|
|
384
472
|
Read `references/incremental-extraction.md` before declaring it: the lookback, what re-reads the
|
|
385
473
|
source, and how to read a run.
|
|
386
474
|
|
|
475
|
+
## When the source announces what changed: requested keys
|
|
476
|
+
|
|
477
|
+
If the system of record can NOTIFY — an Odoo automated action posting on write, a Dataverse webhook — receive
|
|
478
|
+
the notification with an inbound handler (skill `inbound-channels`) and have it call
|
|
479
|
+
`ctx.pipelines.requestPipelineKeys(resourceType, remoteKeys)`. The pipeline then re-reads exactly those records
|
|
480
|
+
from the source and loads them through itself, within seconds. The handler never writes the pipeline's rows,
|
|
481
|
+
and nothing in the notification becomes a value: the source is asked, and its answer loads.
|
|
482
|
+
|
|
483
|
+
Nothing requested is dropped: the keys are recorded first, and every run of the pipeline — the scheduled one
|
|
484
|
+
included — re-reads waiting keys before its own pass; a run that ends with a request that arrived while it held the
|
|
485
|
+
pipeline asks for a keyed run itself. A keyed read the source refuses never stops the pass that follows it. A requested record the source no longer serves is reported `missing` and never deleted locally.
|
|
486
|
+
It supplements the schedule, never replaces it. An INBOUND or a BIDIRECTIONAL pipeline on Odoo (one key field) or
|
|
487
|
+
OData v4 takes requested keys; startup refuses a handler naming any other. On a BIDIRECTIONAL pipeline a re-read record
|
|
488
|
+
is decided exactly as a pass decides it, conflicts included. Read `references/requested-keys.md`.
|
|
489
|
+
|
|
387
490
|
## Rate budgets: two per call, and only a pipeline waits
|
|
388
491
|
|
|
389
492
|
Every remote call spends TWO local budgets and is sent only if both have room. The instance budget and a
|
|
@@ -434,9 +537,11 @@ Odoo's own list views — while a subject erasure searches archived records too.
|
|
|
434
537
|
|
|
435
538
|
## When a copied person is erased: the suppression list
|
|
436
539
|
|
|
437
|
-
|
|
438
|
-
remote record — a keyed hash, never the key — and every later pass, full or incremental,
|
|
439
|
-
under it and counts the skip as `suppressedRows`.
|
|
540
|
+
Only an `OWNED_COPY` is suppressed. An erasure that scrubs or deletes a row of an owned copy records a
|
|
541
|
+
SUPPRESSION of its remote record — a keyed hash, never the key — and every later pass, full or incremental,
|
|
542
|
+
loads nothing under it and counts the skip as `suppressedRows`. A copy that follows its system of record is
|
|
543
|
+
left to the source by an erasure, so nothing is suppressed: when the source erases the record, the copy's
|
|
544
|
+
orphan policy removes it. It is released only by a completed full pass over the
|
|
440
545
|
whole remote entity (no `sourceFilter`) that no longer sees the record. Read
|
|
441
546
|
`references/erasure-suppression.md`, including the one refusal: a changed `encryptionKey` stops runs.
|
|
442
547
|
|
|
@@ -499,9 +604,22 @@ now: a CREATE the first time (its answered key is written to `remoteKeyLocalFiel
|
|
|
499
604
|
The ownership rules reverse: the mapped fields are the application's and stay writable, the remote key is
|
|
500
605
|
an optional engine-written string. Only the owner organization's rows are ever sent, a local delete never
|
|
501
606
|
is, and an unknown-outcome CREATE waits for an operator rather than risk a duplicate. It needs
|
|
502
|
-
`writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only
|
|
503
|
-
|
|
504
|
-
`references/outbound-pipelines.md`.
|
|
607
|
+
`writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, and `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only. It may
|
|
608
|
+
send personal data: the system of record answers requests about what it receives (leave `subjectRights` out), and
|
|
609
|
+
your local rows are erased as their resource declares. Read `references/outbound-pipelines.md`.
|
|
610
|
+
|
|
611
|
+
## When both sides edit the records: `direction: BIDIRECTIONAL`
|
|
612
|
+
|
|
613
|
+
When a record is edited in the application AND in the system of record, declare ONE pipeline with
|
|
614
|
+
`direction: ExternalDataPipelineDirection.BIDIRECTIONAL`.
|
|
615
|
+
- Each mapped field says who owns it (`owner`): `REMOTE` is loaded, `LOCAL` is sent, `BOTH` is loaded and sent.
|
|
616
|
+
- A run loads, then sends. Only a `BOTH` field changed on both sides since they last agreed is a conflict, and
|
|
617
|
+
`conflictPolicy` decides it: `REMOTE_WINS`, `LOCAL_WINS`, or `REFUSE_AND_REPORT` (the default). A refused row
|
|
618
|
+
waits, listed on every run, until an operator chooses a side through the admin door.
|
|
619
|
+
- The vendor must version its rows (Odoo `write_date`, an OData v4 entity tag). Startup refuses one that does
|
|
620
|
+
not, and `population` must be `OPEN`.
|
|
621
|
+
|
|
622
|
+
Read `references/bidirectional-pipelines.md`.
|
|
505
623
|
|
|
506
624
|
## Worked Example
|
|
507
625
|
|
|
@@ -596,12 +714,40 @@ export enum ExternalDataDestinationPopulation {
|
|
|
596
714
|
* seam's mapping is exhaustive and compile-forced, so a new member on either side reddens P-2).
|
|
597
715
|
*/
|
|
598
716
|
export enum ExternalDataOrphanPolicy {
|
|
599
|
-
/**
|
|
717
|
+
/**
|
|
718
|
+
* Hard-delete the orphan row through the row's declared parent-delete lifecycle (#2575): a legal hold on the row keeps
|
|
719
|
+
* it; a `REFUSE_WHILE_CHILDREN_EXIST` edge still naming it, or a held descendant, refuses the delete (reported, retried
|
|
720
|
+
* next pass); otherwise its file fields are released, every enabled `onParentDelete` edge runs as it declares (children
|
|
721
|
+
* deleted, scrubbed or deferred), and its RAG chunks and case corrections go with it. Not run: the resource's operation
|
|
722
|
+
* hooks. Opt-in, and one of the two answers a copy that follows its system of record and copies personal data must
|
|
723
|
+
* declare (#2560).
|
|
724
|
+
*/
|
|
600
725
|
DELETE = 'delete',
|
|
601
726
|
/** Mark the row deprecated and keep it; a re-appearing remote key REVIVES it (v3.1 §4). Opt-in. */
|
|
602
727
|
DEPRECATE = 'deprecate',
|
|
603
728
|
/** Touch nothing; surface the diff in the run ledger. The DEFAULT — least surprise. */
|
|
604
729
|
REPORT = 'report',
|
|
730
|
+
/**
|
|
731
|
+
* Erase the orphan's personal data in place and keep the row (#2117). A record ABSENT FROM A COMPLETE PASS leaves the
|
|
732
|
+
* copy nothing of what the system held about a person, while rows that reference the copy (the work done for a client)
|
|
733
|
+
* keep pointing at it.
|
|
734
|
+
*
|
|
735
|
+
* "Absent from a complete pass" is wider than "deleted at the source": a record that leaves the pipeline's filtered or
|
|
736
|
+
* permitted view (a source filter it no longer matches, a service account that lost the right to read it) is scrubbed
|
|
737
|
+
* the same way, and the scrub cannot be undone.
|
|
738
|
+
*
|
|
739
|
+
* The row goes through the same scrub chokepoint the erasure door uses (`impersonalizeRowsInPlace`): its
|
|
740
|
+
* `.impersonalizeWith()` fields are scrubbed, and it is marked RETAINED (hidden from ordinary reads, immutable). Unlike
|
|
741
|
+
* an erasure, NO erasure suppression is written: nobody asked for this record to be forgotten, it only stopped being
|
|
742
|
+
* listed. So a record the source lists again loads as a NEW row (the destination's remote-key unique index is
|
|
743
|
+
* retention-scoped, so the retained row does not block it), and rows that referenced the scrubbed copy keep pointing at
|
|
744
|
+
* the scrubbed copy, not at the new one. A legal hold suspends the scrub, as it suspends the DELETE.
|
|
745
|
+
*
|
|
746
|
+
* Requires the destination to opt into the scrub door (`retentionPolicy: RETAIN_AND_IMPERSONALIZE`) and a CLOSED
|
|
747
|
+
* population; the factory refuses it otherwise. An archived Odoo record is never an orphan (see
|
|
748
|
+
* `ExternalDataArchivedRecordTreatment`), so archiving a record does not scrub its copy. Opt-in.
|
|
749
|
+
*/
|
|
750
|
+
IMPERSONALIZE = 'impersonalize',
|
|
605
751
|
}
|
|
606
752
|
|
|
607
753
|
/**
|
|
@@ -1025,6 +1171,21 @@ export const ExternalDataFieldMappingEntrySchema = z.discriminatedUnion('kind',
|
|
|
1025
1171
|
required: z.boolean().default(false),
|
|
1026
1172
|
/** Which side owns the field — BIDIRECTIONAL pipelines only (#1723). Absent = REMOTE. */
|
|
1027
1173
|
owner: z.enum(ExternalDataFieldOwner).optional(),
|
|
1174
|
+
/**
|
|
1175
|
+
* #2566 — the field's name in a WRITE member that spells it differently from the list the pipeline extracts through
|
|
1176
|
+
* (REST_JSON only). NetSuite's SuiteQL answers `companyname`, while its record service — which a create or an update
|
|
1177
|
+
* is sent to — names the same field `companyName`; sent under the list's name, the field is unknown there. Each key
|
|
1178
|
+
* names the field in that member; a member not named here uses `remoteField`. The same answer a read-through binding
|
|
1179
|
+
* gives in `fieldMappings[].remoteFieldByMember` (#2553).
|
|
1180
|
+
*
|
|
1181
|
+
* OUTBOUND pipelines only: nothing else sends a body (an INBOUND pipeline writes nothing, and a BIDIRECTIONAL one needs
|
|
1182
|
+
* a row-version read that only Odoo and OData serve). Refused on Odoo and OData, whose members share one wire shape,
|
|
1183
|
+
* and for a member the binding does not declare.
|
|
1184
|
+
*/
|
|
1185
|
+
remoteFieldByMember: z.strictObject({
|
|
1186
|
+
create: z.string().trim().min(1).optional(),
|
|
1187
|
+
update: z.string().trim().min(1).optional(),
|
|
1188
|
+
}).optional(),
|
|
1028
1189
|
}),
|
|
1029
1190
|
z.strictObject({
|
|
1030
1191
|
kind: z.literal(ExternalDataMappingEntryKind.CONSTANT),
|
|
@@ -1120,7 +1281,7 @@ export enum ExternalDataIncrementalExtractionMode {
|
|
|
1120
1281
|
* and the next incremental pass reads the whole source again. The run summary says it did.
|
|
1121
1282
|
*/
|
|
1122
1283
|
export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminatedUnion('mode', [
|
|
1123
|
-
z.
|
|
1284
|
+
z.strictObject({
|
|
1124
1285
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE),
|
|
1125
1286
|
/**
|
|
1126
1287
|
* When FULL passes run (cron). The only deletion detector, so required. A full pass that takes
|
|
@@ -1145,7 +1306,7 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
|
|
|
1145
1306
|
* re-read by the next pass. Changing `modifiedAtRemoteField` starts the track over (the stored watermark
|
|
1146
1307
|
* names the property it was read on).
|
|
1147
1308
|
*/
|
|
1148
|
-
z.
|
|
1309
|
+
z.strictObject({
|
|
1149
1310
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT),
|
|
1150
1311
|
fullPassCron: z.string().trim().min(1),
|
|
1151
1312
|
/** The entity's modified-at property (`Edm.DateTimeOffset`), by its REMOTE name. */
|
|
@@ -1162,18 +1323,26 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
|
|
|
1162
1323
|
*
|
|
1163
1324
|
* Refused at declaration: a `sourceFilter` (Dataverse refuses `$filter`, `$orderby`, `$expand` and `$top`
|
|
1164
1325
|
* with change tracking) and a composite key (a deleted entity names one id). A delta link the service no
|
|
1165
|
-
* longer honours
|
|
1166
|
-
*
|
|
1326
|
+
* longer honours resets the track and the same run falls back to a FULL pass; the run summary says so. "No longer
|
|
1327
|
+
* honours" is `410 Gone` or `404 Not Found` — the two answers the protocol lets a service give for an expired URL —
|
|
1328
|
+
* or one of the vendor's own error codes for an expired change position, declared by its system-of-record facet as
|
|
1329
|
+
* `odataExpiredChangePositionErrorCodes` (#2104 review F6). That pass finds most of what the expired link would have reported, not all of it: when it completes it
|
|
1330
|
+
* orphans every row it did not see, so a row deleted before the pass read its key is found, but one deleted after
|
|
1331
|
+
* both the pass read it and the old link's last read, and before the next incremental run opens a new link, is
|
|
1332
|
+
* found only by the next full pass.
|
|
1167
1333
|
* spec-cite: Microsoft Learn, "Use change tracking to synchronize data with external systems"
|
|
1168
1334
|
* (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/use-change-tracking-synchronize-data-external-systems),
|
|
1169
1335
|
* "Query options not supported in Change Tracking Web API request" — "System query options $filter,
|
|
1170
1336
|
* $orderby, $expand, and $top aren't supported when you use the Prefer: odata.track-changes header".
|
|
1171
1337
|
* spec-cite: OData Version 4.01 Part 1: Protocol §9.2.4 — "410 Gone indicates that the requested resource is
|
|
1172
1338
|
* no longer available. This can happen if a client has waited too long to follow a delta link".
|
|
1339
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.2 — "If a client subsequently requests the advertised resource and
|
|
1340
|
+
* the URL has expired, then the service SHOULD respond with 410 Gone. If this is not feasible, the service MUST respond
|
|
1341
|
+
* with 404 Not Found."
|
|
1173
1342
|
*
|
|
1174
1343
|
* No lookback: a delta link is the service's own position, not a clock.
|
|
1175
1344
|
*/
|
|
1176
|
-
z.
|
|
1345
|
+
z.strictObject({
|
|
1177
1346
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK),
|
|
1178
1347
|
fullPassCron: z.string().trim().min(1),
|
|
1179
1348
|
}),
|
|
@@ -1195,7 +1364,7 @@ export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT: Readonly<Record<ExternalDat
|
|
|
1195
1364
|
### Origin Package: `@wildo-ai/saas-models`
|
|
1196
1365
|
|
|
1197
1366
|
```typescript
|
|
1198
|
-
export const ExternalDataPipelineDeclarationSchema = z.
|
|
1367
|
+
export const ExternalDataPipelineDeclarationSchema = z.strictObject({
|
|
1199
1368
|
/**
|
|
1200
1369
|
* Which way rows travel — see {@link ExternalDataPipelineDirection}. `INBOUND` when omitted.
|
|
1201
1370
|
*
|
|
@@ -1210,7 +1379,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1210
1379
|
|
|
1211
1380
|
/**
|
|
1212
1381
|
* The source half — the SAME binding declaration the VIRTUAL mode uses (the system of record it
|
|
1213
|
-
* reads, entity, dialect, key fields + codecs, remote-call semantics,
|
|
1382
|
+
* reads, entity, dialect, key fields + codecs, remote-call semantics, subject-rights posture).
|
|
1214
1383
|
*
|
|
1215
1384
|
* Every source is a SYSTEM OF RECORD: a deployment the OPERATOR runs, read with the application's
|
|
1216
1385
|
* own service identity, with ONE owner organization. There is no per-tenant variant to confine
|
|
@@ -1245,9 +1414,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1245
1414
|
* On an OUTBOUND pipeline (#1690) it is empty until the row is first sent: the engine writes the key the system of
|
|
1246
1415
|
* record answers the create with, exactly once, and then updates the remote row it names. It must therefore accept
|
|
1247
1416
|
* absence, and it is still excluded from create and update — a caller that could write it could point a local row at
|
|
1248
|
-
* any remote record. It must be `.isUnique()` (global, sparse — the default)
|
|
1249
|
-
*
|
|
1250
|
-
*
|
|
1417
|
+
* any remote record. It must be `.isUnique()` (global, sparse — the default): one remote record, one local row,
|
|
1418
|
+
* enforced by the store on every path that writes the key, while the rows not yet sent stay outside the index on both
|
|
1419
|
+
* stores, whether their key is absent or null (#2582). Declare it `.optional()`, so "no key yet" has one
|
|
1420
|
+
* representation. No business key is required there: nothing upserts on it.
|
|
1251
1421
|
*/
|
|
1252
1422
|
remoteKeyLocalField: z.string().trim().min(1),
|
|
1253
1423
|
|
|
@@ -1268,13 +1438,20 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1268
1438
|
* subsidiary to their own company's rows. Declare the destination narrowable on this field.
|
|
1269
1439
|
*
|
|
1270
1440
|
* `partitionKeyLocalField` carries the REMOTE key verbatim — Odoo's `company_id`, NetSuite's
|
|
1271
|
-
* `subsidiary`. It
|
|
1272
|
-
*
|
|
1273
|
-
*
|
|
1274
|
-
*
|
|
1275
|
-
*
|
|
1276
|
-
*
|
|
1277
|
-
*
|
|
1441
|
+
* `subsidiary`. It is the FACT the unit was derived from: the unit is a function of this key and
|
|
1442
|
+
* the assignment map at load time, and the map changes. Keep only the unit and, once a partition
|
|
1443
|
+
* is reassigned or unassigned, nothing on the row says which partition it belongs to — the unit
|
|
1444
|
+
* id still resolves, and says nothing about the edge that produced it. With the key stored, a
|
|
1445
|
+
* row's partition is answered locally: shown to people, queryable, and READ ON EVERY CALLER'S QUERY
|
|
1446
|
+
* (#2479): a non-exempt caller — organization-wide included — sees only rows whose stored key is
|
|
1447
|
+
* assigned to a unit, or unset (shared). That is what keeps the rows loaded before a partition was
|
|
1448
|
+
* unassigned from being read through the unit they still carry: nothing re-stamps a row that is no
|
|
1449
|
+
* longer loaded, so the unit alone would keep confining them to the unit the operator withdrew.
|
|
1450
|
+
*
|
|
1451
|
+
* It is NOT what keeps an unassignment from becoming a mass delete, and no orphan walk reads it
|
|
1452
|
+
* (#2478). That guard is in the transform: a pipeline extracts every row, unassigned partitions
|
|
1453
|
+
* included, and a row whose partition has no unit is left out of the load while its business key
|
|
1454
|
+
* is counted as OBSERVED, so a complete pass never sees it as gone.
|
|
1278
1455
|
*
|
|
1279
1456
|
* Both are ENGINE-WRITTEN: the transform stamps them from the assignment map, so a mapping entry
|
|
1280
1457
|
* targeting either is refused, as is a caller write (the factory requires both
|
|
@@ -1358,6 +1535,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1358
1535
|
* It bounds extraction and load together: each page is loaded before the next is read (#1689), so a
|
|
1359
1536
|
* run finishes after the page it was working on, by at most one page's extraction and load.
|
|
1360
1537
|
*
|
|
1538
|
+
* A BIDIRECTIONAL run's two halves share it (#2107): the loading half starts no page after two thirds, and the sending
|
|
1539
|
+
* half runs until the whole deadline, so a long inbound pass never leaves the sending half no time (it keeps about the
|
|
1540
|
+
* last third). A keyed run, which sends nothing, reads to the whole deadline.
|
|
1541
|
+
*
|
|
1361
1542
|
* Fifteen minutes by default: well inside an hourly `scheduleCron`, and long enough that a pass of the
|
|
1362
1543
|
* default `maxRowsPerRun` completes at even a small binding ceiling. Six hours at most — a run that
|
|
1363
1544
|
* needs longer is a backfill, and resuming across runs is what the cursor is for.
|
|
@@ -1379,6 +1560,8 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1379
1560
|
- `references/odata-v2-sources.md` — reading an OData v2 service (`ODATA_V2`): declaring it, why the
|
|
1380
1561
|
engine reads the service's `$metadata`, the values it decodes and refuses, how a pipeline walks it by
|
|
1381
1562
|
key rather than by `__next`, and what it cannot do.
|
|
1563
|
+
- `references/framework-system-of-record-capabilities-api.md` — what the engine can do over a binding (sort, writes,
|
|
1564
|
+
partitions, incremental modes, actions), asked instead of restated per vendor.
|
|
1382
1565
|
- `references/system-of-record-actions.md` — running a declared ERP action (Odoo `action_post`, an
|
|
1383
1566
|
OData action): the declaration, who may run it on which record, its one HTTP door, and its codes.
|
|
1384
1567
|
- `references/lane-selection.md` — the choice in Step 1 at more depth, including what each lane
|
|
@@ -1389,14 +1572,17 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1389
1572
|
its mapping, read what each one last did (`cursor`, `loadStatus`) and its health, list its run
|
|
1390
1573
|
history with the rows each run refused (`GET …/runs`), and reset a pipeline whose run keeps
|
|
1391
1574
|
refusing its stored state (`POST …/reset`).
|
|
1575
|
+
- `references/requested-keys.md` — a system of record announcing which records changed: the inbound handler's
|
|
1576
|
+
`ctx.pipelines.requestPipelineKeys`, the keyed run, why a busy pipeline drops nothing, what it never deletes,
|
|
1577
|
+
and which pipelines can take it.
|
|
1392
1578
|
- `references/incremental-extraction.md` — reading only what changed: the two tracks, the Odoo
|
|
1393
1579
|
`write_date` watermark and its lookback, the fingerprint that re-reads the source, and why a
|
|
1394
1580
|
full-pass cadence is required.
|
|
1395
1581
|
- `references/rate-budgets-and-pacing.md` — the instance budget and the binding ceiling, how a
|
|
1396
1582
|
pipeline paces against them, `maxRunDurationMs`, how to size the numbers, and the measured load
|
|
1397
1583
|
throughput a pass costs the store.
|
|
1398
|
-
- `references/erasure-suppression.md` — why an erased
|
|
1399
|
-
when a suppression is released, and the key-rotation refusal.
|
|
1584
|
+
- `references/erasure-suppression.md` — why an erased row of an `OWNED_COPY` is not re-imported (a following copy
|
|
1585
|
+
writes no suppression), what a run counts, when a suppression is released, and the key-rotation refusal.
|
|
1400
1586
|
- `references/declared-expressions.md` — `ENUM_MAP`, `CONCATENATION`, `ARITHMETIC`, `CONDITIONAL`: a
|
|
1401
1587
|
local value derived from remote fields, what startup checks, why there is no transform function, and
|
|
1402
1588
|
how an expression edit reaches rows an incremental pass would not re-read.
|
|
@@ -1412,6 +1598,9 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1412
1598
|
- `references/outbound-pipelines.md` — `direction: OUTBOUND`: sending the application's own rows to a
|
|
1413
1599
|
system of record — the declaration, the reversed field ownership, what each pass sends and never sends,
|
|
1414
1600
|
partition placement, the unknown-outcome create that waits for an operator, and what a pass reports.
|
|
1601
|
+
- `references/bidirectional-pipelines.md` — `direction: BIDIRECTIONAL`: one resource edited on both sides —
|
|
1602
|
+
field ownership, the vendor's row version, what a run loads and sends, the three conflict policies, the
|
|
1603
|
+
operator's door for a refused conflict, what is audited and reported, and the stated limits.
|
|
1415
1604
|
- `references/provenance-cue.md` — the "synced from ⟨instance⟩ · as of ⟨pass⟩" note on pipeline-written
|
|
1416
1605
|
fields: which fields carry it, what "as of" means, the read surface and instance label it needs, and
|
|
1417
1606
|
who may read it.
|
|
@@ -1419,7 +1608,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1419
1608
|
## Verification
|
|
1420
1609
|
|
|
1421
1610
|
- [ ] The resource declares exactly one lane, not both.
|
|
1422
|
-
- [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `
|
|
1611
|
+
- [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `subjectRights` is left out unless the rows hold no subject data or each erasure is forwarded.
|
|
1423
1612
|
- [ ] A binding whose rows hold personal data names `purposeRefs` that exist in
|
|
1424
1613
|
`operatorComplianceIdentity.lawfulBases`.
|
|
1425
1614
|
- [ ] An instance whose resources hold personal data declares `personalDataOrigin`.
|
|
@@ -1431,7 +1620,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1431
1620
|
custom operation named in `actions.<name>.operation`, borrowing `UPDATE`, with
|
|
1432
1621
|
`idempotencyKey: REQUIRED`, whose implementation calls `utils.systemOfRecordActions.run(...)`; no
|
|
1433
1622
|
code reaches the ERP any other way.
|
|
1434
|
-
- [ ] Either lane: a binding declaring `
|
|
1623
|
+
- [ ] Either lane: a binding declaring `subjectRights: NO_SUBJECT_DATA` brings no field that declares
|
|
1435
1624
|
`.dataCategories()` (read-through: any field; pipeline: any mapped field).
|
|
1436
1625
|
- [ ] Virtual writes: a field landing on the partition field is excluded from create and update.
|
|
1437
1626
|
- [ ] Virtual writes: the client handles `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` by reading the row,
|
|
@@ -1447,8 +1636,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1447
1636
|
`remoteCallSemantics.maxRequestsPerMinute` strictly below it, and `maxRunDurationMs` fits the
|
|
1448
1637
|
pipeline's `scheduleCron` interval.
|
|
1449
1638
|
- [ ] Pipeline: verify first and last batch keys remain present across a resumed pass; then remove a source row and verify the configured orphan policy. Check reconciliationStatus for skipped reconciliation and loadStatus for failed writes.
|
|
1450
|
-
- [ ]
|
|
1451
|
-
back as a live row and the run reports `suppressedRows: 1`.
|
|
1639
|
+
- [ ] `OWNED_COPY` pipeline holding personal data: erase one copied row, run a full pass, and confirm the
|
|
1640
|
+
row is not back as a live row and the run reports `suppressedRows: 1`.
|
|
1641
|
+
- [ ] Following copy holding personal data: remove its record at the source, run a full pass, and confirm the
|
|
1642
|
+
copy keeps none of the person's data (gone under `DELETE`, scrubbed under `IMPERSONALIZE`).
|
|
1452
1643
|
- [ ] REST_JSON pipeline source: the binding's `list` statement declares `keyset` on its single key
|
|
1453
1644
|
field; a SOQL one declares `cursorPath`, a SuiteQL one `pagingParams` with
|
|
1454
1645
|
`placement: 'query-string'`.
|
|
@@ -1461,11 +1652,19 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1461
1652
|
code); each `CONCATENATION` targets a string field, each `ARITHMETIC` a number field, and a
|
|
1462
1653
|
currency conversion uses a declared `factor`.
|
|
1463
1654
|
- [ ] OUTBOUND pipeline: `writableVerbs` includes `CREATE`; the mapped fields are caller-writable;
|
|
1464
|
-
`remoteKeyLocalField` is an optional
|
|
1655
|
+
`remoteKeyLocalField` is an optional `.isUnique()` string excluded from create and update; no sent field declares
|
|
1465
1656
|
`.dataCategories()`; on a partitioned instance `partitionUnitLocalField` names the row's unit.
|
|
1466
1657
|
- [ ] OUTBOUND pipeline: create a row, run a pass, and confirm the row gained its remote key and the
|
|
1467
1658
|
record exists remotely; edit it, run again, and confirm exactly one update; a row of another
|
|
1468
1659
|
organization is never sent (`droppedOtherOrganization`).
|
|
1660
|
+
- [ ] BIDIRECTIONAL pipeline: every mapped entry that is not Odoo's-only declares `owner`; `population` is
|
|
1661
|
+
`OPEN`; the vendor facet declares `rowVersionField` (Odoo or OData v4); `conflictPolicy` is chosen on purpose.
|
|
1662
|
+
- [ ] BIDIRECTIONAL pipeline: edit a `BOTH` field on each side, run, and confirm the declared policy's outcome
|
|
1663
|
+
in the run's `conflicts` — and for `REFUSE_AND_REPORT`, that neither side's value moved.
|
|
1664
|
+
- [ ] A handler asking a pipeline to re-read (`requestPipelineKeys`) lists that resource in its
|
|
1665
|
+
`pipelineKeyRequests`, and the pipeline is INBOUND on Odoo or OData v4; the pipeline keeps its
|
|
1666
|
+
`scheduleCron`. Send a notification naming one changed record and confirm the run history shows a
|
|
1667
|
+
`keyed` run with `drainedRequestedKeys: 1` and only that row changed.
|
|
1469
1668
|
- [ ] The application starts. Every rule above is checked at startup, by name.
|
|
1470
1669
|
|
|
1471
1670
|
### Grep invariants
|
|
@@ -1495,6 +1694,12 @@ rg -n 'maxRequestsPerMinute' wildo.saas.config.ts shared-lib/src
|
|
|
1495
1694
|
# OUTBOUND pipelines — each mapped field must be caller-writable and its remote key an optional string.
|
|
1496
1695
|
rg -B2 -A12 'ExternalDataPipelineDirection.OUTBOUND' shared-lib/src --glob '*.resources-config.ts'
|
|
1497
1696
|
|
|
1697
|
+
# BIDIRECTIONAL pipelines — each owner declared, OPEN population, a conflict policy chosen on purpose.
|
|
1698
|
+
rg -B2 -A16 'ExternalDataPipelineDirection.BIDIRECTIONAL' shared-lib/src --glob '*.resources-config.ts'
|
|
1699
|
+
|
|
1700
|
+
# Requested keys — every handler calling requestPipelineKeys declares the resource in pipelineKeyRequests.
|
|
1701
|
+
rg -l 'requestPipelineKeys' backend-api/src/modules | xargs rg --files-without-match 'pipelineKeyRequests'
|
|
1702
|
+
|
|
1498
1703
|
# Bulk write operations on a virtual resource — refused; a remote bulk write has no atomicity.
|
|
1499
1704
|
rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOperation'
|
|
1500
1705
|
```
|
|
@@ -1503,6 +1708,8 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1503
1708
|
|
|
1504
1709
|
| Rationalization | Reality |
|
|
1505
1710
|
|---|---|
|
|
1711
|
+
| "The webhook body has the new values, so the handler can write them straight into the synced resource." | The synced fields are the pipeline's to write, and a notification body is not the system of record — it can be stale, partial, forged or replayed. Name the records with `ctx.pipelines.requestPipelineKeys`; the pipeline re-reads them from the source. |
|
|
1712
|
+
| "Notifications keep it fresh, so the schedule can go." | A vendor drops notifications, and a keyed read never finds a deletion. Keep `scheduleCron`: requested keys make a pipeline fresher, not complete. |
|
|
1506
1713
|
| "Virtual is cleaner — no copy to keep in sync." | Cleaner until the first requirement it cannot meet. A virtual resource can hold no files, feed no retrieval corpus, and carry no local column. Those are not edge cases; they are the second and third things most applications ask for. |
|
|
1507
1714
|
| "I'll mark the synced fields writable and let users fix bad data." | Then the next sync overwrites their edit and nobody knows why. Remote-authoritative fields are read-only *because* the remote system wins; if users must edit, that field belongs in the local half, not the mapping. |
|
|
1508
1715
|
| "I'll sync everything from the remote entity, just in case." | Every mapped field is personal data you now store, retain and must erase. Map what the application uses. |
|
|
@@ -1527,7 +1734,9 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1527
1734
|
- `population: CLOSED` alongside a create-shaped custom operation — refused at startup, and the
|
|
1528
1735
|
message names the operation.
|
|
1529
1736
|
- A run reporting rejected rows after the source added a selection value — an `ENUM_MAP` that does not
|
|
1530
|
-
map it
|
|
1737
|
+
map it, or a plain mapping onto an enum field that now receives a value outside the field's members
|
|
1738
|
+
(such a row is rejected, never loaded with a value the field refuses); catch it with the
|
|
1739
|
+
declared-expressions grep above and map the code.
|
|
1531
1740
|
- Concurrent pipeline execution across application instances — single-instance execution is required until destination mutations have exclusive ownership. Checkpoint conflicts alone do not fence deletion.
|
|
1532
1741
|
- A binding whose `system` was copied from another resource without checking the instance is the one
|
|
1533
1742
|
you meant — two instances of one vendor differ only by that name.
|
|
@@ -1548,8 +1757,13 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1548
1757
|
(`suppressedRows` above zero is expected; never delete a suppression to "fix" it — that re-imports.)
|
|
1549
1758
|
- An OUTBOUND pipeline whose runs show `waiting.awaitingOperator` above zero — creates of unknown outcome that
|
|
1550
1759
|
nobody has answered and that are never sent again on their own; look each up in the system of record and answer
|
|
1551
|
-
it through `POST /internal/admin/external-data/outbound-changes/resolve`.
|
|
1552
|
-
|
|
1760
|
+
it through `POST /internal/admin/external-data/outbound-changes/resolve`. One whose `lastOutcomeCode` is
|
|
1761
|
+
`remote-key-held-by-another-row` first needs the wrong holder unlinked (`…/outbound-changes/unlink`; see
|
|
1762
|
+
`references/outbound-pipelines.md`). Catch the declarations with the OUTBOUND grep above.
|
|
1763
|
+
- A BIDIRECTIONAL pipeline whose runs keep reporting `conflicts.refused` above zero — rows edited on both
|
|
1764
|
+
sides that nobody has chosen a side for; they are neither loaded over nor sent until someone does, through
|
|
1765
|
+
`POST /internal/admin/external-data/outbound-changes/conflicts/resolve`. Catch the declarations with the
|
|
1766
|
+
BIDIRECTIONAL grep above.
|
|
1553
1767
|
- A `STANDALONE` primary-scope anchor on a virtual resource. It answers 403 `parent_scope_denied` to
|
|
1554
1768
|
an organization owner, because the execution context's organization id comes from the URL and a
|
|
1555
1769
|
standalone resource is not routed under its scope parent — measured, not inferred.
|
|
@@ -1560,3 +1774,5 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1560
1774
|
- `resource-schema-authoring` — the field declarations a destination schema needs.
|
|
1561
1775
|
- `resource-rag-source-fields` — indexing pipeline-fed text for retrieval (a pipeline lane only).
|
|
1562
1776
|
- `application-database-migrations` — a new destination resource on PostgreSQL owes a migration.
|
|
1777
|
+
- `inbound-channels` — receiving a system of record's change notification, and asking the pipeline to
|
|
1778
|
+
re-read the records it names (`ctx.pipelines`).
|