@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
|
@@ -789,7 +789,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
|
|
|
789
789
|
const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
|
|
790
790
|
|
|
791
791
|
for (const [iIdx, icp] of snapshot.icps.entries()) {
|
|
792
|
-
if (
|
|
792
|
+
if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
|
|
793
793
|
if (positionedIcpRefs.has(icp.ref)) continue;
|
|
794
794
|
|
|
795
795
|
issues.push({
|
|
@@ -379,9 +379,20 @@ export const indieMakerSelfPersona: MarketPersonaConfig = {
|
|
|
379
379
|
| Invariant | Command |
|
|
380
380
|
|--------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
|
|
381
381
|
| Every persona file uses the typed `MarketPersonaConfig` contract | `rg -n ":\s+MarketPersonaConfig" specifications/src/market/customer-profile/personas.ts` |
|
|
382
|
-
| `BUYING_GROUP_MEMBER` carries a `dmuRole` |
|
|
383
|
-
| `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole` |
|
|
384
|
-
| Every persona declares `belongsToIcpRefs` |
|
|
382
|
+
| `BUYING_GROUP_MEMBER` carries a `dmuRole` | see the commands below the table |
|
|
383
|
+
| `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole` | see the commands below the table |
|
|
384
|
+
| Every persona declares `belongsToIcpRefs` | see the commands below the table |
|
|
385
|
+
|
|
386
|
+
```bash
|
|
387
|
+
# `BUYING_GROUP_MEMBER` carries a `dmuRole`
|
|
388
|
+
rg -n "BUYING_GROUP_MEMBER" -A 4 specifications/src/market/ | rg "dmuRole"
|
|
389
|
+
|
|
390
|
+
# `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole`
|
|
391
|
+
rg -n "INDIVIDUAL_SELF|INDIVIDUAL_INFLUENCER" -A 4 specifications/src/market/ | rg -v "dmuRole"
|
|
392
|
+
|
|
393
|
+
# Every persona declares `belongsToIcpRefs`
|
|
394
|
+
rg -n "MarketPersonaConfig" -A 6 specifications/src/market/ | rg "belongsToIcpRefs"
|
|
395
|
+
```
|
|
385
396
|
|
|
386
397
|
## Common Rationalizations
|
|
387
398
|
|
|
@@ -350,9 +350,14 @@ export const indieMakerPositioning: MarketPositioningConfig = {
|
|
|
350
350
|
|-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
|
|
351
351
|
| Every positioning file uses the typed `MarketPositioningConfig` | `rg -n ":\s+MarketPositioningConfig" specifications/src/market/positioning.ts` |
|
|
352
352
|
| Each positioning ties to a CORE / EXPANSION ICP | `rg -n "icpRef:" specifications/src/market/positioning.ts` |
|
|
353
|
-
| Each pillar is backed by at least one benefit |
|
|
353
|
+
| Each pillar is backed by at least one benefit | see the commands below the table |
|
|
354
354
|
| No `LocalizedString` shapes inside positioning | `rg -n "LocalizedString" specifications/src/market/positioning.ts` |
|
|
355
355
|
|
|
356
|
+
```bash
|
|
357
|
+
# Each pillar is backed by at least one benefit
|
|
358
|
+
rg -n "valuePillars" -A 6 specifications/src/market/positioning.ts | rg "backedByBenefitRefs"
|
|
359
|
+
```
|
|
360
|
+
|
|
356
361
|
## Common Rationalizations
|
|
357
362
|
|
|
358
363
|
| Rationalization | Reality |
|
|
@@ -624,10 +624,18 @@ fires WARN:
|
|
|
624
624
|
|-----------|---------|
|
|
625
625
|
| Every proof file uses the typed `MarketProofConfig` | `rg -n ":\s+MarketProofConfig" specifications/src/market/` |
|
|
626
626
|
| Every objection file uses the typed `MarketObjectionConfig` | `rg -n ":\s+MarketObjectionConfig" specifications/src/market/` |
|
|
627
|
-
| Every proof declares non-empty support edges |
|
|
628
|
-
| Every objection declares a `response` |
|
|
627
|
+
| Every proof declares non-empty support edges | see the commands below the table |
|
|
628
|
+
| Every objection declares a `response` | see the commands below the table |
|
|
629
629
|
| No `LocalizedString` shapes in proof / objection files | `rg -n "LocalizedString" specifications/src/market/proofs.ts specifications/src/market/objections.ts` |
|
|
630
630
|
|
|
631
|
+
```bash
|
|
632
|
+
# Every proof declares non-empty support edges
|
|
633
|
+
rg -n "MarketProofConfig" -A 12 specifications/src/market/ | rg "supportsBenefitRefs|supportsIcpRefs"
|
|
634
|
+
|
|
635
|
+
# Every objection declares a `response`
|
|
636
|
+
rg -n "MarketObjectionConfig" -A 10 specifications/src/market/ | rg "response:"
|
|
637
|
+
```
|
|
638
|
+
|
|
631
639
|
## Common Rationalizations
|
|
632
640
|
|
|
633
641
|
| Rationalization | Reality |
|
|
@@ -578,10 +578,15 @@ itself:
|
|
|
578
578
|
| Invariant | Command |
|
|
579
579
|
|------------------------------------------------------------------------|------------------------------------------------------------------------------|
|
|
580
580
|
| Consumers import the typed scorer entrypoint | `rg -n "computeFeatureFitScoreForICP" --type ts` |
|
|
581
|
-
| No call site re-derives the algorithm by hand |
|
|
581
|
+
| No call site re-derives the algorithm by hand | see the commands below the table |
|
|
582
582
|
| Anti-target opt-in is intentional (rare; flag uses) | `rg -n "excludeAntiTargets:\s*false" --type ts` |
|
|
583
583
|
| Runtime no-go check uses the dedicated helper | `rg -n "isBenefitAvailable\(" --type ts` |
|
|
584
584
|
|
|
585
|
+
```bash
|
|
586
|
+
# No call site re-derives the algorithm by hand
|
|
587
|
+
rg -n "(theoreticalMax|raw \* 100|painSeverity)" --type ts | rg -v "market-scoring"
|
|
588
|
+
```
|
|
589
|
+
|
|
585
590
|
## Common Rationalizations
|
|
586
591
|
|
|
587
592
|
| Rationalization | Reality |
|
|
@@ -807,7 +807,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
|
|
|
807
807
|
const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
|
|
808
808
|
|
|
809
809
|
for (const [iIdx, icp] of snapshot.icps.entries()) {
|
|
810
|
-
if (
|
|
810
|
+
if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
|
|
811
811
|
if (positionedIcpRefs.has(icp.ref)) continue;
|
|
812
812
|
|
|
813
813
|
issues.push({
|
|
@@ -1663,9 +1663,20 @@ objection threatens:
|
|
|
1663
1663
|
| Invariant | Command |
|
|
1664
1664
|
|--------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
1665
1665
|
| Bootstrap calls the validator | `rg -n "validateMarketSnapshot\(" --type ts` |
|
|
1666
|
-
| Bootstrap throws BusinessConfigError on ERROR |
|
|
1667
|
-
| Bootstrap passes cross-family ref sets |
|
|
1668
|
-
| No consumer reaches into `result.issues` to mutate |
|
|
1666
|
+
| Bootstrap throws BusinessConfigError on ERROR | see the commands below the table |
|
|
1667
|
+
| Bootstrap passes cross-family ref sets | see the commands below the table |
|
|
1668
|
+
| No consumer reaches into `result.issues` to mutate | see the commands below the table |
|
|
1669
|
+
|
|
1670
|
+
```bash
|
|
1671
|
+
# Bootstrap throws BusinessConfigError on ERROR
|
|
1672
|
+
rg -n "validateMarketSnapshot" -A 6 --type ts | rg "BusinessConfigError"
|
|
1673
|
+
|
|
1674
|
+
# Bootstrap passes cross-family ref sets
|
|
1675
|
+
rg -n "validateMarketSnapshot" -A 4 --type ts | rg "availableFeatureRefs|availableProductRefs"
|
|
1676
|
+
|
|
1677
|
+
# No consumer reaches into `result.issues` to mutate
|
|
1678
|
+
rg -n "result\.issues\." --type ts | rg -v "filter|forEach|map|find"
|
|
1679
|
+
```
|
|
1669
1680
|
|
|
1670
1681
|
## Common Rationalizations
|
|
1671
1682
|
|
|
@@ -666,7 +666,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
|
|
|
666
666
|
const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
|
|
667
667
|
|
|
668
668
|
for (const [iIdx, icp] of snapshot.icps.entries()) {
|
|
669
|
-
if (
|
|
669
|
+
if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
|
|
670
670
|
if (positionedIcpRefs.has(icp.ref)) continue;
|
|
671
671
|
|
|
672
672
|
issues.push({
|
|
@@ -233,9 +233,14 @@ export const trustedEngineerVoice: ToneOfVoiceConfig = {
|
|
|
233
233
|
| Invariant | Command |
|
|
234
234
|
|----------------------------------------------------------------------|----------------------------------------------------------------------------------------|
|
|
235
235
|
| Voices use the typed `ToneOfVoiceConfig` contract | `rg -n ":\s+ToneOfVoiceConfig" specifications/src/market/tones-of-voice.ts` |
|
|
236
|
-
| Axis values stay in -2..+2 |
|
|
236
|
+
| Axis values stay in -2..+2 | see the commands below the table |
|
|
237
237
|
| At least 2 examples per voice | `rg -n "examples:\s*\[" -A 3 specifications/src/market/` |
|
|
238
238
|
|
|
239
|
+
```bash
|
|
240
|
+
# Axis values stay in -2..+2
|
|
241
|
+
rg -n "formality:|seriousness:|respectfulness:|enthusiasm:" specifications/src/market/ | rg -v ":\s*-?[012]\b"
|
|
242
|
+
```
|
|
243
|
+
|
|
239
244
|
## Common Rationalizations
|
|
240
245
|
|
|
241
246
|
| Rationalization | Reality |
|
|
@@ -620,6 +620,32 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
620
620
|
* Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
|
|
621
621
|
* one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
|
|
622
622
|
* a person — and if so, whose session an erasure ends.
|
|
623
|
+
*
|
|
624
|
+
* And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
|
|
625
|
+
* `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
|
|
626
|
+
* `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
|
|
627
|
+
* and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
|
|
628
|
+
* transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
|
|
629
|
+
* erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
|
|
630
|
+
* `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
|
|
631
|
+
*
|
|
632
|
+
* Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
|
|
633
|
+
* or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
|
|
634
|
+
* STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
|
|
635
|
+
* service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
|
|
636
|
+
*
|
|
637
|
+
* @example
|
|
638
|
+
* ```ts
|
|
639
|
+
* retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
|
|
640
|
+
* dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
|
|
641
|
+
* coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
|
|
642
|
+
* operationsConfiguration: {
|
|
643
|
+
* // …READ / LIST as API_CALL defaults…
|
|
644
|
+
* [CoreResourceOperation.UPDATE_MANY]: {
|
|
645
|
+
* variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
|
|
646
|
+
* },
|
|
647
|
+
* },
|
|
648
|
+
* ```
|
|
623
649
|
*/
|
|
624
650
|
retentionPolicy?: ResourceRetentionPolicy,
|
|
625
651
|
|
|
@@ -286,6 +286,12 @@ What earns its place:
|
|
|
286
286
|
(`compositeViewSpecifications`, `tasksManagerExecutionViewSpecifications`,
|
|
287
287
|
`tasksManagerChartViewSpecifications`) keep authorship close to the
|
|
288
288
|
module; the companion-exports file only **wires** them.
|
|
289
|
+
- In an application scaffolded by `wildo init`, that wiring is done for you: the file declares four
|
|
290
|
+
anchors (`applicationModuleResourceSpecifications`, `applicationModuleChartViewSpecifications`,
|
|
291
|
+
`applicationModuleExecutionViewSpecifications`, `applicationModuleCompositeViewSpecifications`),
|
|
292
|
+
and the `add-module` scenario spreads each new module's maps into them. A module created by hand
|
|
293
|
+
must be spread into the same four anchors, or its specifications exist and the companion reads
|
|
294
|
+
none of them.
|
|
289
295
|
- Annotate the authored snapshot with `BusinessSemanticsSnapshotDeclaration`, never with
|
|
290
296
|
`BusinessSemanticsSnapshot`. The declaration type leaves every defaulted list optional, so a
|
|
291
297
|
list the framework adds later (as `systemsOfRecord` was) does not break your specifications
|
|
@@ -324,7 +330,7 @@ Run from the app root:
|
|
|
324
330
|
|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
325
331
|
| Companion exports use the typed contract | `rg -n "SpecificationsCompanionExports<" specifications/src/companion-exports.ts` |
|
|
326
332
|
| Every spec family declared in the generic has an assignment | `rg -c ":\s+" specifications/src/companion-exports.ts` then count `<...>` parameters by hand (TS is the source of truth — must build) |
|
|
327
|
-
| No deep imports across package boundaries | `rg -n "from\s+'@wildo-ai/[^']+/(?!companion\b)[^']+/[^']+/" specifications/src/companion-exports.ts` (must return empty) |
|
|
333
|
+
| No deep imports across package boundaries | `rg -P -n "from\s+'@wildo-ai/[^']+/(?!companion\b)[^']+/[^']+/" specifications/src/companion-exports.ts` (must return empty) |
|
|
328
334
|
| Framework-default maps spread before app maps in merges | `rg -n "\.\.\.framework[A-Z][A-Za-z]+Specifications" specifications/src/companion-exports.ts` |
|
|
329
335
|
|
|
330
336
|
The first invariant (typed contract) is the high-signal one — the
|
package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md
CHANGED
|
@@ -132,6 +132,8 @@ export interface SpecificationsCompanionExports<
|
|
|
132
132
|
TIntegrationPlan = IntegrationPlan,
|
|
133
133
|
// Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
|
|
134
134
|
TApplicationMaturity = ApplicationMaturity,
|
|
135
|
+
// Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
|
|
136
|
+
TBrandNameScreening = BrandNameScreening,
|
|
135
137
|
> {
|
|
136
138
|
resourceSpecifications: TResourceSpecifications;
|
|
137
139
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -662,6 +664,14 @@ export interface SpecificationsCompanionExports<
|
|
|
662
664
|
* never a gate. Read by the coherence report and the workbench.
|
|
663
665
|
*/
|
|
664
666
|
applicationMaturity?: TApplicationMaturity;
|
|
667
|
+
/**
|
|
668
|
+
* WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
|
|
669
|
+
* registers, classes and jurisdictions searched, per-register results with sources and dates, and the
|
|
670
|
+
* competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
|
|
671
|
+
* `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
|
|
672
|
+
* brand name stands. A screening, never a legal clearance opinion.
|
|
673
|
+
*/
|
|
674
|
+
brandNameScreening?: TBrandNameScreening;
|
|
665
675
|
/**
|
|
666
676
|
* Accepted application-declared semantic causality between whole
|
|
667
677
|
* specification-family states. This is not the registry's physical
|
|
@@ -40,6 +40,7 @@ matching FK field produces silent JOIN failures at query time.
|
|
|
40
40
|
| Module relationships file | `shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
|
|
41
41
|
| Resource schemas (FK side) | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.schemas.ts` |
|
|
42
42
|
| Resource configs | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.config.ts` |
|
|
43
|
+
| Holder UI behavior | `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
43
44
|
| Resource specs | `specifications/src/modules/<slug>/resources/<resource>.resource.specification.ts` |
|
|
44
45
|
| FK identifier map | `shared-lib/src/modules/<slug>/resources/<slug>.resources-types.ts` |
|
|
45
46
|
|
|
@@ -92,7 +93,8 @@ one `[dependent-lifecycle-unclassified]` warning. Declare one of four on the edg
|
|
|
92
93
|
the rows hold nothing worth keeping once their owner is gone (the common case). The
|
|
93
94
|
child must declare `DELETE` or `DELETE_MANY`; an `INTERNAL_CALL` variant is enough and
|
|
94
95
|
adds no route.
|
|
95
|
-
- `strategy: IMPERSONALIZE_AND_RETAIN` — the child declares a `retentionPolicy
|
|
96
|
+
- `strategy: IMPERSONALIZE_AND_RETAIN` — the child declares a `retentionPolicy` (with the
|
|
97
|
+
`dataSubjectPolicy` the factory requires beside it), so its
|
|
96
98
|
rows survive frozen and hidden rather than destroyed. Only a retention-governed child
|
|
97
99
|
can take it; boot refuses it on any other.
|
|
98
100
|
- `onParentDelete: { enabled: true, strategy: REFUSE_WHILE_CHILDREN_EXIST }` — the
|
|
@@ -107,12 +109,29 @@ one `[dependent-lifecycle-unclassified]` warning. Declare one of four on the edg
|
|
|
107
109
|
Mind `maxDepth` where edges meet: a deeper budget carries a child's own DELETE cascade
|
|
108
110
|
further down, and can hard-delete rows another edge of the same parent retains.
|
|
109
111
|
|
|
110
|
-
### Step 3:
|
|
112
|
+
### Step 3: Show the reference on the holder's pages
|
|
113
|
+
|
|
114
|
+
A relationship that only reaches the form is invisible to the person reading a record: a job
|
|
115
|
+
page that does not say whose job it is. In the FK holder's
|
|
116
|
+
`frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx`:
|
|
117
|
+
|
|
118
|
+
- `edit()` — a `<FormField name="<fkField>" />`, so the reference can be chosen.
|
|
119
|
+
- `display()` — a `<DisplayField name="<fkField>" />`, so the read page names the related record.
|
|
120
|
+
- `summary()` — the same, when the related record is part of how a row is recognised (a job's
|
|
121
|
+
customer, an invoice's job).
|
|
122
|
+
- How it renders — `.foreignKeyUI({ display: { mode } })` on the schema field (`LABEL`, or
|
|
123
|
+
`SUMMARY` for a card); see `resource-ui-behavior` → `references/framework-foreign-key-ui-api.md`.
|
|
124
|
+
- If the UI task left an interim row label waiting for this relationship (a date, an id), replace
|
|
125
|
+
it now with the related record's label (`forwardedLabel`, `resource-config-wiring`).
|
|
126
|
+
|
|
127
|
+
Leave a reference off a read surface only on purpose, and say why in a comment beside the layout.
|
|
128
|
+
|
|
129
|
+
### Step 4: Specifications
|
|
111
130
|
|
|
112
131
|
Update specs for both resources (`spec-resource-update`) so the
|
|
113
132
|
companion sees the relationship.
|
|
114
133
|
|
|
115
|
-
### Step
|
|
134
|
+
### Step 5: Verify
|
|
116
135
|
|
|
117
136
|
`references/cross-resource-fk-checklist.md` — runs the full
|
|
118
137
|
schema/config/spec parity check.
|
|
@@ -526,11 +545,13 @@ read it back after the build settles, not mid-edit.
|
|
|
526
545
|
rg -c "allowCycle: true" ./shared-lib/src/modules/**/*.relationships.ts
|
|
527
546
|
|
|
528
547
|
# an allowCycle edge with no explicit foreignKeyField — two edges between one pair of types are
|
|
529
|
-
# told apart ONLY by their columns, so an implicit one is ambiguous (must return empty)
|
|
530
|
-
|
|
548
|
+
# told apart ONLY by their columns, so an implicit one is ambiguous (must return empty). One
|
|
549
|
+
# match is one createResourcesRelationship(...) call holding allowCycle and no foreignKeyField,
|
|
550
|
+
# wherever in the call either appears.
|
|
551
|
+
rg -U -P -l 'createResourcesRelationship\((?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*?allowCycle: true(?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*(?=createResourcesRelationship\(|\z)' ./shared-lib/src/modules --glob '*.relationships.ts'
|
|
531
552
|
|
|
532
|
-
# a lateral reference to a non-tenant-scoped target that does NOT confine itself
|
|
533
|
-
rg -
|
|
553
|
+
# a lateral reference to a non-tenant-scoped target that does NOT confine itself (must return empty)
|
|
554
|
+
rg -U -P -l "createResourcesRelationship\((?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*?foreignKeyField: '(?:assignedTo|sharedWith|reviewer|owner)\w*'(?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*(?=createResourcesRelationship\(|\z)" ./shared-lib/src/modules --glob '*.relationships.ts'
|
|
534
555
|
|
|
535
556
|
# a per-variant policy naming a foreign key no relationship confines is INERT
|
|
536
557
|
rg -A 4 "referenceConstraints" ./shared-lib/src/modules/**/*.resources-config.ts
|
|
@@ -545,8 +566,14 @@ Run from the app root:
|
|
|
545
566
|
| `foreignKeyField` literal always paired with explicit declaration | `rg -n "foreignKeyField:" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
|
|
546
567
|
| Discriminators use typed field references (no string field names) | `rg -n "discriminatorField:\s+'[a-z]" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` (must return empty) |
|
|
547
568
|
| `nature` is declared on every relationship | `rg -n "nature:\s+RelationshipNature\." shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
|
|
548
|
-
| Composition relationships with `onParentDelete` declare `maxDepth` |
|
|
569
|
+
| Composition relationships with `onParentDelete` declare `maxDepth` | see the commands below the table |
|
|
549
570
|
| Every `COMPOSITION` edge declares its parent-delete lifecycle | `rg -c "^[^/*]*nature: RelationshipNature\.COMPOSITION" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` equals `rg -c "^[^/*]*onParentDelete: \{" …` on the same file (the `^[^/*]*` prefix skips comment lines, which quote declarations when explaining them) |
|
|
571
|
+
| The holder shows the reference on its read page | `rg -c 'DisplayField name="<fkField>"' frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` is at least 1, or a comment beside the layout says why it is left off |
|
|
572
|
+
|
|
573
|
+
```bash
|
|
574
|
+
# Composition relationships with `onParentDelete` declare `maxDepth`
|
|
575
|
+
rg -nB 1 "onParentDelete" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts | rg "maxDepth"
|
|
576
|
+
```
|
|
550
577
|
|
|
551
578
|
The third invariant (typed discriminator) is the high-signal one —
|
|
552
579
|
string field names bypass typecheck and break silently when fields
|
|
@@ -561,6 +588,7 @@ are renamed.
|
|
|
561
588
|
| "I'll model self-referencing M:N as direct peers" | The framework fail-closes peer M:N expansion. Use an explicit junction resource (TODOS_RELATIONSHIPS pattern) so source/target identity stays unambiguous. |
|
|
562
589
|
| "Conditional logic belongs in app code" | The `discriminator` mechanism is the framework's first-class conditional. Authoring it in app code bypasses the spec layer and breaks introspection. |
|
|
563
590
|
| "A COMPOSITION edge cascades by default" | It does not: `onParentDelete.enabled` defaults to `false`. Declaring COMPOSITION says who owns the rows; only `onParentDelete` says what happens to them, and a tenant purge relies on it for every owned resource. |
|
|
591
|
+
| "The UI task already did the ui-behavior" | It ran before this relationship existed, so the foreign key was not there to show. Adding it to the read page is this task's work (Step 3). |
|
|
564
592
|
| "Cascade is fine without `maxDepth`" | `maxDepth` bounds the cascade. Without it, a deep tree can produce expensive deletes (or wedge the framework on cyclic graphs). |
|
|
565
593
|
| "The cycle report is wrong — my two columns are different, no row can loop" | Both halves are true and the refusal still stands. The detector is type-level because the traversals it protects are type-level. Declare `allowCycle` on every edge and say in a comment why the loop is unreachable at row level. |
|
|
566
594
|
| "I'll set `allowCycle` on the new edge only" | The check is all-or-nothing: the error names each edge still missing the flag, including ones you did not write. |
|
|
@@ -576,6 +604,7 @@ are renamed.
|
|
|
576
604
|
- `onParentDelete: { enabled: true }` without `maxDepth` (catch with the **Composition relationships with `onParentDelete` declare `maxDepth`** grep).
|
|
577
605
|
- A `COMPOSITION` edge with no `onParentDelete` at all (catch with the **Every `COMPOSITION` edge declares its parent-delete lifecycle** counts, and with the boot line `[dependent-lifecycle-unclassified]`).
|
|
578
606
|
- An odd number of `allowCycle: true` edges, or one with no explicit `foreignKeyField` (catch with the two **allowCycle** greps above — a cycle needs the flag on every edge, and the edges are told apart only by their columns).
|
|
607
|
+
- A foreign key that appears in the holder's `edit()` and not in its `display()`: the read page never says which record it belongs to (catch with the **holder shows the reference on its read page** grep).
|
|
579
608
|
- A second edge to a parent type declared `COMPOSITION` or `REQUIRES_CONTEXT` when it is only an actor reference (catch by reading both edges together — the resource's scope must come from exactly one of them).
|
|
580
609
|
|
|
581
610
|
## Related Skills
|
|
@@ -107,8 +107,10 @@ Rules:
|
|
|
107
107
|
|
|
108
108
|
### Step 3: Bind at backend startup
|
|
109
109
|
|
|
110
|
-
Add the module binding with `definePdfTemplateBindings(...)` and
|
|
111
|
-
through the
|
|
110
|
+
Add the module binding with `definePdfTemplateBindings(...)` and contribute it
|
|
111
|
+
through the module's `pdfTemplateBindings` slot on its `BackendDomainModule`
|
|
112
|
+
(`backend-api/src/modules/<slug>/index.ts`), which the backend domain-module
|
|
113
|
+
assembly merges.
|
|
112
114
|
|
|
113
115
|
The binding is keyed by resource type and field name. The shared schema
|
|
114
116
|
stores only a stable `templateId`; the binding stores the live imported
|
|
@@ -178,11 +178,22 @@ export const GOOGLE_PLACES_ADDRESS_LOOKUP_ADAPTER: ProviderAddressLookupAdapter
|
|
|
178
178
|
|
|
179
179
|
| Invariant | Command |
|
|
180
180
|
|---|---|
|
|
181
|
-
| Both operations opened |
|
|
182
|
-
| No Google key in the frontend |
|
|
183
|
-
| No direct vendor call |
|
|
181
|
+
| Both operations opened | see the commands below the table (both present) |
|
|
182
|
+
| No Google key in the frontend | see the commands below the table (must be empty) |
|
|
183
|
+
| No direct vendor call | see the commands below the table (must be empty) |
|
|
184
184
|
| No stored place id | `rg -in "placeId" shared-lib/src` (must be empty) |
|
|
185
185
|
|
|
186
|
+
```bash
|
|
187
|
+
# Both operations opened
|
|
188
|
+
rg -n "address_suggest|address_retrieve" wildo.saas.config.ts
|
|
189
|
+
|
|
190
|
+
# No Google key in the frontend
|
|
191
|
+
rg -n "AIza|GOOGLE_PLACES_API_KEY" frontend/src
|
|
192
|
+
|
|
193
|
+
# No direct vendor call
|
|
194
|
+
rg -n "places.googleapis.com|maps.googleapis.com" frontend/src
|
|
195
|
+
```
|
|
196
|
+
|
|
186
197
|
## Common Rationalizations
|
|
187
198
|
|
|
188
199
|
| Rationalization | Reality |
|
|
@@ -338,9 +338,14 @@ Run from the app root, substituting `<ref>`:
|
|
|
338
338
|
| No hand-written `frontendEntry` literal | `rg -n "frontendEntry: \{" frontend/src/provider-contributions.ts` (must be empty) |
|
|
339
339
|
| Scope entry present | `rg -n "<ref>" wildo.saas.config.ts` |
|
|
340
340
|
| Consent purposes use the vocabulary, not strings | `rg -n "consentPurposes: \['" frontend/src/engine/providers/` (must be empty) |
|
|
341
|
-
| No secret-looking key in publicConfig |
|
|
341
|
+
| No secret-looking key in publicConfig | see the commands below the table (must be empty) |
|
|
342
342
|
| Module declares its public-config keys | `rg -n "publicConfigSchema: defineFrontendPublicConfigSchema" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
|
|
343
343
|
|
|
344
|
+
```bash
|
|
345
|
+
# No secret-looking key in publicConfig
|
|
346
|
+
rg -in "secret|apikey|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts
|
|
347
|
+
```
|
|
348
|
+
|
|
344
349
|
## Common Rationalizations
|
|
345
350
|
|
|
346
351
|
| Rationalization | Reality |
|
|
@@ -208,12 +208,23 @@ export async function listMyAsanaProjects(
|
|
|
208
208
|
|
|
209
209
|
| Invariant | Command |
|
|
210
210
|
|---|---|
|
|
211
|
-
| Clients are built from `forExecution` |
|
|
212
|
-
| No credential handled in application code |
|
|
211
|
+
| Clients are built from `forExecution` | see the commands below the table (review each hit) |
|
|
212
|
+
| No credential handled in application code | see the commands below the table (must be empty) |
|
|
213
213
|
| Browser calls name declared operations | `rg -n "executeProviderOperation" frontend/src` then check each against `rg -n "browserOperations" wildo.saas.config.ts` |
|
|
214
214
|
| No component calls a vendor directly | `rg -n "fetch\(['\"]https://" frontend/src` (must be empty) |
|
|
215
215
|
| A scope refusal grows the connection | `rg -n "SCOPE_NOT_GRANTED" frontend/src` then check each handler passes `addScopes` to `startProviderConnection` |
|
|
216
|
-
| No hand-rolled vendor throttle |
|
|
216
|
+
| No hand-rolled vendor throttle | see the commands below the table (review each hit near a provider call) |
|
|
217
|
+
|
|
218
|
+
```bash
|
|
219
|
+
# Clients are built from `forExecution`
|
|
220
|
+
rg -n "Client\(" backend-api/src | rg -v forExecution
|
|
221
|
+
|
|
222
|
+
# No credential handled in application code
|
|
223
|
+
rg -in "accessToken|apiKey|botToken" backend-api/src frontend/src
|
|
224
|
+
|
|
225
|
+
# No hand-rolled vendor throttle
|
|
226
|
+
rg -n "setTimeout|sleep|RATE_BUDGET" backend-api/src
|
|
227
|
+
```
|
|
217
228
|
|
|
218
229
|
## Common Rationalizations
|
|
219
230
|
|
|
@@ -651,8 +651,16 @@ Run from the app root, substituting `<slug>` and `<resource>`:
|
|
|
651
651
|
| `rateLimit?` declared on variant builder | `rg -n "rateLimit:\s*\{" shared-lib/src/modules/<slug>/resources/<resource>/` |
|
|
652
652
|
| `checkPolicy` invoked from controller | `rg -n "rateLimitService\.checkPolicy\(" backend-api/src/modules/<slug>/controllers/` |
|
|
653
653
|
| **No `req.ip` direct reference** (must be empty in custom controllers; use `getClientIpFromRequest`) | `rg -n "\\breq\\.ip\\b" backend-api/src/modules/<slug>/controllers/` |
|
|
654
|
-
| **No `if (ipAddress)` guard** around per-IP `checkPolicy` (must be empty outside K-3 sites) |
|
|
655
|
-
| F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets |
|
|
654
|
+
| **No `if (ipAddress)` guard** around per-IP `checkPolicy` (must be empty outside K-3 sites) | see the commands below the table |
|
|
655
|
+
| F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets | see the commands below the table |
|
|
656
|
+
|
|
657
|
+
```bash
|
|
658
|
+
# No `if (ipAddress)` guard around per-IP `checkPolicy` (must be empty outside K-3 sites)
|
|
659
|
+
rg -nB1 "checkPolicy\\([^)]*\\.by-ip" backend-api/src/modules/<slug>/controllers/ | rg "if \\(ipAddress\\)"
|
|
660
|
+
|
|
661
|
+
# F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets
|
|
662
|
+
rg -n "checkPolicy\\(" backend-api/src/modules/<slug>/controllers/<file>.controller.ts | rg ":by-"
|
|
663
|
+
```
|
|
656
664
|
|
|
657
665
|
The high-signal invariant is **"no `req.ip` direct reference"**
|
|
658
666
|
combined with **"no `if (ipAddress)` guard around per-IP
|
|
@@ -243,8 +243,16 @@ substitute the new field name (`<field>`) and resource path:
|
|
|
243
243
|
| FK field has corresponding `isForeignKey()` decorator | `rg -n "<field>.*isForeignKey\(\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
244
244
|
| FK field has a registered relationship edge (the decorator marks, it does not resolve) | `rg -n "foreignKeyField: '<field>'" shared-lib/src/modules/*/resources/*.relationships.ts` |
|
|
245
245
|
| Enum declared by the schema is re-exported from the module barrel (declaring is not publishing) | `rg -n "<EnumName>" shared-lib/src/modules/*/resources/index.ts` |
|
|
246
|
-
| Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable |
|
|
247
|
-
| Label keys exist in the primary locale |
|
|
246
|
+
| Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable | see the commands below the table |
|
|
247
|
+
| Label keys exist in the primary locale | see the commands below the table |
|
|
248
|
+
|
|
249
|
+
```bash
|
|
250
|
+
# Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable
|
|
251
|
+
rg -n "<field>" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts | rg "exclude(From|FromCreate|FromUpdate)"
|
|
252
|
+
|
|
253
|
+
# Label keys exist in the primary locale
|
|
254
|
+
rg -n "\"<resource>\.<field>\.(label|<enumValue>)\"" frontend/src/i18n
|
|
255
|
+
```
|
|
248
256
|
|
|
249
257
|
If a user-facing field passes none of the UI / spec / label greps, the
|
|
250
258
|
work stopped after the schema and the task is **not done**.
|
package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md
CHANGED
|
@@ -405,6 +405,8 @@ export enum CollectionFilterPanelVisibility {
|
|
|
405
405
|
HIDDEN = 'hidden',
|
|
406
406
|
}
|
|
407
407
|
|
|
408
|
+
/**
|
|
409
|
+
*/
|
|
408
410
|
/**
|
|
409
411
|
* A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
|
|
410
412
|
*
|
|
@@ -417,39 +419,63 @@ export enum CollectionFilterPanelVisibility {
|
|
|
417
419
|
* Resolution is in the VIEWER's timezone, which is the only one that makes "today" true for the
|
|
418
420
|
* person reading the screen. The backend compares instants, so the boundaries travel as absolute
|
|
419
421
|
* times and nothing downstream has to know a timezone was involved.
|
|
422
|
+
*
|
|
423
|
+
* Every window is whole local days and ends at the LAST instant of its last day, one millisecond before the next local
|
|
424
|
+
* midnight. The date-range filter's end bound is inclusive, and a date-only value (a due date picked in a calendar) is
|
|
425
|
+
* stored at the local midnight of the day it names, so ending at the next midnight would also match the day after.
|
|
420
426
|
*/
|
|
421
427
|
export enum CollectionFilterPresetRelativeRange {
|
|
422
|
-
/**
|
|
428
|
+
/** All of today, local: midnight this morning to the end of the day. */
|
|
423
429
|
TODAY = 'today',
|
|
424
|
-
/**
|
|
430
|
+
/** All of yesterday, local. */
|
|
425
431
|
YESTERDAY = 'yesterday',
|
|
426
432
|
/** The last seven days INCLUDING today — the rolling week, not the last seven whole days. */
|
|
427
433
|
LAST_7_DAYS = 'last_7_days',
|
|
428
434
|
/** The last thirty days including today. */
|
|
429
435
|
LAST_30_DAYS = 'last_30_days',
|
|
430
|
-
/** The first of this calendar month
|
|
436
|
+
/** The first of this calendar month through the end of today. */
|
|
431
437
|
THIS_MONTH = 'this_month',
|
|
432
|
-
/** The first of this calendar year
|
|
438
|
+
/** The first of this calendar year through the end of today. */
|
|
433
439
|
THIS_YEAR = 'this_year',
|
|
440
|
+
/**
|
|
441
|
+
* Everything BEFORE today, local: what an "overdue" list shows on a due-date field. Ends at the last instant of
|
|
442
|
+
* yesterday, so a date-only value due TODAY is due, not overdue. A deadline with a time earlier today is in TODAY, not
|
|
443
|
+
* here: the window is whole days, like every other member, so the pill reads the same all day.
|
|
444
|
+
*/
|
|
445
|
+
BEFORE_TODAY = 'before_today',
|
|
446
|
+
/** Today and the six days after it, local: "due this week" from today. */
|
|
447
|
+
NEXT_7_DAYS = 'next_7_days',
|
|
448
|
+
/** Today and the twenty-nine days after it, local. */
|
|
449
|
+
NEXT_30_DAYS = 'next_30_days',
|
|
434
450
|
}
|
|
435
451
|
|
|
436
452
|
/**
|
|
437
|
-
*
|
|
453
|
+
* A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
|
|
454
|
+
* viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
|
|
455
|
+
* reading the list, whoever that is.
|
|
438
456
|
*
|
|
439
|
-
*
|
|
440
|
-
*
|
|
441
|
-
|
|
442
|
-
|
|
457
|
+
* A preset naming one is unavailable to a viewer the value cannot be resolved for (no signed-in user): the pill is
|
|
458
|
+
* disabled rather than applied without the field, which would show a different list under the same name.
|
|
459
|
+
*/
|
|
460
|
+
export enum CollectionFilterPresetContextValue {
|
|
461
|
+
/** The signed-in user's id, for a reference field such as an assignee or owner. */
|
|
462
|
+
CURRENT_USER = 'current_user',
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
/**
|
|
466
|
+
* What a preset ASSIGNS to one filter field.
|
|
443
467
|
*
|
|
444
|
-
*
|
|
445
|
-
* mean anything: the framework's collection filters carried a date range and scalars and no numeric
|
|
446
|
-
* range, so a preset could have declared "cost below 500" and nothing between here and the database
|
|
447
|
-
* would have honoured it. It is expressible now because `Resources_Filter_NumberRangeSchema`, the
|
|
448
|
-
* controller's fail-closed value guard and the cross-adapter normalizer all learned the `{ min, max }`
|
|
449
|
-
* vocabulary — a preset assigning one is writing the same value the filter panel's own two inputs do.
|
|
468
|
+
* Four kinds, split by WHEN the value is known:
|
|
450
469
|
*
|
|
451
|
-
*
|
|
452
|
-
*
|
|
470
|
+
* - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
|
|
471
|
+
* which is the whole of "filter to HIGH priority";
|
|
472
|
+
* - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
|
|
473
|
+
* answer would be wrong by tomorrow;
|
|
474
|
+
* - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
|
|
475
|
+
* backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
|
|
476
|
+
* commonest threshold anyone asks for;
|
|
477
|
+
* - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
|
|
478
|
+
* when the pill is clicked, so the same authored preset shows each viewer their own rows.
|
|
453
479
|
*/
|
|
454
480
|
export const CollectionFilterPresetValueSchema = z.union([
|
|
455
481
|
z.string(),
|
|
@@ -457,6 +483,7 @@ export const CollectionFilterPresetValueSchema = z.union([
|
|
|
457
483
|
z.boolean(),
|
|
458
484
|
z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
|
|
459
485
|
z.object({ min: z.number().optional(), max: z.number().optional() }),
|
|
486
|
+
z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
|
|
460
487
|
]);
|
|
461
488
|
export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
|
|
462
489
|
|
|
@@ -1020,6 +1047,8 @@ export const ResourceOperationFrontendConfigSchema = z.object({
|
|
|
1020
1047
|
* presetFilters: [
|
|
1021
1048
|
* { ref: 'urgent', filters: { priority: 'high' } },
|
|
1022
1049
|
* { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
|
|
1050
|
+
* { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
|
|
1051
|
+
* { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
|
|
1023
1052
|
* ]
|
|
1024
1053
|
*/
|
|
1025
1054
|
presetFilters: z.array(CollectionFilterPresetSchema).optional(),
|