@wildo-ai/framework-knowledge 1.1.2 → 1.1.4
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/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 +351 -18
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts +1 -2
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +3 -4
- 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 +4 -4
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +3 -4
- 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 +4 -4
- 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 +0 -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 +0 -1
- 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 +0 -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 +0 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +1 -2
- 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 +1 -2
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +2 -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 +3 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -2
- 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 +1 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +0 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +0 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +0 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +0 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +0 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +0 -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.d.ts +0 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +0 -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 +0 -2
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +2 -2
- 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 +0 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +0 -2
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +9 -4
- 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.d.ts +0 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +0 -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.d.ts +0 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +0 -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 +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +0 -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 +0 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +0 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +0 -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 +0 -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 +0 -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 +0 -1
- 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/manifest.json +8 -9
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +13 -70
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +11 -19
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +5 -88
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +15 -8
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +4 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +15 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +4 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -7
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +22 -49
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -17
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +15 -780
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +11 -11
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +20 -141
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +15 -10
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +3 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +16 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +14 -6
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +16 -7
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +4 -21
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +65 -16
- package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +165 -51
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +43 -23
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +4 -8
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +7 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +7 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -11
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +15 -7
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +2 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +16 -11
- package/dist/knowledge/references/build-plan.task-graph.config.md +1 -45
- package/dist/knowledge/references/companion.technical-doc.service.md +2 -102
- package/dist/knowledge/references/example.config.app-shell.full.md +5 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +0 -1
- package/dist/knowledge/references/example.provider.backend-module-shape.md +0 -7
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +1 -0
- package/dist/knowledge/references/platform.config.saas.md +0 -51
- package/dist/knowledge/references/presets.models.surface-policy.md +10 -19
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +48 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +11 -31
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +1 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +0 -45
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +0 -198
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -164
- package/dist/knowledge/references/saas.models.engine-capabilities.md +6 -26
- package/dist/knowledge/references/saas.models.http-api-binding.md +29 -3
- package/dist/knowledge/references/saas.models.provider-capabilities.md +3 -4
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +2 -4
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +0 -2
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +0 -14
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +31 -11
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +2 -32
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +6 -29
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +0 -56
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +0 -22
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +0 -26
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +0 -45
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +1 -7
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +5 -31
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +1 -44
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +0 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +0 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +0 -15
- package/dist/knowledge/registries/assurance-authority-bases.json +2 -3
- package/dist/knowledge/registries/framework-topics.json +11 -146
- package/dist/knowledge/registries/playbooks.json +18 -154
- package/dist/knowledge/registries/source-tags.json +630 -883
- package/dist/knowledge/skills/INDEX.md +3 -4
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +1 -2
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -16
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +9 -31
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +74 -252
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +8 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +53 -97
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +21 -84
- package/dist/knowledge/skills/config-app-shell/SKILL.md +9 -31
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +12 -31
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -23
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +10 -19
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -75
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -19
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +9 -30
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +0 -51
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +0 -7
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +1 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +3 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +0 -56
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +0 -56
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +0 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +0 -56
- package/dist/knowledge/skills/resource-add-field/SKILL.md +3 -3
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +0 -213
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +1 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +2 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +0 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +2 -224
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +0 -198
- package/dist/knowledge/skills/resource-external-data/SKILL.md +2 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +29 -3
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +70 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -22
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +8 -28
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +0 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +0 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +0 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +0 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +0 -26
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +1 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +0 -198
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +1 -44
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +0 -3
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +0 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +0 -56
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +5 -31
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +0 -22
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +0 -45
- package/dist/knowledge/topic-index.json +220 -725
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +0 -1
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +0 -51
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -43
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +0 -185
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +0 -64
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +0 -41
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +0 -100
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +0 -117
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +0 -86
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +0 -61
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +0 -41
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +0 -76
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +0 -42
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +0 -56
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -42
- package/dist/knowledge/playbooks/top_down.market-research/method.md +0 -68
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -44
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +0 -239
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +0 -67
- package/dist/knowledge/references/placement-plan.config.md +0 -330
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +0 -34
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +0 -45
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +0 -65
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +0 -58
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +0 -118
- package/dist/knowledge/references/saas.models.file-upload-grant.md +0 -179
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +0 -124
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +0 -99
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +0 -127
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +0 -42
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +0 -29
- package/dist/knowledge/references/zod.decorators.data-categories.md +0 -197
- package/dist/knowledge/rules/resource-schema-awareness.md +0 -77
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +0 -124
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +0 -47
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +0 -98
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +0 -54
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +0 -232
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +0 -149
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +0 -114
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +0 -133
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +0 -111
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +0 -622
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +0 -192
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +0 -245
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +0 -134
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +0 -65
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +0 -127
- /package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/structured-artifact-action.json +0 -0
|
@@ -1,330 +0,0 @@
|
|
|
1
|
-
# placement-plan.config
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-specifications`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
*
|
|
13
|
-
* Versioning for the placement-plan payload format itself. `V1` — initial
|
|
14
|
-
* shape (declared groups + one decision per subject). The shape grows
|
|
15
|
-
* additively across versions; `version` is the explicit marker for consumers
|
|
16
|
-
* that branch on era.
|
|
17
|
-
*/
|
|
18
|
-
export enum PlacementPlanVersion {
|
|
19
|
-
V1 = 'v1',
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
/** Stable prefix every placement decision ref carries; the trusted runtime stamps it, a provider supplies only the slug. */
|
|
23
|
-
export const PLACEMENT_DECISION_REF_PREFIX = 'placement-';
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* WHICH shell surface a subject is placed on — a closed vocabulary, because
|
|
27
|
-
* each member names a different authoring file with a different vocabulary,
|
|
28
|
-
* and the dispatching coding agent derives which skill and which file from it.
|
|
29
|
-
*
|
|
30
|
-
* Deliberately NOT merged into one "navigation surface" bucket: a settings
|
|
31
|
-
* placement names a rail CATEGORY, a sidebar placement names a sidebar
|
|
32
|
-
* SECTION, and the two are different concepts that happen to both be groups.
|
|
33
|
-
*/
|
|
34
|
-
export enum PlacementSurface {
|
|
35
|
-
/** The settings hub rail (`frontend/src/config/settings-hub.config.ts`). Grouped by category. */
|
|
36
|
-
SETTINGS_HUB = 'SETTINGS_HUB',
|
|
37
|
-
/** The application sidebar (`appShellConfig[SIDEBAR].contentSections`). Grouped by section. */
|
|
38
|
-
SIDEBAR = 'SIDEBAR',
|
|
39
|
-
/** The user dropdown's settings entries. Flat — no groups. */
|
|
40
|
-
USER_MENU = 'USER_MENU',
|
|
41
|
-
/** The command palette (Cmd+K). Flat — its `category` is a search facet, not a placement group. */
|
|
42
|
-
COMMAND_MENU = 'COMMAND_MENU',
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/** The surfaces whose placements MUST name a declared group. The other members are flat by construction. */
|
|
46
|
-
export const GROUPED_PLACEMENT_SURFACES: readonly PlacementSurface[] = [
|
|
47
|
-
PlacementSurface.SETTINGS_HUB,
|
|
48
|
-
PlacementSurface.SIDEBAR,
|
|
49
|
-
];
|
|
50
|
-
|
|
51
|
-
/** WHAT is being placed. */
|
|
52
|
-
export enum PlacementSubjectKind {
|
|
53
|
-
/**
|
|
54
|
-
* An engine-owned settings destination, named by its
|
|
55
|
-
* `SettingsDestination.ref` (the engine catalog's id). The catalog itself
|
|
56
|
-
* lives in the frontend package; `_core` deliberately does not import it, so
|
|
57
|
-
* ref EXISTENCE is checked by the caller that holds the catalog — see
|
|
58
|
-
* `validatePlacementPlan`'s `knownSubjectRefs`.
|
|
59
|
-
*/
|
|
60
|
-
ENGINE_SETTINGS_DESTINATION = 'ENGINE_SETTINGS_DESTINATION',
|
|
61
|
-
/** A resource operation surface the application owns (its LIST, its READ, a custom verb). */
|
|
62
|
-
RESOURCE_OPERATION = 'RESOURCE_OPERATION',
|
|
63
|
-
/** An application-scoped view (composite, chart, execution, full-custom). */
|
|
64
|
-
APP_VIEW = 'APP_VIEW',
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
68
|
-
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
69
|
-
|
|
70
|
-
export const PlacementSubjectSchema = z.discriminatedUnion('kind', [
|
|
71
|
-
z.strictObject({
|
|
72
|
-
kind: z.literal(PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION),
|
|
73
|
-
destinationRef: SlugSchema,
|
|
74
|
-
}),
|
|
75
|
-
z.strictObject({
|
|
76
|
-
kind: z.literal(PlacementSubjectKind.RESOURCE_OPERATION),
|
|
77
|
-
moduleRef: SlugSchema,
|
|
78
|
-
resourceRef: SlugSchema,
|
|
79
|
-
/** The operation this placement surfaces (`list`, `read`, a custom verb ref). */
|
|
80
|
-
operation: NonEmptyStringSchema,
|
|
81
|
-
}),
|
|
82
|
-
z.strictObject({
|
|
83
|
-
kind: z.literal(PlacementSubjectKind.APP_VIEW),
|
|
84
|
-
viewRef: SlugSchema,
|
|
85
|
-
}),
|
|
86
|
-
]);
|
|
87
|
-
export type PlacementSubject = z.infer<typeof PlacementSubjectSchema>;
|
|
88
|
-
|
|
89
|
-
/**
|
|
90
|
-
* A container the plan decides should exist on a grouped surface — a settings
|
|
91
|
-
* rail category, or a sidebar section.
|
|
92
|
-
*
|
|
93
|
-
* `purpose` is prose, and it is load-bearing rather than decorative: it is what
|
|
94
|
-
* grounds the generated `settings_hub.categories.<ref>.label` /
|
|
95
|
-
* `sidebar_sections.<ref>.title` labels in authored intent instead of letting a
|
|
96
|
-
* model invent filler from the ref alone. The plan does NOT author the label
|
|
97
|
-
* string — that is the labelling pipeline's job.
|
|
98
|
-
*/
|
|
99
|
-
export const PlacementGroupSchema = z.strictObject({
|
|
100
|
-
groupRef: SlugSchema,
|
|
101
|
-
/** Which grouped surface this group belongs to. */
|
|
102
|
-
surface: z.enum(PlacementSurface),
|
|
103
|
-
/** Why this group exists / what it gathers, from a product perspective. */
|
|
104
|
-
purpose: NonEmptyStringSchema,
|
|
105
|
-
/** Sort order among groups on its surface (lower = higher). */
|
|
106
|
-
order: z.number().int().min(0),
|
|
107
|
-
});
|
|
108
|
-
export type PlacementGroup = z.infer<typeof PlacementGroupSchema>;
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* WHERE a placed subject sits. Discriminated on surface because the address
|
|
112
|
-
* vocabularies genuinely differ: the grouped surfaces name a group, the flat
|
|
113
|
-
* ones do not have one to name.
|
|
114
|
-
*/
|
|
115
|
-
export const PlacementAddressSchema = z.discriminatedUnion('surface', [
|
|
116
|
-
z.strictObject({
|
|
117
|
-
surface: z.literal(PlacementSurface.SETTINGS_HUB),
|
|
118
|
-
/** The `PlacementGroup.groupRef` of the settings rail category. */
|
|
119
|
-
groupRef: SlugSchema,
|
|
120
|
-
order: z.number().int().min(0),
|
|
121
|
-
}),
|
|
122
|
-
z.strictObject({
|
|
123
|
-
surface: z.literal(PlacementSurface.SIDEBAR),
|
|
124
|
-
/** The `PlacementGroup.groupRef` of the sidebar section. */
|
|
125
|
-
groupRef: SlugSchema,
|
|
126
|
-
order: z.number().int().min(0),
|
|
127
|
-
}),
|
|
128
|
-
z.strictObject({
|
|
129
|
-
surface: z.literal(PlacementSurface.USER_MENU),
|
|
130
|
-
order: z.number().int().min(0),
|
|
131
|
-
}),
|
|
132
|
-
z.strictObject({
|
|
133
|
-
surface: z.literal(PlacementSurface.COMMAND_MENU),
|
|
134
|
-
order: z.number().int().min(0),
|
|
135
|
-
}),
|
|
136
|
-
]);
|
|
137
|
-
export type PlacementAddress = z.infer<typeof PlacementAddressSchema>;
|
|
138
|
-
|
|
139
|
-
/**
|
|
140
|
-
* Whether a considered subject was placed or deliberately left unplaced.
|
|
141
|
-
*
|
|
142
|
-
* `DECLINED` is a first-class outcome, not an absence. A subject that is simply
|
|
143
|
-
* missing from the plan is a COVERAGE GAP (the decision was never taken); a
|
|
144
|
-
* subject recorded as `DECLINED` is a decision, with a reason a reader can
|
|
145
|
-
* disagree with. Collapsing the two would make "we thought about it and said no"
|
|
146
|
-
* indistinguishable from "nobody looked".
|
|
147
|
-
*/
|
|
148
|
-
export enum PlacementDisposition {
|
|
149
|
-
PLACED = 'PLACED',
|
|
150
|
-
DECLINED = 'DECLINED',
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
/**
|
|
154
|
-
* WHOSE judgement a decision currently represents.
|
|
155
|
-
*
|
|
156
|
-
* The placement plan is produced by an expert-panel deliberation, and every decision carries a
|
|
157
|
-
* `rationale` written by that panel. Nothing stopped a later edit — a re-run, or a human changing
|
|
158
|
-
* the landed file — from leaving that rationale in place while changing what it explains, so the
|
|
159
|
-
* artifact went on asserting panel reasoning for a decision the panel never took.
|
|
160
|
-
*
|
|
161
|
-
* This is the field that makes the difference legible. It is REQUIRED and has NO DEFAULT, which is
|
|
162
|
-
* the whole point: a defaulted `DELIBERATED` would mean silence claims the panel, and silence is
|
|
163
|
-
* exactly what a hand-edit produces.
|
|
164
|
-
*
|
|
165
|
-
* ⚠️ TRUSTED, like `decisionRef`. `PlacementDecisionGenerationSchema` cannot express it, so a
|
|
166
|
-
* provider cannot declare its own output a human revision; `parsePlacementPlanGeneration` stamps
|
|
167
|
-
* `DELIBERATED` because a panel run is by definition the panel's judgement.
|
|
168
|
-
*
|
|
169
|
-
* ⚠️ This is not an audit trail and must not grow into one. Git already records WHO changed a
|
|
170
|
-
* decision, WHEN, and with what commit message, mergeably and across branches
|
|
171
|
-
* (`.claude/rules/one-source-of-truth.md`). What git cannot tell a reader who is looking at the
|
|
172
|
-
* FILE — the config, in an editor, asking "why is Billing under Account?" — is that this particular
|
|
173
|
-
* line is no longer what the panel decided. That is the one fact this carries.
|
|
174
|
-
*/
|
|
175
|
-
export enum PlacementDecisionOrigin {
|
|
176
|
-
/** The expert panel decided it, and nobody has changed it since. */
|
|
177
|
-
DELIBERATED = 'DELIBERATED',
|
|
178
|
-
/** A human changed it after the panel decided otherwise. {@link PlacementSupersededDecisionSchema} says what the panel had said. */
|
|
179
|
-
REVISED = 'REVISED',
|
|
180
|
-
}
|
|
181
|
-
|
|
182
|
-
/**
|
|
183
|
-
* What a revision replaced — the panel's own reasoning, kept beside the human's.
|
|
184
|
-
*
|
|
185
|
-
* Only the RATIONALE, deliberately. The decision schema's own note already says the reasoning is
|
|
186
|
-
* "the artifact's most perishable and most valuable part", and it is the half a reader cannot
|
|
187
|
-
* reconstruct: the prior address is visible in `git diff`, the prior argument is not, because a
|
|
188
|
-
* diff shows the words that changed and never the case they were making.
|
|
189
|
-
*
|
|
190
|
-
* Keeping more — the old address, a timestamp, an author — would grow a shadow decision beside the
|
|
191
|
-
* real one, and every one of those is something git already holds, in a form that merges.
|
|
192
|
-
*/
|
|
193
|
-
export const PlacementSupersededDecisionSchema = z.strictObject({
|
|
194
|
-
/** The rationale the panel gave for the decision this one replaced. */
|
|
195
|
-
rationale: NonEmptyStringSchema,
|
|
196
|
-
});
|
|
197
|
-
export type PlacementSupersededDecision = z.infer<typeof PlacementSupersededDecisionSchema>;
|
|
198
|
-
|
|
199
|
-
/**
|
|
200
|
-
* One placement decision.
|
|
201
|
-
*
|
|
202
|
-
* `rationale` is REQUIRED on both arms. It is what lets a creator ask "why is
|
|
203
|
-
* Billing under Organization?" and get an answer without re-running the panel
|
|
204
|
-
* that decided it — the plan is produced by an expert-panel deliberation, so
|
|
205
|
-
* the reasoning is the artifact's most perishable and most valuable part.
|
|
206
|
-
*
|
|
207
|
-
* A subject may legitimately be placed on SEVERAL surfaces (billing sits in the
|
|
208
|
-
* settings rail AND answers to the command palette), so one decision per
|
|
209
|
-
* (subject, surface) — never one per subject.
|
|
210
|
-
*/
|
|
211
|
-
export const PlacementDecisionSchema = z.discriminatedUnion('disposition', [
|
|
212
|
-
z.strictObject({
|
|
213
|
-
/** `placement-<slug>`, stamped by the trusted runtime. */
|
|
214
|
-
decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
215
|
-
disposition: z.literal(PlacementDisposition.PLACED),
|
|
216
|
-
/** Whose judgement this is. Required, never defaulted — see {@link PlacementDecisionOrigin}. */
|
|
217
|
-
origin: z.enum(PlacementDecisionOrigin),
|
|
218
|
-
subject: PlacementSubjectSchema,
|
|
219
|
-
address: PlacementAddressSchema,
|
|
220
|
-
/** Why this subject belongs at this address. One or two sentences, product-level. */
|
|
221
|
-
rationale: NonEmptyStringSchema,
|
|
222
|
-
/** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */
|
|
223
|
-
supersedes: PlacementSupersededDecisionSchema.optional(),
|
|
224
|
-
}),
|
|
225
|
-
z.strictObject({
|
|
226
|
-
decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
227
|
-
disposition: z.literal(PlacementDisposition.DECLINED),
|
|
228
|
-
origin: z.enum(PlacementDecisionOrigin),
|
|
229
|
-
subject: PlacementSubjectSchema,
|
|
230
|
-
/** Why this subject is deliberately NOT surfaced anywhere. */
|
|
231
|
-
rationale: NonEmptyStringSchema,
|
|
232
|
-
supersedes: PlacementSupersededDecisionSchema.optional(),
|
|
233
|
-
}),
|
|
234
|
-
]).superRefine((decision, context) => {
|
|
235
|
-
/*
|
|
236
|
-
* The pairing, enforced on the DECISION rather than on the plan.
|
|
237
|
-
*
|
|
238
|
-
* `PlacementDecisionSchema` is exported and parsed on its own, so a check that lived only in the
|
|
239
|
-
* plan's `superRefine` would hold for a whole plan and not for a decision — one of the two call
|
|
240
|
-
* sites of an invariant, which is the shape `.claude/rules/invariant-call-site-enumeration.md`
|
|
241
|
-
* exists for. Here it cannot be bypassed by parsing at a different granularity.
|
|
242
|
-
*
|
|
243
|
-
* Both directions, and the second matters as much as the first. A REVISED decision with no
|
|
244
|
-
* `supersedes` is the defect this whole field was added for, wearing the new vocabulary: it says
|
|
245
|
-
* "a human changed this" and still cannot say what was changed. A DELIBERATED decision that
|
|
246
|
-
* CARRIES a `supersedes` is a plan claiming the panel overruled itself — no run produces that, so
|
|
247
|
-
* it can only come from an edit that changed one half and forgot the other.
|
|
248
|
-
*/
|
|
249
|
-
if (decision.origin === PlacementDecisionOrigin.REVISED && decision.supersedes === undefined) {
|
|
250
|
-
context.addIssue({
|
|
251
|
-
code: 'custom',
|
|
252
|
-
message: `placement decision "${decision.decisionRef}" is REVISED but records no superseded rationale — a revision must say what the panel had decided, or the artifact loses the argument it replaced`,
|
|
253
|
-
path: ['supersedes'],
|
|
254
|
-
});
|
|
255
|
-
}
|
|
256
|
-
if (decision.origin === PlacementDecisionOrigin.DELIBERATED && decision.supersedes !== undefined) {
|
|
257
|
-
context.addIssue({
|
|
258
|
-
code: 'custom',
|
|
259
|
-
message: `placement decision "${decision.decisionRef}" is DELIBERATED and records a superseded rationale — a panel decision supersedes nothing; set origin to REVISED, or drop the supersedes block`,
|
|
260
|
-
path: ['supersedes'],
|
|
261
|
-
});
|
|
262
|
-
}
|
|
263
|
-
});
|
|
264
|
-
export type PlacementDecision = z.infer<typeof PlacementDecisionSchema>;
|
|
265
|
-
|
|
266
|
-
/**
|
|
267
|
-
* THE placement payload — a **single aggregate per application**: which shell
|
|
268
|
-
* surface every destination, resource operation and app view sits on, and why.
|
|
269
|
-
*
|
|
270
|
-
* **Artifact-family id: `placement-plan`.** This schema is the shape of the
|
|
271
|
-
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
272
|
-
* 'placement-plan'` (the `family` vocabulary stays an open string owned by the
|
|
273
|
-
* selector surface; this note is the single place tying the SHAPE to the NAME).
|
|
274
|
-
* Produced by the `bottom_up.placement-plan` playbook — an expert-panel
|
|
275
|
-
* deliberation, not a creator elicitation — and consumed by `build-decompose`,
|
|
276
|
-
* which turns it into the coding tasks that author the real config files.
|
|
277
|
-
*
|
|
278
|
-
* Invariants enforced HERE: unique decision refs; at least one decision; every
|
|
279
|
-
* placement on a grouped surface names a group declared in this plan, of the
|
|
280
|
-
* SAME surface; no two groups share a ref on one surface. Coherence beyond
|
|
281
|
-
* structure — duplicate placements, empty groups, order collisions, coverage
|
|
282
|
-
* against the engine catalog — is `validatePlacementPlan`'s job.
|
|
283
|
-
*/
|
|
284
|
-
export const PlacementPlanSchema = z.object({
|
|
285
|
-
version: z.enum(PlacementPlanVersion).default(PlacementPlanVersion.V1),
|
|
286
|
-
/**
|
|
287
|
-
* The groups the plan decides should exist. May be empty only when no
|
|
288
|
-
* grouped-surface placement is made — enforced below rather than by a
|
|
289
|
-
* `min(1)`, because a plan that places nothing but command-menu entries is
|
|
290
|
-
* legitimate and needs no group.
|
|
291
|
-
*/
|
|
292
|
-
groups: z.array(PlacementGroupSchema).default([]),
|
|
293
|
-
/**
|
|
294
|
-
* At least one decision, at the SCHEMA. A plan that decided nothing is a
|
|
295
|
-
* refusal ("there was nothing to place"), never an artifact — and an empty
|
|
296
|
-
* artifact that LANDS overwrites a real one, which is exactly how a completed
|
|
297
|
-
* 3-task build plan was destroyed by a vacuous one on 2026-08-24.
|
|
298
|
-
*/
|
|
299
|
-
decisions: z.array(PlacementDecisionSchema).min(1),
|
|
300
|
-
}).superRefine((plan, context) => {
|
|
301
|
-
const groupKeys = new Set<string>();
|
|
302
|
-
plan.groups.forEach((group, index) => {
|
|
303
|
-
const key = `${group.surface}::${group.groupRef}`;
|
|
304
|
-
if (groupKeys.has(key)) {
|
|
305
|
-
context.addIssue({ code: 'custom', message: `duplicate placement group "${group.groupRef}" on surface ${group.surface}`, path: ['groups', index, 'groupRef'] });
|
|
306
|
-
}
|
|
307
|
-
groupKeys.add(key);
|
|
308
|
-
});
|
|
309
|
-
|
|
310
|
-
const decisionRefs = new Set<string>();
|
|
311
|
-
plan.decisions.forEach((decision, index) => {
|
|
312
|
-
if (decisionRefs.has(decision.decisionRef)) {
|
|
313
|
-
context.addIssue({ code: 'custom', message: `duplicate placement decision ref "${decision.decisionRef}"`, path: ['decisions', index, 'decisionRef'] });
|
|
314
|
-
}
|
|
315
|
-
decisionRefs.add(decision.decisionRef);
|
|
316
|
-
|
|
317
|
-
if (decision.disposition !== PlacementDisposition.PLACED) return;
|
|
318
|
-
const address = decision.address;
|
|
319
|
-
if (!('groupRef' in address)) return;
|
|
320
|
-
if (!groupKeys.has(`${address.surface}::${address.groupRef}`)) {
|
|
321
|
-
context.addIssue({
|
|
322
|
-
code: 'custom',
|
|
323
|
-
message: `placement "${decision.decisionRef}" names group "${address.groupRef}", which this plan does not declare for surface ${address.surface}`,
|
|
324
|
-
path: ['decisions', index, 'address', 'groupRef'],
|
|
325
|
-
});
|
|
326
|
-
}
|
|
327
|
-
});
|
|
328
|
-
});
|
|
329
|
-
export type PlacementPlan = z.infer<typeof PlacementPlanSchema>;
|
|
330
|
-
```
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
# saas.frontend.display-layout.reading-measure
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
-
|
|
11
|
-
```tsx
|
|
12
|
-
export interface DisplayLayoutProps {
|
|
13
|
-
/** Additional CSS classes for the root container. */
|
|
14
|
-
className?: string;
|
|
15
|
-
/**
|
|
16
|
-
* How wide the layout root lets its content grow, named in the framework's own vocabulary.
|
|
17
|
-
*
|
|
18
|
-
* Defaults to `'measure'` — the reading-measure cap (~42rem, themeable via `--measure-max-width`)
|
|
19
|
-
* that keeps a single-column stack of label/value pairs readable instead of stretched edge to edge.
|
|
20
|
-
* That default is right for what this layout was built for and is unchanged.
|
|
21
|
-
*
|
|
22
|
-
* It is WRONG for a composed document. A template that renders tabs, quote blocks, tables or regions
|
|
23
|
-
* is not a field stack: those set their own measure internally, and a 42rem cap around them squeezes
|
|
24
|
-
* the whole composition into a column with dead space beside it. Such a template declares `'none'`.
|
|
25
|
-
*
|
|
26
|
-
* `'none'` is not "uncapped" in practice — the zone content boundary above has already capped the
|
|
27
|
-
* area at the page-content width (`'content'`, ~80rem) and an adjacent pane is narrower still. This
|
|
28
|
-
* prop decides only whether a SECOND, tighter cap applies inside that, and the answer depends on what
|
|
29
|
-
* the template renders, which is why the template is the one asked.
|
|
30
|
-
*/
|
|
31
|
-
responsiveMaxWidth?: ResponsiveMaxWidth;
|
|
32
|
-
children?: ReactNode;
|
|
33
|
-
}
|
|
34
|
-
```
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
# saas.frontend.navigation.operation-override
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
*
|
|
13
|
-
* Per-operation navigation chrome: transition, overlay/split appearance, source zone.
|
|
14
|
-
*
|
|
15
|
-
* **How to use:** attach fragments of this shape under
|
|
16
|
-
* `ResourceOperationFrontendConfig.navigationOverrides` in `resourceUIBehavior()`.
|
|
17
|
-
* Each override applies when navigating **from** the configured zone/viewport into
|
|
18
|
-
* this operation. Prefer mirroring a sibling resource that already matches the
|
|
19
|
-
* product’s overlay vs split behavior.
|
|
20
|
-
*/
|
|
21
|
-
export const NavigationOperationOverrideSchema = z.object({
|
|
22
|
-
transition: TransitionConfigSchema,
|
|
23
|
-
appearance: viewportDiscriminatedSchema(z.union([
|
|
24
|
-
z.enum(OverlayAppearance),
|
|
25
|
-
z.enum(SplitAppearance),
|
|
26
|
-
])).optional(),
|
|
27
|
-
fromZone: z.union([z.enum(NavigationZoneName), z.literal('appLevel')]).optional(),
|
|
28
|
-
viewport: z.enum(ViewportBreakpoint).optional(),
|
|
29
|
-
/**
|
|
30
|
-
* Behaviour of the OVERLAY this override resolves to — whether the page behind stays interactive,
|
|
31
|
-
* whether touching it dismisses, whether it is dimmed. Ignored for non-overlay transitions.
|
|
32
|
-
*
|
|
33
|
-
* These three were already declared on `OverlayContainerConfig` with documented defaults and read by
|
|
34
|
-
* nothing; they are honoured now, and this is the channel that lets a NAVIGATION-driven overlay set
|
|
35
|
-
* them. Declared per operation because it describes the CONTENT: an application legitimately has a
|
|
36
|
-
* create dialog that blocks everything and a detail sheet beside a live canvas that blocks nothing.
|
|
37
|
-
*/
|
|
38
|
-
overlayBehavior: z.object({
|
|
39
|
-
modal: z.boolean().optional(),
|
|
40
|
-
closeOnOutsideClick: z.boolean().optional(),
|
|
41
|
-
showBackdrop: z.boolean().optional(),
|
|
42
|
-
}).optional(),
|
|
43
|
-
});
|
|
44
|
-
export type NavigationOperationOverride = z.infer<typeof NavigationOperationOverrideSchema>;
|
|
45
|
-
```
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
# saas.frontend.public-shell.identity-mode
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
*
|
|
13
|
-
* Whether the PUBLIC (unauthenticated) pages present the application's identity.
|
|
14
|
-
*
|
|
15
|
-
* Declare it beside your other frontend configuration and pass it to
|
|
16
|
-
* `buildFrontendModuleConfigOverrides` in `frontend/src/modules-registry.frontend.ts`, alongside
|
|
17
|
-
* `navigationLayout`, `homeDefinition` and `errorPageConfig`:
|
|
18
|
-
*
|
|
19
|
-
* ```ts
|
|
20
|
-
* import { PublicShellIdentityMode } from '@wildo-ai/saas-frontend-lib';
|
|
21
|
-
*
|
|
22
|
-
* frontendConfigOverrides: buildFrontendModuleConfigOverrides({
|
|
23
|
-
* // …navigationLayout, designSystemConfiguration, homeDefinition, errorPageConfig
|
|
24
|
-
* publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER,
|
|
25
|
-
* }),
|
|
26
|
-
* ```
|
|
27
|
-
*
|
|
28
|
-
* It is NOT an `ApplicationLevelComponentType` key: it does not belong in
|
|
29
|
-
* `frontend/src/config/app-shell.config.ts`, and putting it there configures nothing at all. Those
|
|
30
|
-
* keys describe the AUTHENTICATED shell (menubar, sidebar, status bar); the pages this governs
|
|
31
|
-
* render before any of that exists.
|
|
32
|
-
*
|
|
33
|
-
* Login, registration, invitation acceptance, e-mail confirmation, password reset, the MFA
|
|
34
|
-
* challenge and the OAuth consent screens are the first thing a person ever sees of an application,
|
|
35
|
-
* and they are also the pages most likely to be reached from a link — an e-mail, a chat message, a
|
|
36
|
-
* bookmark — with no surrounding context saying what they belong to. Naming the surface there is
|
|
37
|
-
* conventional (Stripe, Linear, GitHub, Slack all do it) and it is the difference between "sign in"
|
|
38
|
-
* and "sign in to WHAT".
|
|
39
|
-
*
|
|
40
|
-
* OPT-IN, and {@link HIDDEN} is the framework default, for the same reason the sidebar's home mode
|
|
41
|
-
* defaults to a navigation row rather than a brand header: showing an identity assumes the surface
|
|
42
|
-
* HAS one worth showing, and an application that has generated no brand yet would get its technical
|
|
43
|
-
* `appName` printed over its login form. An application says when it is ready.
|
|
44
|
-
*
|
|
45
|
-
* Mirrors {@link SidebarHomeDisplayMode} deliberately — same question ("how is this product's
|
|
46
|
-
* identity surfaced here"), same answer shape, so an author who has met one already knows this one.
|
|
47
|
-
*/
|
|
48
|
-
export enum PublicShellIdentityMode {
|
|
49
|
-
/**
|
|
50
|
-
* Public pages carry no identity. The framework default, and the behavior of every application
|
|
51
|
-
* that does not mention this field.
|
|
52
|
-
*/
|
|
53
|
-
HIDDEN = 'hidden',
|
|
54
|
-
/**
|
|
55
|
-
* The identity at the top of the public card, above the form's own heading: the mark when one
|
|
56
|
-
* resolves, and the name.
|
|
57
|
-
*
|
|
58
|
-
* What actually renders is decided from the DATA, not from this mode — an application with no
|
|
59
|
-
* generated brand shows its name alone, and a brand whose mark is a wordmark or lockup shows the
|
|
60
|
-
* mark alone, because such a mark already contains the name. So this mode is a permission, never
|
|
61
|
-
* a promise that a logo exists.
|
|
62
|
-
*/
|
|
63
|
-
BRAND_HEADER = 'brand_header',
|
|
64
|
-
}
|
|
65
|
-
```
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# saas.frontend.settings-hub.engine-destinations
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
/**
|
|
13
|
-
* Every settings destination the engine ships, as a named vocabulary.
|
|
14
|
-
*
|
|
15
|
-
* Exists because these refs are a CLOSED vocabulary that engine code addresses
|
|
16
|
-
* by name — the billing command-menu entry opens `/settings/billing`, and any
|
|
17
|
-
* future engine launcher will do the same. Before this enum, `'billing'` was a
|
|
18
|
-
* bare literal in `billing-launcher.ts` with nothing tying it to the catalog
|
|
19
|
-
* entry it names: rename the destination and the command silently resolves to
|
|
20
|
-
* the hub's DEFAULT section instead of failing, so a menu item labelled
|
|
21
|
-
* "Billing" would open Profile.
|
|
22
|
-
*
|
|
23
|
-
* **Engine code must address a destination through this enum. Application
|
|
24
|
-
* config addresses one by string**, deliberately: a placement is authored data,
|
|
25
|
-
* an application should not import an engine enum to write its own rail, and a
|
|
26
|
-
* typo there is caught at DEV startup by `verifySettingsHubContent`.
|
|
27
|
-
*/
|
|
28
|
-
export enum EngineSettingsDestinationRef {
|
|
29
|
-
/** The signed-in user's own profile record. */
|
|
30
|
-
PROFILE = 'profile',
|
|
31
|
-
/** Password, MFA, sessions — a bespoke engine panel. */
|
|
32
|
-
SECURITY = 'security',
|
|
33
|
-
/** Theme and appearance preferences — a bespoke engine panel. */
|
|
34
|
-
APPEARANCE = 'appearance',
|
|
35
|
-
/** The signed-in user's own preference record. */
|
|
36
|
-
PREFERENCES = 'preferences',
|
|
37
|
-
/** Invitations addressed TO the signed-in user, across organizations they have not joined. */
|
|
38
|
-
MY_INVITATIONS = 'my-invitations',
|
|
39
|
-
/** The current organization's own record. Org owner/admin only. */
|
|
40
|
-
ORGANIZATION_GENERAL = 'organization-general',
|
|
41
|
-
/** Organization membership list, including INVITED rows. Org owner/admin only. */
|
|
42
|
-
MEMBERS = 'members',
|
|
43
|
-
/** Billing home — subscription, plans, usage, invoices. Gated on the `billingEnabled` capability. */
|
|
44
|
-
BILLING = 'billing',
|
|
45
|
-
/** Organization API keys. Org owner/admin only. */
|
|
46
|
-
API_KEYS = 'api-keys',
|
|
47
|
-
/** Single sign-on configuration and connections. */
|
|
48
|
-
SSO = 'sso',
|
|
49
|
-
/** SCIM directory provisioning configuration and tokens. */
|
|
50
|
-
SCIM = 'scim',
|
|
51
|
-
/** Audit-event streaming configuration and failed-delivery queue. */
|
|
52
|
-
SIEM = 'siem',
|
|
53
|
-
/** Outbound webhook endpoints and delivery log. */
|
|
54
|
-
WEBHOOKS = 'webhooks',
|
|
55
|
-
/** The organization's audit log. Org owner/admin only. */
|
|
56
|
-
AUDIT_LOGS = 'audit-logs',
|
|
57
|
-
}
|
|
58
|
-
```
|
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
# saas.frontend.settings-hub.placement
|
|
2
|
-
|
|
3
|
-
## Import Origins
|
|
4
|
-
|
|
5
|
-
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
-
|
|
7
|
-
## Source Excerpts
|
|
8
|
-
|
|
9
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
-
|
|
11
|
-
```typescript
|
|
12
|
-
/**
|
|
13
|
-
* An addressable settings DESTINATION — what a settings surface *is*, with no
|
|
14
|
-
* opinion on where it appears.
|
|
15
|
-
*
|
|
16
|
-
* This is the half the engine ships (`ENGINE_SETTINGS_DESTINATIONS`). It carries
|
|
17
|
-
* the target and the gating stack, and deliberately carries **no `categoryRef`,
|
|
18
|
-
* no `order` and no `label`**: those are placement, and placement is the
|
|
19
|
-
* application's decision (`SettingsPlacement`).
|
|
20
|
-
*
|
|
21
|
-
* The split exists because the engine shipping a PLACED hub is what made the
|
|
22
|
-
* settings rail unauthorable — an application could not add, remove, reorder or
|
|
23
|
-
* rename a section without the framework agreeing. Splitting destination from
|
|
24
|
-
* placement lets the engine keep owning what a destination MEANS (its target,
|
|
25
|
-
* its roles, its entitlement) while the application owns where it sits.
|
|
26
|
-
*/
|
|
27
|
-
export interface SettingsDestination {
|
|
28
|
-
/** Destination reference — the `/settings/:sectionRef` URL segment and the id a placement names. */
|
|
29
|
-
ref: string;
|
|
30
|
-
/** What the destination renders in its content panel. */
|
|
31
|
-
target: SettingsSectionTarget;
|
|
32
|
-
/** Declarative runtime capability gating (same contract as launcher items). */
|
|
33
|
-
runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
|
|
34
|
-
/** Feature flags required to surface this destination (plan/subscription gating). */
|
|
35
|
-
requiredFeatures?: RequiredFeaturesConfig;
|
|
36
|
-
/** RBAC roles required to surface this destination (OR semantics). */
|
|
37
|
-
requiredRoles?: string[];
|
|
38
|
-
/** Optional CoreFeature id this destination's content is ENTITLED by (soft gate — renders an upgrade prompt). */
|
|
39
|
-
entitlementFeatureId?: string;
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
/**
|
|
43
|
-
* An application's explicit PLACEMENT of one destination in its settings rail.
|
|
44
|
-
*
|
|
45
|
-
* Authored in the application's own config. Nothing is placed implicitly: a
|
|
46
|
-
* destination the application does not place does not render, which is the whole
|
|
47
|
-
* point — "we should just place things", with no automatic inference.
|
|
48
|
-
*
|
|
49
|
-
* `label` is optional and is an OVERRIDE. The resolved label otherwise comes from
|
|
50
|
-
* the `settings_hub.sections.<ref>.label` key, so a placed section is localizable
|
|
51
|
-
* without the application authoring an English string.
|
|
52
|
-
*
|
|
53
|
-
* That namespace and its resolver (`tSettingsHubSection`) EXIST and already fall
|
|
54
|
-
* back to the authored label. What does not exist is anything that generates the
|
|
55
|
-
* units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the
|
|
56
|
-
* companion plans nothing for it, so today every rail label is the authored
|
|
57
|
-
* English string. R9 is a wiring job, not a new mechanism.
|
|
58
|
-
*/
|
|
59
|
-
export interface SettingsPlacement {
|
|
60
|
-
/** The {@link SettingsDestination.ref} being placed. Refused at DEV startup when unknown. */
|
|
61
|
-
destinationRef: string;
|
|
62
|
-
/** Which category (rail group) this destination sits under. */
|
|
63
|
-
categoryRef: string;
|
|
64
|
-
/** Sort order within the category (lower = higher). */
|
|
65
|
-
order?: number;
|
|
66
|
-
/** Optional icon ref for the rail entry. */
|
|
67
|
-
icon?: string;
|
|
68
|
-
/** Rail label override. Omit to take `settings_hub.sections.<ref>.label`. */
|
|
69
|
-
label?: string;
|
|
70
|
-
}
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
74
|
-
|
|
75
|
-
```typescript
|
|
76
|
-
/**
|
|
77
|
-
* The AUTHORED Settings Hub registry — an application's own settings rail.
|
|
78
|
-
*
|
|
79
|
-
* The framework ships destinations (`ENGINE_SETTINGS_DESTINATIONS`), never a
|
|
80
|
-
* placed hub. This is the application's half: which categories exist, and which
|
|
81
|
-
* destinations are placed where. `wildo init` scaffolds the full destination list
|
|
82
|
-
* as placements so a new application starts complete and edits down.
|
|
83
|
-
*
|
|
84
|
-
* Resolve it with `resolveSettingsHubConfig()` to get the rendered
|
|
85
|
-
* {@link SettingsSection} list; the render path never reads this shape directly.
|
|
86
|
-
*/
|
|
87
|
-
export interface SettingsHubConfig {
|
|
88
|
-
/** Rail groups, in render order (also orderable via `SettingsCategory.order`). */
|
|
89
|
-
categories: SettingsCategory[];
|
|
90
|
-
/**
|
|
91
|
-
* Every destination this application places, and where.
|
|
92
|
-
*
|
|
93
|
-
* A destination that appears in no placement does not render. That is
|
|
94
|
-
* deliberate: absence is how an application removes a settings section, and it
|
|
95
|
-
* must not be second-guessed by a merge against a framework default.
|
|
96
|
-
*/
|
|
97
|
-
placements: SettingsPlacement[];
|
|
98
|
-
/**
|
|
99
|
-
* Section opened when the hub is launched without an explicit section
|
|
100
|
-
* (`/settings` with no `:sectionRef`). Falls back to the first section of the
|
|
101
|
-
* first category when omitted.
|
|
102
|
-
*/
|
|
103
|
-
defaultSectionRef?: string;
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
/**
|
|
107
|
-
* The RESOLVED hub — categories plus fully-resolved sections, ready to render.
|
|
108
|
-
*
|
|
109
|
-
* Distinct from {@link SettingsHubConfig} (what an application AUTHORS) because
|
|
110
|
-
* conflating the two is what let a placed default ship from the engine. A
|
|
111
|
-
* consumer that renders takes this; a consumer that configures takes the other.
|
|
112
|
-
*/
|
|
113
|
-
export interface ResolvedSettingsHubConfig {
|
|
114
|
-
categories: SettingsCategory[];
|
|
115
|
-
sections: SettingsSection[];
|
|
116
|
-
defaultSectionRef?: string;
|
|
117
|
-
}
|
|
118
|
-
```
|