@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
|
@@ -470,6 +470,31 @@ export interface ResourceRetentionPolicy {
|
|
|
470
470
|
* one row two erasure authorities.
|
|
471
471
|
*/
|
|
472
472
|
statutoryRetention?: ResourceStatutoryRetention;
|
|
473
|
+
/**
|
|
474
|
+
* The fields a framework process may still write on a RETAINED row, to finish work that was committed before the
|
|
475
|
+
* erasure and that the erasure must not cancel (#3000). Rarely declared: a retained row is frozen, and this is the one
|
|
476
|
+
* way past that, for one resource and the fields named here.
|
|
477
|
+
*
|
|
478
|
+
* The framework's own case is an approval seal. A person's decision commits its seal PENDING, and a relay signs it
|
|
479
|
+
* later. When the approver is erased before the signature arrives, the erasure removes their disclosure and retains
|
|
480
|
+
* the row. Without this declaration nothing could sign it, and a committed decision would never get its seal. The
|
|
481
|
+
* signature covers claims that name no person, so finishing it discloses nothing the erasure removed.
|
|
482
|
+
*
|
|
483
|
+
* The declaration does NOT reveal anything. A framework process reads such rows through
|
|
484
|
+
* `findRetainedForCompletionForInfrastructure` and writes them through `completeRetainedRowForInfrastructure`. Both
|
|
485
|
+
* reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
|
|
486
|
+
* personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
|
|
487
|
+
* be the primary key or a retention marker: the build refuses each of those.
|
|
488
|
+
*/
|
|
489
|
+
retainedRowCompletion?: ResourceRetainedRowCompletion;
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
/** See {@link ResourceRetentionPolicy.retainedRowCompletion}. */
|
|
493
|
+
export interface ResourceRetainedRowCompletion {
|
|
494
|
+
/** The fields the completing process writes, and no others. */
|
|
495
|
+
fields: readonly string[];
|
|
496
|
+
/** What committed work it finishes, and why finishing it discloses nothing the erasure removed. Required, non-empty. */
|
|
497
|
+
rationale: string;
|
|
473
498
|
}
|
|
474
499
|
|
|
475
500
|
/**
|
|
@@ -580,7 +605,7 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
580
605
|
* Carries everything the external repository needs that the platform does not own: provider
|
|
581
606
|
* reference (credentials resolve through `ExternalProvidersRegistryBackendService`), transport
|
|
582
607
|
* dialect, remote entity, ordered key declaration (id synthesis), identity mode, tenancy
|
|
583
|
-
* stance,
|
|
608
|
+
* stance, subject-rights posture (#2558), and remote-call semantics. The factory enforces presence/absence
|
|
584
609
|
* coherence and content-validates the declaration.
|
|
585
610
|
*/
|
|
586
611
|
httpApiBinding?: HttpApiResourceBindingAuthored,
|
|
@@ -693,9 +718,48 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
693
718
|
* Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
|
|
694
719
|
* one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
|
|
695
720
|
* a person — and if so, whose session an erasure ends.
|
|
721
|
+
*
|
|
722
|
+
* And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
|
|
723
|
+
* `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
|
|
724
|
+
* `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
|
|
725
|
+
* and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
|
|
726
|
+
* transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
|
|
727
|
+
* erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
|
|
728
|
+
* `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
|
|
729
|
+
*
|
|
730
|
+
* Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
|
|
731
|
+
* or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
|
|
732
|
+
* STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
|
|
733
|
+
* service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
|
|
734
|
+
*
|
|
735
|
+
* @example
|
|
736
|
+
* ```ts
|
|
737
|
+
* retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
|
|
738
|
+
* dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
|
|
739
|
+
* coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
|
|
740
|
+
* operationsConfiguration: {
|
|
741
|
+
* // …READ / LIST as API_CALL defaults…
|
|
742
|
+
* [CoreResourceOperation.UPDATE_MANY]: {
|
|
743
|
+
* variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
|
|
744
|
+
* },
|
|
745
|
+
* },
|
|
746
|
+
* ```
|
|
696
747
|
*/
|
|
697
748
|
retentionPolicy?: ResourceRetentionPolicy,
|
|
698
749
|
|
|
750
|
+
/**
|
|
751
|
+
*
|
|
752
|
+
* The fields that NAME a row of this resource to a person: one to three top-level string fields of its
|
|
753
|
+
* summary row (or a `forwardedLabel` virtual such as an `instanceLabel`), joined by a space. What a chat search result,
|
|
754
|
+
* a chat list or a created record is shown as, and what the application's pages show it as too.
|
|
755
|
+
*
|
|
756
|
+
* It is the record's ONE name. The frontend names a record by it wherever it is declared, and refuses at startup a
|
|
757
|
+
* resource whose ui-behavior also declares `getFrontendResourceLabel`, since that would be a second name the chat never
|
|
758
|
+
* shows. A resource with no chat command may keep a richer `getFrontendResourceLabel` instead. Absent, the backend
|
|
759
|
+
* names no row of this resource, and a read command over it is refused at startup.
|
|
760
|
+
*/
|
|
761
|
+
recordLabelFields?: readonly string[],
|
|
762
|
+
|
|
699
763
|
/**
|
|
700
764
|
* WHO a row of this resource is with respect to an erasure — and, when it is a person, which field
|
|
701
765
|
* names the `USERS` row whose session that erasure must end.
|
|
@@ -706,6 +770,16 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
706
770
|
*/
|
|
707
771
|
dataSubjectPolicy?: ResourceDataSubjectPolicy,
|
|
708
772
|
|
|
773
|
+
/**
|
|
774
|
+
* This resource's rows are EVIDENCE of another record, of any resource type, and possibly of files (#2940): an
|
|
775
|
+
* approval seal, a signature request, a frozen copy. Its rows carry the subject in `linkedResourceType` /
|
|
776
|
+
* `linkedResourceId` (the naming files use for their link) and each attested file in a scalar field the declaration
|
|
777
|
+
* names. Every reference field must be `.excludeFromUpdate()` and `.isDBIndexed()`, and no writer, the engine
|
|
778
|
+
* included, may change one after creation: re-pointed evidence could be destroyed with its new target. See
|
|
779
|
+
* {@link ResourceEvidenceDeclaration}.
|
|
780
|
+
*/
|
|
781
|
+
evidence?: ResourceEvidenceDeclaration,
|
|
782
|
+
|
|
709
783
|
/**
|
|
710
784
|
* How long this resource's rows are KEPT: a binding to one of the application's declared retention
|
|
711
785
|
* classes, and the moment each row's clock starts. An engine sweep deletes a bound row once its
|
|
@@ -732,10 +806,18 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
732
806
|
*/
|
|
733
807
|
portabilityPolicy?: ResourcePortabilityPolicy,
|
|
734
808
|
|
|
809
|
+
/**
|
|
810
|
+
* #2903: top-level fields of this resource that hold OTHER people's data, which a subject export reaching a row through
|
|
811
|
+
* a relationship edge withholds and lists (`fieldsWithheldAsOthersData`), for both rights: a copy of a person's data
|
|
812
|
+
* may not adversely affect others (GDPR Art. 15(4)). The row's own subject still receives every other field. Each name
|
|
813
|
+
* must be a field of the main schema; the factory refuses one that is not.
|
|
814
|
+
*/
|
|
815
|
+
subjectExportOthersDataFields?: readonly string[],
|
|
816
|
+
|
|
735
817
|
/**
|
|
736
818
|
* Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
|
|
737
819
|
* matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
|
|
738
|
-
* application can compute its cost per case (#1598), and
|
|
820
|
+
* application can compute its cost per case (#1598), and decisions on agent work name it (#1599).
|
|
739
821
|
*
|
|
740
822
|
* A reference to a case is a `WorkUnitRef` (`{ resourceType, resourceId }`), and the engine accepts one at a
|
|
741
823
|
* service boundary only when `resourceType` names a resource declaring `workUnit: true` and the caller can
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-chat-commands
|
|
3
|
+
description: Let a member run one of your app's resource operations from Slack or Teams as a chat command (a Slack slash command, a Teams message-extension form or search) by declaring `chatCommand` on the operation and `recordLabelFields` on the resource. Use when the user says "add a slash command", "let people create a <record> from Slack", "a Teams message extension that searches our records", "run an operation from chat", "chat command", or "why does the backend refuse my chatCommand at startup". Not for an agent conversation in chat (that is chat-agent-conversations), and not for wiring the inbound handler or the provider (that is the provider's own skill).
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Run Resource Operations from Slack or Teams — Workflow
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
A chat command runs ONE resource operation as the member who typed it, with their own authority, confined to the
|
|
24
|
+
organization the chat belongs to. You author two declarations and nothing else: the engine derives the Slack slash
|
|
25
|
+
command and the Teams message-extension commands from them, words them from your labels, and refuses at startup any
|
|
26
|
+
declaration a chat could not run.
|
|
27
|
+
|
|
28
|
+
- **`chatCommand: { verb, argument }`** on the operation's DEFAULT variant: the word typed after the command, and for a
|
|
29
|
+
write the request field the member's text fills.
|
|
30
|
+
- **`recordLabelFields`** on the resource: the one to three fields that are the record's ONE name, in a chat answer and
|
|
31
|
+
in the application. Required for a search or a list. The frontend refuses at startup a resource whose ui-behavior
|
|
32
|
+
also declares `getFrontendResourceLabel`.
|
|
33
|
+
|
|
34
|
+
## App Paths
|
|
35
|
+
|
|
36
|
+
| Surface | Typical path |
|
|
37
|
+
|---|---|
|
|
38
|
+
| The operation's declaration | `shared-lib/src/modules/<module>/<resource>/<resource>.resources-config.ts` |
|
|
39
|
+
| The words a command shows (title, field labels, enum values) | your label tree, generated by `wildo generate labels` |
|
|
40
|
+
| The inbound handler that runs commands | `backend-api/src/**/` (the provider skill's section 8) |
|
|
41
|
+
| The vendor registration | `wildo providers register <ref>` (Slack manifest, Teams package) |
|
|
42
|
+
|
|
43
|
+
## When to Use
|
|
44
|
+
|
|
45
|
+
- A member should create one record from a chat line (`/acme add Buy milk`) or a Teams form.
|
|
46
|
+
- A member should find records from a chat (`/acme find milk`, a Teams search) or list their first ones.
|
|
47
|
+
|
|
48
|
+
## When NOT to Use
|
|
49
|
+
|
|
50
|
+
- An agent should answer what a person writes: `chat-agent-conversations`.
|
|
51
|
+
- You are wiring the handler, the provider, or the registration: `provider-slack`, `provider-microsoft-teams-bot`.
|
|
52
|
+
- An external agent should call the operation as a tool: `resource-mcp-tool-exposure`.
|
|
53
|
+
|
|
54
|
+
## Workflow
|
|
55
|
+
|
|
56
|
+
1. **Choose the operation.** Only a DEFAULT, non-bulk, URL-bearing, INLINE API_CALL qualifies, and it must create ONE
|
|
57
|
+
record, search, or list. An update or a delete needs a record id a chat cannot give. Read
|
|
58
|
+
`references/framework-resource-chat-command-contract.md` for the full contract.
|
|
59
|
+
2. **Declare it.** `chatCommand: { verb: 'add', argument: 'title' }` on a write; `chatCommand: { verb: 'find' }` on a
|
|
60
|
+
search; `chatCommand: { verb: 'mine' }` on a list. The verb is lowercase and unique in the application; `help` is
|
|
61
|
+
reserved.
|
|
62
|
+
3. **Name the records.** Declare `recordLabelFields: ['title']` on the resource for every search or list command. If the
|
|
63
|
+
resource's ui-behavior declares `getFrontendResourceLabel`, remove it: the application then names the record by
|
|
64
|
+
`recordLabelFields` too, and keeping both is refused when the frontend starts.
|
|
65
|
+
4. **Generate the words**: `wildo generate labels` then `wildo generate translate`. A registration refuses a word the
|
|
66
|
+
label tree lacks, naming its key.
|
|
67
|
+
5. **Restart the backend and read its startup log.** Every declaration a chat could not run is refused there, with the
|
|
68
|
+
operation and the remedy. Then run `wildo providers register <ref>` and upload what it builds.
|
|
69
|
+
|
|
70
|
+
## Worked Example
|
|
71
|
+
|
|
72
|
+
A write and a search on a `todos` resource (TIER C: no dogfood application declares a chat command yet, and four lines
|
|
73
|
+
are the whole surface):
|
|
74
|
+
|
|
75
|
+
```ts
|
|
76
|
+
recordLabelFields: ['title'],
|
|
77
|
+
// in operations: the default CREATE variant, then the default SEARCH variant
|
|
78
|
+
{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, chatCommand: { verb: 'add', argument: 'title' } }
|
|
79
|
+
{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, chatCommand: { verb: 'find' } }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
<!-- TIER C WAIVER: no application in the repository declares a chat command yet (the live run is issue #2763), and the declaration is two fields. -->
|
|
83
|
+
|
|
84
|
+
## References
|
|
85
|
+
|
|
86
|
+
- `references/framework-resource-chat-command-contract.md`: the source-backed `chatCommand` and `recordLabelFields`
|
|
87
|
+
contract.
|
|
88
|
+
|
|
89
|
+
## Verification
|
|
90
|
+
|
|
91
|
+
- [ ] Each command's operation is its resource's default, URL-bearing variant (the startup log refuses it otherwise).
|
|
92
|
+
- [ ] Every search or list command's resource declares `recordLabelFields`: the check below prints nothing.
|
|
93
|
+
- [ ] No verb repeats and none is `help`: the second check below prints nothing.
|
|
94
|
+
- [ ] The backend starts with no `chat_command_declaration_violation` in its log.
|
|
95
|
+
- [ ] No resource that declares `recordLabelFields` keeps a ui-behavior `getFrontendResourceLabel`: compare the two
|
|
96
|
+
lists the third check prints, by resource; the frontend refuses a match with `names its records twice`.
|
|
97
|
+
|
|
98
|
+
These checks match a declaration written on one line (`chatCommand: { verb: 'find' }`); read a multi-line one by eye.
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# a resource with a find/list command and no recordLabelFields (review each file it prints)
|
|
102
|
+
rg -l "chatCommand: \{ verb: '[a-z0-9-]+' \}" shared-lib/src | xargs -r rg --files-without-match "recordLabelFields"
|
|
103
|
+
# a verb declared twice, or the reserved one
|
|
104
|
+
rg -o "chatCommand: \{ verb: '[a-z0-9-]+'" shared-lib/src --no-filename | sort | uniq -d
|
|
105
|
+
rg -n "verb: 'help'" shared-lib/src
|
|
106
|
+
# the resources naming records by recordLabelFields, then the ui-behaviors declaring their own label
|
|
107
|
+
rg -l "recordLabelFields" shared-lib/src
|
|
108
|
+
rg -l "getFrontendResourceLabel" frontend/src
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Common Rationalizations
|
|
112
|
+
|
|
113
|
+
| Rationalization | Reality |
|
|
114
|
+
|---|---|
|
|
115
|
+
| "I'll declare it on the variant my UI uses." | Only the DEFAULT, URL-bearing API_CALL variant runs from a chat; startup refuses any other. |
|
|
116
|
+
| "The argument can be the record's parent id." | A chat cannot give an id. An argument that is an id, a credential, backend-only or hidden from edit forms is refused. |
|
|
117
|
+
| "The search will show the id when there is no label." | A read command's resource must declare `recordLabelFields`; startup refuses one without. |
|
|
118
|
+
| "I'll type the Slack command in the app's manifest by hand." | The manifest is derived from the declarations; a hand-typed command runs nothing. |
|
|
119
|
+
|
|
120
|
+
## Red Flags
|
|
121
|
+
|
|
122
|
+
- A `chatCommand` on an update or delete (catch it with the startup log).
|
|
123
|
+
- A search or list command whose resource has no `recordLabelFields` (catch it with the first check above).
|
|
124
|
+
- Two operations declaring the same verb (catch it with the second check above).
|
|
125
|
+
- A resource declaring `recordLabelFields` whose ui-behavior keeps `getFrontendResourceLabel`: a record with two names,
|
|
126
|
+
refused when the frontend starts (catch it with the third check above).
|
|
127
|
+
- A shared `chatCommand` on a polymorphic resource with several scopes: the factory refuses it, because every scope
|
|
128
|
+
would declare the same verb. Declare `polymorphicChatCommand` instead, keyed by the parent resource type of the scope
|
|
129
|
+
the chat runs (`{ [CoreResourceType.ORGANIZATIONS]: { verb: 'add', argument: 'title' } }`).
|
|
130
|
+
|
|
131
|
+
## Related Skills
|
|
132
|
+
|
|
133
|
+
- `provider-slack`, `provider-microsoft-teams-bot`: the handler (`ctx.chat.runCommand()`), the outcome posters and the
|
|
134
|
+
registration.
|
|
135
|
+
- `chat-agent-conversations`: an agent conversation, not a command.
|
|
136
|
+
- `inbound-channels`: inbound handlers in general.
|
|
137
|
+
- `resource-mcp-tool-exposure`: the same operation as a tool for an external agent.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Chat Command Declaration (source-backed)
|
|
2
|
+
|
|
3
|
+
The `chatCommand` field on a resource operation variant, and the resource's `recordLabelFields`: the two
|
|
4
|
+
declarations that turn a resource operation into a command a member runs from Slack or Teams. You author both in
|
|
5
|
+
your resource's configuration (imported from `@wildo-ai/saas-models`).
|
|
6
|
+
|
|
7
|
+
Read this when you need the exact contract:
|
|
8
|
+
|
|
9
|
+
- what `verb` and `argument` are, and which operations are eligible (DEFAULT, non-bulk, URL-bearing, INLINE
|
|
10
|
+
API_CALL; one record made, or a search, or a list);
|
|
11
|
+
- why a read command's resource must declare `recordLabelFields`, and how a record is named by it;
|
|
12
|
+
- why exposure can never widen access (every run is authorized as the member's own request).
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-models`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
*
|
|
24
|
+
* Chat command exposure for this operation: a member runs it from Slack (`/<command> <verb> <text>`) or from
|
|
25
|
+
* a Teams message extension, as themselves, confined to the organization the chat belongs to. Import path:
|
|
26
|
+
* `@wildo-ai/saas-models`, a field on an operation variant inside a resource's `operations` config.
|
|
27
|
+
*
|
|
28
|
+
* Opt-in and fail-closed, like `mcp`: absent, the operation is no command. Only a DEFAULT, non-bulk, URL-bearing, INLINE
|
|
29
|
+
* API_CALL is eligible, and startup refuses the rest (an operation whose route binds a record or a parent id beyond the
|
|
30
|
+
* scope root, one that requires a step-up, one whose roles a chat member can never hold). A write must make ONE record;
|
|
31
|
+
* a SEARCH answers records found by the member's text; a LIST answers the member's first records and takes no argument.
|
|
32
|
+
* A read command's resource must declare `recordLabelFields`, so each result is shown by its name.
|
|
33
|
+
*
|
|
34
|
+
* - `verb`: the word the member types after the command (`add`, `find`), lowercase, unique in the application; `help`
|
|
35
|
+
* is reserved.
|
|
36
|
+
* - `argument`: the request field the member's text fills: required for a write (one top-level string field; every
|
|
37
|
+
* other required field must have a default). A SEARCH's text is its query and a LIST takes none, so neither names one.
|
|
38
|
+
*
|
|
39
|
+
* Exposure decides only that the operation can be ASKED for from a chat. Every run is authorized as the member's own
|
|
40
|
+
* request would be: the operation's roles, the record's reach, the declared rate limit, the service consent.
|
|
41
|
+
*
|
|
42
|
+
* On a polymorphic resource with several scopes, declare `polymorphicChatCommand` instead, keyed by the parent resource
|
|
43
|
+
* type of each scope whose operation the chat runs (usually only `CoreResourceType.ORGANIZATIONS`; two scopes need two
|
|
44
|
+
* verbs): a shared `chatCommand` would give every scope the same verb, and the polymorphic factory refuses it.
|
|
45
|
+
*/
|
|
46
|
+
chatCommand?: {
|
|
47
|
+
verb: string;
|
|
48
|
+
argument?: string;
|
|
49
|
+
};
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Import Origins
|
|
53
|
+
|
|
54
|
+
- `@wildo-ai/saas-models`
|
|
55
|
+
|
|
56
|
+
## Source Excerpts
|
|
57
|
+
|
|
58
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
*
|
|
62
|
+
* The fields that NAME a row of this resource to a person: one to three top-level string fields of its
|
|
63
|
+
* summary row (or a `forwardedLabel` virtual such as an `instanceLabel`), joined by a space. What a chat search result,
|
|
64
|
+
* a chat list or a created record is shown as, and what the application's pages show it as too.
|
|
65
|
+
*
|
|
66
|
+
* It is the record's ONE name. The frontend names a record by it wherever it is declared, and refuses at startup a
|
|
67
|
+
* resource whose ui-behavior also declares `getFrontendResourceLabel`, since that would be a second name the chat never
|
|
68
|
+
* shows. A resource with no chat command may keep a richer `getFrontendResourceLabel` instead. Absent, the backend
|
|
69
|
+
* names no row of this resource, and a read command over it is refused at startup.
|
|
70
|
+
*/
|
|
71
|
+
recordLabelFields?: readonly string[],
|
|
72
|
+
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: resource-config-wiring
|
|
3
|
-
description: Author or modify `*.resources-config.ts` and the matching `*.relationships.ts` for operations, variants, FK relationships, role visibility, and access scope. Use when the user says "wire <field> as a foreign key to <resource>", "add a custom operation to <resource>", "make <op> admin-only", "expose <resource> on <role>", "declare <child> as a child of <parent>", or "change which operations include <relationship>" — anything that changes how a resource shows up in the framework registry, not just its persisted shape or rendered chrome.
|
|
3
|
+
description: Author or modify `*.resources-config.ts` and the matching `*.relationships.ts` for operations, variants, FK relationships, role visibility, and access scope. Use when the user says "wire <field> as a foreign key to <resource>", "add a custom operation to <resource>", "make <op> admin-only", "expose <resource> on <role>", "declare <child> as a child of <parent>", "an action is disabled on every row of the list", or "change which operations include <relationship>" — anything that changes how a resource shows up in the framework registry, not just its persisted shape or rendered chrome.
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -266,13 +266,93 @@ as a denormalized `userEmail`), then to the static `fallback` — never a raw id
|
|
|
266
266
|
never a throw.
|
|
267
267
|
|
|
268
268
|
Guarantees mirror relational search: tenant-safe (only resolves related rows for
|
|
269
|
-
join values already on the caller's scoped page), no per-row N+1
|
|
270
|
-
|
|
271
|
-
|
|
269
|
+
join values already on the caller's scoped page), and no per-row N+1: a LIST
|
|
270
|
+
or SEARCH page resolves every join value it carries in ONE related read. Both storage
|
|
271
|
+
adapters serve the read. A READ carries the field too, in every data mode, so the
|
|
272
|
+
record's own page and breadcrumb use the same name its list row shows.
|
|
273
|
+
|
|
274
|
+
### Naming a PERSON a viewer may not read (`forwardedUserName`)
|
|
275
|
+
|
|
276
|
+
A field holding a user id (`approvedByUserId`, `assignedByUserId`, a reference to
|
|
277
|
+
`users`) prints 24 hexadecimal characters wherever the viewer may not read that
|
|
278
|
+
user, which is most of the time. Add a sibling built with
|
|
279
|
+
`forwardedUserName({ localField: '<the id field>' })` (from `@wildo-ai/saas-models`):
|
|
280
|
+
a virtual field holding the person's profile name, resolved at read time and never
|
|
281
|
+
stored. A person with no profile name reads as absent; their account email is shown
|
|
282
|
+
only where the field opts in (`fallBackToEmail: true`), because a login address is a
|
|
283
|
+
disclosure, not a name. Then:
|
|
284
|
+
|
|
285
|
+
- for a **foreign key**, name the sibling as its fallback in the field's
|
|
286
|
+
`*.ui-behavior.tsx` entry, `.foreignKeyUI({ display: { labelFallbackField: '<sibling>' } })`
|
|
287
|
+
(the application's own schema keeps it out; the framework's shared schemas carry some
|
|
288
|
+
display decorators, which an application need not copy), and hide the sibling from display
|
|
289
|
+
there (`.isHidden({ display: true })`) so the person is not shown twice; declare the
|
|
290
|
+
sibling `.isSummaryField()` in the schema when the key is one;
|
|
291
|
+
- for a plain **who-acted stamp**, show the sibling in the READ layout where the id
|
|
292
|
+
was, and leave the id out of the layout.
|
|
293
|
+
|
|
294
|
+
Only name a person the reading organization may be told about: a person of
|
|
295
|
+
another organization is a disclosure decision, not a display one.
|
|
296
|
+
|
|
297
|
+
When the user id sits INSIDE the row rather than in a top-level field (the decider
|
|
298
|
+
on each entry of a status history, the requester of an embedded question), there is
|
|
299
|
+
no field to stand beside. Declare one virtual directory instead:
|
|
300
|
+
`forwardedUserNameDirectory({ paths: ['statusChanges[].resolution.decidedByUserId', 'suspension.requester.ref'] })`
|
|
301
|
+
(from `@wildo-ai/saas-models`; a segment ending in `[]` walks an array). It holds
|
|
302
|
+
user id → profile name for every id those paths reach, never stored, with no email
|
|
303
|
+
fallback, and it is hidden from display. A READ computes it for its row. A LIST or
|
|
304
|
+
SEARCH page computes it only when you also declare it `.isSummaryField()`, and then
|
|
305
|
+
in one profile read for the whole page; without that, list rows carry no names. A
|
|
306
|
+
path may reach an id that is not a person's (a machine's credential id where the
|
|
307
|
+
same field holds either): no profile matches it, so it stays unnamed. To show the
|
|
308
|
+
names, hand the field display the value with the ids replaced:
|
|
309
|
+
`nameUserIdsAtPaths(row, paths, row.<directory>)` from the same package, which
|
|
310
|
+
leaves an id no profile names as it is, so the gap stays visible. Keep the paths in
|
|
311
|
+
one exported constant read by both, so the lookup and the display cannot drift.
|
|
312
|
+
|
|
313
|
+
### A virtual field of your own that reads another resource
|
|
314
|
+
|
|
315
|
+
`isVirtual({ calculate })` computes a field per row. When the field reads another
|
|
316
|
+
resource, declare `calculateMany` beside it: a list calls it ONCE with every row
|
|
317
|
+
and expects one value per row in the same order, so a page reads that resource
|
|
318
|
+
once instead of once per row. One row (a READ) still goes through `calculate`, so write the derivation once and call it from both (the
|
|
319
|
+
`VirtualFieldParams` reference in `resource-schema-authoring` shows the shape).
|
|
320
|
+
A field declaring `needsObjectContext` or `needsUserContext` is computed per row
|
|
321
|
+
by `calculate` alone.
|
|
272
322
|
|
|
273
323
|
See `references/framework-saas-models-resource-config-api.md` for the full
|
|
274
324
|
`LabelRelationDescriptor` contract.
|
|
275
325
|
|
|
326
|
+
## Row-action conditions on list rows (`enabledConditionFields`)
|
|
327
|
+
|
|
328
|
+
A collection list fetches its rows in SUMMARY mode (only `.isSummaryField()` fields) and
|
|
329
|
+
judges each row's actions against that row. An `enabledCondition` reading any other field
|
|
330
|
+
sees it `undefined` on every row, so the action is disabled on the whole list with no error.
|
|
331
|
+
The framework cannot see inside the condition, so declare what it reads beside it:
|
|
332
|
+
|
|
333
|
+
```ts
|
|
334
|
+
enabledCondition: ({ currentObject }) => currentObject.assignedToUserId !== undefined,
|
|
335
|
+
enabledConditionFields: ['assignedToUserId'], // carried on every SUMMARY row of the resource
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
`enabledConditionFields` CARRIES a field on list rows; `.isSummaryField()` SHOWS it (a table
|
|
339
|
+
column, part of the card). Use `.isSummaryField()` only when the list should display the field.
|
|
340
|
+
A field that is already a summary field needs no entry. The factory refuses a name that is not a
|
|
341
|
+
top-level field of the resource (or of an inheritance variant) and a `.isBackendOnly()` field,
|
|
342
|
+
which no frontend row ever carries. In development, a list names in the console any field a
|
|
343
|
+
condition reads on a SUMMARY row that the row does not carry. The full contract is on
|
|
344
|
+
`enabledConditionFields` in `references/framework-saas-models-resource-config-api.md`.
|
|
345
|
+
|
|
346
|
+
## What a request field offers (`requestFieldOffers`)
|
|
347
|
+
|
|
348
|
+
When an operation refuses some values of a request field for THIS row (a capability the
|
|
349
|
+
relationship's kind does not lend, a unit choice a kind keeps organization-wide), declare what the
|
|
350
|
+
form offers, so the person is never shown a choice that can only be refused. Each entry answers
|
|
351
|
+
`EVERY`, `VALUES` (only these) or `NOT_OFFERED` (the field leaves the form and the request), from
|
|
352
|
+
the row, the fields it `readsFields`, a row a field `readsReferences`, and the application's
|
|
353
|
+
configuration. Call the SAME predicate the operation refuses with. Read
|
|
354
|
+
`references/framework-request-field-offers-api.md` before declaring one.
|
|
355
|
+
|
|
276
356
|
## System-context access (`systemAccessPolicy`)
|
|
277
357
|
|
|
278
358
|
`SystemAccessBackendService` (from `@wildo-ai/saas-backend-lib`) accesses a resource
|
|
@@ -290,6 +370,11 @@ resource**: a verb works ONLY if its `*.resources-config.ts` declares
|
|
|
290
370
|
systemAccessPolicy: { read: ResourceSystemAccessMode.ALLOWED }, // + list / create / update / updateMany as used
|
|
291
371
|
```
|
|
292
372
|
|
|
373
|
+
Each verb needs its operation (`create` → `CREATE`, `update` → `UPDATE`, `exportSubject` → `READ`, …)
|
|
374
|
+
declared with an `API_CALL` or `INTERNAL_CALL` DEFAULT variant: the system door resolves only those.
|
|
375
|
+
The configuration factory refuses an `ALLOWED` verb whose operation is missing or `REPOSITORY_ONLY`,
|
|
376
|
+
naming the verb. For a write that must stay route-less, use `INTERNAL_CALL`.
|
|
377
|
+
|
|
293
378
|
Set it ONLY when a genuine system access exists, and ensure the calling code enforces an
|
|
294
379
|
explicit alternative authorization (token / email-ownership / userless-internal) — the
|
|
295
380
|
bypass relocates the authorization decision onto the caller. A read returns the FULL
|
|
@@ -298,6 +383,20 @@ fields (derived from the schema, never caller-supplied). Distinct from `isSystem
|
|
|
298
383
|
("infrastructure" ≠ "ACL-bypassable"). See
|
|
299
384
|
`references/framework-system-access-reads-api.md`.
|
|
300
385
|
|
|
386
|
+
## A `retentionPolicy` resource owes READ, LIST and UPDATE_MANY
|
|
387
|
+
|
|
388
|
+
Any `retentionPolicy` — `RETAIN_ONLY` included — requires `READ`, `LIST` and `UPDATE_MANY` in the
|
|
389
|
+
core-operation type AND in `coreOperations`, each with an `API_CALL` or `INTERNAL_CALL` default
|
|
390
|
+
variant (`UPDATE_MANY` as `INTERNAL_CALL`, never `REPOSITORY_ONLY`). The erasure writes the row in
|
|
391
|
+
place through `updateManyAsSystem` even when it scrubs nothing. `systemAccessPolicy.updateMany` and
|
|
392
|
+
`seeRetained` are derived for you; never author them `FORBIDDEN`. A typecheck catches a missing
|
|
393
|
+
operation in the core-operation TYPE (the error names
|
|
394
|
+
`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations`); the `coreOperations` array and the
|
|
395
|
+
variant types are checked only when the backend STARTS. Ask that half before the backend does with
|
|
396
|
+
`wildo config check-resources`, which builds every resource configuration and the registry offline
|
|
397
|
+
(the build lane runs it as `check:resources-registry-init`). See
|
|
398
|
+
`references/framework-retention-policy-operations.md` for the rule and a worked example.
|
|
399
|
+
|
|
301
400
|
## References
|
|
302
401
|
|
|
303
402
|
- `references/config-change-routing.md` — review table for which sub-areas a change touches
|
|
@@ -311,14 +410,20 @@ fields (derived from the schema, never caller-supplied). Distinct from `isSystem
|
|
|
311
410
|
- `references/framework-operation-audit-api.md` — what an operation leaves in the audit trail: the risk-driven baseline, `auditBelowRiskFloor`, and the three things the trail will not tell you
|
|
312
411
|
- `references/framework-authority-audit-interpretation.md` — membership and unit authority events, support-grant correlation, scoped queries, and the difference between actor, affected member and retained evidence
|
|
313
412
|
- `references/framework-required-features-api.md` — source-backed `requiredFeatures`: presence checks vs usage `limitChecks`, and why the SCREEN gate is not the security boundary
|
|
413
|
+
- `references/framework-request-field-offers-api.md` — source-backed `requestFieldOffers`: narrowing what a request field offers per row (EVERY / VALUES / NOT_OFFERED), declaring what the offer reads, and why the offer must call the predicate the operation refuses with
|
|
314
414
|
- `references/framework-collection-operation-declarations.md` — what a LIST/SEARCH variant declares (`filterFields`, `sortFields`, `isSearchable`, `maxPaginatedResultPerPageLimit`, `collectionExport`) and what each ABSENCE means — including why omitting `sortFields` is not "no sorting"
|
|
315
415
|
- `references/framework-operation-step-up-api.md` — source-backed `requiresStepUpAuthentication`: gating an irreversible operation behind a fresh proof of identity, why it is per-variant, and the read-shaped operations where it silently enforces nothing
|
|
416
|
+
- `references/framework-operation-approval-api.md` — source-backed `requiresApproval`: making a person's create or change wait until another person approves it (maker-checker): anyone holding a named role, or the one person a registered resolver names, with claim, reassignment and escalation; what the caller is answered, how a request ends, who may ask it, and what startup refuses
|
|
316
417
|
- `references/framework-operation-idempotency-key-api.md` — source-backed `idempotencyKey`: making a provider-backed mutation safe to retry, `ACCEPTED` vs `REQUIRED`, and the half of the contract (remember, replay, refuse reuse) your implementation still owns
|
|
418
|
+
- `references/framework-webhook-events-api.md` — source-backed `m2mNotifications[].events`: which outcomes an operation announces to webhook endpoints (`operation.completed`, `operation.failed` for a failed background run), what each delivery carries, and the refusal on an operation that never runs in the background
|
|
419
|
+
- `references/framework-operation-bulk-api.md` — source-backed `haveBulkOperation` / `bulkOperationMaxSelection` / `bulkServiceRuntimeMode`: acting on many rows, `_ids` vs "all N matching", and when the bulk form should run in the background while the single-row action stays immediate
|
|
420
|
+
- `references/framework-retention-policy-operations.md` — **read before adding any `retentionPolicy`**: the three operations it requires, their variant types, and a worked `RETAIN_ONLY` example
|
|
317
421
|
- `references/framework-personal-data-declaration-api.md` — **read once per resource**: does it hold data about a person, and the four ways to answer (including the checked way to say "no")
|
|
318
422
|
|
|
319
423
|
## Verification
|
|
320
424
|
|
|
321
|
-
- [ ] The resource has ANSWERED the personal-data question — a `retentionPolicy` (`RETAIN_ONLY` is the checked way to say it holds
|
|
425
|
+
- [ ] The resource has ANSWERED the personal-data question — a `retentionPolicy` TOGETHER WITH its `dataSubjectPolicy` (the factory refuses either one alone; `RETAIN_ONLY` + `NO_PRINCIPAL` is the checked way to say it holds no personal data of its own), a `systemAccessPolicy.exportSubject`, or a `.dataCategories()` declaration on the fields that hold it. Start from the decision table in `references/framework-personal-data-declaration-api.md`. Startup warns by name for every application resource that has said nothing.
|
|
426
|
+
- [ ] A resource with a `retentionPolicy` declares `READ`, `LIST` and `UPDATE_MANY` in its core-operation type and `coreOperations`, with `UPDATE_MANY` as an `INTERNAL_CALL` (or `API_CALL`) default — never `REPOSITORY_ONLY` (catch with the retention grep below; the backend otherwise refuses to start)
|
|
322
427
|
- [ ] Every FK in the schema has a matching `createResourcesRelationship(...)` entry in the module relationships file
|
|
323
428
|
- [ ] Every relationship that resolves to multiple FKs to the same parent type sets `foreignKeyField` explicitly
|
|
324
429
|
- [ ] Operations referenced from `*.ui-behavior.tsx` exist in `*.resources-config.ts`
|
|
@@ -330,6 +435,7 @@ fields (derived from the schema, never caller-supplied). Distinct from `isSystem
|
|
|
330
435
|
- [ ] Every relational `searchableFields` entry uses a `localField` that exists on this schema (and a `relatedJoinField` that exists on the related resource — defaults to `_id`)
|
|
331
436
|
- [ ] A junction/row whose identity is a related party is labeled via `forwardedLabel(...)` (a virtual field referenced by `getFrontendResourceLabel`), not a denormalized mutable copy; its `localField` exists on this schema
|
|
332
437
|
- [ ] Every token-bearing notification has a matching token-generation condition and an explicit product recovery path when a lost email matters
|
|
438
|
+
- [ ] Every field an `enabledCondition` reads is a summary field or listed in that variant's `enabledConditionFields` (catch with the condition-fields grep below)
|
|
333
439
|
|
|
334
440
|
### Grep invariants
|
|
335
441
|
|
|
@@ -343,7 +449,16 @@ Run from the app root and substitute the resource / FK field name:
|
|
|
343
449
|
| Custom operation IDs in the UI exist in the resource config | `rg -n "operationLike:\\s*<Resource>_Operations\\." frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
344
450
|
| Same custom operation IDs are defined in the resource config | `rg -n "<Resource>_Operations\\." shared-lib/src/modules/*/resources/<resource>/<resource>.resources-config.ts` |
|
|
345
451
|
| Long-running variants declare their client timeout | `rg -n "clientRequestTimeoutMs" shared-lib/src/modules/*/resources/<resource>/<resource>.resources-config.ts` (expect a hit for any variant that generates/imports synchronously) |
|
|
346
|
-
| The two custom-operation lists agree |
|
|
452
|
+
| The two custom-operation lists agree | see the commands below the table |
|
|
453
|
+
| Every `retentionPolicy` resource declares UPDATE_MANY (expect each listed file in both outputs) | see the commands below the table (must be empty) |
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# The two custom-operation lists agree
|
|
457
|
+
comm -23 <(rg -oN "<Resource>_Operations\\.[A-Z_]+" frontend/src/modules/*/resources/<resource>/*.tsx | sort -u) <(rg -oN "<Resource>_Operations\\.[A-Z_]+" shared-lib/src/modules/*/resources/<resource>/*.ts | sort -u)
|
|
458
|
+
|
|
459
|
+
# Every `retentionPolicy` resource declares UPDATE_MANY (expect each listed file in both outputs)
|
|
460
|
+
comm -23 <(rg -l "retentionPolicy:" shared-lib/src --glob '*.resources-config.ts' | sort) <(rg -l "CoreResourceOperation\.UPDATE_MANY" shared-lib/src --glob '*.resources-config.ts' | sort)
|
|
461
|
+
```
|
|
347
462
|
|
|
348
463
|
The third grep MUST return zero matches — relationship declarations in
|
|
349
464
|
`resources-config.ts` are a layering bug. The `comm` invariant MUST also
|
|
@@ -357,6 +472,11 @@ For `forwardedLabel`, find the descriptors and confirm each `localField` is a re
|
|
|
357
472
|
field on this schema: `rg -n "forwardedLabel\\(" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts`
|
|
358
473
|
(then check the `localField`/`relatedJoinField`/`fallbackField` of each against the schema).
|
|
359
474
|
|
|
475
|
+
For row-action conditions, list each condition with what it declares, then check every
|
|
476
|
+
`currentObject.<field>` it reads against the schema's `.isSummaryField()` fields and its own
|
|
477
|
+
`enabledConditionFields`: `rg -n -A4 "enabledCondition:" shared-lib/src/modules/*/resources/<resource>/<resource>.resources-config.ts`
|
|
478
|
+
and `rg -n "isSummaryField" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts`.
|
|
479
|
+
|
|
360
480
|
For token-bearing notifications, inspect `tokenGeneration` and the authored
|
|
361
481
|
notification together. Their predicates must describe the same operation
|
|
362
482
|
branch, and the template must consume the generated token context.
|
|
@@ -372,6 +492,8 @@ branch, and the template must consume the generated token context.
|
|
|
372
492
|
| "`contextPolicy: {}` is fine for everything" | Empty context policy is fine for low-cardinality compositions. For high-cardinality `REFERENCE` relationships, an explicit `LIST` / `SEARCH` override is mandatory. |
|
|
373
493
|
| "Just denormalize the related resource's name onto this row so SEARCH can match it" | A mutable related field copied onto this row goes stale and needs a sync on every mutation path. Use a relational `searchableFields` descriptor instead — it reuses the related resource's own search at query time, no copy. |
|
|
374
494
|
| "Just denormalize the related resource's name onto this junction so it has a label" | Same staleness/sync trap, display side. Use `forwardedLabel` (a virtual field referenced by `getFrontendResourceLabel`) — it resolves the related name server-side at read time, never stale, and degrades to a `fallbackField` (not a raw id) when absent. |
|
|
495
|
+
| "The action works on the detail page, so its condition is fine" | The detail page reads a FULL row. A list reads SUMMARY rows, where a non-summary field is absent, so the same action is disabled on every list row. List the fields the condition reads in `enabledConditionFields`. |
|
|
496
|
+
| "Just make the field `.isSummaryField()` so the condition sees it" | That also makes it a table column and part of every card and preview. If the list should not show it, `enabledConditionFields` carries it without displaying it. |
|
|
375
497
|
| "Post-commit means the email is guaranteed" | Post-commit protects the database mutation from external I/O and prevents sends from aborted attempts. It does not replay a send lost after commit; use an explicit product recovery operation or justify a generic outbox separately. |
|
|
376
498
|
|
|
377
499
|
## Red Flags
|
|
@@ -381,9 +503,11 @@ branch, and the template must consume the generated token context.
|
|
|
381
503
|
- `createResourcesRelationship` called from inside `*.resources-config.ts` (catch with the **Relationship is co-located** grep — should be empty).
|
|
382
504
|
- Custom operation referenced from UI behavior but not declared in `resources-config.ts` (catch with the **comm** invariant above).
|
|
383
505
|
- High-cardinality `REFERENCE` relationship with `contextPolicy: {}` and no `LIST`/`SEARCH` override (manual review — N+1 risk).
|
|
384
|
-
- Relational `searchableFields` entry whose `localField` is not a field on this resource's schema (catch with the **relational search** `rg -n "localField:"` invariant above)
|
|
506
|
+
- Relational `searchableFields` entry whose `localField` is not a field on this resource's schema (catch with the **relational search** `rg -n "localField:"` invariant above).
|
|
385
507
|
- A junction/row labeled by a denormalized copy of a related resource's MUTABLE name instead of `forwardedLabel` (manual review — staleness trap), or a `forwardedLabel` whose `localField` is not a field on this schema (catch with the `forwardedLabel` `localField` grep below).
|
|
386
508
|
- Token generation and its notification use different conditions, leaving a live token without an email or an email without a usable token.
|
|
509
|
+
- An `enabledCondition` reading `currentObject.<field>` where the field is neither `.isSummaryField()` nor in the variant's `enabledConditionFields` (catch with the **row-action conditions** greps above), or a development console warning naming one.
|
|
510
|
+
- A `retentionPolicy` (even `RETAIN_ONLY`) on a resource whose `coreOperations` lack `UPDATE_MANY`, or whose `UPDATE_MANY` is `REPOSITORY_ONLY` (catch with the **retentionPolicy declares UPDATE_MANY** `comm` invariant above). When the core-operation type still lists it, it typechecks, and the backend then refuses to start.
|
|
387
511
|
|
|
388
512
|
## Related Skills
|
|
389
513
|
|
|
@@ -91,11 +91,11 @@ export enum AdministrativeContinuityErrorCode {
|
|
|
91
91
|
LAST_ORGANIZATION_OWNER = 'LAST_ORGANIZATION_OWNER',
|
|
92
92
|
|
|
93
93
|
/**
|
|
94
|
-
* `grantOwnership` was asked to make a
|
|
95
|
-
*
|
|
96
|
-
*
|
|
94
|
+
* `grantOwnership` was asked to make a REPRESENTATIVE membership (#1597 — a representative, present through the
|
|
95
|
+
* granting organization's relationship) an owner. Refused: an organization whose owner is a representative
|
|
96
|
+
* still cannot administer itself, and the floor never counts such a row. Remedy:
|
|
97
97
|
* grant ownership to one of the organization's OWN members.
|
|
98
98
|
*/
|
|
99
|
-
|
|
99
|
+
RELATIONSHIP_MEMBERSHIP_CANNOT_OWN = 'RELATIONSHIP_MEMBERSHIP_CANNOT_OWN',
|
|
100
100
|
}
|
|
101
101
|
```
|
|
@@ -96,14 +96,20 @@ availability of evidence as separate claims.
|
|
|
96
96
|
|
|
97
97
|
## Application audit read policy
|
|
98
98
|
|
|
99
|
-
`auditTrail.applicationReadAccess`
|
|
100
|
-
environment
|
|
101
|
-
|
|
102
|
-
|
|
99
|
+
When `auditTrail.applicationReadAccess` is not declared, the application's shape decides it, in every
|
|
100
|
+
environment: `AuditApplicationReadAccess.INDEPENDENT_APPROVAL` when the operator is a third party to the parties of
|
|
101
|
+
some relationship kind (the `ownsApplication` type represents nobody in a kind declared under
|
|
102
|
+
`organizationRelationships`), and `AuditApplicationReadAccess.ROLE_BASED` otherwise. `resolveAuditApplicationReadAccess` from
|
|
103
|
+
`@wildo-ai/saas-models` gives the effective policy. Under `ROLE_BASED`, holders of
|
|
104
|
+
`CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN` or the read-only `CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER` can read
|
|
105
|
+
the application audit trail without a second approval; scope filters and cross-tenant observations still
|
|
106
|
+
apply. Give the evidence reader — not super-admin — to a
|
|
103
107
|
party that must read the trail and must not administer the application: an assurance collector's machine
|
|
104
|
-
credential or an external auditor. It inherits no other role.
|
|
108
|
+
credential or an external auditor. It inherits no other role. Declare
|
|
105
109
|
`AuditApplicationReadAccess.INDEPENDENT_APPROVAL` when the application requires a time-bound
|
|
106
|
-
grant signed by a different administrator
|
|
110
|
+
grant signed by a different administrator and its shape does not already imply it, or declare `ROLE_BASED` to
|
|
111
|
+
keep the role alone in an application whose relationship parties are independent of its operator. Import the enum from
|
|
112
|
+
`@wildo-ai/saas-models`.
|
|
107
113
|
|
|
108
114
|
A role-based audit read can therefore legitimately have no `authorizingGrantId`. Do not invent a
|
|
109
115
|
grant or infer refusal from that absence: correlate the operation, configured policy, actor roles
|
|
@@ -115,7 +121,9 @@ application audit door also records `machine_access` (`resourceServer: api`, `op
|
|
|
115
121
|
`api_read` or `api_search`) even when it returned no tenant's rows. A collector counting audit rows should
|
|
116
122
|
exclude the rows its own credential wrote, or each run counts the previous run's reads.
|
|
117
123
|
|
|
118
|
-
Under `INDEPENDENT_APPROVAL`
|
|
124
|
+
Under `INDEPENDENT_APPROVAL` the same grant admits the assurance evidence doors
|
|
125
|
+
(`/assurance/*-evidence`, `/assurance/scheduled-evidence-coverage`), and each read's
|
|
126
|
+
`platform_directory_access` row names it. A machine reads only through an application access grant bound to its
|
|
119
127
|
credential: an administrator requests it with `grantedMachineCredential` (an active, unexpired API key or
|
|
120
128
|
OAuth client of this application), a DIFFERENT administrator approves it, and the grant admits that credential
|
|
121
129
|
and never the administrator who requested it. A machine credential can also ask the token endpoint for a
|
|
@@ -134,7 +142,8 @@ const auditTrail: AuditTrailConfig = {
|
|
|
134
142
|
};
|
|
135
143
|
```
|
|
136
144
|
|
|
137
|
-
Omitting `applicationReadAccess` selects
|
|
145
|
+
Omitting `applicationReadAccess` selects the shape's default: independent approval when the parties of some
|
|
146
|
+
relationship kind are independent of the operator, role-based access otherwise. The stronger universal
|
|
138
147
|
`WILDO.ACCESS.SEGREGATION_OF_DUTIES@1` claim must not be accepted on the strength of a directory-only
|
|
139
148
|
elevation test when audit reads intentionally use the role-based policy.
|
|
140
149
|
|