@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
|
@@ -32,7 +32,8 @@ report carries `passMode` — `full` or `incremental` — and `incrementalTrackR
|
|
|
32
32
|
the incremental track over. `POST …/run` accepts `"passMode": "full"` to run a deletion-detecting pass
|
|
33
33
|
now; without it the run is the kind `scheduleCron` runs. An OUTBOUND pipeline runs `send` passes only — `full` or
|
|
34
34
|
`incremental` is refused for it — and its report carries an `outbound` summary of what was sent, kept, dropped and
|
|
35
|
-
left for an operator (`outbound-pipelines.md`).
|
|
35
|
+
left for an operator (`outbound-pipelines.md`). `"passMode": "keyed"` re-reads now only the records inbound
|
|
36
|
+
deliveries asked for (`requested-keys.md`); a report that drained any carries `requestedKeys`.
|
|
36
37
|
|
|
37
38
|
Three summary fields name rows the source HOLDS that the run deliberately did not load. All are
|
|
38
39
|
still counted as present, so none can reach the orphan policy:
|
|
@@ -75,18 +76,45 @@ A summary carries **`fullPassRestart: extraction-basis-changed`** when that full
|
|
|
75
76
|
because the declaration changed under it (see `incremental-extraction.md`).
|
|
76
77
|
|
|
77
78
|
**`POST …/reset`** is the way past those refusals — a checkpoint with no version, a malformed
|
|
78
|
-
checkpoint, a membership journal that is cyclic, does not match its pass,
|
|
79
|
-
used before its keys were stored one row each — which otherwise repeat on
|
|
79
|
+
checkpoint, a membership journal that is cyclic, does not match its pass, holds fewer key rows than its segments
|
|
80
|
+
count, or was recorded in the format used before its keys were stored one row each — which otherwise repeat on
|
|
80
81
|
every scheduled tick. Body: `{ "resourceType": "…", "mode": "restart-pass" | "full-resync", "reason":
|
|
81
82
|
"…", "operator": "…" }`. `restart-pass` discards the full pass in flight (cursor, checkpoint, membership
|
|
82
83
|
journal) and the next full run starts over; `full-resync` also discards the incremental watermark, so
|
|
83
|
-
the next incremental pass re-reads the whole source. `
|
|
84
|
+
the next incremental pass re-reads the whole source. `full-resync` also drops the records inbound deliveries asked the
|
|
85
|
+
pipeline to re-read (`requested-keys.md`) — its whole re-read covers them — which is how a request whose keyed read the
|
|
86
|
+
source keeps refusing is cleared; `restart-pass` keeps them, as it keeps the incremental watermark: a delivery's "this
|
|
87
|
+
record changed" is still true after the full pass's position is gone, and dropping it would leave the change unread
|
|
88
|
+
until a full pass reached the record — on an incremental or unscheduled pipeline, possibly never. `reason` is required. The answer names what was
|
|
84
89
|
discarded, and so does the audit trail (`external_data_pipeline_reset`: pipeline, mode, reason, the
|
|
85
|
-
operator as stated, the discarded pass id, cursor and watermark
|
|
90
|
+
operator as stated, the discarded pass id, cursor — a next link's query string removed — and watermark, the requested
|
|
91
|
+
keys dropped, and an `outcome`). A reset
|
|
92
|
+
writes TWO rows, paired by `resetAttemptId`: `attempted`, written under its lease before it deletes anything (if the
|
|
93
|
+
audit trail refuses that row, or does not confirm it within 15 seconds, the reset is not started and answers 409, and
|
|
94
|
+
still writes a `failed-before-discard` ending row), and one when it ends — `completed`,
|
|
95
|
+
`failed-after-discard` (what the row names is gone and a later step did not finish), `failed-before-discard` (nothing
|
|
96
|
+
changed) or `outcome-unknown` (a commit answer was lost: read the pipeline's state to know). An `attempted` row with no
|
|
97
|
+
ending row means the ending was not recorded, and what it names may already be gone: the audit store refused the ending
|
|
98
|
+
row (the metric `audit_store_failure_total` counts that), the process died part-way, or a refused start's ending row also
|
|
99
|
+
failed to land. An ending row can also appear without its `attempted` row, when the store refused that one. The
|
|
100
|
+
requested-key count is absent when the delete had not landed, because
|
|
101
|
+
those keys still wait. When a SIEM receives the rows, the failures and `outcome-unknown` are failures; a reset row
|
|
102
|
+
carries no tenant, so today no per-organization SIEM receives it.
|
|
103
|
+
Destination rows, erasure
|
|
86
104
|
suppressions and pending references are never touched. The door answers `409` while the pipeline is
|
|
87
105
|
running; retry when the run has finished. You do NOT need it after a declaration change — the run
|
|
88
106
|
restarts the pass itself.
|
|
89
107
|
|
|
108
|
+
**`POST …/erasure-suppressions/reconcile`** (#2082) is the way past the run's refusal on erasure suppressions filed
|
|
109
|
+
under a source identity the pipeline no longer has (409, `external_data_erasure_suppression_identity_mismatch`). Body:
|
|
110
|
+
`{ "resourceType": "…", "action": "carry-over" | "release", "reason": "…", "operator": "…" }`. The decision is this
|
|
111
|
+
pipeline's: `carry-over` keeps it matching the suppressions filed under the old identity; `release` stops it matching
|
|
112
|
+
them, and records still at the source are copied in again. A `release` releases the suppressions themselves only when
|
|
113
|
+
no other registered pipeline still matches that identity or owes a decision about it — the answer's `stillMatchedBy`
|
|
114
|
+
names any that do. A decision is final (see `erasure-suppression.md`). The reason is required and recorded at HIGH
|
|
115
|
+
risk with the identities, the counts and what was released, also when the door fails after deciding. See
|
|
116
|
+
`erasure-suppression.md` for which to choose. 409 while the pipeline is running, and before it first ran.
|
|
117
|
+
|
|
90
118
|
## The run history — what happened across runs, and which rows were refused
|
|
91
119
|
|
|
92
120
|
The listing shows each pipeline's CURRENT state; the history shows what its runs did. Every run leaves one row —
|
|
@@ -114,15 +142,20 @@ reads the door with the application's stored admin secret, so you need not call
|
|
|
114
142
|
**`GET …/runs?resourceType=…&limit=…`** answers one pipeline's runs, most recently STARTED first (20 by default, at
|
|
115
143
|
most 100).
|
|
116
144
|
Each run names its trigger, `passMode`, `passId`, `outcome`, counts (`extractedRows`, `rejectedRows`,
|
|
117
|
-
`submittedEntries`, `suppressedRows`, `pendingReferences`), `durationMs`, `
|
|
118
|
-
|
|
145
|
+
`submittedEntries`, `suppressedRows`, `pendingReferences`), `durationMs`, `leaseGeneration` (the turn the run took on
|
|
146
|
+
the pipeline's lease, increasing run after run; empty for a run that ended before taking it), `seedRunId`, `fullPassRestart`,
|
|
147
|
+
`incrementalTrackReset`, `continuationRestart` (why the pass read again from its start: `expired` — the source forgot
|
|
148
|
+
its next link — or `origin-moved` — the link named a host the instance's base URL no longer points at) — and, for records inbound deliveries asked to re-read, `inboundDeliveryId` (the delivery that
|
|
149
|
+
started a keyed run), `drainedRequestedKeys`, `missingRequestedKeys`, `keptRequestedKeys` (re-read and kept for a later
|
|
150
|
+
run on a two-way pipeline) and `requestedKeyDeliveryIds`. A keyed run is not a
|
|
151
|
+
pass: the pipeline's health ignores it. A failed run also names its **`failureKind`**:
|
|
119
152
|
|
|
120
153
|
| `failureKind` | What to do |
|
|
121
154
|
|---|---|
|
|
122
155
|
| `source-unreachable` (with `unreachableCause`) | Wait, or fix the instance address; the scheduled runs back off (see above). |
|
|
123
156
|
| `owner-organization-absent` | Seed or promote the application's owner organization; nothing loads until it exists. |
|
|
124
157
|
| `ownership-lost` | Nothing: the run lost its lease and a later run continues from the accepted checkpoint. |
|
|
125
|
-
| `other` | Read `failureMessage` — the failure's
|
|
158
|
+
| `other` | Read `failureMessage` — the failure's line, with a URL's query and the forms in which a database driver quotes a row's values (a duplicate key, a refused input or cast) removed; a vendor's own wording beyond those forms is not controlled. A refused stored state is cleared with `POST …/reset`. |
|
|
126
159
|
|
|
127
160
|
**`rejections`** lists the source rows the transform refused — up to 100 per run, `rejectionsTruncated` true
|
|
128
161
|
when there were more (`rejectedRows` stays exact). Each carries the row's `remoteKey` (null when the row could
|
|
@@ -168,7 +201,10 @@ export const ExternalDataAdminEndpointPath = {
|
|
|
168
201
|
* `incremental` (#1682), its last-run summary, and — while its system of record cannot be reached — the
|
|
169
202
|
* unreachable streak (`sourceUnreachable`, #1475): since when, how many failed attempts, how many scheduled
|
|
170
203
|
* runs were skipped, and when the next scheduled attempt is. Each entry carries `health` (#1740), read from the run
|
|
171
|
-
* history: the last run and its outcome, the failures in a row, and when it last completed a pass
|
|
204
|
+
* history: the last run and its outcome, the failures in a row, and when it last completed a pass — and, for a
|
|
205
|
+
* BIDIRECTIONAL pipeline, how many passes in a row ended with the sending half failed and when the last did
|
|
206
|
+
* (`consecutiveSendingFailures`, `lastSendingFailureAt`, #2096): a run keeps its inbound outcome when only its sending
|
|
207
|
+
* half fails, so those two fields are the only signal that nothing is being sent.
|
|
172
208
|
*/
|
|
173
209
|
PIPELINES: '/pipelines',
|
|
174
210
|
/**
|
|
@@ -187,13 +223,14 @@ export const ExternalDataAdminEndpointPath = {
|
|
|
187
223
|
RUN: '/run',
|
|
188
224
|
/**
|
|
189
225
|
* GET — one pipeline's run history, newest first (#1740): `?resourceType=externalCustomers&limit=20`. Each row names
|
|
190
|
-
* the trigger, track, pass, outcome, counts and duration; a failed run its failure kind (source unreachable, no owner
|
|
226
|
+
* the trigger, track, pass, outcome, counts and duration, and the lease generation the run held (#2271); a failed run its failure kind (source unreachable, no owner
|
|
191
227
|
* organization, lost lease, other) and message; and every run up to 100 of its REJECTED rows with their remote key and
|
|
192
228
|
* reason — what an operator needs to fix the data at the source. Kept for the application's OPERATIONAL_LOGS period.
|
|
193
229
|
*/
|
|
194
230
|
RUNS: '/runs',
|
|
195
231
|
/**
|
|
196
|
-
* POST — reset ONE pipeline (#1734)
|
|
232
|
+
* POST — reset ONE pipeline (#1734) — the way past a refused stored state, including a membership journal holding fewer
|
|
233
|
+
* key rows than its segments count (#2080): `{ "resourceType": "externalCustomers", "mode": "restart-pass" | "full-resync",
|
|
197
234
|
* "reason": "…", "operator"?: "…" }`. `restart-pass` discards the full pass in flight (cursor, checkpoint, membership
|
|
198
235
|
* journal) so the next full run starts over; `full-resync` also discards the incremental watermark, so the next
|
|
199
236
|
* incremental pass re-reads the whole source. Destination rows are never touched. The reason is required and
|
|
@@ -204,6 +241,31 @@ export const ExternalDataAdminEndpointPath = {
|
|
|
204
241
|
* pipeline is running.
|
|
205
242
|
*/
|
|
206
243
|
RESET: '/reset',
|
|
244
|
+
/**
|
|
245
|
+
* POST — reconcile ONE pipeline's erasure suppressions with its changed source identity (#2082): `{ "resourceType":
|
|
246
|
+
* "externalCustomers", "action": "carry-over" | "release", "reason": "…", "operator"?: "…" }`.
|
|
247
|
+
*
|
|
248
|
+
* A run REFUSES (409, code `external_data_erasure_suppression_identity_mismatch`) while active suppressions are filed
|
|
249
|
+
* under a system, remote entity or key shape the pipeline no longer has — the identity it last matched under, whoever
|
|
250
|
+
* recorded them, or one its own destination recorded under: they would match nothing, and every erased record would be
|
|
251
|
+
* copied back in. The decision is THIS pipeline's and is kept on its state; nothing is moved or re-keyed.
|
|
252
|
+
* - `carry-over`: the pipeline keeps matching the suppressions filed under the old identity, so they keep suppressing —
|
|
253
|
+
* right when the same records keep the same remote keys (an instance renamed, an entity moved to another API version).
|
|
254
|
+
* - `release`: the pipeline stops matching them — right when the identity names other records now, and a record still
|
|
255
|
+
* at the source is copied in again. The suppressions themselves are released only when NO other registered pipeline
|
|
256
|
+
* still matches that identity or still owes a decision about it; otherwise they stay active for it, and the answer's
|
|
257
|
+
* `stillMatchedBy` names who.
|
|
258
|
+
*
|
|
259
|
+
* A decision is per identity and final: a released suppression is not restored (run the erasure again), and an identity
|
|
260
|
+
* already decided is not offered again. A wrong carry-over is NOT harmless: it suppresses every record of the new source
|
|
261
|
+
* that merely shares a key value with an erased one, so that record is never copied; no door revokes a carry-over yet,
|
|
262
|
+
* so choose it only when the same remote keys name the same records. A `release` also retries the identities this
|
|
263
|
+
* pipeline already decided to release whose rows are still active. Returning the pipeline to an identity voids its
|
|
264
|
+
* decision about it. The reason is required and recorded at HIGH risk with the identities, the counts and what
|
|
265
|
+
* was released, also when the door fails after deciding. Answers 409 while the pipeline is running, and before it first
|
|
266
|
+
* ran.
|
|
267
|
+
*/
|
|
268
|
+
ERASURE_SUPPRESSIONS_RECONCILE: '/erasure-suppressions/reconcile',
|
|
207
269
|
/**
|
|
208
270
|
* GET — one OUTBOUND pipeline's changes of UNKNOWN outcome (#2039): `?resourceType=leads&limit=50`. A write the pass
|
|
209
271
|
* sent and got no clear answer for — a timeout after sending — is never sent again on its own, because a create sent
|
|
@@ -228,6 +290,44 @@ export const ExternalDataAdminEndpointPath = {
|
|
|
228
290
|
* unknown outcome any more (answered, or settled by a pass) — list again.
|
|
229
291
|
*/
|
|
230
292
|
OUTBOUND_CHANGES_RESOLVE: '/outbound-changes/resolve',
|
|
293
|
+
/**
|
|
294
|
+
* POST — UNLINK one row from the remote record whose key it holds (#2043): `{ "resourceType": "leads",
|
|
295
|
+
* "localResourceId": "…", "remoteKey": "…", "reason": "…", "operator"?: "…" }`.
|
|
296
|
+
*
|
|
297
|
+
* The way past a create the pass could not link: it landed in the system of record, and the key it returned is held
|
|
298
|
+
* by ANOTHER local row (`lastOutcomeCode: remote-key-held-by-another-row`) — a key written by an earlier mistake, or a
|
|
299
|
+
* record merged over there. Unlink the row that holds it WRONGLY, then answer the waiting create `applied` with that
|
|
300
|
+
* key through `/outbound-changes/resolve`; the store's unique index refuses a racing claim on the key.
|
|
301
|
+
*
|
|
302
|
+
* `remoteKey` must be the key the row holds (409 `row-does-not-hold-key` otherwise): naming it is what says which link
|
|
303
|
+
* is wrong. 409 `send-in-flight` when the row's own change is being sent or is of unknown outcome — answer that first;
|
|
304
|
+
* 409 `conflict-undecided` when the row's two-way conflict is waiting for, or carrying, a choice of side.
|
|
305
|
+
* The unlinked row's pending change, or its next one, is sent as a CREATE. The reason is required and recorded on the
|
|
306
|
+
* audit trail.
|
|
307
|
+
* There is no re-key: moving a key between two rows is two claims, each made through its own door.
|
|
308
|
+
*/
|
|
309
|
+
OUTBOUND_CHANGES_UNLINK: '/outbound-changes/unlink',
|
|
310
|
+
/**
|
|
311
|
+
* GET — one BIDIRECTIONAL pipeline's refused CONFLICTS (#1723): `?resourceType=partners&limit=50`. A row whose shared
|
|
312
|
+
* fields changed on both sides since they last agreed, which the declared policy `refuse-and-report` left alone on
|
|
313
|
+
* both sides. Neither loaded over nor sent until someone chooses a side. Each entry names the local row, and who made
|
|
314
|
+
* the local change and when; the run history's `conflicts` names its remote key and the fields that differ.
|
|
315
|
+
*/
|
|
316
|
+
OUTBOUND_CONFLICTS: '/outbound-changes/conflicts',
|
|
317
|
+
/**
|
|
318
|
+
* POST — choose the side that wins ONE of them (#1723): `{ "resourceType": "partners", "localResourceId": "…",
|
|
319
|
+
* "winner": "remote" | "local", "reason": "…", "operator"?: "…" }`.
|
|
320
|
+
*
|
|
321
|
+
* - `remote` discards the local change to the shared fields: the next pass that reads the record loads the system of
|
|
322
|
+
* record's values over them (a full pass at the latest, for a pipeline that reads incrementally). Nothing local is
|
|
323
|
+
* sent over the record in the meantime.
|
|
324
|
+
* - `local` keeps the local values: the next outbound pass agrees on the record's current version and sends them over
|
|
325
|
+
* it.
|
|
326
|
+
*
|
|
327
|
+
* The reason is required and recorded on the audit trail. 409 (`no-conflict`) when the row has no refused conflict —
|
|
328
|
+
* answered already, or never refused.
|
|
329
|
+
*/
|
|
330
|
+
OUTBOUND_CONFLICTS_RESOLVE: '/outbound-changes/conflicts/resolve',
|
|
231
331
|
} as const;
|
|
232
332
|
|
|
233
333
|
export type ExternalDataAdminEndpointPathValue =
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# What the engine can do over a binding — ask, do not restate
|
|
2
|
+
|
|
3
|
+
Read this when an application decides something per vendor that the ENGINE already decides:
|
|
4
|
+
|
|
5
|
+
- whether a list over this binding may declare `sortFields` (and must, where the dialect sorts);
|
|
6
|
+
- whether the binding may open `writableVerbs` (an onboarding create, an update);
|
|
7
|
+
- which incremental extraction mode a pipeline over this vendor can use;
|
|
8
|
+
- whether the instance can be partitioned, and which action call shapes it can declare.
|
|
9
|
+
|
|
10
|
+
Every one of these is enforced at startup, so writing the answer down per vendor is a second copy of engine
|
|
11
|
+
knowledge: it is right until the engine learns something (a dialect gains sort translation, a write prerequisite
|
|
12
|
+
gets performed), and then it refuses work the engine would now accept, or opens work it would refuse.
|
|
13
|
+
|
|
14
|
+
Two questions, two inputs, both from `@wildo-ai/saas-models/external-data`:
|
|
15
|
+
|
|
16
|
+
- `httpApiDialectCapabilities(dialect)` needs only the binding's dialect: `translatesSort`, `sendsRowWrites`, and a
|
|
17
|
+
`writeRefusal` sentence when it cannot write. Shared code that a frontend also loads can ask it.
|
|
18
|
+
- `systemOfRecordBindingCapabilities(facet, dialect)` also takes the vendor's facet (from
|
|
19
|
+
`@wildo-ai/systems-of-record/systems-of-record`, linked where the application declares it): it adds `writesRows`
|
|
20
|
+
(the dialect writes AND every write prerequisite the vendor declares is performed), `partitions` (the vendor declares
|
|
21
|
+
a partition of a kind the engine can confine — a FIELD, like Odoo's `company_id`. A path-segment partition cannot be
|
|
22
|
+
confined, and `partition: true` on one is refused at startup; Business Central addresses its companies that way, which
|
|
23
|
+
is why its facet declares no partition at all), and the vendor's `incrementalExtractionModes` and `actionCallShapes`
|
|
24
|
+
narrowed to that dialect. Use it in a backend, a script or a
|
|
25
|
+
test that checks a declaration against the vendor.
|
|
26
|
+
|
|
27
|
+
## Import Origins
|
|
28
|
+
|
|
29
|
+
- `@wildo-ai/saas-models`
|
|
30
|
+
|
|
31
|
+
## Source Excerpts
|
|
32
|
+
|
|
33
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
/** What one transport dialect can do in this engine. */
|
|
37
|
+
export interface HttpApiDialectCapabilities {
|
|
38
|
+
/**
|
|
39
|
+
* The dialect translates a list's sort to the remote (`$orderby`, Odoo's `order`). A list over a dialect that does
|
|
40
|
+
* must declare its `sortFields` (an undeclared key is refused at translation); a list over one that does not must
|
|
41
|
+
* declare none, and serves the remote's natural order.
|
|
42
|
+
*/
|
|
43
|
+
readonly translatesSort: boolean;
|
|
44
|
+
/** The engine sends row writes (`writableVerbs`) over this dialect. A binding opening a verb on one that does not is refused at startup. */
|
|
45
|
+
readonly sendsRowWrites: boolean;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Total over {@link HttpApiTransportDialect}, so a dialect added tomorrow is a compile error here until somebody
|
|
50
|
+
* states what it can do.
|
|
51
|
+
*/
|
|
52
|
+
export const HTTP_API_DIALECT_CAPABILITIES: { readonly [dialect in HttpApiTransportDialect]: HttpApiDialectCapabilities } = Object.freeze({
|
|
53
|
+
// `$orderby`; POST / PATCH / DELETE on the entity set (#1726).
|
|
54
|
+
[HttpApiTransportDialect.ODATA]: { translatesSort: true, sendsRowWrites: true },
|
|
55
|
+
// `$orderby`; reads only — v2 writes (a CSRF fetch, MERGE, v2 payloads) are not built (#1687).
|
|
56
|
+
[HttpApiTransportDialect.ODATA_V2]: { translatesSort: true, sendsRowWrites: false },
|
|
57
|
+
// `search_read`'s `order`; `execute_kw` create / write / unlink (#1724).
|
|
58
|
+
[HttpApiTransportDialect.ODOO_JSONRPC]: { translatesSort: true, sendsRowWrites: true },
|
|
59
|
+
// No sort translation (the compiler refuses every sort); the binding's declared method and path per verb (#1728).
|
|
60
|
+
[HttpApiTransportDialect.REST_JSON]: { translatesSort: false, sendsRowWrites: true },
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* The vendor write PREREQUISITES this engine performs before a modifying request (#1726) — none yet. Total over
|
|
65
|
+
* {@link SystemOfRecordWritePrerequisite}; `false` means a binding opening writes toward a vendor that requires the
|
|
66
|
+
* step is refused at startup, because the vendor would refuse every such write anyway, as a bare `403`.
|
|
67
|
+
*/
|
|
68
|
+
export const SYSTEM_OF_RECORD_PERFORMED_WRITE_PREREQUISITES: { readonly [prerequisite in SystemOfRecordWritePrerequisite]: boolean } = Object.freeze({
|
|
69
|
+
// SAP Gateway's X-CSRF-Token fetch + session cookie: the read client carries no cookie jar and fetches no token.
|
|
70
|
+
[SystemOfRecordWritePrerequisite.CSRF_TOKEN_HANDSHAKE]: false,
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Which kinds of partition the engine can CONFINE a read to. Total over {@link SystemOfRecordPartitionKind}, so a kind
|
|
75
|
+
* added tomorrow is a compile error here until somebody decides. The vocabulary names a kind the engine cannot confine
|
|
76
|
+
* (a path segment) so that a facet or an augmentation CAN be honest about one, and the backend refuses `partition: true`
|
|
77
|
+
* on such a vendor at startup (`PARTITION_KIND_UNSUPPORTED`), reading this table. (Business Central addresses its
|
|
78
|
+
* companies by path segment, and its shipped facet declares no partition at all for that reason, so `partition: true`
|
|
79
|
+
* there is refused earlier, as `PARTITION_NOT_SUPPORTED_BY_VENDOR`.)
|
|
80
|
+
*/
|
|
81
|
+
export const SYSTEM_OF_RECORD_CONFINABLE_PARTITION_KINDS: { readonly [kind in SystemOfRecordPartitionKind]: boolean } = Object.freeze({
|
|
82
|
+
// A field on every row (Odoo `company_id`): filterable, so the confinement is pushed down into the read.
|
|
83
|
+
[SystemOfRecordPartitionKind.FIELD]: true,
|
|
84
|
+
// A path segment is chosen before the request is built, so it cannot express several partitions in one read.
|
|
85
|
+
[SystemOfRecordPartitionKind.PATH_SEGMENT]: false,
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
/** Whether a vendor's declared partition is one the engine can confine; `false` when it declares none. */
|
|
89
|
+
export function systemOfRecordPartitionIsConfinable(partition: SystemOfRecordPartitionSupport | undefined): boolean {
|
|
90
|
+
return partition !== undefined && SYSTEM_OF_RECORD_CONFINABLE_PARTITION_KINDS[partition.kind];
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** What a dialect can do, and — when it cannot write — why, in a sentence an application can show as a held reason. */
|
|
94
|
+
export function httpApiDialectCapabilities(dialect: HttpApiTransportDialect): HttpApiDialectCapabilities & { readonly writeRefusal?: string } {
|
|
95
|
+
const capabilities = HTTP_API_DIALECT_CAPABILITIES[dialect];
|
|
96
|
+
return capabilities.sendsRowWrites ? capabilities : { ...capabilities, writeRefusal: `The engine sends no row writes over the ${dialect} dialect yet.` };
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** The write prerequisites of a vendor that this engine does NOT perform — empty when its writes can be sent. */
|
|
100
|
+
export function unperformedSystemOfRecordWritePrerequisites(prerequisites: readonly SystemOfRecordWritePrerequisite[] | undefined): SystemOfRecordWritePrerequisite[] {
|
|
101
|
+
return (prerequisites ?? []).filter((prerequisite) => !SYSTEM_OF_RECORD_PERFORMED_WRITE_PREREQUISITES[prerequisite]);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** What the engine can do over a binding of a vendor, through one of its dialects. */
|
|
105
|
+
export interface SystemOfRecordBindingCapabilities extends HttpApiDialectCapabilities {
|
|
106
|
+
/** The engine can send row writes to THIS vendor over this dialect: the dialect writes and every prerequisite is performed. */
|
|
107
|
+
readonly writesRows: boolean;
|
|
108
|
+
/** Why `writesRows` is false, as a sentence. Absent when it is true. */
|
|
109
|
+
readonly writeRefusal?: string;
|
|
110
|
+
/**
|
|
111
|
+
* The engine can confine the vendor's data by partition — the vendor declares a partition of a kind the engine can
|
|
112
|
+
* confine (Odoo's companies). An instance still opts in with `partition: true`.
|
|
113
|
+
*/
|
|
114
|
+
readonly partitions: boolean;
|
|
115
|
+
/** The incremental extraction modes the vendor offers that run over this dialect. Empty: every pass is a full pass. */
|
|
116
|
+
readonly incrementalExtractionModes: readonly ExternalDataIncrementalExtractionMode[];
|
|
117
|
+
/** The vendor action call shapes spoken over this dialect. Empty: the binding can declare no action. */
|
|
118
|
+
readonly actionCallShapes: readonly SystemOfRecordActionCallShape[];
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Everything the engine can do over a binding of `facet`'s vendor through `dialect`. Refuses a dialect the vendor's
|
|
123
|
+
* facet does not list, which the backend would refuse at startup too.
|
|
124
|
+
*/
|
|
125
|
+
export function systemOfRecordBindingCapabilities(facet: SystemOfRecordVendorFacet, dialect: HttpApiTransportDialect): SystemOfRecordBindingCapabilities {
|
|
126
|
+
if (!facet.dialects.includes(dialect)) {
|
|
127
|
+
throw new Error(`System-of-record vendor '${facet.vendor}' is not spoken to over ${dialect} (its dialects: ${facet.dialects.join(', ')}).`);
|
|
128
|
+
}
|
|
129
|
+
const dialectCapabilities = HTTP_API_DIALECT_CAPABILITIES[dialect];
|
|
130
|
+
const unperformed = unperformedSystemOfRecordWritePrerequisites(facet.writePrerequisites);
|
|
131
|
+
const writeRefusal = !dialectCapabilities.sendsRowWrites
|
|
132
|
+
? `The engine sends no row writes over the ${dialect} dialect yet.`
|
|
133
|
+
: unperformed.length > 0
|
|
134
|
+
? `The engine does not perform ${unperformed.join(', ')}, which '${facet.vendor}' requires before every write.`
|
|
135
|
+
: undefined;
|
|
136
|
+
return {
|
|
137
|
+
...dialectCapabilities,
|
|
138
|
+
writesRows: writeRefusal === undefined,
|
|
139
|
+
...(writeRefusal === undefined ? {} : { writeRefusal }),
|
|
140
|
+
partitions: systemOfRecordPartitionIsConfinable(facet.partition),
|
|
141
|
+
incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) => EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT[mode] === dialect),
|
|
142
|
+
actionCallShapes: (facet.actionCallShapes ?? []).filter((shape) => SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape] === dialect),
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
```
|
|
@@ -83,13 +83,39 @@ v4: modified-at; the generic `odata` facet: both):
|
|
|
83
83
|
last page names the next one. Refused at startup: a `sourceFilter` (change tracking refuses `$filter`)
|
|
84
84
|
and a composite key (a deleted entity names one id). A service that answers the first pass without a
|
|
85
85
|
delta link does not track changes — that pass fails, naming the cause.
|
|
86
|
-
- **A delta link that has EXPIRED** resets the track, and the same run
|
|
87
|
-
read that finds the deletions the expired link would have reported. Expired means `410 Gone` or
|
|
86
|
+
- **A delta link that has EXPIRED** resets the track, and the same run advances a FULL pass instead. Expired means `410 Gone` or
|
|
88
87
|
`404 Not Found` (what the protocol lets a service answer), or the vendor's own error code where its
|
|
89
88
|
system-of-record facet declares one: Dataverse keeps change tracking for `ExpireChangeTrackingInDays`
|
|
90
89
|
(seven by default) and answers an older token with `0x80044352`, "Please perform a full sync". The run reports
|
|
91
|
-
`incrementalTrackReset: position-rejected` with `passMode: full
|
|
92
|
-
new delta link.
|
|
90
|
+
`incrementalTrackReset: position-rejected` with `passMode: full` and `continuationRestart: expired`, and
|
|
91
|
+
the next incremental run starts a new delta link. What that full pass does and does not recover, precisely:
|
|
92
|
+
- The fallback run advances the full pass by ONE run's worth of rows (`maxRowsPerRun`). If a full pass
|
|
93
|
+
was already in flight, it is that pass that continues; otherwise a new one starts. The deletions it
|
|
94
|
+
recovers are applied only when that pass COMPLETES, which may take several runs.
|
|
95
|
+
- A completing full pass orphans the rows whose keys it did not see anywhere in the pass — in its own
|
|
96
|
+
pages or in the incremental runs that ran while it was in flight. A row deleted at the source AFTER the
|
|
97
|
+
pass read its key was seen, so it is not orphaned by this pass.
|
|
98
|
+
- A row deleted before the old link's last successful read was already reported by that link. A row
|
|
99
|
+
deleted AFTER both that read and the moment the full pass read it, and before the next incremental run
|
|
100
|
+
opens a new delta link, is reported by neither: the pass saw it present, and the new link starts after
|
|
101
|
+
it left. It stays until the next full pass (`fullPassCron`) finds it absent.
|
|
102
|
+
- **A NEXT LINK that has expired** is different: it only continues a pass. A pass that spans runs keeps the
|
|
103
|
+
service's `@odata.nextLink` as its cursor — the OData full pass, and a modified-at pass — and a service
|
|
104
|
+
may forget it. On `410` / `404` the pass reads again from its start (the full pass from its first page,
|
|
105
|
+
a modified-at pass from its unchanged watermark); nothing is skipped, and the run's history row says
|
|
106
|
+
`continuationRestart: expired`. Once per pass: a second restart in the same pass, for either reason
|
|
107
|
+
(expired or moved, below), FAILS the run, because a source that forgets links faster than a pass
|
|
108
|
+
completes would otherwise restart it forever and never detect a deletion. The failure names both
|
|
109
|
+
reasons. When the second was an expiry, raise `maxRowsPerRun` or run the pipeline more often; when it
|
|
110
|
+
was a move, settle the instance's base URL. Then reset the pipeline.
|
|
111
|
+
- **A stored link under a base URL you MOVED the instance away from** is never followed. That covers
|
|
112
|
+
another scheme, host or port (a continuation that leaves the instance's origin would carry its
|
|
113
|
+
credentials elsewhere), and also only another PATH on the same host (`/odata/v1` → `/odata/v2`: the
|
|
114
|
+
link would keep reading the service root you moved away from). Each link is stored with the service
|
|
115
|
+
root it was received under, so both moves are seen. It is treated like an expired one: the full and
|
|
116
|
+
modified-at passes restart on the new root, a delta link resets the track and falls back to a full
|
|
117
|
+
pass, and the history says `continuationRestart: origin-moved`. Same once-per-pass rule. Links are
|
|
118
|
+
stored absolute, so this holds for a service that serves relative links too.
|
|
93
119
|
|
|
94
120
|
## How the Odoo mode reads what changed
|
|
95
121
|
|
|
@@ -28,11 +28,20 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
|
|
|
28
28
|
- **It decodes values before you see them:** `"/Date(1767571200000)/"` becomes a `Date`; a string
|
|
29
29
|
`Edm.Decimal`, `Edm.Int64`, `Edm.Double` becomes a `number`; `__metadata` and deferred navigation
|
|
30
30
|
properties are removed. Map these fields onto `z.date()` / `z.number()` directly — no coercion needed.
|
|
31
|
-
- **It
|
|
32
|
-
2^53 − 1,
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
31
|
+
- **It never rounds a number,** and names the property, never the value: an `Edm.Int64` beyond
|
|
32
|
+
2^53 − 1, an `Edm.Decimal` with more than 15 significant digits, and a `NaN`, `INF` or `-INF` (legal
|
|
33
|
+
`Edm.Double` / `Edm.Single` values) are values no number field can hold. Where the reading stops depends
|
|
34
|
+
on the reader:
|
|
35
|
+
- a **read-through** cannot refuse one record of a page, so it refuses the READ. It `$select`s only the
|
|
36
|
+
fields of the resource's schema (plus its keys), so this happens only for a property you declared.
|
|
37
|
+
- a **pipeline** rejects just THAT RECORD, naming the field: the other records load, the pass completes,
|
|
38
|
+
and the record keeps its earlier value (it stays observed, so it is never orphaned). This applies only
|
|
39
|
+
to a field the pipeline reads (a mapping, a key, a reference). A record holding such a value in a field
|
|
40
|
+
nobody reads loads normally. A KEY component of that kind still refuses the read, because the key walk
|
|
41
|
+
cannot advance past a key it cannot read.
|
|
42
|
+
|
|
43
|
+
Leave such a property out of the resource's schema or the mapping, or read it from a service that
|
|
44
|
+
serves it as `Edm.String`.
|
|
36
45
|
- **It spells each filter for the property's type:** `datetime'2026-01-05T00:00:00.000'`, `42L`,
|
|
37
46
|
`2.5M`, `guid'…'`, and search as `substringof('needle', tolower(Prop)) eq true`. Every request asks for
|
|
38
47
|
JSON (`$format=json`); totals use `$inlinecount=allpages`. When the service serves fewer rows than a
|
|
@@ -41,13 +50,16 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
|
|
|
41
50
|
- **A pipeline walks the entity's KEY,** not `__next`: each page asks for the next N keys after the last
|
|
42
51
|
one read (`Key gt 'last'`, lexicographic for a composite key). v2 does not promise a partial listing is
|
|
43
52
|
stable, and a complete pass that skipped a row would delete its local copy. A page served out of key
|
|
44
|
-
order is refused rather than trusted.
|
|
53
|
+
order is refused rather than trusted. The one exception is a page with NO rows that still carries a
|
|
54
|
+
`__next`: the service cut its answer short, and an empty page cannot move a key walk, so its link is
|
|
55
|
+
followed to the first page that serves rows. A service that keeps answering empty pages is refused
|
|
56
|
+
after a bounded number of links, and the run stops rather than treat the set as finished.
|
|
45
57
|
|
|
46
58
|
## What it cannot do
|
|
47
59
|
|
|
48
60
|
- **Write.** A binding opening `create` / `update` / `delete` on `ODATA_V2` is refused at startup, and so
|
|
49
|
-
is
|
|
50
|
-
`
|
|
61
|
+
is `subjectRights: FORWARDED_TO_SOURCE` (a remote DELETE). Leave `subjectRights` out (the system of
|
|
62
|
+
record answers for its records) or declare `NO_SUBJECT_DATA`.
|
|
51
63
|
- **Filter or sort by a complex-typed property,** or by `Edm.Time` / `Edm.Binary`: those are refused by
|
|
52
64
|
name.
|
|
53
65
|
- **Run actions** (OData function imports) — declared actions are v4-only.
|
|
@@ -56,5 +68,5 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
|
|
|
56
68
|
|
|
57
69
|
- [ ] The instance and the binding both say `ODATA_V2`, and the instance's `baseUrl` is the v2 service root.
|
|
58
70
|
- [ ] Every mapped field exists in the service's `$metadata` (a pipeline's run report warns when one is missing).
|
|
59
|
-
- [ ]
|
|
71
|
+
- [ ] `subjectRights` is left out or declares `NO_SUBJECT_DATA` (never a forward).
|
|
60
72
|
- [ ] No `create` / `update` / `delete` is opened.
|
|
@@ -16,7 +16,7 @@ record: a **create** the first time, an **update** after that.
|
|
|
16
16
|
| One user action must change the ERP NOW, and the user must see the result or the refusal | a write through a VIRTUAL resource (`read-through-writes.md`) |
|
|
17
17
|
| The ERP owns the data and the application copies it | an INBOUND pipeline (the default direction) |
|
|
18
18
|
| The ERP must run a business step (post an invoice, confirm an order) | a declared action (`system-of-record-actions.md`) |
|
|
19
|
-
| The same row is edited on BOTH sides |
|
|
19
|
+
| The same row is edited on BOTH sides | a BIDIRECTIONAL pipeline (`bidirectional-pipelines.md`) |
|
|
20
20
|
|
|
21
21
|
The difference from a virtual write is WHEN and WHO: a virtual write happens inside the user's request and fails
|
|
22
22
|
it when the ERP refuses. An outbound pipeline sends later, on its own schedule, and a refusal is retried and
|
|
@@ -26,14 +26,14 @@ reported — the user's save always succeeds locally.
|
|
|
26
26
|
|
|
27
27
|
```ts
|
|
28
28
|
import { ExternalDataMappingEntryKind, ExternalDataPipelineDirection, HttpApiKeyComponentCodec, HttpApiWriteConcurrencyMode, HttpApiWriteVerb } from '@wildo-ai/saas-models/external-data';
|
|
29
|
-
import {
|
|
29
|
+
import { HttpApiTransportDialect, SystemOfRecordSubjectRightsPosture } from '@wildo-ai/saas-models';
|
|
30
30
|
|
|
31
31
|
externalDataPipeline: {
|
|
32
32
|
direction: ExternalDataPipelineDirection.OUTBOUND,
|
|
33
33
|
binding: {
|
|
34
34
|
dialect: HttpApiTransportDialect.ODOO_JSONRPC, system: 'odoo', entityRef: 'crm.lead',
|
|
35
35
|
keyFields: [{ localField: 'id', remoteField: 'id', codec: HttpApiKeyComponentCodec.INTEGER }],
|
|
36
|
-
|
|
36
|
+
subjectRights: { posture: SystemOfRecordSubjectRightsPosture.NO_SUBJECT_DATA },
|
|
37
37
|
writableVerbs: [HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE],
|
|
38
38
|
writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS },
|
|
39
39
|
},
|
|
@@ -58,13 +58,16 @@ What each part means, and what startup refuses:
|
|
|
58
58
|
ones and has no inverse. `required`, `coercion` and a non-default `unresolved` are refused: they describe
|
|
59
59
|
loading, and this direction loads nothing. `orphanCascadeAcknowledged` is ADMITTED and means what it means
|
|
60
60
|
inbound: when the reference's target is an INBOUND destination that deletes orphans, and the relationship
|
|
61
|
-
deletes children with their parent, a record vanishing from the target's source
|
|
61
|
+
deletes children with their parent, the declaration says a record vanishing from the target's source should take
|
|
62
|
+
these rows with it, and the cascade does run when that record vanishes.
|
|
62
63
|
- **Nothing that describes READING the source:** `sourceFilter`, `incremental`, `archivedRecords`,
|
|
63
64
|
`partitionKeyLocalField`, and a `population` or `orphanPolicy` other than the defaults are refused.
|
|
64
|
-
- **`
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
about a person
|
|
65
|
+
- **`subjectRights` says who answers for what the system of record receives.** Leave it out (`HANDLED_AT_SOURCE`):
|
|
66
|
+
the system answers requests about the records it received, and an erasure's receipt says so. The local rows are
|
|
67
|
+
born in your application, so an erasure scrubs or deletes them as their resource's retention declares, like any of
|
|
68
|
+
your rows. Declare `NO_SUBJECT_DATA` only when no sent field can be about a person — startup checks it against the
|
|
69
|
+
sent fields that declare `.dataCategories()`, a credential marker, `.impersonalizeWith()` or `.portabilityProvenance()`,
|
|
70
|
+
the same fields the privacy notice counts. `FORWARDED_TO_SOURCE` and `OWNED_COPY` are refused here (#2560).
|
|
68
71
|
|
|
69
72
|
## The destination schema — the ownership rules reversed
|
|
70
73
|
|
|
@@ -74,7 +77,7 @@ APPLICATION's:
|
|
|
74
77
|
| Field | Rule | Why |
|
|
75
78
|
|---|---|---|
|
|
76
79
|
| each mapped `localField` | writable by callers (NOT excluded from both create and update) | a field nobody can set would send a value nobody decided |
|
|
77
|
-
| `remoteKeyLocalField` | `z.string().optional().isUnique().excludeFromCreate().excludeFromUpdate()` — optional
|
|
80
|
+
| `remoteKeyLocalField` | `z.string().optional().isUnique().excludeFromCreate().excludeFromUpdate()` — optional | empty until the first send; the engine writes it ONCE from the key the create answered, and a caller who could write it could point a local row at any remote record. UNIQUE because one remote record may have one local row: two rows on one key would overwrite each other's record. The plain (sparse) unique ignores rows with no key yet, on both stores, whether the key is absent or null |
|
|
78
81
|
| a `REMOTE_REFERENCE` `localField` | an optional string foreign key of a declared relationship to `targetResourceType` | the target's REMOTE key is sent in its place |
|
|
79
82
|
| the tenant foreign key | exactly as for any pipeline destination: ORGANIZATIONS scope, a routed required foreign key, engine-supplied | see "The destination's tenant is ENGINE-SUPPLIED" in the skill |
|
|
80
83
|
|
|
@@ -101,6 +104,16 @@ Each pass (on `scheduleCron`, or `POST …/run`) reads the markers and, for each
|
|
|
101
104
|
- **a `REMOTE_REFERENCE`** sends the target row's remote key — an Odoo many2one as the bare record id. A target not
|
|
102
105
|
sent yet makes the row WAIT (`deferred.reference-target-not-sent`), because sending it without its link would
|
|
103
106
|
create a record nothing ever links afterwards. It goes the pass after its target does.
|
|
107
|
+
- **a field the vendor's write API spells differently from its list** goes under the write member's name. NetSuite's
|
|
108
|
+
SuiteQL answers `companyname`, while the record service a create or an update goes to names it `companyName`. Name it
|
|
109
|
+
per member on the mapping entry, the way a read-through binding does (see `read-through-writes.md`):
|
|
110
|
+
|
|
111
|
+
```ts
|
|
112
|
+
{ kind: ExternalDataMappingEntryKind.REMOTE_FIELD, remoteField: 'companyname', localField: 'name',
|
|
113
|
+
remoteFieldByMember: { create: 'companyName', update: 'companyName' } }
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
REST_JSON only, OUTBOUND only, and only for a member the binding declares. Anything else is refused at startup.
|
|
104
117
|
|
|
105
118
|
Never sent:
|
|
106
119
|
|
|
@@ -116,8 +129,16 @@ A created record must land in ONE partition (an Odoo company). Declare `partitio
|
|
|
116
129
|
field holding the organization unit the row belongs to. The engine places the create in the partition the operator
|
|
117
130
|
assigned to that unit, exactly as a read-through create is placed. A row naming no unit, or a unit assigned no
|
|
118
131
|
single partition, waits (`deferred.partition-unplaced`) and is retried each time its backoff elapses — assign the partition, or set the
|
|
119
|
-
row's unit. An update never moves a record between partitions.
|
|
120
|
-
|
|
132
|
+
row's unit. An update never moves a record between partitions.
|
|
133
|
+
|
|
134
|
+
An update is confined as well, the same way a key-addressed write through a read-through resource is. Before
|
|
135
|
+
sending it, the pass reads the partition the record is in, and sends only if the row's unit is assigned that
|
|
136
|
+
partition. A row naming no unit may update only a record that is in no partition. Otherwise the update waits
|
|
137
|
+
(`deferred.partition-not-entitled`) until the unit is assigned the record's partition, or the row names a unit that
|
|
138
|
+
is. Because the confinement needs that read, a partitioned instance takes updates only over a dialect that can read
|
|
139
|
+
one record (Odoo, OData v4); startup refuses the others.
|
|
140
|
+
|
|
141
|
+
Do not map anything onto the partition field itself: startup refuses it, because the partition is derived.
|
|
121
142
|
|
|
122
143
|
## The order changes are sent in, and the backoff
|
|
123
144
|
|
|
@@ -136,10 +157,11 @@ the local row it came from.
|
|
|
136
157
|
| What happened | What the pipeline does |
|
|
137
158
|
|---|---|
|
|
138
159
|
| The system of record refused the write | retried under a NEW key once its backoff has elapsed; counted in `remoteRefused` |
|
|
139
|
-
| It could not be reached | the pass stops (`stoppedBecauseUnreachable`)
|
|
160
|
+
| It could not be reached, before anything was sent (the connection was refused, the host was not found, the token endpoint or Odoo's sign-in did not answer) | the pass stops (`stoppedBecauseUnreachable`). Nothing was written, so the change is not refused: it keeps its due time, is counted `leftForNextPass`, and the next pass sends it under a new key, with the rows not reached |
|
|
161
|
+
| The run's deadline came while the write waited for its rate budget, before it was sent | the pass stops (`stoppedAtDeadline`), and the change is left for the next pass exactly as above. A write is never re-sent after a throttle, so this is the only wait it has |
|
|
140
162
|
| The write landed, and recording it locally failed | nothing is sent again: the next pass settles it (`replayed`) — from the row's key if it was written, from the write ledger if not |
|
|
141
|
-
| The pass stopped after sending, before the answer was recorded | the next pass asks the write ledger. Applied → settled, nothing sent (`replayed`). Still in flight → left for later (`leftForNextPass`), then UNKNOWN once its deadline passes. A CREATE whose ledger entry is gone (a day passed) is UNKNOWN — never sent afresh |
|
|
142
|
-
| **The outcome is UNKNOWN** (a timeout after sending) | never sent again under that change. An UPDATE is sent again once the row changes again (`awaitingNewerChange` until then). A **CREATE waits for an operator** (`awaitingOperator`): sending it again could create the record twice |
|
|
163
|
+
| The pass stopped after sending, before the answer was recorded | the next pass asks the write ledger, whether or not the row changed since. Applied → settled, nothing sent (`replayed`), and a newer change is then sent under a new key. Not applied → sent again: under the same key when the row is unchanged, under a new key when it changed since. Still in flight → left for later (`leftForNextPass`), then UNKNOWN once its deadline passes. A CREATE whose ledger entry is gone (a day passed) is UNKNOWN — never sent afresh |
|
|
164
|
+
| **The outcome is UNKNOWN** (a timeout or a lost connection after sending, or a 502 or 504 from a gateway) | never sent again under that change. An UPDATE is sent again once the row changes again (`awaitingNewerChange` until then). A **CREATE waits for an operator** (`awaitingOperator`): sending it again could create the record twice |
|
|
143
165
|
|
|
144
166
|
An unknown CREATE is answered by someone who looked in the system of record, through the admin door (same
|
|
145
167
|
`X-Admin-Secret` as the other pipeline doors; see `framework-pipeline-admin-endpoints-api.md`):
|
|
@@ -158,6 +180,31 @@ An unknown CREATE is answered by someone who looked in the system of record, thr
|
|
|
158
180
|
Every answer is recorded on the audit trail (`external_data_outbound_unknown_resolved`) with the reason, who said they
|
|
159
181
|
answered, and what it changed. 409 means the change is not of unknown outcome any more — list again.
|
|
160
182
|
|
|
183
|
+
### When the key is already held by another row
|
|
184
|
+
|
|
185
|
+
A create can land and return a key that ANOTHER local row already holds. That happens when the other row's link is
|
|
186
|
+
wrong: a key written by an earlier mistaken answer, or a record merged in the system of record. The pass refuses to
|
|
187
|
+
link one record to two rows. The create then waits with `lastOutcomeCode: remote-key-held-by-another-row`, and the
|
|
188
|
+
error log names both rows and the key. Answering it `applied` with that key is refused for the same reason. The way
|
|
189
|
+
past it has two steps, each one audited, and each one a single write the store can refuse:
|
|
190
|
+
|
|
191
|
+
1. **Unlink the row that holds the key wrongly**: `POST /internal/admin/external-data/outbound-changes/unlink` with
|
|
192
|
+
`{ "resourceType", "localResourceId", "remoteKey", "reason", "operator"? }`.
|
|
193
|
+
- `remoteKey` must be the key that row holds (409 `row-does-not-hold-key` otherwise), so the unlink names which
|
|
194
|
+
link is wrong.
|
|
195
|
+
- It is refused (409 `send-in-flight`) while that row's own change is being sent or is of unknown outcome. Answer
|
|
196
|
+
that change first. On a BIDIRECTIONAL pipeline it is also refused (409 `conflict-undecided`) while the row has a
|
|
197
|
+
conflict that is not yet decided.
|
|
198
|
+
- The unlinked row keeps its values but loses its link: its pending change, or its next one, is sent as a CREATE.
|
|
199
|
+
- Recorded as `external_data_outbound_remote_key_unlinked`.
|
|
200
|
+
2. **Answer the waiting create** `applied` with the key, as above. The destination's unique index now lets the right
|
|
201
|
+
row hold it, and refuses any other answer that claims the same key at the same moment. On a BIDIRECTIONAL pipeline
|
|
202
|
+
the gap between the two steps is safe too. While that create waits for its answer, a run does not load records that
|
|
203
|
+
no local row holds. So the record is not imported as a third row before the answer links it.
|
|
204
|
+
|
|
205
|
+
There is deliberately no single "move the key" call. Moving a key between two rows is two claims about another
|
|
206
|
+
system, and each one is made, checked and recorded on its own.
|
|
207
|
+
|
|
161
208
|
## What a pass reports
|
|
162
209
|
|
|
163
210
|
A sending pass's run report carries `passMode: 'send'` (an OUTBOUND pipeline runs no other kind, and `POST …/run`
|