@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- 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 +55 -10
- 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.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -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 +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -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 +8 -3
- 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 +1 -1
- 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 +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -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 +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- 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 +0 -1
- 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 +10 -3
- 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 +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +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-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- 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 +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- 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 +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- 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 +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,447 @@
|
|
|
1
|
+
# Collection-export PDF template contracts (source)
|
|
2
|
+
|
|
3
|
+
- **`PdfCollectionTemplateDefinition` / `definePdfCollectionTemplate`** — backend-only template that renders the ROWS of a LIST/SEARCH export into one downloaded PDF.
|
|
4
|
+
- **`createGovernedDocumentsPdfTemplate`** — ready-made collection template printing governed documents (cover, contents, one section per document with its standing and clauses).
|
|
5
|
+
|
|
6
|
+
Read this when declaring `collectionExport: { formats: [ResourceCollectionExportFormat.PDF], pdfTemplateId }` on a LIST/SEARCH variant, or when authoring the template it names.
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/saas-backend-lib`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
*
|
|
18
|
+
* Input to a collection-export PDF template: the rows a listing's export returned (#1645).
|
|
19
|
+
*
|
|
20
|
+
* The rows are exactly what the source LIST/SEARCH operation answered for this caller — same tenant
|
|
21
|
+
* scope, roles, contextual filters and field stripping — because the export re-runs that operation.
|
|
22
|
+
* A template therefore cannot show more than the caller could read in the listing itself.
|
|
23
|
+
*/
|
|
24
|
+
export interface PdfCollectionBuildContextInput<TRow = Record<string, unknown>> {
|
|
25
|
+
/** The exported rows, in the listing's order. */
|
|
26
|
+
rows: readonly TRow[];
|
|
27
|
+
/** The resource the listing belongs to. */
|
|
28
|
+
resourceType: ResourceType;
|
|
29
|
+
/** Execution context of the SOURCE listing: auth, scope and audit attribution. */
|
|
30
|
+
executionContext: ExecutionContext<any>;
|
|
31
|
+
/** Locale chosen for this render. */
|
|
32
|
+
locale: string;
|
|
33
|
+
/** When the export was requested — print it rather than reading the clock inside `body`. */
|
|
34
|
+
generatedAt: Date;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Backend-only PDF template that renders a WHOLE collection export into one document (#1645).
|
|
39
|
+
*
|
|
40
|
+
* ## Why this is not `PdfTemplateDefinition`
|
|
41
|
+
*
|
|
42
|
+
* A `PdfTemplateDefinition` renders ONE record into a stored file field: its input is the record being
|
|
43
|
+
* created or regenerated. A collection template renders the rows of a listing into a document the
|
|
44
|
+
* caller downloads and nothing stores. Different input, different lifecycle, so a different type; the
|
|
45
|
+
* two share only the renderer.
|
|
46
|
+
*
|
|
47
|
+
* Declared on a LIST/SEARCH operation by `collectionExport: { formats: [PDF], pdfTemplateId }`, and
|
|
48
|
+
* bound at startup through the backend module's `pdfCollectionExportTemplates` slot. The backend
|
|
49
|
+
* refuses to boot when an export names a template nothing provides.
|
|
50
|
+
*
|
|
51
|
+
* @example
|
|
52
|
+
* export const invoicesDigestTemplate = definePdfCollectionTemplate<InvoiceRow, { rows: InvoiceRow[] }>({
|
|
53
|
+
* id: 'my-app.invoices.digest.v1',
|
|
54
|
+
* buildContext: async ({ rows }) => ({ rows: [...rows] }),
|
|
55
|
+
* body: ({ context }) => createElement(Document, null, ...),
|
|
56
|
+
* });
|
|
57
|
+
*/
|
|
58
|
+
export interface PdfCollectionTemplateDefinition<TRow = Record<string, unknown>, TContext = unknown> {
|
|
59
|
+
/** Stable id, named by `collectionExport.pdfTemplateId`. */
|
|
60
|
+
id: string;
|
|
61
|
+
/**
|
|
62
|
+
* Optional locale-keyed label maps, resolved exact-locale, then base language, then the first
|
|
63
|
+
* declared locale, and handed to `body()` as one flat map.
|
|
64
|
+
*/
|
|
65
|
+
labels?: Record<string, Record<string, string>>;
|
|
66
|
+
/** Build the render context. The only hook intended to perform I/O. */
|
|
67
|
+
buildContext(input: PdfCollectionBuildContextInput<TRow>): Promise<TContext>;
|
|
68
|
+
/** Build the React-PDF document from the context. No I/O here. */
|
|
69
|
+
body(props: { context: TContext; locale: string; labels: Record<string, string> }): ReactElement;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Authoring helper: keeps the row and context types at the call site; performs no registration. */
|
|
73
|
+
export function definePdfCollectionTemplate<TRow, TContext>(
|
|
74
|
+
template: PdfCollectionTemplateDefinition<TRow, TContext>,
|
|
75
|
+
): PdfCollectionTemplateDefinition<TRow, TContext> {
|
|
76
|
+
return template;
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Import Origins
|
|
81
|
+
|
|
82
|
+
- `@wildo-ai/saas-backend-lib`
|
|
83
|
+
|
|
84
|
+
## Source Excerpts
|
|
85
|
+
|
|
86
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
87
|
+
|
|
88
|
+
```typescript
|
|
89
|
+
*
|
|
90
|
+
* What one exported row contributes to the governed-documents PDF (#1645), as `resolveSources` answers it.
|
|
91
|
+
*
|
|
92
|
+
* `document` is the content a reader would be shown: the document's release when it has one, else its
|
|
93
|
+
* latest draft — the same `GovernedDocumentPublicDocument` a public page renders. `null` means the
|
|
94
|
+
* document is declared but nothing has been composed for it yet; it still gets a page saying so, because
|
|
95
|
+
* a document that silently drops out of the bundle reads as a document that does not exist.
|
|
96
|
+
*/
|
|
97
|
+
export interface GovernedDocumentsPdfSource {
|
|
98
|
+
/** Shown when `document` is null; otherwise the content's own title is used. */
|
|
99
|
+
title: string;
|
|
100
|
+
document: GovernedDocumentPublicDocument | null;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** Where a document stands, as the PDF tells its reader. Derived, never authored. */
|
|
104
|
+
export enum GovernedDocumentsPdfStanding {
|
|
105
|
+
/** A release that has been approved: the published text. */
|
|
106
|
+
RELEASED_APPROVED = 'RELEASED_APPROVED',
|
|
107
|
+
/** A composed release nobody has approved yet: true text, not a published document. */
|
|
108
|
+
RELEASED_UNAPPROVED = 'RELEASED_UNAPPROVED',
|
|
109
|
+
/** A release whose `expiresAt` has passed at the export instant: no longer in force, whatever its approval. */
|
|
110
|
+
RELEASE_EXPIRED = 'RELEASE_EXPIRED',
|
|
111
|
+
/** The latest draft of a document that was never released. */
|
|
112
|
+
UNRELEASED_DRAFT = 'UNRELEASED_DRAFT',
|
|
113
|
+
/** Declared, and nothing composed yet. */
|
|
114
|
+
NOT_COMPOSED = 'NOT_COMPOSED',
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** The kinds of text block a clause's markdown is flattened into. */
|
|
118
|
+
export enum PdfTextBlockKind {
|
|
119
|
+
HEADING = 'HEADING',
|
|
120
|
+
PARAGRAPH = 'PARAGRAPH',
|
|
121
|
+
LIST_ITEM = 'LIST_ITEM',
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
export interface PdfTextBlock {
|
|
125
|
+
kind: PdfTextBlockKind;
|
|
126
|
+
text: string;
|
|
127
|
+
/** The item's marker (`•`, `1.`) — present exactly for a list item. */
|
|
128
|
+
marker?: string;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* Flatten a clause's `bodyMarkdown` into text blocks a PDF can lay out.
|
|
133
|
+
*
|
|
134
|
+
* A public document's markdown is rendered as TEXT everywhere (it is never trusted as HTML), so this
|
|
135
|
+
* keeps the structure a reader needs — paragraphs, list items, sub-headings — and drops inline
|
|
136
|
+
* emphasis marks rather than interpreting them. A link keeps its target beside its text, because a
|
|
137
|
+
* printed page cannot be clicked.
|
|
138
|
+
*/
|
|
139
|
+
export function markdownToPdfTextBlocks(markdown: string): PdfTextBlock[] {
|
|
140
|
+
const blocks: PdfTextBlock[] = [];
|
|
141
|
+
let paragraph: string[] = [];
|
|
142
|
+
const flushParagraph = () => {
|
|
143
|
+
if (paragraph.length > 0) {
|
|
144
|
+
blocks.push({ kind: PdfTextBlockKind.PARAGRAPH, text: stripInlineMarkdown(paragraph.join(' ')) });
|
|
145
|
+
paragraph = [];
|
|
146
|
+
}
|
|
147
|
+
};
|
|
148
|
+
for (const rawLine of markdown.split(/\r?\n/)) {
|
|
149
|
+
const line = rawLine.trim();
|
|
150
|
+
if (line === '') {
|
|
151
|
+
flushParagraph();
|
|
152
|
+
continue;
|
|
153
|
+
}
|
|
154
|
+
const heading = /^#{1,6}\s+(.*)$/.exec(line);
|
|
155
|
+
if (heading) {
|
|
156
|
+
flushParagraph();
|
|
157
|
+
blocks.push({ kind: PdfTextBlockKind.HEADING, text: stripInlineMarkdown(heading[1]) });
|
|
158
|
+
continue;
|
|
159
|
+
}
|
|
160
|
+
const bullet = /^[-*+]\s+(.*)$/.exec(line);
|
|
161
|
+
const numbered = /^(\d+)[.)]\s+(.*)$/.exec(line);
|
|
162
|
+
if (bullet || numbered) {
|
|
163
|
+
flushParagraph();
|
|
164
|
+
blocks.push(bullet
|
|
165
|
+
? { kind: PdfTextBlockKind.LIST_ITEM, marker: '•', text: stripInlineMarkdown(bullet[1]) }
|
|
166
|
+
: { kind: PdfTextBlockKind.LIST_ITEM, marker: `${numbered![1]}.`, text: stripInlineMarkdown(numbered![2]) });
|
|
167
|
+
continue;
|
|
168
|
+
}
|
|
169
|
+
paragraph.push(line);
|
|
170
|
+
}
|
|
171
|
+
flushParagraph();
|
|
172
|
+
return blocks;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
function stripInlineMarkdown(text: string): string {
|
|
176
|
+
return text
|
|
177
|
+
.replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1')
|
|
178
|
+
.replace(/\[([^\]]+)\]\(([^)\s]+)[^)]*\)/g, (_match, label: string, target: string) => (label === target ? label : `${label} (${target})`))
|
|
179
|
+
.replace(/\*\*([^*]+)\*\*/g, '$1')
|
|
180
|
+
.replace(/__([^_]+)__/g, '$1')
|
|
181
|
+
.replace(/\*([^*]+)\*/g, '$1')
|
|
182
|
+
.replace(/`([^`]+)`/g, '$1');
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
interface GovernedDocumentsPdfClause {
|
|
186
|
+
blocks: PdfTextBlock[];
|
|
187
|
+
/** Present exactly when the clause is not yet established: what it still lacks, in the reader's terms. */
|
|
188
|
+
missingInformation?: string;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
interface GovernedDocumentsPdfEntry {
|
|
192
|
+
title: string;
|
|
193
|
+
standing: GovernedDocumentsPdfStanding;
|
|
194
|
+
/** Release number, effective date and — for an expired one — the day it lapsed. */
|
|
195
|
+
release?: { version: number; effectiveOn: string; expiredOn?: string };
|
|
196
|
+
sections: { title: string; clauses: GovernedDocumentsPdfClause[] }[];
|
|
197
|
+
notYetEstablishedClauseCount: number;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
export interface GovernedDocumentsPdfContext {
|
|
201
|
+
generatedOn: string;
|
|
202
|
+
entries: GovernedDocumentsPdfEntry[];
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
function toEntry(source: GovernedDocumentsPdfSource, generatedAt: Date): GovernedDocumentsPdfEntry {
|
|
206
|
+
if (source.document === null) {
|
|
207
|
+
return { title: source.title, standing: GovernedDocumentsPdfStanding.NOT_COMPOSED, sections: [], notYetEstablishedClauseCount: 0 };
|
|
208
|
+
}
|
|
209
|
+
// Parsed, not trusted: the schema is what guarantees a marked clause says what it lacks.
|
|
210
|
+
const document = GovernedDocumentPublicDocumentSchema.parse(source.document);
|
|
211
|
+
const sections = document.content.sections.map((section) => ({
|
|
212
|
+
title: section.title,
|
|
213
|
+
clauses: section.clauses.map((clause) => ({
|
|
214
|
+
blocks: markdownToPdfTextBlocks(clause.bodyMarkdown),
|
|
215
|
+
missingInformation: clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED ? clause.missingInformation : undefined,
|
|
216
|
+
})),
|
|
217
|
+
}));
|
|
218
|
+
const notYetEstablishedClauseCount = sections.reduce(
|
|
219
|
+
(count, section) => count + section.clauses.filter((clause) => clause.missingInformation !== undefined).length,
|
|
220
|
+
0,
|
|
221
|
+
);
|
|
222
|
+
if (document.kind === GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT) {
|
|
223
|
+
return { title: document.content.title, standing: GovernedDocumentsPdfStanding.UNRELEASED_DRAFT, sections, notYetEstablishedClauseCount };
|
|
224
|
+
}
|
|
225
|
+
// Expiry is judged at the EXPORT instant, the same instant the cover prints, so a file never calls a
|
|
226
|
+
// release current on a day it had already lapsed.
|
|
227
|
+
const expired = document.release.expiresAt !== undefined && Date.parse(document.release.expiresAt) <= generatedAt.getTime();
|
|
228
|
+
return {
|
|
229
|
+
title: document.content.title,
|
|
230
|
+
standing: expired
|
|
231
|
+
? GovernedDocumentsPdfStanding.RELEASE_EXPIRED
|
|
232
|
+
: document.approvalState === GovernedDocumentReleaseApprovalState.APPROVED
|
|
233
|
+
? GovernedDocumentsPdfStanding.RELEASED_APPROVED
|
|
234
|
+
: GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED,
|
|
235
|
+
release: {
|
|
236
|
+
version: document.release.identity.releaseVersion,
|
|
237
|
+
effectiveOn: document.release.effectiveAt.slice(0, 10),
|
|
238
|
+
...(expired ? { expiredOn: document.release.expiresAt!.slice(0, 10) } : {}),
|
|
239
|
+
},
|
|
240
|
+
sections,
|
|
241
|
+
notYetEstablishedClauseCount,
|
|
242
|
+
};
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* The words of the governed-documents PDF, per locale. A key missing from the resolved map renders as
|
|
247
|
+
* the key itself, so an unauthored label looks unauthored rather than borrowing invented text.
|
|
248
|
+
*/
|
|
249
|
+
export const GOVERNED_DOCUMENTS_PDF_LABELS: Record<string, Record<string, string>> = {
|
|
250
|
+
en: {
|
|
251
|
+
coverEyebrow: 'Governed documents',
|
|
252
|
+
coverTitle: 'Compliance documents',
|
|
253
|
+
generatedOn: 'Generated on {date}',
|
|
254
|
+
documentCount: 'Documents in this file: {count}',
|
|
255
|
+
contents: 'Contents',
|
|
256
|
+
empty: 'This application has no governed documents.',
|
|
257
|
+
[GovernedDocumentsPdfStanding.RELEASED_APPROVED]: 'Release {version}, effective {date}',
|
|
258
|
+
[GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'Release {version}, effective {date} — not approved',
|
|
259
|
+
[GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'Release {version}, expired {expiredDate}',
|
|
260
|
+
[GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'Draft — never released',
|
|
261
|
+
[GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'Not composed yet',
|
|
262
|
+
unapprovedNotice: 'This release has not been approved. It is not a published document.',
|
|
263
|
+
expiredNotice: 'This release has expired. It is no longer in force.',
|
|
264
|
+
draftNotice: 'This document is a draft. It has never been released and is not in force.',
|
|
265
|
+
notComposedNotice: 'Nothing has been composed for this document yet.',
|
|
266
|
+
incompleteNotice: 'Clauses not yet established: {count}',
|
|
267
|
+
notYetEstablished: 'Not yet established: {detail}',
|
|
268
|
+
page: 'Page {page} of {total}',
|
|
269
|
+
},
|
|
270
|
+
fr: {
|
|
271
|
+
coverEyebrow: 'Documents gouvernés',
|
|
272
|
+
coverTitle: 'Documents de conformité',
|
|
273
|
+
generatedOn: 'Généré le {date}',
|
|
274
|
+
documentCount: 'Documents dans ce fichier : {count}',
|
|
275
|
+
contents: 'Sommaire',
|
|
276
|
+
empty: "Cette application n'a aucun document gouverné.",
|
|
277
|
+
[GovernedDocumentsPdfStanding.RELEASED_APPROVED]: 'Version publiée {version}, en vigueur le {date}',
|
|
278
|
+
[GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'Version publiée {version}, en vigueur le {date} — non approuvée',
|
|
279
|
+
[GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'Version publiée {version}, expirée le {expiredDate}',
|
|
280
|
+
[GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'Brouillon — jamais publié',
|
|
281
|
+
[GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'Pas encore rédigé',
|
|
282
|
+
unapprovedNotice: "Cette version n'a pas été approuvée. Ce n'est pas un document publié.",
|
|
283
|
+
expiredNotice: "Cette version a expiré. Elle n'est plus en vigueur.",
|
|
284
|
+
draftNotice: "Ce document est un brouillon. Il n'a jamais été publié et n'est pas en vigueur.",
|
|
285
|
+
notComposedNotice: "Rien n'a encore été rédigé pour ce document.",
|
|
286
|
+
incompleteNotice: 'Clauses pas encore établies : {count}',
|
|
287
|
+
notYetEstablished: 'Pas encore établi : {detail}',
|
|
288
|
+
page: 'Page {page} sur {total}',
|
|
289
|
+
},
|
|
290
|
+
};
|
|
291
|
+
|
|
292
|
+
function word(labels: Record<string, string>, key: string, params: Record<string, string | number> = {}): string {
|
|
293
|
+
const template = labels[key] ?? key;
|
|
294
|
+
return template.replace(/\{(\w+)\}/g, (match, name: string) => (name in params ? String(params[name]) : match));
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
function standingLine(entry: GovernedDocumentsPdfEntry, labels: Record<string, string>): string {
|
|
298
|
+
return word(labels, entry.standing, entry.release
|
|
299
|
+
? { version: entry.release.version, date: entry.release.effectiveOn, expiredDate: entry.release.expiredOn ?? '' }
|
|
300
|
+
: {});
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
const NOTICE_BY_STANDING: Partial<Record<GovernedDocumentsPdfStanding, string>> = {
|
|
304
|
+
[GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'unapprovedNotice',
|
|
305
|
+
[GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'expiredNotice',
|
|
306
|
+
[GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'draftNotice',
|
|
307
|
+
[GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'notComposedNotice',
|
|
308
|
+
};
|
|
309
|
+
|
|
310
|
+
const styles = StyleSheet.create({
|
|
311
|
+
// No `lineHeight` here: set on the PAGE it is inherited by the fixed footer, and React-PDF 4.5 then
|
|
312
|
+
// drops a `render`-prop Text entirely — the page numbers vanish with no error. Measured; it is set on
|
|
313
|
+
// the text styles below instead.
|
|
314
|
+
page: { paddingTop: 48, paddingBottom: 56, paddingHorizontal: 48, fontSize: 10.5, fontFamily: 'Helvetica', color: '#111827' },
|
|
315
|
+
eyebrow: { fontSize: 9, textTransform: 'uppercase', color: '#6b7280', marginBottom: 6 },
|
|
316
|
+
coverTitle: { fontSize: 26, fontFamily: 'Helvetica-Bold', marginBottom: 10 },
|
|
317
|
+
meta: { fontSize: 10, color: '#4b5563', marginBottom: 2 },
|
|
318
|
+
contentsHeading: { fontSize: 13, fontFamily: 'Helvetica-Bold', marginTop: 28, marginBottom: 10 },
|
|
319
|
+
contentsRow: { flexDirection: 'row', marginBottom: 6 },
|
|
320
|
+
contentsNumber: { width: 24, color: '#6b7280' },
|
|
321
|
+
contentsTitle: { flex: 1 },
|
|
322
|
+
contentsStanding: { fontSize: 9, color: '#6b7280' },
|
|
323
|
+
documentTitle: { fontSize: 18, fontFamily: 'Helvetica-Bold', marginBottom: 4 },
|
|
324
|
+
standing: { fontSize: 10, color: '#4b5563', marginBottom: 10 },
|
|
325
|
+
notice: { padding: 8, marginBottom: 12, lineHeight: 1.4, backgroundColor: '#fef3c7', color: '#78350f', fontSize: 10 },
|
|
326
|
+
sectionTitle: { fontSize: 13, fontFamily: 'Helvetica-Bold', marginTop: 14, marginBottom: 6 },
|
|
327
|
+
clause: { marginBottom: 8 },
|
|
328
|
+
heading: { fontFamily: 'Helvetica-Bold', marginTop: 4, marginBottom: 2 },
|
|
329
|
+
paragraph: { marginBottom: 4, lineHeight: 1.45 },
|
|
330
|
+
listItem: { flexDirection: 'row', marginBottom: 2, paddingLeft: 8 },
|
|
331
|
+
listMarker: { width: 16 },
|
|
332
|
+
listText: { flex: 1, lineHeight: 1.45 },
|
|
333
|
+
missing: { marginTop: 2, padding: 6, lineHeight: 1.4, borderLeftWidth: 2, borderLeftColor: '#d97706', backgroundColor: '#fffbeb', fontSize: 9.5, color: '#78350f' },
|
|
334
|
+
footer: { position: 'absolute', bottom: 24, left: 48, right: 48, fontSize: 8.5, color: '#9ca3af', textAlign: 'right' },
|
|
335
|
+
});
|
|
336
|
+
|
|
337
|
+
function footer(labels: Record<string, string>): ReactElement {
|
|
338
|
+
return createElement(Text, {
|
|
339
|
+
style: styles.footer,
|
|
340
|
+
fixed: true,
|
|
341
|
+
render: ({ pageNumber, totalPages }: { pageNumber: number; totalPages: number }) => word(labels, 'page', { page: pageNumber, total: totalPages }),
|
|
342
|
+
});
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
function renderBlock(block: PdfTextBlock, key: number): ReactNode {
|
|
346
|
+
if (block.kind === PdfTextBlockKind.LIST_ITEM) {
|
|
347
|
+
return createElement(View, { key, style: styles.listItem },
|
|
348
|
+
createElement(Text, { style: styles.listMarker }, block.marker ?? ''),
|
|
349
|
+
createElement(Text, { style: styles.listText }, block.text));
|
|
350
|
+
}
|
|
351
|
+
return createElement(Text, { key, style: block.kind === PdfTextBlockKind.HEADING ? styles.heading : styles.paragraph }, block.text);
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
function coverPage(context: GovernedDocumentsPdfContext, labels: Record<string, string>): ReactElement {
|
|
355
|
+
const contents = context.entries.length === 0
|
|
356
|
+
? [createElement(Text, { key: 'empty', style: styles.meta }, word(labels, 'empty'))]
|
|
357
|
+
: context.entries.map((entry, index) =>
|
|
358
|
+
createElement(View, { key: index, style: styles.contentsRow, wrap: false },
|
|
359
|
+
createElement(Text, { style: styles.contentsNumber }, `${index + 1}.`),
|
|
360
|
+
createElement(View, { style: styles.contentsTitle },
|
|
361
|
+
createElement(Text, null, entry.title),
|
|
362
|
+
createElement(Text, { style: styles.contentsStanding }, standingLine(entry, labels)))));
|
|
363
|
+
return createElement(Page, { size: 'A4', style: styles.page },
|
|
364
|
+
createElement(Text, { style: styles.eyebrow }, word(labels, 'coverEyebrow')),
|
|
365
|
+
createElement(Text, { style: styles.coverTitle }, word(labels, 'coverTitle')),
|
|
366
|
+
createElement(Text, { style: styles.meta }, word(labels, 'generatedOn', { date: context.generatedOn })),
|
|
367
|
+
createElement(Text, { style: styles.meta }, word(labels, 'documentCount', { count: context.entries.length })),
|
|
368
|
+
createElement(Text, { style: styles.contentsHeading }, word(labels, 'contents')),
|
|
369
|
+
...contents,
|
|
370
|
+
footer(labels));
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
function documentPage(entry: GovernedDocumentsPdfEntry, index: number, labels: Record<string, string>): ReactElement {
|
|
374
|
+
const noticeKey = NOTICE_BY_STANDING[entry.standing];
|
|
375
|
+
return createElement(Page, { key: index, size: 'A4', style: styles.page, wrap: true },
|
|
376
|
+
createElement(Text, { style: styles.eyebrow }, `${index + 1}.`),
|
|
377
|
+
createElement(Text, { style: styles.documentTitle }, entry.title),
|
|
378
|
+
createElement(Text, { style: styles.standing }, standingLine(entry, labels)),
|
|
379
|
+
noticeKey ? createElement(Text, { style: styles.notice }, word(labels, noticeKey)) : null,
|
|
380
|
+
entry.notYetEstablishedClauseCount > 0
|
|
381
|
+
? createElement(Text, { style: styles.notice }, word(labels, 'incompleteNotice', { count: entry.notYetEstablishedClauseCount }))
|
|
382
|
+
: null,
|
|
383
|
+
...entry.sections.map((section, sectionIndex) =>
|
|
384
|
+
createElement(View, { key: sectionIndex },
|
|
385
|
+
createElement(Text, { style: styles.sectionTitle, minPresenceAhead: 40 }, section.title),
|
|
386
|
+
...section.clauses.map((clause, clauseIndex) =>
|
|
387
|
+
createElement(View, { key: clauseIndex, style: styles.clause },
|
|
388
|
+
...clause.blocks.map(renderBlock),
|
|
389
|
+
clause.missingInformation !== undefined
|
|
390
|
+
? createElement(Text, { style: styles.missing }, word(labels, 'notYetEstablished', { detail: clause.missingInformation }))
|
|
391
|
+
: null)))),
|
|
392
|
+
footer(labels));
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
/**
|
|
396
|
+
* The engine's governed-documents PDF: a cover with contents, then one section per document with its
|
|
397
|
+
* standing, its release line, and every clause — each not-yet-established clause marked with what it
|
|
398
|
+
* still lacks (#1645).
|
|
399
|
+
*
|
|
400
|
+
* The standing is the first thing under each title on purpose. A reviewer handed this file must not be
|
|
401
|
+
* able to mistake a draft, or an unapproved release, for the application's published text; the same
|
|
402
|
+
* rule the public pages follow (`GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT` "must SAY it is
|
|
403
|
+
* a draft").
|
|
404
|
+
*
|
|
405
|
+
* Bound like any collection-export template: a LIST export declares
|
|
406
|
+
* `collectionExport: { formats: [ResourceCollectionExportFormat.PDF], pdfTemplateId: <id> }` and the
|
|
407
|
+
* backend module lists the template in `pdfCollectionExportTemplates`.
|
|
408
|
+
*
|
|
409
|
+
* ## The rows name documents; `resolveSources` fetches their text
|
|
410
|
+
*
|
|
411
|
+
* The listing a caller exports decides WHICH documents are printed — its scope, filters and order. Their
|
|
412
|
+
* text is resolved here, once for all rows, rather than carried on every row, because a document's full
|
|
413
|
+
* text is large and a listing is read far more often than it is printed. `resolveSources` must answer
|
|
414
|
+
* one source per row, in row order; a mismatch is refused rather than printed misaligned.
|
|
415
|
+
*
|
|
416
|
+
* @example
|
|
417
|
+
* export const governedDocumentsPdfTemplate = createGovernedDocumentsPdfTemplate<GovernedDocumentRow>({
|
|
418
|
+
* id: 'my-app.governed-documents.v1',
|
|
419
|
+
* resolveSources: async ({ rows }) => rows.map((row) => ({ title: row.title, document: textsByRef.get(row.ref) ?? null })),
|
|
420
|
+
* });
|
|
421
|
+
*/
|
|
422
|
+
export function createGovernedDocumentsPdfTemplate<TRow>(options: {
|
|
423
|
+
id: string;
|
|
424
|
+
resolveSources: (input: PdfCollectionBuildContextInput<TRow>) => Promise<readonly GovernedDocumentsPdfSource[]>;
|
|
425
|
+
labels?: Record<string, Record<string, string>>;
|
|
426
|
+
}): PdfCollectionTemplateDefinition<TRow, GovernedDocumentsPdfContext> {
|
|
427
|
+
return {
|
|
428
|
+
id: options.id,
|
|
429
|
+
labels: options.labels ?? GOVERNED_DOCUMENTS_PDF_LABELS,
|
|
430
|
+
async buildContext(input) {
|
|
431
|
+
const sources = await options.resolveSources(input);
|
|
432
|
+
if (sources.length !== input.rows.length) {
|
|
433
|
+
throw new Error(`The governed-documents PDF resolved ${sources.length} document(s) for ${input.rows.length} exported row(s); it prints one per row.`);
|
|
434
|
+
}
|
|
435
|
+
return {
|
|
436
|
+
generatedOn: input.generatedAt.toISOString().slice(0, 10),
|
|
437
|
+
entries: sources.map((source) => toEntry(source, input.generatedAt)),
|
|
438
|
+
};
|
|
439
|
+
},
|
|
440
|
+
body({ context, labels }) {
|
|
441
|
+
return createElement(Document, null,
|
|
442
|
+
coverPage(context, labels),
|
|
443
|
+
...context.entries.map((entry, index) => documentPage(entry, index, labels)));
|
|
444
|
+
},
|
|
445
|
+
};
|
|
446
|
+
}
|
|
447
|
+
```
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: provider-address-lookup
|
|
3
|
+
description: Let people fill an address field by searching for their address (Google Places), or add another vendor's address lookup. Every `z_address()` field offers the lookup once a provider is enabled; the vendor is reached only through the application backend. Use when the user says "add address autocomplete", "let users search for their address", "fill the address from Google Places", "address suggestions", "Google Maps address lookup", "the address search says it is unavailable", "PROVIDER_OPERATION_RATE_LIMITED on the address search", or "add a Loqate / Mapbox address lookup".
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Address Lookup Provider
|
|
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 field declared with `z_address()` renders one input per address part. When a `FRONTEND_ADDRESS_LOOKUP`
|
|
24
|
+
provider is enabled, the same field also shows a search box above the parts: the person types part of their
|
|
25
|
+
address, picks a suggestion, and the parts fill in, still editable. With no provider, or when the lookup fails,
|
|
26
|
+
the field is the plain multi-part control and nothing blocks the form.
|
|
27
|
+
|
|
28
|
+
The framework ships one lookup provider, `google-places` (Places API (New)). The vendor is NEVER called from the
|
|
29
|
+
page: each suggestion and the final retrieval run on the application backend through the provider-operation door,
|
|
30
|
+
with the application's server key. The page holds no key, loads no Google script, and needs no CSP origin.
|
|
31
|
+
|
|
32
|
+
## App Paths
|
|
33
|
+
|
|
34
|
+
| Surface | Glob (relative to app root) |
|
|
35
|
+
|---|---|
|
|
36
|
+
| The address field | `shared-lib/src/**/resources/**/*.schemas.ts` → `z_address()` |
|
|
37
|
+
| Backend scope + the two browser operations | `wildo.saas.config.ts` → `providers.scopes.backend.providers['google-places']`, `providers.browserOperations['google-places']` |
|
|
38
|
+
| Frontend scope | `wildo.saas.config.ts` → `providers.scopes.frontendServices.app.providers['google-places']` |
|
|
39
|
+
| The server key | `infrastructure/**/secrets/secrets.json` → `GOOGLE_PLACES_API_KEY` |
|
|
40
|
+
|
|
41
|
+
## When to Use
|
|
42
|
+
|
|
43
|
+
- An address field should offer address search.
|
|
44
|
+
- The address search shows "unavailable", or answers `PROVIDER_OPERATION_REFUSED` / `PROVIDER_OPERATION_RATE_LIMITED`.
|
|
45
|
+
- A vendor other than Google must power the lookup.
|
|
46
|
+
|
|
47
|
+
## When NOT to Use
|
|
48
|
+
|
|
49
|
+
- Declaring the address field itself — `resource-schema-authoring` (`z_address()`).
|
|
50
|
+
- Calling some other provider operation from a component — `provider-operation-calls`.
|
|
51
|
+
- A file picker or another component that must run vendor code in the page — `provider-frontend-file-picker`.
|
|
52
|
+
|
|
53
|
+
## Workflow
|
|
54
|
+
|
|
55
|
+
### Step 1 — Enable Google Places on both scopes
|
|
56
|
+
|
|
57
|
+
Add `google-places` to the backend scope (`providerCapabilities: ['FRONTEND_ADDRESS_LOOKUP']`,
|
|
58
|
+
`protocols: ['REST_API']`) and to the application's frontend scope (`providerCapabilities:
|
|
59
|
+
['FRONTEND_ADDRESS_LOOKUP']`, `protocols: []`). Read `references/google-places-setup.md`.
|
|
60
|
+
|
|
61
|
+
### Step 2 — Supply a SERVER key
|
|
62
|
+
|
|
63
|
+
Set `GOOGLE_PLACES_API_KEY`. Restrict it in Google Cloud to Places API (New) and to the backend's IP addresses,
|
|
64
|
+
never to an HTTP referrer: it never reaches a browser. Do not put a key in the frontend provider's public
|
|
65
|
+
configuration; its schema declares no key and refuses one.
|
|
66
|
+
|
|
67
|
+
### Step 3 — Open the two operations to browsers
|
|
68
|
+
|
|
69
|
+
Declare `address_suggest` and `address_retrieve` under `providers.browserOperations['google-places']` on the
|
|
70
|
+
application's own connection, with `allowedRoles` (required for the application's account). Every call is also
|
|
71
|
+
counted per person: the framework default is 60 a minute and 1000 an hour; declare `callerRateLimit` to change it.
|
|
72
|
+
Read `references/framework-browser-operation-policy-api.md`. Run `wildo config sync`.
|
|
73
|
+
|
|
74
|
+
### Step 4 — Check what fills the field
|
|
75
|
+
|
|
76
|
+
Nothing else to wire: `FormField` mounts the lookup in every `z_address()` field's `renderLookup` slot. A chosen
|
|
77
|
+
place fills the text parts and the country only; coordinates are never filled from a lookup and no vendor id is
|
|
78
|
+
stored. An address the field refuses (a country outside `countriesAllowed`) fills nothing and says so. Read
|
|
79
|
+
`references/framework-address-field-lookup-slot-api.md`.
|
|
80
|
+
|
|
81
|
+
### Step 5 — Another vendor: write an adapter, declare its operations
|
|
82
|
+
|
|
83
|
+
Author the vendor's backend operations (a suggest and a retrieve, each `remoteCallSemantics` with one attempt and
|
|
84
|
+
a short timeout), then a frontend module whose `FRONTEND_ADDRESS_LOOKUP` component declares `addressLookup`
|
|
85
|
+
(the two operation ids, the session-token input, the attribution) and a component that renders
|
|
86
|
+
`ProviderAddressLookupCombobox` with your `ProviderAddressLookupAdapter`. Read
|
|
87
|
+
`references/framework-address-lookup-contract-api.md`, then stop.
|
|
88
|
+
|
|
89
|
+
## Worked Example
|
|
90
|
+
|
|
91
|
+
Google's adapter — the four functions the framework's lookup combobox runs. The request shapes follow the two
|
|
92
|
+
backend operations; the answer mapping reads Google's structured `postalAddress`, never a formatted string:
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
## Usage Example
|
|
96
|
+
|
|
97
|
+
```typescript
|
|
98
|
+
export const GOOGLE_PLACES_ADDRESS_LOOKUP_ADAPTER: ProviderAddressLookupAdapter = {
|
|
99
|
+
buildSuggestInput({ query, countriesAllowed, languageCode }) {
|
|
100
|
+
const regions = countriesAllowed !== undefined && countriesAllowed.length > 0 && countriesAllowed.length <= GOOGLE_PLACES_MAX_INCLUDED_REGION_CODES
|
|
101
|
+
? countriesAllowed.map((code) => code.toLowerCase())
|
|
102
|
+
: undefined;
|
|
103
|
+
return {
|
|
104
|
+
input: query,
|
|
105
|
+
languageCode,
|
|
106
|
+
...(regions !== undefined ? { includedRegionCodes: regions } : {}),
|
|
107
|
+
};
|
|
108
|
+
},
|
|
109
|
+
|
|
110
|
+
readSuggestions(output) {
|
|
111
|
+
if (!isRecord(output)) throw new GooglePlacesAnswerUnreadableError('suggestion list');
|
|
112
|
+
const raw = output.suggestions;
|
|
113
|
+
if (raw === undefined) return [];
|
|
114
|
+
if (!Array.isArray(raw)) throw new GooglePlacesAnswerUnreadableError('suggestion list');
|
|
115
|
+
const suggestions: ProviderAddressLookupSuggestion[] = [];
|
|
116
|
+
for (const entry of raw) {
|
|
117
|
+
// A `queryPrediction` (a search phrase rather than a place) is not requested and cannot be retrieved: skipped.
|
|
118
|
+
const prediction = isRecord(entry) ? entry.placePrediction : undefined;
|
|
119
|
+
if (!isRecord(prediction) || typeof prediction.placeId !== 'string' || prediction.placeId === '') continue;
|
|
120
|
+
const structured = isRecord(prediction.structuredFormat) ? prediction.structuredFormat : undefined;
|
|
121
|
+
const primaryText = textOf(structured?.mainText) ?? textOf(prediction.text);
|
|
122
|
+
if (primaryText === undefined) continue;
|
|
123
|
+
const secondaryText = textOf(structured?.secondaryText);
|
|
124
|
+
suggestions.push({ id: prediction.placeId, primaryText, ...(secondaryText !== undefined ? { secondaryText } : {}) });
|
|
125
|
+
}
|
|
126
|
+
return suggestions;
|
|
127
|
+
},
|
|
128
|
+
|
|
129
|
+
buildRetrieveInput({ suggestion, languageCode }) {
|
|
130
|
+
return { placeId: suggestion.id, languageCode };
|
|
131
|
+
},
|
|
132
|
+
|
|
133
|
+
readAddress(output): AddressValue | undefined {
|
|
134
|
+
if (!isRecord(output)) throw new GooglePlacesAnswerUnreadableError('place');
|
|
135
|
+
const postal = output.postalAddress;
|
|
136
|
+
if (postal === undefined) return undefined;
|
|
137
|
+
if (!isRecord(postal)) throw new GooglePlacesAnswerUnreadableError('postal address');
|
|
138
|
+
const lines = Array.isArray(postal.addressLines) ? postal.addressLines.map(nonEmpty).filter((line): line is string => line !== undefined) : [];
|
|
139
|
+
const country = nonEmpty(postal.regionCode)?.toUpperCase();
|
|
140
|
+
const [line1, ...rest] = lines;
|
|
141
|
+
const city = nonEmpty(postal.locality) ?? nonEmpty(postal.sublocality);
|
|
142
|
+
if (line1 === undefined || city === undefined || country === undefined) return undefined;
|
|
143
|
+
const state = nonEmpty(postal.administrativeArea);
|
|
144
|
+
const postalCode = nonEmpty(postal.postalCode);
|
|
145
|
+
return {
|
|
146
|
+
line1,
|
|
147
|
+
...(rest.length > 0 ? { line2: rest.join(', ') } : {}),
|
|
148
|
+
city,
|
|
149
|
+
...(state !== undefined ? { state } : {}),
|
|
150
|
+
...(postalCode !== undefined ? { postalCode } : {}),
|
|
151
|
+
country,
|
|
152
|
+
};
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
- `buildSuggestInput` restricts to the field's countries only when Google can (15 at most); the field validates
|
|
158
|
+
the country anyway.
|
|
159
|
+
- There is no session token here: the host writes it into the declared input on every call.
|
|
160
|
+
- `readAddress` answers `undefined` for a place the field cannot hold, and the host says the place cannot be used.
|
|
161
|
+
|
|
162
|
+
## References
|
|
163
|
+
|
|
164
|
+
- `references/google-places-setup.md` — the complete configuration, the key restrictions, and what Google's terms allow
|
|
165
|
+
- `references/framework-address-lookup-contract-api.md` — the component props, the adapter, the `addressLookup` declaration (source-backed)
|
|
166
|
+
- `references/framework-address-field-lookup-slot-api.md` — the field's `renderLookup` slot and `applyAddress` (source-backed)
|
|
167
|
+
- `references/framework-browser-operation-policy-api.md` — `providers.browserOperations`, including `callerRateLimit` (source-backed)
|
|
168
|
+
|
|
169
|
+
## Verification
|
|
170
|
+
|
|
171
|
+
- [ ] `google-places` is on the backend scope AND the frontend scope
|
|
172
|
+
- [ ] `GOOGLE_PLACES_API_KEY` is set as a secret, and no Google key appears in frontend code or public configuration
|
|
173
|
+
- [ ] `address_suggest` and `address_retrieve` are both in `providers.browserOperations['google-places']` with `allowedRoles`
|
|
174
|
+
- [ ] No component calls a Google host directly
|
|
175
|
+
- [ ] No resource stores a vendor place id or a lookup geocode
|
|
176
|
+
|
|
177
|
+
### Grep invariants
|
|
178
|
+
|
|
179
|
+
| Invariant | Command |
|
|
180
|
+
|---|---|
|
|
181
|
+
| Both operations opened | `rg -n "address_suggest\|address_retrieve" wildo.saas.config.ts` (both present) |
|
|
182
|
+
| No Google key in the frontend | `rg -n "AIza\|GOOGLE_PLACES_API_KEY" frontend/src` (must be empty) |
|
|
183
|
+
| No direct vendor call | `rg -n "places.googleapis.com\|maps.googleapis.com" frontend/src` (must be empty) |
|
|
184
|
+
| No stored place id | `rg -in "placeId" shared-lib/src` (must be empty) |
|
|
185
|
+
|
|
186
|
+
## Common Rationalizations
|
|
187
|
+
|
|
188
|
+
| Rationalization | Reality |
|
|
189
|
+
|---|---|
|
|
190
|
+
| "A browser key restricted by referrer is fine" | It is still a published key. The lookup runs on the backend, so there is nothing for a browser key to do. |
|
|
191
|
+
| "Store the place id so we can refresh the address later" | The framework never stores a vendor id; the saved value is the address the person confirmed. |
|
|
192
|
+
| "Fill the coordinates too, Google returns them" | A stored coordinate never expires, while a lookup's geocode may be kept for a limited time at best, and nothing would delete it on the vendor's clock. Coordinates are entered by hand or not at all. |
|
|
193
|
+
| "Throttle the typing in the component" | The door counts every call per person, in the application's store, for every process. |
|
|
194
|
+
| "Hide the Google Maps line, it clutters the form" | Google requires it wherever its suggestions appear without a Google map, inside the same container as the suggestions. The lookup shows it there; do not remove it. |
|
|
195
|
+
|
|
196
|
+
## Red Flags
|
|
197
|
+
|
|
198
|
+
- A Google key in frontend code or a public config (catch with the **no Google key** grep)
|
|
199
|
+
- A component `fetch` to a Google host (catch with the **no direct vendor call** grep)
|
|
200
|
+
- Only one of the two operations opened: the search works and choosing does nothing (catch with the **both operations** grep)
|
|
201
|
+
- A `placeId` field on a resource (catch with the **no stored place id** grep)
|
|
202
|
+
|
|
203
|
+
## Related Skills
|
|
204
|
+
|
|
205
|
+
- `resource-schema-authoring` — declaring `z_address()` and its `countriesAllowed`
|
|
206
|
+
- `provider-operation-calls` — the door the lookup runs through, and its refusals
|
|
207
|
+
- `provider-frontend-file-picker` — how any provider component loads, and consent
|