@wildo-ai/framework-knowledge 1.1.8 → 1.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +9 -2
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
- 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 +95 -5
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
- 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 +41 -3
- 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 +175 -14
- 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 +3 -3
- 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.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- 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 -6
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -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 +90 -13
- 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 +4 -3
- 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 +4 -3
- 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 +8 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
- 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 +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
- 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 +2 -1
- 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.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -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.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
- 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 +91 -43
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -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 +27 -18
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
- 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 +11 -11
- 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 +2 -0
- 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 +3 -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.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
- 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 +3 -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.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
- 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 +27 -6
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
- 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 +7 -3
- 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 +71 -2
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
- 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 +9 -3
- 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 +3 -3
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
- 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 +41 -17
- 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/method.md +22 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
- package/dist/knowledge/references/brand.name-choice.config.md +144 -0
- package/dist/knowledge/references/brand.name-screening.config.md +308 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
- package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
- package/dist/knowledge/references/capability-composition.config.md +67 -4
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
- package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +374 -1
- package/dist/knowledge/registries/playbooks.json +76 -28
- package/dist/knowledge/registries/source-tags.json +1513 -898
- package/dist/knowledge/rules/live-context-door.md +5 -2
- package/dist/knowledge/skills/INDEX.md +5 -2
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1590 -292
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# saas.frontend.launcher.runtime-availability
|
|
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
|
+
* When a launcher entry appears at all: `runtimeAvailability` on a sidebar section, a sidebar item, a command-menu
|
|
14
|
+
* command, a quick action, a toolbar, control-panel or menubar item, or a hotkey. An entry that fails it is removed, not
|
|
15
|
+
* shown disabled.
|
|
16
|
+
*
|
|
17
|
+
* - `requiredCapabilities`: runtime capabilities that must all be on (`billingEnabled`, `ssoEnabled`…).
|
|
18
|
+
* - `visibleToRoles`: the roles the entry is shown to (an office-only section a field technician does not see).
|
|
19
|
+
*
|
|
20
|
+
* Import from `@wildo-ai/saas-frontend-lib`.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* // frontend/src/config/app-shell.config.ts: a sidebar section only office staff see
|
|
24
|
+
* { contentKind: SidebarSectionContentKind.NAVIGATION_LIST, ref: 'office',
|
|
25
|
+
* runtimeAvailability: { visibleToRoles: ['office-manager', CORE_ORG_ROLES.ORG_ADMIN] },
|
|
26
|
+
* children: [{ kind: LauncherItemTargetKind.VIEW, viewRef: 'invoices' }] }
|
|
27
|
+
*
|
|
28
|
+
* This is intentionally distinct from `requiredFeatures` on resolved
|
|
29
|
+
* view/resource targets:
|
|
30
|
+
* - `runtimeAvailability` decides whether a launcher declaration should survive
|
|
31
|
+
* the app-shell filtering pass at all
|
|
32
|
+
* - `requiredFeatures` stays the canonical plan/subscription gating mechanism
|
|
33
|
+
* once an item has already survived launcher filtering and is being resolved
|
|
34
|
+
*/
|
|
35
|
+
export interface LauncherRuntimeAvailabilityConfig {
|
|
36
|
+
requiredCapabilities?: string[];
|
|
37
|
+
/**
|
|
38
|
+
* The roles this item is shown to: an office-only "Invoices" section a field technician does not see. Visible when the
|
|
39
|
+
* viewer holds ANY listed role, at the application or in the current organization, or a CORE role that inherits one
|
|
40
|
+
* (an organization owner sees an `ORG_MEMBER` item).
|
|
41
|
+
*
|
|
42
|
+
* A custom role counts only as itself: the browser receives the application's role keys, not how its custom roles
|
|
43
|
+
* inherit, so list every role that should see the item. Never wider: an unknown role does not reveal an item, because
|
|
44
|
+
* the declaration names exactly who it is for.
|
|
45
|
+
*
|
|
46
|
+
* Navigation, not authorization. Hiding an entry stops nobody from opening its target; the target operation's `roles`
|
|
47
|
+
* are what the backend enforces. An entry opening a resource operation the viewer's roles cannot perform is already
|
|
48
|
+
* hidden by resolution, so `visibleToRoles` is for narrowing further: an operation open to every member that only
|
|
49
|
+
* office staff need in their navigation.
|
|
50
|
+
*
|
|
51
|
+
* Omitted or empty: shown to every role.
|
|
52
|
+
*/
|
|
53
|
+
visibleToRoles?: string[];
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export const LauncherRuntimeAvailabilityConfigSchema = z.object({
|
|
57
|
+
requiredCapabilities: z.array(z.string()).optional(),
|
|
58
|
+
visibleToRoles: z.array(z.string().min(1)).optional(),
|
|
59
|
+
});
|
|
60
|
+
```
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# saas.frontend.resource-label-params
|
|
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
|
+
* Parameters passed to a `getFrontendResourceLabel` function: what a resource's ui-behavior receives when it names one
|
|
14
|
+
* record (a list row, a page title, a reference chip). Import the type from `@wildo-ai/saas-frontend-lib`.
|
|
15
|
+
*
|
|
16
|
+
* Words in a label come from `t`, which takes a FULL key (`resources.<type>.…`). This resource's own `resources.<type>`
|
|
17
|
+
* words are always loaded; a label that also needs words from ANOTHER label section declares it in
|
|
18
|
+
* `instanceLabelSections`, or `t` renders the key itself wherever that section has not been loaded. Dates go through
|
|
19
|
+
* `formatDate` / `formatDateTime`, never a hand-formatted string.
|
|
20
|
+
*
|
|
21
|
+
* Generic `TMainSchema` defaults to `z.ZodAny` — presets and records use the
|
|
22
|
+
* default (giving `currentObject: any`), while app-level configs can narrow it
|
|
23
|
+
* to a concrete schema for type-safe field access.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* // An invoice named by its number and its issue date, in the viewer's date format.
|
|
27
|
+
* getFrontendResourceLabel: ({ currentObject, formatDate }) => `${currentObject.number} · ${formatDate(currentObject.issuedAt)}`,
|
|
28
|
+
*/
|
|
29
|
+
export type ResourceUIBehaviorLabelParams<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {
|
|
30
|
+
currentObject: z.infer<TMainSchema>;
|
|
31
|
+
objectContext: any;
|
|
32
|
+
initiatorUserContext?: any;
|
|
33
|
+
t: (toTranslate: string, params?: Record<string, any>) => string;
|
|
34
|
+
/**
|
|
35
|
+
* Formats a date the way the viewer's regional preferences (date format, timezone) render one everywhere
|
|
36
|
+
* else. A label built from a date must use it: a hand-formatted `YYYY-MM-DD` agreed with the record's own
|
|
37
|
+
* card only for a viewer whose preference happened to be ISO, and a different timezone could shift the day.
|
|
38
|
+
*/
|
|
39
|
+
formatDate: (value: Date | string | number) => string;
|
|
40
|
+
/**
|
|
41
|
+
* `formatDate` with the time of day, for a record whose name is an instant rather than a day — an audit
|
|
42
|
+
* event, where many share a date and only the time tells them apart.
|
|
43
|
+
*/
|
|
44
|
+
formatDateTime: (value: Date | string | number) => string;
|
|
45
|
+
/**
|
|
46
|
+
* The resource being named. One polymorphic behavior serves several resource types (an organization's and a
|
|
47
|
+
* user's billing account share one callback), and a record with no name of its own is named by ITS resource's
|
|
48
|
+
* words — which only the resource type can address in the label tree.
|
|
49
|
+
*/
|
|
50
|
+
resourceType: string;
|
|
51
|
+
};
|
|
52
|
+
```
|
|
@@ -53,6 +53,8 @@ export enum CollectionFilterPanelVisibility {
|
|
|
53
53
|
HIDDEN = 'hidden',
|
|
54
54
|
}
|
|
55
55
|
|
|
56
|
+
/**
|
|
57
|
+
*/
|
|
56
58
|
/**
|
|
57
59
|
* A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
|
|
58
60
|
*
|
|
@@ -65,39 +67,63 @@ export enum CollectionFilterPanelVisibility {
|
|
|
65
67
|
* Resolution is in the VIEWER's timezone, which is the only one that makes "today" true for the
|
|
66
68
|
* person reading the screen. The backend compares instants, so the boundaries travel as absolute
|
|
67
69
|
* times and nothing downstream has to know a timezone was involved.
|
|
70
|
+
*
|
|
71
|
+
* Every window is whole local days and ends at the LAST instant of its last day, one millisecond before the next local
|
|
72
|
+
* midnight. The date-range filter's end bound is inclusive, and a date-only value (a due date picked in a calendar) is
|
|
73
|
+
* stored at the local midnight of the day it names, so ending at the next midnight would also match the day after.
|
|
68
74
|
*/
|
|
69
75
|
export enum CollectionFilterPresetRelativeRange {
|
|
70
|
-
/**
|
|
76
|
+
/** All of today, local: midnight this morning to the end of the day. */
|
|
71
77
|
TODAY = 'today',
|
|
72
|
-
/**
|
|
78
|
+
/** All of yesterday, local. */
|
|
73
79
|
YESTERDAY = 'yesterday',
|
|
74
80
|
/** The last seven days INCLUDING today — the rolling week, not the last seven whole days. */
|
|
75
81
|
LAST_7_DAYS = 'last_7_days',
|
|
76
82
|
/** The last thirty days including today. */
|
|
77
83
|
LAST_30_DAYS = 'last_30_days',
|
|
78
|
-
/** The first of this calendar month
|
|
84
|
+
/** The first of this calendar month through the end of today. */
|
|
79
85
|
THIS_MONTH = 'this_month',
|
|
80
|
-
/** The first of this calendar year
|
|
86
|
+
/** The first of this calendar year through the end of today. */
|
|
81
87
|
THIS_YEAR = 'this_year',
|
|
88
|
+
/**
|
|
89
|
+
* Everything BEFORE today, local: what an "overdue" list shows on a due-date field. Ends at the last instant of
|
|
90
|
+
* yesterday, so a date-only value due TODAY is due, not overdue. A deadline with a time earlier today is in TODAY, not
|
|
91
|
+
* here: the window is whole days, like every other member, so the pill reads the same all day.
|
|
92
|
+
*/
|
|
93
|
+
BEFORE_TODAY = 'before_today',
|
|
94
|
+
/** Today and the six days after it, local: "due this week" from today. */
|
|
95
|
+
NEXT_7_DAYS = 'next_7_days',
|
|
96
|
+
/** Today and the twenty-nine days after it, local. */
|
|
97
|
+
NEXT_30_DAYS = 'next_30_days',
|
|
82
98
|
}
|
|
83
99
|
|
|
84
100
|
/**
|
|
85
|
-
*
|
|
101
|
+
* A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
|
|
102
|
+
* viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
|
|
103
|
+
* reading the list, whoever that is.
|
|
86
104
|
*
|
|
87
|
-
*
|
|
88
|
-
*
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
*
|
|
97
|
-
* vocabulary — a preset assigning one is writing the same value the filter panel's own two inputs do.
|
|
105
|
+
* A preset naming one is unavailable to a viewer the value cannot be resolved for (no signed-in user): the pill is
|
|
106
|
+
* disabled rather than applied without the field, which would show a different list under the same name.
|
|
107
|
+
*/
|
|
108
|
+
export enum CollectionFilterPresetContextValue {
|
|
109
|
+
/** The signed-in user's id, for a reference field such as an assignee or owner. */
|
|
110
|
+
CURRENT_USER = 'current_user',
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* What a preset ASSIGNS to one filter field.
|
|
98
115
|
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
116
|
+
* Four kinds, split by WHEN the value is known:
|
|
117
|
+
*
|
|
118
|
+
* - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
|
|
119
|
+
* which is the whole of "filter to HIGH priority";
|
|
120
|
+
* - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
|
|
121
|
+
* answer would be wrong by tomorrow;
|
|
122
|
+
* - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
|
|
123
|
+
* backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
|
|
124
|
+
* commonest threshold anyone asks for;
|
|
125
|
+
* - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
|
|
126
|
+
* when the pill is clicked, so the same authored preset shows each viewer their own rows.
|
|
101
127
|
*/
|
|
102
128
|
export const CollectionFilterPresetValueSchema = z.union([
|
|
103
129
|
z.string(),
|
|
@@ -105,6 +131,7 @@ export const CollectionFilterPresetValueSchema = z.union([
|
|
|
105
131
|
z.boolean(),
|
|
106
132
|
z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
|
|
107
133
|
z.object({ min: z.number().optional(), max: z.number().optional() }),
|
|
134
|
+
z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
|
|
108
135
|
]);
|
|
109
136
|
export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
|
|
110
137
|
|
|
@@ -668,6 +695,8 @@ export const ResourceOperationFrontendConfigSchema = z.object({
|
|
|
668
695
|
* presetFilters: [
|
|
669
696
|
* { ref: 'urgent', filters: { priority: 'high' } },
|
|
670
697
|
* { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
|
|
698
|
+
* { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
|
|
699
|
+
* { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
|
|
671
700
|
* ]
|
|
672
701
|
*/
|
|
673
702
|
presetFilters: z.array(CollectionFilterPresetSchema).optional(),
|
|
@@ -139,7 +139,10 @@ export type ResourceUIBehaviorConfig<
|
|
|
139
139
|
* Can be either:
|
|
140
140
|
* - `string[]` — array of field paths to concatenate (each entry is a field
|
|
141
141
|
* name on the summary record, including any server-resolved virtual field
|
|
142
|
-
* such as a `forwardedLabel`, e.g. `['instanceLabel']`).
|
|
142
|
+
* such as a `forwardedLabel`, e.g. `['instanceLabel']`). The present,
|
|
143
|
+
* non-empty values are trimmed and joined with ONE SPACE (`['firstName',
|
|
144
|
+
* 'lastName']` → "Ada Lovelace"); for any other separator, or for words,
|
|
145
|
+
* use the function form.
|
|
143
146
|
* - `(params: ResourceUIBehaviorLabelParams) => string` — a function
|
|
144
147
|
*
|
|
145
148
|
* Used by `ResourceListItemRenderer` (rows) and `ResourceLayout_Header` (titles).
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# saas.frontend.settings-hub.engine-destination-roles
|
|
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
|
+
/** Org-management destinations are visible to organization owners and admins. */
|
|
13
|
+
const ORG_MANAGEMENT_ROLES: string[] = [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN];
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Application-administration destinations are visible to the application's own super-administrator.
|
|
17
|
+
*
|
|
18
|
+
* ONE role, deliberately, and not the wider `APP_ADMIN_*` family: every destination gated with this
|
|
19
|
+
* is a surface whose resource ALSO requires `APP_ADMIN_SUPER_ADMIN` server-side, so admitting
|
|
20
|
+
* `APP_ADMIN_VIEWER` or `APP_ADMIN_BILLING_MANAGER` here would render a rail entry that answers 403
|
|
21
|
+
* on open — worse than absent, because it reads as a permission the operator has and a bug they hit.
|
|
22
|
+
* Widen this only alongside the operation roles it would then have to match.
|
|
23
|
+
*/
|
|
24
|
+
const APPLICATION_ADMINISTRATION_ROLES: string[] = [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN];
|
|
25
|
+
```
|
|
@@ -119,8 +119,8 @@ export interface SettingsDestination {
|
|
|
119
119
|
ref: string;
|
|
120
120
|
/** What the destination renders in its content panel. */
|
|
121
121
|
target: SettingsSectionTarget;
|
|
122
|
-
/** Declarative runtime capability gating (
|
|
123
|
-
runtimeAvailability?:
|
|
122
|
+
/** Declarative runtime capability gating (launcher items' `requiredCapabilities`; roles are `requiredRoles`). */
|
|
123
|
+
runtimeAvailability?: SettingsRuntimeAvailabilityConfig;
|
|
124
124
|
/** Feature flags required to surface this destination (plan/subscription gating). */
|
|
125
125
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
126
126
|
/** RBAC roles required to surface this destination (OR semantics). */
|
|
@@ -89,6 +89,19 @@ export enum AuditApplicationReadAccess {
|
|
|
89
89
|
INDEPENDENT_APPROVAL = 'independent-approval',
|
|
90
90
|
}
|
|
91
91
|
|
|
92
|
+
/**
|
|
93
|
+
* How one of the application's OWN audit event types is classified: the activity it records and the attention it
|
|
94
|
+
* deserves. The same two vocabularies the engine uses for its event types.
|
|
95
|
+
*/
|
|
96
|
+
export const ApplicationAuditEventTypeDeclarationSchema = z.strictObject({
|
|
97
|
+
/** What kind of activity the event records. A business event (an invoice issued, a quote sent) is `data_access`. */
|
|
98
|
+
category: z.enum(AuditEventCategory),
|
|
99
|
+
/** How much attention it deserves: `info` is evidence, `warning` is worth review, `critical` is meant for whoever handles security incidents. A SIEM destination's event filter is what routes on it. */
|
|
100
|
+
severity: z.enum(AuditEventSeverity),
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
export type ApplicationAuditEventTypeDeclaration = z.infer<typeof ApplicationAuditEventTypeDeclarationSchema>;
|
|
104
|
+
|
|
92
105
|
export const AuditTrailConfigSchema = z.object({
|
|
93
106
|
/**
|
|
94
107
|
* Application audit viewer admission. Omitted means ROLE_BASED in every environment.
|
|
@@ -155,7 +168,39 @@ export const AuditTrailConfigSchema = z.object({
|
|
|
155
168
|
* addresses are admitted, never whether the admitted address is the one connected to.
|
|
156
169
|
*/
|
|
157
170
|
allowPrivateNetworkSiemCollectors: z.boolean().optional(),
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The application's OWN audit event types — the `eventType` values it passes to `AuditLogsBackendService.logEvent`
|
|
174
|
+
* — each with its classification. Keyed by the exact `eventType` string.
|
|
175
|
+
*
|
|
176
|
+
* ── What declaring one changes ─────────────────────────────────────────────
|
|
177
|
+
* - Every row of that type is recorded with the declared `eventCategory` and `severity`, and the SIEM export
|
|
178
|
+
* routes and filters by them. An UNDECLARED application type is recorded as `data_access` / `info`, whatever
|
|
179
|
+
* the event is — a business-critical event is then indistinguishable from routine reads.
|
|
180
|
+
* - The labelling pipeline plans a word for it (`system_enums.CoreAuditableEventType.<eventType>`, the open
|
|
181
|
+
* vocabulary the audit row's `eventType` field names), so the audit views show "Quote issued" instead of
|
|
182
|
+
* `SALES_QUOTE_ISSUED`. Run label generation after adding one.
|
|
183
|
+
*
|
|
184
|
+
* ── What it cannot do ──────────────────────────────────────────────────────
|
|
185
|
+
* It cannot reclassify a FRAMEWORK event type: the engine's own classification is authoritative, and naming one of
|
|
186
|
+
* its event types here is refused at startup. The key must be usable as the last segment of a label key (letters,
|
|
187
|
+
* digits, `_`, `-`).
|
|
188
|
+
*
|
|
189
|
+
* Severity is a property of the event TYPE. A row's `riskLevel` (supplied per emission) is a separate signal and
|
|
190
|
+
* does not change it.
|
|
191
|
+
*
|
|
192
|
+
* @example
|
|
193
|
+
* auditTrail: {
|
|
194
|
+
* applicationEventTypes: {
|
|
195
|
+
* SALES_QUOTE_ISSUED: { category: AuditEventCategory.DATA_ACCESS, severity: AuditEventSeverity.WARNING },
|
|
196
|
+
* },
|
|
197
|
+
* }
|
|
198
|
+
*/
|
|
199
|
+
applicationEventTypes: z.record(z.string().regex(LABEL_KEY_SEGMENT_PATTERN), ApplicationAuditEventTypeDeclarationSchema).optional(),
|
|
158
200
|
});
|
|
159
201
|
|
|
202
|
+
/** The application's declared audit event types, keyed by `eventType` — see `AuditTrailConfig.applicationEventTypes`. */
|
|
203
|
+
export type ApplicationAuditEventTypes = NonNullable<AuditTrailConfig['applicationEventTypes']>;
|
|
204
|
+
|
|
160
205
|
export type AuditTrailConfig = z.infer<typeof AuditTrailConfigSchema>;
|
|
161
206
|
```
|
|
@@ -28,9 +28,11 @@
|
|
|
28
28
|
* dropped, and were removed. The framework's SMS transport serves authentication's one-time codes, not
|
|
29
29
|
* resource notifications.
|
|
30
30
|
*
|
|
31
|
-
* For an EMAIL, create the template
|
|
32
|
-
*
|
|
33
|
-
* and
|
|
31
|
+
* For an EMAIL, create the template the derived reference names: one per operation variant that declares a
|
|
32
|
+
* `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
|
|
33
|
+
* the configured locale chain before the application takes traffic and names the folder to create when one is
|
|
34
|
+
* missing. It REFUSES to start only for an operation with `tokenGeneration` (the email carries the token its flow
|
|
35
|
+
* needs); for any other operation it WARNS and starts, and that email is silently never sent.
|
|
34
36
|
*
|
|
35
37
|
* ## The recipient's preferences are honoured, and three things override them
|
|
36
38
|
*
|
|
@@ -13,6 +13,56 @@
|
|
|
13
13
|
export const SCHEDULED_INITIAL_ADMISSION_MAX_AGE_MS = 5 * 60 * 1000;
|
|
14
14
|
export const SCHEDULED_INITIAL_ADMISSION_FUTURE_SKEW_MS = 30 * 1000;
|
|
15
15
|
|
|
16
|
+
/**
|
|
17
|
+
* How long after its token expired a delivery may still be RECORDED as a missed occurrence (#2212).
|
|
18
|
+
*
|
|
19
|
+
* An expired token stays cryptographically valid forever, so without a horizon anyone able to
|
|
20
|
+
* publish onto the application's queue could replay a captured token of any age and plant a
|
|
21
|
+
* "missed while absent" record. The horizon is APPROXIMATELY the job-row retention: within it, a
|
|
22
|
+
* replayed token almost always meets the occurrence's existing row and is recognised as already
|
|
23
|
+
* held; beyond it, no genuine backlog is plausible and the delivery is rejected as a trust failure.
|
|
24
|
+
* "Approximately" because a row that ran on time expires measured from its completion while the
|
|
25
|
+
* horizon is measured from the token's expiry, which leaves a window of a few minutes in which a
|
|
26
|
+
* replay is recorded as a fresh miss. It never runs anything, and archived run evidence still wins
|
|
27
|
+
* the occurrence in coverage.
|
|
28
|
+
*
|
|
29
|
+
* Equal to `JOB_EXECUTION_TTL_SECONDS` (declared further down, outside this shared block, so it
|
|
30
|
+
* cannot be referenced here without a temporal-dead-zone hazard); a test pins the two together, so
|
|
31
|
+
* changing one without the other fails.
|
|
32
|
+
*/
|
|
33
|
+
export const SCHEDULED_LATE_DELIVERY_HORIZON_MS = 30 * 24 * 60 * 60 * 1000;
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Why an AUTHENTIC scheduled delivery reached the application too late to be admitted (#2212).
|
|
37
|
+
*
|
|
38
|
+
* Either way the occurrence was MISSED: it is recorded as such and not run, and the schedule
|
|
39
|
+
* continues with its next occurrence. The two gates differ in WHO was late, which is why they are
|
|
40
|
+
* kept apart:
|
|
41
|
+
*
|
|
42
|
+
* - `TOKEN_EXPIRED` — the delivery sat in the queue for longer than its token lives, so nothing
|
|
43
|
+
* consumed the application's scheduled queue for that long: the backend (or minion) was stopped,
|
|
44
|
+
* restarting or crash-looping. This is the common case after a restart.
|
|
45
|
+
* - `OUTSIDE_ADMISSION_WINDOW` — the token is still current, but the occurrence it names is older
|
|
46
|
+
* than the window. The scheduler may sign up to the window's length AFTER the occurrence, so the
|
|
47
|
+
* delay is shared between the scheduler's publication and the application's consumption, and
|
|
48
|
+
* cannot be attributed to the application alone.
|
|
49
|
+
*
|
|
50
|
+
* A late delivery is never an authentication failure: its signature, issuer and audience were
|
|
51
|
+
* proven before it was classified late. A token that cannot be proven authentic, that names an
|
|
52
|
+
* occurrence in the future, or that expired longer ago than `SCHEDULED_LATE_DELIVERY_HORIZON_MS`
|
|
53
|
+
* is a trust failure instead and is reported loudly.
|
|
54
|
+
*
|
|
55
|
+
* Missed occurrences are SKIPPED, never caught up: that is the established cron behaviour (a
|
|
56
|
+
* Kubernetes `CronJob` past its `startingDeadlineSeconds`, a Quartz trigger with the do-nothing
|
|
57
|
+
* misfire instruction), and it keeps the short signed window a replay bound rather than a credential.
|
|
58
|
+
*/
|
|
59
|
+
export enum ScheduledDeliveryLateness {
|
|
60
|
+
/** The signed delivery token's `exp` passed before the delivery was consumed. */
|
|
61
|
+
TOKEN_EXPIRED = 'token_expired',
|
|
62
|
+
/** The token is current, but the occurrence it names is older than `SCHEDULED_INITIAL_ADMISSION_MAX_AGE_MS`; scheduler and consumer share the delay. */
|
|
63
|
+
OUTSIDE_ADMISSION_WINDOW = 'outside_admission_window',
|
|
64
|
+
}
|
|
65
|
+
|
|
16
66
|
/** How the handler's complete effects tolerate execution after an uncertain outcome. */
|
|
17
67
|
export enum ScheduledReplaySafety {
|
|
18
68
|
/** No automatic repetition; a failed call can already have committed effects. */
|
|
@@ -86,11 +136,41 @@ export const ScheduledEvidencePolicySchema = z.object({
|
|
|
86
136
|
});
|
|
87
137
|
export type ScheduledEvidencePolicy = z.infer<typeof ScheduledEvidencePolicySchema>;
|
|
88
138
|
|
|
139
|
+
/** How a scheduled occurrence's archived evidence came to exist. */
|
|
89
140
|
export enum ScheduledEvidenceSource {
|
|
141
|
+
/** The handler ran and reported completion. */
|
|
90
142
|
EXECUTION = 'execution',
|
|
143
|
+
/** The handler's reconciler established that an interrupted run completed. */
|
|
91
144
|
RECONCILIATION = 'reconciliation',
|
|
145
|
+
/** An operator confirmed completion of an occurrence held for review. */
|
|
92
146
|
OPERATOR_CONFIRMATION = 'operator_confirmation',
|
|
147
|
+
/** An operator decided an occurrence held for review will not run. */
|
|
93
148
|
ABANDONMENT = 'abandonment',
|
|
149
|
+
/**
|
|
150
|
+
* The occurrence was never run: its authentic delivery reached the application after the
|
|
151
|
+
* admission deadline (see `ScheduledDeliveryLateness` for who was late). Coverage reads it as an
|
|
152
|
+
* EXPLAINED gap: the slot stays missing, because the occurrence did not run, and the record says
|
|
153
|
+
* why — rather than an unexplained one.
|
|
154
|
+
*/
|
|
155
|
+
LATE_DELIVERY = 'late_delivery',
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* The terminal invocation status each evidence source records — the one place that pairing is stated.
|
|
160
|
+
*
|
|
161
|
+
* A source whose occurrence never reached a successful invocation records `FAILED`; this follows the
|
|
162
|
+
* precedent `ABANDONMENT` set, and the SOURCE (never the status) is what says why it did not run.
|
|
163
|
+
*/
|
|
164
|
+
export function scheduledEvidenceInvocationStatus(source: ScheduledEvidenceSource): JobExecutionStatus {
|
|
165
|
+
switch (source) {
|
|
166
|
+
case ScheduledEvidenceSource.EXECUTION:
|
|
167
|
+
case ScheduledEvidenceSource.RECONCILIATION:
|
|
168
|
+
case ScheduledEvidenceSource.OPERATOR_CONFIRMATION:
|
|
169
|
+
return JobExecutionStatus.COMPLETED;
|
|
170
|
+
case ScheduledEvidenceSource.ABANDONMENT:
|
|
171
|
+
case ScheduledEvidenceSource.LATE_DELIVERY:
|
|
172
|
+
return JobExecutionStatus.FAILED;
|
|
173
|
+
}
|
|
94
174
|
}
|
|
95
175
|
export enum ScheduledEvidenceResultStatus {
|
|
96
176
|
CAPTURED = 'captured',
|
|
@@ -120,8 +200,7 @@ export const ScheduledRunEvidenceSchema = ScheduledRunEvidenceFieldsSchema.super
|
|
|
120
200
|
: evidence.jobType !== JobType.SCHEDULED_CRON || !(evidence.batchRef || evidence.operationPathKey))) {
|
|
121
201
|
ctx.addIssue({ code: 'custom', message: 'Evidence requires exactly one scheduled batch, operation or minion target' });
|
|
122
202
|
}
|
|
123
|
-
|
|
124
|
-
if (evidence.invocationStatus !== expectedStatus) {
|
|
203
|
+
if (evidence.invocationStatus !== scheduledEvidenceInvocationStatus(evidence.source)) {
|
|
125
204
|
ctx.addIssue({ code: 'custom', path: ['invocationStatus'], message: 'Terminal outcome must agree with evidence source' });
|
|
126
205
|
}
|
|
127
206
|
|
|
@@ -584,6 +584,32 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
584
584
|
* Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
|
|
585
585
|
* one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
|
|
586
586
|
* a person — and if so, whose session an erasure ends.
|
|
587
|
+
*
|
|
588
|
+
* And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
|
|
589
|
+
* `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
|
|
590
|
+
* `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
|
|
591
|
+
* and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
|
|
592
|
+
* transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
|
|
593
|
+
* erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
|
|
594
|
+
* `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
|
|
595
|
+
*
|
|
596
|
+
* Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
|
|
597
|
+
* or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
|
|
598
|
+
* STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
|
|
599
|
+
* service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
|
|
600
|
+
*
|
|
601
|
+
* @example
|
|
602
|
+
* ```ts
|
|
603
|
+
* retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
|
|
604
|
+
* dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
|
|
605
|
+
* coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
|
|
606
|
+
* operationsConfiguration: {
|
|
607
|
+
* // …READ / LIST as API_CALL defaults…
|
|
608
|
+
* [CoreResourceOperation.UPDATE_MANY]: {
|
|
609
|
+
* variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
|
|
610
|
+
* },
|
|
611
|
+
* },
|
|
612
|
+
* ```
|
|
587
613
|
*/
|
|
588
614
|
retentionPolicy?: ResourceRetentionPolicy,
|
|
589
615
|
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# saas.models.roles.definition
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* One role an application declares, and the table of them. Import from `@wildo-ai/saas-models`
|
|
14
|
+
* (`RolesConfiguration`, `CORE_ORG_ROLES`, `CORE_APP_ROLES`, `ResourcePrimaryScope`).
|
|
15
|
+
*
|
|
16
|
+
* An application's own roles live in ONE place: `CUSTOM_ROLES_CONFIGURATION` in
|
|
17
|
+
* `shared-lib/src/engine/roles.ts`, a `RolesConfiguration` keyed by the role's name. Nothing else
|
|
18
|
+
* declares a role — never a resource holding role names or permission lists, which the engine does not
|
|
19
|
+
* read.
|
|
20
|
+
*
|
|
21
|
+
* - `role` — the role's name, equal to its key. Any string; prefer a stable upper-snake name
|
|
22
|
+
* (`FIELD_TECHNICIAN`).
|
|
23
|
+
* - `inheritFrom` — the role whose access this one also receives. A holder of a role satisfies every
|
|
24
|
+
* operation naming that role OR any role up its `inheritFrom` chain. The core organization chain is
|
|
25
|
+
* linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`. So a custom role inheriting
|
|
26
|
+
* `ORG_MEMBER` is NOT held by an `ORG_ADMIN`: to let administrators do what the custom role does,
|
|
27
|
+
* name both roles on the operation.
|
|
28
|
+
* - `isSystemRole` — `false` for every role an application declares.
|
|
29
|
+
* - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
|
|
30
|
+
* organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
|
|
31
|
+
* ignored at startup with a warning, and the role grants nothing.
|
|
32
|
+
*
|
|
33
|
+
* Declaring a role is one of three steps. An organization role must also be listed in
|
|
34
|
+
* `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
|
|
35
|
+
* it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
|
|
36
|
+
* nothing). People receive it through the engine's members screen and invitations.
|
|
37
|
+
*/
|
|
38
|
+
export const RoleDefinitionSchema = z.object({
|
|
39
|
+
role: RolesSchema,
|
|
40
|
+
inheritFrom: RolesSchema.optional(),
|
|
41
|
+
isSystemRole: z.boolean().default(false),
|
|
42
|
+
relatedPrimaryScope : z.enum(ResourcePrimaryScope),
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
export type RoleDefinition = z.infer<typeof RoleDefinitionSchema>;
|
|
47
|
+
|
|
48
|
+
export const RolesConfigurationSchema = z.record(z.string(), RoleDefinitionSchema).refine(
|
|
49
|
+
(record) => {
|
|
50
|
+
// Validate that all keys are valid roles
|
|
51
|
+
return Object.keys(record).every(key => {
|
|
52
|
+
try {
|
|
53
|
+
RolesSchema.parse(key);
|
|
54
|
+
return true;
|
|
55
|
+
} catch {
|
|
56
|
+
return false;
|
|
57
|
+
}
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
);
|
|
61
|
+
```
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# saas.models.roles.organization-defaults
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The organization roles the engine ships, and how they inherit. Read it to choose what a custom role
|
|
14
|
+
* should `inheritFrom` and which roles an operation must name.
|
|
15
|
+
*
|
|
16
|
+
* The person-holdable chain is linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`
|
|
17
|
+
* (each holds everything to its right). `ORG_SERVICE_PROVIDER` hangs off `ORG_MEMBER` for experts of a
|
|
18
|
+
* service firm. The entries after `ORG_OWNER` are handler-only or delegated-capability roles: the
|
|
19
|
+
* engine confers them (an inbound handler, a live capability grant), they are never stored on a
|
|
20
|
+
* membership, and a membership naming one is refused. Never inherit from them or assign them.
|
|
21
|
+
*/
|
|
22
|
+
export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
23
|
+
[CORE_ORG_ROLES.ORG_GUEST]: {
|
|
24
|
+
role: CORE_ORG_ROLES.ORG_GUEST,
|
|
25
|
+
isSystemRole: true,
|
|
26
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
27
|
+
},
|
|
28
|
+
[CORE_ORG_ROLES.ORG_MEMBER]: {
|
|
29
|
+
role: CORE_ORG_ROLES.ORG_MEMBER,
|
|
30
|
+
inheritFrom: CORE_ORG_ROLES.ORG_GUEST,
|
|
31
|
+
isSystemRole: true,
|
|
32
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
33
|
+
},
|
|
34
|
+
[CORE_ORG_ROLES.ORG_SERVICE_PROVIDER]: {
|
|
35
|
+
role: CORE_ORG_ROLES.ORG_SERVICE_PROVIDER,
|
|
36
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
|
|
37
|
+
isSystemRole: true,
|
|
38
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
39
|
+
},
|
|
40
|
+
[CORE_ORG_ROLES.ORG_MANAGER]: {
|
|
41
|
+
role: CORE_ORG_ROLES.ORG_MANAGER,
|
|
42
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
|
|
43
|
+
isSystemRole: true,
|
|
44
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
45
|
+
},
|
|
46
|
+
[CORE_ORG_ROLES.ORG_ADMIN]: {
|
|
47
|
+
role: CORE_ORG_ROLES.ORG_ADMIN,
|
|
48
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MANAGER,
|
|
49
|
+
isSystemRole: true,
|
|
50
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
51
|
+
},
|
|
52
|
+
[CORE_ORG_ROLES.ORG_OWNER]: {
|
|
53
|
+
role: CORE_ORG_ROLES.ORG_OWNER,
|
|
54
|
+
inheritFrom: CORE_ORG_ROLES.ORG_ADMIN,
|
|
55
|
+
isSystemRole: true,
|
|
56
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
57
|
+
},
|
|
58
|
+
// No `inheritFrom`: handler-only, confers exactly the billing operations that name it (#1629).
|
|
59
|
+
[CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS]: {
|
|
60
|
+
role: CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS,
|
|
61
|
+
isSystemRole: true,
|
|
62
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
63
|
+
},
|
|
64
|
+
// No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
|
|
65
|
+
// inheriting anything would make a lent capability's reach a function of what that role grows into later.
|
|
66
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
|
|
67
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS,
|
|
68
|
+
isSystemRole: true,
|
|
69
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
70
|
+
},
|
|
71
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS]: {
|
|
72
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS,
|
|
73
|
+
isSystemRole: true,
|
|
74
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
75
|
+
},
|
|
76
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL]: {
|
|
77
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL,
|
|
78
|
+
isSystemRole: true,
|
|
79
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
80
|
+
},
|
|
81
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM]: {
|
|
82
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM,
|
|
83
|
+
isSystemRole: true,
|
|
84
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
85
|
+
},
|
|
86
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS]: {
|
|
87
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS,
|
|
88
|
+
isSystemRole: true,
|
|
89
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
90
|
+
},
|
|
91
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS]: {
|
|
92
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS,
|
|
93
|
+
isSystemRole: true,
|
|
94
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
```
|