@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
package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Derived artifacts and their currency
|
|
2
|
+
|
|
3
|
+
Read this when:
|
|
4
|
+
|
|
5
|
+
- a dev server, the backend, a worker, a minion or the dev companion refuses to start and its error
|
|
6
|
+
names a generated file, or tells you to "regenerate" or to run `wildo config sync`;
|
|
7
|
+
- something behaves as if an earlier version of your configuration were still in force;
|
|
8
|
+
- you just ran `wildo update`, or changed `providers` / `services` in `wildo.saas.config.ts`;
|
|
9
|
+
- you need to know whether a file under `.wildo-saas/` or a `src/generated/` folder is safe to
|
|
10
|
+
delete, safe to edit (never), or must be committed.
|
|
11
|
+
|
|
12
|
+
### Derived artifacts: where they live, how to tell they are current, what regenerates them
|
|
13
|
+
|
|
14
|
+
Much of what your application runs is **derived**: written by a `wildo` command or a dev watcher from
|
|
15
|
+
something you authored. A derived file never fails at the moment it goes stale. It fails later, far
|
|
16
|
+
from its cause, when a process that reads it refuses it — and by then the error reads like a bug in
|
|
17
|
+
your code or in the framework. It almost never is.
|
|
18
|
+
|
|
19
|
+
Four facts govern every row below:
|
|
20
|
+
|
|
21
|
+
- **A derived file is never edited by hand.** Fix the authored source, then regenerate. A hand edit is
|
|
22
|
+
overwritten by the next regeneration and leaves no trace of why it reverted.
|
|
23
|
+
- **Most derived files are regenerated by a COMMAND, not by a watcher.** `wildo local dev` rebuilds
|
|
24
|
+
your packages as you edit them, and when it STARTS it regenerates the provider runtime artifacts if a
|
|
25
|
+
generated module is missing or a reader would refuse one of the JSON artifacts — but it never refreshes the CSP file, the labels or the docs,
|
|
26
|
+
and it does not watch the provider artifacts once running. A framework update can change what a
|
|
27
|
+
reader requires of those files while their inputs stay the same, so they go stale without anything
|
|
28
|
+
you did.
|
|
29
|
+
- **When a reader refuses a derived file, its message names the command that regenerates it.** That
|
|
30
|
+
is the fix. Run it; do not "repair" the reader, the provider, or the authored config to make the
|
|
31
|
+
refusal go away.
|
|
32
|
+
- **Regenerating is safe.** `wildo config sync` never rotates a secret unless you pass
|
|
33
|
+
`--rotate-secrets`; it only adds framework-managed secrets that are missing. Apart from that, the
|
|
34
|
+
one authored file it can change is a backend `package.json` (and the root `pnpm.overrides`), when
|
|
35
|
+
`systemsOfRecord` is declared and the library it needs is not: run `pnpm install` after that.
|
|
36
|
+
Regenerating a current file changes nothing.
|
|
37
|
+
|
|
38
|
+
#### When a running process refuses a generated file
|
|
39
|
+
|
|
40
|
+
1. **Read the refusal for a command.** The messages in the table below each name one.
|
|
41
|
+
2. **Date the artifact.** Provider runtime artifacts carry a `generatedAt` field; for anything else use
|
|
42
|
+
the file's modification time. Older than the last change to your `@wildo-ai/*` versions
|
|
43
|
+
(`pnpm-lock.yaml`), to `wildo.saas.config.ts`, or to `wildo.infra.<env>.config.ts`? It is stale.
|
|
44
|
+
3. **Run the command it names**, from the application root. For the provider runtime artifacts that
|
|
45
|
+
is `wildo -y config sync --local` (add `--env <env>` for one environment). `-y` keeps it from
|
|
46
|
+
stopping at the env-file prompt: it then leaves existing `.env` files alone, which is what you want
|
|
47
|
+
here, and still writes every provider runtime artifact.
|
|
48
|
+
4. **Let the refused process restart.** Under `wildo local dev` each process is supervised and
|
|
49
|
+
restarts on its own within seconds; otherwise restart that one process. Do not restart the stack.
|
|
50
|
+
5. **Confirm**: the process logs that it started, and the artifact's `generatedAt` is now.
|
|
51
|
+
|
|
52
|
+
| The refusal says (abbreviated) | Stale artifact | Regenerate with |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| `refused to serve frontend provider configuration it was handed … declares no publicConfigSchema whose keys can be read … generated before this check existed` | the frontend provider bootstrap: `.wildo-saas/generated/providers/frontend-services.runtime-providers.generated.json` when a website or docs build refuses, `backend-api/src/generated/wildo-provider-runtime.generated.ts` when the backend's `/application-config` refuses | `wildo -y config sync --local` |
|
|
55
|
+
| `generated provider runtime artifact at … does not satisfy the current contract` | a `.wildo-saas/generated/providers/*.runtime-providers.generated.json` file | `wildo -y config sync --local` |
|
|
56
|
+
| `generated before the contract changed. Regenerate it … and restart` · `The artifact is stale for this package` | `backend-api/src/generated/wildo-provider-runtime.generated.ts` | `wildo -y config sync --local` |
|
|
57
|
+
| `runtime artifact lists no facet modules` | the same module, generated before systems of record existed | `wildo -y config sync --local --domain env-files` |
|
|
58
|
+
| `Missing generated provider runtime module` (printed by your backend's own `src/index.ts`) | the same module, absent | `wildo -y config sync --local` |
|
|
59
|
+
| `Missing or invalid companion provider runtime artifact` | `.wildo-saas/generated/providers/companion.runtime-providers.generated.json` | `wildo -y config sync --local` |
|
|
60
|
+
| `detected stale provider topology` · `does not contain a scope for worker/minion` | a minion's or worker's `.wildo-providers.env` or generated module | `wildo -y config sync --local` |
|
|
61
|
+
| browser console: `bundle carries no code for it … regenerate frontend-providers.generated.ts` (a provider silently missing) | `<frontend service>/src/generated/frontend-providers.generated.ts` | `wildo -y config sync --local`, then commit it |
|
|
62
|
+
| `Lockfile drift detected` | `.wildo-saas/wildo-saas.lock.json` | `wildo -y config sync --local`, then commit it |
|
|
63
|
+
| `postgresql_table_schema_mismatch` | the database schema behind your resources | `wildo db generate --name <label>` (see the database-migrations skill) |
|
|
64
|
+
| `Run wildo dev sync-csp and commit the result` | `<frontend service>/src/generated/csp.generated.json` | `wildo dev sync-csp` |
|
|
65
|
+
| `Run wildo config <data-retention · service-consent · subject-data-recipients · document-releases> and commit` | the matching `backend-api/src/*.generated.ts` compliance module | the command it names |
|
|
66
|
+
| `No generated config … Run wildo config sync --domain config` | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json` | `wildo config sync --local --domain config` |
|
|
67
|
+
|
|
68
|
+
#### Every derived artifact, and how to check it
|
|
69
|
+
|
|
70
|
+
| Artifact | Lives at | Regenerated by | How to tell it is current | In git? |
|
|
71
|
+
|---|---|---|---|---|
|
|
72
|
+
| Provider runtime artifacts | `.wildo-saas/generated/providers/*.runtime-providers.generated.json`; `backend-api/src/generated/wildo-provider-runtime.generated.ts` and the same file in each minion and Node worker; `minions/*/.wildo-providers.env`, `workers/*/.wildo-providers.env` | `wildo -y config sync --local` (no prompt); `wildo local dev` regenerates a missing or refused one when it starts | `wildo local doctor` — the **generated provider-runtime artifact content** line checks the frontend-services, backend and companion JSON files with what their readers apply, and names every one a reader would refuse. It does not read the minion and worker JSON files, the `.ts` modules or the `.wildo-providers.env` files | No — always safe to regenerate |
|
|
73
|
+
| Frontend provider modules | `<frontend service>/src/generated/frontend-providers.generated.ts`, `frontend-provider-service.generated.json` | `wildo -y config sync --local` | Nothing. A stale one drops a provider with a browser-console warning instead of failing | Yes — commit after regenerating |
|
|
74
|
+
| Provider catalogue types | `.wildo-saas/generated/provider-catalog.types.ts` | `wildo -y config sync --local` | Nothing; stale only means stale autocomplete | Yes |
|
|
75
|
+
| Application lockfile | `.wildo-saas/wildo-saas.lock.json` | `wildo -y config sync --local` (providers, infra); module and label commands write their own sections | `wildo lock check` — checks the providers and infra sections only | Yes |
|
|
76
|
+
| Content security policy | `<frontend service>/src/generated/csp.generated.json` | `wildo dev sync-csp` (also `wildo dev start`) — **not** `wildo config sync` | `wildo dev sync-csp --check` (it refreshes the provider artifacts before comparing) | Yes |
|
|
77
|
+
| Environment config and local stack | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `…/docker-compose/docker-compose.wildo-platform.yml`, `…/docker-compose/.env.wildo-platform` | `wildo -y config sync --local`. `wildo local up` only recreates a MISSING one, never a stale one | `wildo config validate --domain config` checks coherence with your secrets, not currency | No |
|
|
78
|
+
| Per-package `.env` files | `backend-api/.env`, `frontend/.env`, `website/.env`, `technical-doc/.env`, each minion and worker, `.wildo-saas/wildo-dev-companion/.env` | `wildo -y config sync --local --domain env-files` — needs the local platform running (when it is down this phase fails, but the provider artifacts are still written). It asks before overwriting; `-y` SKIPS existing files, `--force` rewrites them | Nothing | No |
|
|
79
|
+
| Application identity | `.wildo-saas/infrastructure/environments/<env>/generated/config/application-runtime-identity.json` | **Not derived** — assigned when the application registered (`wildo local init`) | — | No, and **do not delete it**: only re-registration restores it |
|
|
80
|
+
| Compliance modules | `backend-api/src/{data-retention,service-consent-requirement,subject-data-recipients,governed-document-releases}.generated.ts` | `wildo config data-retention` · `service-consent` · `subject-data-recipients` · `document-releases` | The same command with `--check`, or `wildo config validate --domain <same name>` | Yes |
|
|
81
|
+
| Database migrations | `backend-api/migrations/`, `backend-api/migrations/schema-plan.lock.json` | `wildo db generate --name <label>` | `wildo db diff --check`. It refuses to answer while `backend-api/dist` is older than its sources — let the build catch up first | Yes — **never delete** |
|
|
82
|
+
| Labels and translations | `backend-api/src/engine/i18n/**` | `wildo generate labels`, then `wildo generate translate` (the dev companion must be running) | No command reports it; the lockfile records each unit's status | Yes |
|
|
83
|
+
| Technical documentation | `technical-doc/src/generated/api-reference/**`, `technical-doc/src/generated/consumer-documentation/**` | `wildo docs publish` (the dev companion must be running) | Nothing short of republishing and reading the diff | Yes |
|
|
84
|
+
| Package builds | each package's `dist/` | the dev watchers `wildo local dev` starts | Nothing direct; `wildo db diff` refuses on a stale `backend-api/dist` | No |
|
|
85
|
+
| Config loader cache | `.wildo-saas/dist/config-loader/` | rebuilt on demand | Nothing; delete it when `wildo.saas.config.ts` edits seem ignored | No — always safe to delete |
|
|
86
|
+
| Delivered framework | `.claude/skills/` and the rules delivered beside them under `.claude/`, `.wildo-saas/templates/`, `.wildo-saas/wildo-dev-companion/` | `wildo assets sync` (`wildo update` runs it) | Nothing records which release delivered them; re-run `wildo assets sync` when in doubt | Skills and rules yes; templates and the companion build no |
|
|
87
|
+
|
|
88
|
+
Files your application-creation runs produced — brand assets, personas, charters, specifications —
|
|
89
|
+
are **committed decisions**, not caches. They are never regenerated to fix a refusal.
|
|
90
|
+
|
|
91
|
+
#### What `wildo local doctor` can and cannot tell you
|
|
92
|
+
|
|
93
|
+
- It **fails** when a generated provider runtime module is missing, and names `wildo config sync`.
|
|
94
|
+
- It **fails** when a present provider runtime artifact would be refused by the process that reads
|
|
95
|
+
it (*generated provider-runtime artifact content*), with the reason that reader gives — for the
|
|
96
|
+
frontend-services and backend files, the reader's own refusal message. It applies what the readers
|
|
97
|
+
apply rather than comparing dates, so it catches a file a framework update made stale while every
|
|
98
|
+
input stayed the same. It covers the frontend-services, backend and companion JSON files only.
|
|
99
|
+
- It does not check the other derived artifacts in the table above; use the command in their row.
|
|
100
|
+
- Its **derived-artifact currency** line reads `not probed` in an application installed from
|
|
101
|
+
published packages. That is not a pass: it compares builds against a framework source checkout,
|
|
102
|
+
which your application does not have.
|
|
103
|
+
|
|
104
|
+
#### Regenerate before you debug, after any of these
|
|
105
|
+
|
|
106
|
+
- **A framework update.** `wildo update` ends by regenerating the provider runtime artifacts and the
|
|
107
|
+
CSP files (`wildo dev sync-csp`, for the active environment), after declaring and installing the
|
|
108
|
+
systems-of-record library when `systemsOfRecord` needs it. If the release you moved to predates that
|
|
109
|
+
step, run `wildo -y config sync --local` yourself. If the step fails, its message says why:
|
|
110
|
+
- `Config file not found: …/wildo.infra.<env>.config.ts` — only the CSP half failed: the provider
|
|
111
|
+
runtime artifacts were already regenerated. The active environment has no authored infra config;
|
|
112
|
+
set it up with `wildo setup` (or select an environment that has one), then run `wildo dev sync-csp`.
|
|
113
|
+
- `Cannot produce the frontend provider configuration … its secrets … cannot be read` — nothing was
|
|
114
|
+
produced, and `config sync` stops on the same check. Restore that environment's `secrets.json`:
|
|
115
|
+
the provider configuration is screened against it and is never produced without it.
|
|
116
|
+
- **A change to `providers` or `services` in `wildo.saas.config.ts`**, or adding a frontend service:
|
|
117
|
+
`wildo -y config sync --local`, then `wildo dev sync-csp`.
|
|
118
|
+
- **A change to `wildo.infra.<env>.config.ts`**: `wildo -y config sync --local`, then
|
|
119
|
+
`wildo config sync --local --domain manifest`.
|
|
120
|
+
|
|
121
|
+
Commit the tracked files a regeneration changed in their own commit, so the next reader can tell a
|
|
122
|
+
regeneration from an authored change.
|
|
@@ -21,6 +21,17 @@ It moves the two homes of a release, in this order:
|
|
|
21
21
|
It restarts nothing. Afterwards `wildo local up` puts the platform on the release's image, and
|
|
22
22
|
restarting `wildo local dev` runs the application and its companion on the new packages.
|
|
23
23
|
|
|
24
|
+
Its last step is `wildo dev sync-csp`, which regenerates the provider runtime artifacts and the CSP
|
|
25
|
+
files built from them for the active environment. Just before it, an application whose `systemsOfRecord`
|
|
26
|
+
needs the systems-of-record library gets that dependency declared on its backend manifests and
|
|
27
|
+
installed, so the regeneration never meets an uninstalled package. A release can change what the backend, the website or the companion requires
|
|
28
|
+
of those files without any input changing, and a file the previous release wrote is then refused at
|
|
29
|
+
start-up (`…generated before this check existed — regenerate it with wildo config sync`). If the
|
|
30
|
+
release you moved to predates that step, run `wildo -y config sync --local` before restarting
|
|
31
|
+
`wildo local dev`. If the step reports a failure, read its message first: a missing infra config fails only
|
|
32
|
+
the CSP half (the provider artifacts were regenerated), while an unreadable `secrets.json` stops the
|
|
33
|
+
provider artifacts and `config sync` alike. `derived-artifact-currency.md` gives the fix for each.
|
|
34
|
+
|
|
24
35
|
## When the release asks for something this application does not declare
|
|
25
36
|
|
|
26
37
|
A release can make a declaration REQUIRED that older applications do not have. `wildo update` then
|
package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md
CHANGED
|
@@ -361,6 +361,13 @@ timestamps and exactly what to delete, and it does not act. Read it before you
|
|
|
361
361
|
debug logic: a stale artifact answers confidently about a version of the
|
|
362
362
|
application that no longer exists.
|
|
363
363
|
|
|
364
|
+
That sweep compares builds against a framework SOURCE checkout. In an
|
|
365
|
+
application installed from published packages it reports `not probed`, which
|
|
366
|
+
is not a pass. The provider runtime artifacts have their own line, in every
|
|
367
|
+
mode: *generated provider-runtime artifact content* runs their readers' checks
|
|
368
|
+
and names each file they would refuse. See `derived-artifact-currency.md` for
|
|
369
|
+
what each derived artifact can and cannot be checked by.
|
|
370
|
+
|
|
364
371
|
It reports orphaned compiler watchers and never kills them; reaping is
|
|
365
372
|
`wildo dev force-stop`.
|
|
366
373
|
|
|
@@ -478,13 +485,13 @@ their values in logs or documentation.
|
|
|
478
485
|
|---------------------------------------------------------|--------------------------------------------------------------------------------------|
|
|
479
486
|
| `./infrastructure/<env>/wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts` (added/changed a backing service, runtime, `publicDomain`, …) | `wildo -y config sync --local` for config/env outputs; then run `wildo -y config sync --local --domain manifest` separately for the local workload render. An explicit domain filter replaces the defaults. Ordinary non-CI sync reconciles authored state first |
|
|
480
487
|
| `./wildo.saas.config.ts` (modules, engine capabilities, provider scopes) | `wildo -y config sync --local --domain config` then restart the affected runtime process (`wildo dev start` if the app dev script owns it) |
|
|
481
|
-
| Provider API keys (OpenAI, Anthropic, …) — typed in by hand | `wildo secrets set <ENV_VAR_NAME>` (add `--env <env>` for a remote environment): it writes `secrets.json` → `providerEnv`, regenerates the env files and restarts
|
|
488
|
+
| Provider API keys (OpenAI, Anthropic, …) — typed in by hand | `wildo secrets set <ENV_VAR_NAME>` (add `--env <env>` for a remote environment): it writes `secrets.json` → `providerEnv`, regenerates the env files, has a running dev companion load the key in place (no restart, no run interrupted) and restarts the other supervised runtimes that read it; the output says which, and names any runtime you still have to restart yourself (this is the rotation path you DO want) |
|
|
482
489
|
| The authored secrets path (`./infrastructure/<env>/secrets/`) — moved or split | `wildo -y setup` and answer the path question with the new layout |
|
|
483
490
|
| Nothing — just want to bounce the stack | `wildo -y local up --restart` |
|
|
484
491
|
| `./wildo.saas.config.ts` — a service port, a session storage mode, a capability flag, or removing a provider from a scope | `wildo config mutate` (idempotent, dry-runnable, names the segment it cannot resolve) then `wildo -y config sync --local` |
|
|
485
492
|
| Anything at all, and you want to CHECK before writing | `wildo config validate` — writes nothing |
|
|
486
493
|
| The declaration, on an application that is already running | `wildo config reapply-declaration` (leaves credentials, database, infra and the seeded administrator alone) |
|
|
487
|
-
| Nothing — but something is behaving impossibly | `wildo local doctor` FIRST
|
|
494
|
+
| Nothing — but something is behaving impossibly | `wildo local doctor` FIRST, then `derived-artifact-currency.md`: a process refusing a generated file names the command that regenerates it |
|
|
488
495
|
| Nothing — you want a newer framework release | `wildo update` (or `--to <version>`). It moves the CLI, then this application's pins, dependencies, companion, skills and deploy manifests. See `framework-upgrade-and-dependency-alignment.md` |
|
|
489
496
|
| The `@wildo-ai/*` versions in `pnpm.overrides`, by hand | `pnpm install` → `wildo align-deps --write` → `pnpm install` again, then `wildo assets sync`. Prefer `wildo update`, which does all of it and moves the CLI to match |
|
|
490
497
|
| Nothing — the application was just scaffolded and installed for the first time | `wildo align-deps --write` once, then `pnpm install`. Expected, not a defect: scaffolding pins from the framework checkout while pinning the framework to the published release |
|
|
@@ -428,11 +428,19 @@ export const aiAssistantWeeklyDigestBenefit: FeatureBenefitConfig = {
|
|
|
428
428
|
| Invariant | Command |
|
|
429
429
|
|-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
|
|
430
430
|
| Every benefit file uses the typed `FeatureBenefitConfig` | `rg -n ":\s+FeatureBenefitConfig" specifications/src/market/value-proposition/` |
|
|
431
|
-
| Every benefit declares a non-empty `deliveredBy` |
|
|
431
|
+
| Every benefit declares a non-empty `deliveredBy` | see the commands below the table |
|
|
432
432
|
| `THRESHOLD` benefits are intentional (find them all) | `rg -n "BenefitKanoCategory.THRESHOLD" specifications/src/market/` |
|
|
433
|
-
| `REVERSE` benefits live with `ANTI_TARGET` ICPs |
|
|
433
|
+
| `REVERSE` benefits live with `ANTI_TARGET` ICPs | see the commands below the table |
|
|
434
434
|
| No `LocalizedString` shapes inside benefits | `rg -n "LocalizedString" specifications/src/market/value-proposition/` |
|
|
435
435
|
|
|
436
|
+
```bash
|
|
437
|
+
# Every benefit declares a non-empty `deliveredBy`
|
|
438
|
+
rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ | rg "deliveredBy:\s*\["
|
|
439
|
+
|
|
440
|
+
# `REVERSE` benefits live with `ANTI_TARGET` ICPs
|
|
441
|
+
rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ | rg "ANTI_TARGET|icp-anti-"
|
|
442
|
+
```
|
|
443
|
+
|
|
436
444
|
## Common Rationalizations
|
|
437
445
|
|
|
438
446
|
| Rationalization | Reality |
|
|
@@ -507,10 +507,18 @@ export const inHouseNotionAlternative: MarketAlternativeConfig = {
|
|
|
507
507
|
| Invariant | Command |
|
|
508
508
|
|-----------|---------|
|
|
509
509
|
| Every alternative file uses the typed `MarketAlternativeConfig` | `rg -n ":\s+MarketAlternativeConfig" specifications/src/market/` |
|
|
510
|
-
| Every alternative declares both `whenChosen` and `whenWeBeat` |
|
|
511
|
-
| `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` |
|
|
510
|
+
| Every alternative declares both `whenChosen` and `whenWeBeat` | see the commands below the table |
|
|
511
|
+
| `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | see the commands below the table |
|
|
512
512
|
| At least one positioning references each alternative | `rg -n "alt-" specifications/src/market/positioning.ts` |
|
|
513
513
|
|
|
514
|
+
```bash
|
|
515
|
+
# Every alternative declares both `whenChosen` and `whenWeBeat`
|
|
516
|
+
rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ | rg "whenChosen|whenWeBeat"
|
|
517
|
+
|
|
518
|
+
# `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url`
|
|
519
|
+
rg -n "STATUS_QUO|ADJACENT_PROXY|IN_HOUSE_BUILD" -A 6 specifications/src/market/ | rg -v "url"
|
|
520
|
+
```
|
|
521
|
+
|
|
514
522
|
## Common Rationalizations
|
|
515
523
|
|
|
516
524
|
| Rationalization | Reality |
|
|
@@ -296,9 +296,17 @@ What earns its place:
|
|
|
296
296
|
|----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
|
|
297
297
|
| Snapshot uses the typed `MarketSnapshot` contract | `rg -n ":\s+MarketSnapshot" specifications/src/market/index.ts` |
|
|
298
298
|
| Snapshot version is V2 (Phase-3 surface) | `rg -n "version:\s+MarketSnapshotVersion\.V2" specifications/src/market/index.ts` |
|
|
299
|
-
| No `LocalizedString` / `MarketLocaleConfig` references inside `market/` |
|
|
299
|
+
| No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | see the commands below the table |
|
|
300
300
|
| Geographies use ISO 3166-1 alpha-2 codes or recognized region tags | `rg -n "geographies:" specifications/src/market/` (visually verify each value is `[A-Z]{2}` or one of `EMEA / NAM / APAC / LATAM / MENA / GLOBAL`; the validator enforces this at boot) |
|
|
301
|
-
| Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` |
|
|
301
|
+
| Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | see the commands below the table |
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
# No `LocalizedString` / `MarketLocaleConfig` references inside `market/`
|
|
305
|
+
rg -n "LocalizedString|MarketLocaleConfig" specifications/src/market/
|
|
306
|
+
|
|
307
|
+
# Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }`
|
|
308
|
+
rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
|
|
309
|
+
```
|
|
302
310
|
|
|
303
311
|
## Common Rationalizations
|
|
304
312
|
|
|
@@ -65,6 +65,17 @@ Locate the surfaces that may need editing using these app-relative globs:
|
|
|
65
65
|
|
|
66
66
|
### Step 1 — Pick the category name
|
|
67
67
|
|
|
68
|
+
Start from what the creator said the product IS: their one-liner, the
|
|
69
|
+
workflow they named and what they left out. The category keeps every
|
|
70
|
+
stage of that workflow and puts nothing they excluded at its centre: a
|
|
71
|
+
category under which a stated stage disappears is the wrong category,
|
|
72
|
+
not a sharper one. Better market words for the creator's own kind of
|
|
73
|
+
product are fine. When your name is a different kind of product from
|
|
74
|
+
the one the creator named, add a `notes[]` entry starting `Reframe:`
|
|
75
|
+
that quotes their framing, names yours and says why, so they can
|
|
76
|
+
overturn it. Never list the creator's own framing among
|
|
77
|
+
`rejectedCategories`.
|
|
78
|
+
|
|
68
79
|
The name is the words you want a buyer to repeat back. It should
|
|
69
80
|
be:
|
|
70
81
|
|
|
@@ -80,14 +91,14 @@ explaining it to a smart friend who has never seen the product.
|
|
|
80
91
|
|
|
81
92
|
### Step 3 — Author 2–5 `rejectedCategories`
|
|
82
93
|
|
|
83
|
-
For each: `name`, `
|
|
94
|
+
For each: `name`, `rationale`. These are the neighbouring
|
|
84
95
|
categories buyers might think we are — and which we explicitly
|
|
85
|
-
turn down. The `
|
|
96
|
+
turn down. The `rationale` line is the verbatim AI / landing-copy
|
|
86
97
|
ammunition for the comparison.
|
|
87
98
|
|
|
88
99
|
### Step 4 — Author 2–4 `differentiationDimensions`
|
|
89
100
|
|
|
90
|
-
For each: `name`, `
|
|
101
|
+
For each: `name`, `description`. These are the axes where
|
|
91
102
|
we are deliberately better than the average competitor in our
|
|
92
103
|
category. They are what AI prompts pull when asked to argue our
|
|
93
104
|
position.
|
|
@@ -166,8 +177,8 @@ export type MarketCategoryConfig = z.infer<typeof MarketCategoryConfigSchema>;
|
|
|
166
177
|
|
|
167
178
|
A complete, schema-shaped `MarketCategoryConfig` from the
|
|
168
179
|
reference application — a productized category with
|
|
169
|
-
explicit `rejectedCategories` (with `
|
|
170
|
-
`differentiationDimensions` (with `
|
|
180
|
+
explicit `rejectedCategories` (with `rationale`) and
|
|
181
|
+
`differentiationDimensions` (with `description`):
|
|
171
182
|
|
|
172
183
|
|
|
173
184
|
## Usage Example
|
|
@@ -251,9 +262,12 @@ quartet is what the snapshot validator audits.
|
|
|
251
262
|
defensive, none looks unfocused)
|
|
252
263
|
- [ ] At least 2 `differentiationDimensions` (no-axis category is
|
|
253
264
|
unactionable)
|
|
254
|
-
- [ ] Every `rejectedCategory` carries a `
|
|
265
|
+
- [ ] Every `rejectedCategory` carries a `rationale`
|
|
255
266
|
- [ ] Every `differentiationDimension` carries a
|
|
256
|
-
`
|
|
267
|
+
`description`
|
|
268
|
+
- [ ] The category keeps every workflow stage the creator named,
|
|
269
|
+
and a name of a different kind of product from theirs carries a
|
|
270
|
+
`Reframe:` note
|
|
257
271
|
|
|
258
272
|
### Grep invariants
|
|
259
273
|
|
|
@@ -326,9 +326,14 @@ export const communityIndieHackersChannel: MarketChannelConfig = {
|
|
|
326
326
|
| Invariant | Command |
|
|
327
327
|
|-----------|---------|
|
|
328
328
|
| Every channel file uses the typed `MarketChannelConfig` | `rg -n ":\s+MarketChannelConfig" specifications/src/market/` |
|
|
329
|
-
| Every channel declares non-empty `buyingJourneyStages` |
|
|
329
|
+
| Every channel declares non-empty `buyingJourneyStages` | see the commands below the table |
|
|
330
330
|
| No `LocalizedString` shapes in channel files | `rg -n "LocalizedString" specifications/src/market/channels.ts` |
|
|
331
331
|
|
|
332
|
+
```bash
|
|
333
|
+
# Every channel declares non-empty `buyingJourneyStages`
|
|
334
|
+
rg -n "MarketChannelConfig" -A 8 specifications/src/market/ | rg "buyingJourneyStages:\s*\["
|
|
335
|
+
```
|
|
336
|
+
|
|
332
337
|
## Common Rationalizations
|
|
333
338
|
|
|
334
339
|
| Rationalization | Reality |
|
|
@@ -651,7 +651,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
|
|
|
651
651
|
const trimmed = value.trim();
|
|
652
652
|
if (trimmed.length === 0) return undefined;
|
|
653
653
|
if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
|
|
654
|
-
throw new
|
|
654
|
+
throw new IntrospectionInputValidationError(
|
|
655
655
|
`buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
|
|
656
656
|
+ `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
|
|
657
657
|
+ `not a sentence — translation prose belongs in the LLM output, not the tag.`,
|
|
@@ -922,6 +922,8 @@ export interface SpecificationsCompanionExports<
|
|
|
922
922
|
TIntegrationPlan = IntegrationPlan,
|
|
923
923
|
// Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
|
|
924
924
|
TApplicationMaturity = ApplicationMaturity,
|
|
925
|
+
// Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
|
|
926
|
+
TBrandNameScreening = BrandNameScreening,
|
|
925
927
|
> {
|
|
926
928
|
resourceSpecifications: TResourceSpecifications;
|
|
927
929
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -1452,6 +1454,14 @@ export interface SpecificationsCompanionExports<
|
|
|
1452
1454
|
* never a gate. Read by the coherence report and the workbench.
|
|
1453
1455
|
*/
|
|
1454
1456
|
applicationMaturity?: TApplicationMaturity;
|
|
1457
|
+
/**
|
|
1458
|
+
* WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
|
|
1459
|
+
* registers, classes and jurisdictions searched, per-register results with sources and dates, and the
|
|
1460
|
+
* competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
|
|
1461
|
+
* `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
|
|
1462
|
+
* brand name stands. A screening, never a legal clearance opinion.
|
|
1463
|
+
*/
|
|
1464
|
+
brandNameScreening?: TBrandNameScreening;
|
|
1455
1465
|
/**
|
|
1456
1466
|
* Accepted application-declared semantic causality between whole
|
|
1457
1467
|
* specification-family states. This is not the registry's physical
|
|
@@ -2332,7 +2342,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
|
|
|
2332
2342
|
const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
|
|
2333
2343
|
|
|
2334
2344
|
for (const [iIdx, icp] of snapshot.icps.entries()) {
|
|
2335
|
-
if (
|
|
2345
|
+
if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
|
|
2336
2346
|
if (positionedIcpRefs.has(icp.ref)) continue;
|
|
2337
2347
|
|
|
2338
2348
|
issues.push({
|
|
@@ -2883,9 +2893,17 @@ function detectMessageTemplatePlaceholderMismatch(
|
|
|
2883
2893
|
|
|
2884
2894
|
| Invariant | Command |
|
|
2885
2895
|
|--------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
2886
|
-
| Behavior IDs registered in the companion model |
|
|
2896
|
+
| Behavior IDs registered in the companion model | see the commands below the table |
|
|
2887
2897
|
| Handlers wired into the builtin handler map | `rg -n "buildMarketContextBlock\(" --type ts` |
|
|
2888
|
-
| Specifications companion exports `marketSpecification` |
|
|
2898
|
+
| Specifications companion exports `marketSpecification` | see the commands below the table |
|
|
2899
|
+
|
|
2900
|
+
```bash
|
|
2901
|
+
# Behavior IDs registered in the companion model
|
|
2902
|
+
rg -n "market-context-for-(feature|icp)" --type ts
|
|
2903
|
+
|
|
2904
|
+
# Specifications companion exports `marketSpecification`
|
|
2905
|
+
rg -n "marketSpecification" --type ts | rg "companion-exports"
|
|
2906
|
+
```
|
|
2889
2907
|
|
|
2890
2908
|
## Common Rationalizations
|
|
2891
2909
|
|
|
@@ -541,7 +541,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
|
|
|
541
541
|
const trimmed = value.trim();
|
|
542
542
|
if (trimmed.length === 0) return undefined;
|
|
543
543
|
if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
|
|
544
|
-
throw new
|
|
544
|
+
throw new IntrospectionInputValidationError(
|
|
545
545
|
`buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
|
|
546
546
|
+ `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
|
|
547
547
|
+ `not a sentence — translation prose belongs in the LLM output, not the tag.`,
|
|
@@ -827,6 +827,8 @@ export interface SpecificationsCompanionExports<
|
|
|
827
827
|
TIntegrationPlan = IntegrationPlan,
|
|
828
828
|
// Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
|
|
829
829
|
TApplicationMaturity = ApplicationMaturity,
|
|
830
|
+
// Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
|
|
831
|
+
TBrandNameScreening = BrandNameScreening,
|
|
830
832
|
> {
|
|
831
833
|
resourceSpecifications: TResourceSpecifications;
|
|
832
834
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -1357,6 +1359,14 @@ export interface SpecificationsCompanionExports<
|
|
|
1357
1359
|
* never a gate. Read by the coherence report and the workbench.
|
|
1358
1360
|
*/
|
|
1359
1361
|
applicationMaturity?: TApplicationMaturity;
|
|
1362
|
+
/**
|
|
1363
|
+
* WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
|
|
1364
|
+
* registers, classes and jurisdictions searched, per-register results with sources and dates, and the
|
|
1365
|
+
* competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
|
|
1366
|
+
* `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
|
|
1367
|
+
* brand name stands. A screening, never a legal clearance opinion.
|
|
1368
|
+
*/
|
|
1369
|
+
brandNameScreening?: TBrandNameScreening;
|
|
1360
1370
|
/**
|
|
1361
1371
|
* Accepted application-declared semantic causality between whole
|
|
1362
1372
|
* specification-family states. This is not the registry's physical
|
|
@@ -2060,7 +2070,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
|
|
|
2060
2070
|
const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
|
|
2061
2071
|
|
|
2062
2072
|
for (const [iIdx, icp] of snapshot.icps.entries()) {
|
|
2063
|
-
if (
|
|
2073
|
+
if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
|
|
2064
2074
|
if (positionedIcpRefs.has(icp.ref)) continue;
|
|
2065
2075
|
|
|
2066
2076
|
issues.push({
|
|
@@ -134,10 +134,10 @@ intent picker (feature-scoped vs ICP-scoped sections). It is
|
|
|
134
134
|
**never** consumed for placeholder substitution and is not gated by
|
|
135
135
|
`requiredInputs[]`.
|
|
136
136
|
|
|
137
|
-
If a required flag is missing, the
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
137
|
+
If a required flag is missing, the request is refused as a bad
|
|
138
|
+
request naming the exact missing input — it surfaces precisely on
|
|
139
|
+
the CLI as `Market generation failed: …`. An unknown ref or template
|
|
140
|
+
name is refused the same way, with the refs the snapshot does hold. There is no "guess based on the snapshot"
|
|
141
141
|
fallback by design (D17 / framework-mindset).
|
|
142
142
|
|
|
143
143
|
### Step 3 — Pick the output language
|
|
@@ -707,19 +707,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
|
|
|
707
707
|
}
|
|
708
708
|
}
|
|
709
709
|
|
|
710
|
-
|
|
710
|
+
/*
|
|
711
|
+
* The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
|
|
712
|
+
* named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
|
|
713
|
+
* its name across the subprocess boundary: the controller answers 400 with the message instead of a
|
|
714
|
+
* sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
|
|
715
|
+
* `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
|
|
716
|
+
* the AUTHORED template, which no change to the request can fix.
|
|
717
|
+
*/
|
|
718
|
+
export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
|
|
711
719
|
public readonly missing: MarketMessageRequiredInput[];
|
|
712
720
|
constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
|
|
713
721
|
super(
|
|
714
722
|
`Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
|
|
715
723
|
+ `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
|
|
716
724
|
);
|
|
717
|
-
this.name = 'MarketPromptMissingRequiredInputError';
|
|
718
725
|
this.missing = missing;
|
|
719
726
|
}
|
|
720
727
|
}
|
|
721
728
|
|
|
722
|
-
export class MarketPromptUnknownRefError extends
|
|
729
|
+
export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
|
|
723
730
|
public readonly entityKind: string;
|
|
724
731
|
public readonly providedRef: string;
|
|
725
732
|
constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
|
|
@@ -727,19 +734,17 @@ export class MarketPromptUnknownRefError extends Error {
|
|
|
727
734
|
`No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
|
|
728
735
|
+ `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
|
|
729
736
|
);
|
|
730
|
-
this.name = 'MarketPromptUnknownRefError';
|
|
731
737
|
this.entityKind = entityKind;
|
|
732
738
|
this.providedRef = providedRef;
|
|
733
739
|
}
|
|
734
740
|
}
|
|
735
741
|
|
|
736
|
-
export class MarketPromptTemplateNotFoundError extends
|
|
742
|
+
export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
|
|
737
743
|
constructor(templateRef: string, knownRefs: string[]) {
|
|
738
744
|
super(
|
|
739
745
|
`No MarketMessageTemplate found with ref \`${templateRef}\`. `
|
|
740
746
|
+ `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
|
|
741
747
|
);
|
|
742
|
-
this.name = 'MarketPromptTemplateNotFoundError';
|
|
743
748
|
}
|
|
744
749
|
}
|
|
745
750
|
|
|
@@ -1491,7 +1496,12 @@ above is derived from this shape).
|
|
|
1491
1496
|
| The CLI command class is registered in the `Market` category | `rg -n "category:\\s*CommandCategory\\.Market" --type ts` |
|
|
1492
1497
|
| The companion HTTP route the CLI POSTs to | `rg -n "/api/companion/market/generate" --type ts` |
|
|
1493
1498
|
| The default timeout constant has not drifted | `rg -n "MARKET_COMPANION_DEFAULT_TIMEOUT_MS\\s*=\\s*90_000" --type ts` |
|
|
1494
|
-
| The renderer's typed errors surface to the CLI |
|
|
1499
|
+
| The renderer's typed errors surface to the CLI | see the commands below the table |
|
|
1500
|
+
|
|
1501
|
+
```bash
|
|
1502
|
+
# The renderer's typed errors surface to the CLI
|
|
1503
|
+
rg -n "MarketPrompt(MissingRequiredInput|UnknownRef|UnknownPlaceholder|TemplateNotFound)Error" --type ts
|
|
1504
|
+
```
|
|
1495
1505
|
|
|
1496
1506
|
## Common Rationalizations
|
|
1497
1507
|
|
package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md
CHANGED
|
@@ -529,19 +529,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
|
|
|
529
529
|
}
|
|
530
530
|
}
|
|
531
531
|
|
|
532
|
-
|
|
532
|
+
/*
|
|
533
|
+
* The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
|
|
534
|
+
* named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
|
|
535
|
+
* its name across the subprocess boundary: the controller answers 400 with the message instead of a
|
|
536
|
+
* sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
|
|
537
|
+
* `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
|
|
538
|
+
* the AUTHORED template, which no change to the request can fix.
|
|
539
|
+
*/
|
|
540
|
+
export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
|
|
533
541
|
public readonly missing: MarketMessageRequiredInput[];
|
|
534
542
|
constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
|
|
535
543
|
super(
|
|
536
544
|
`Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
|
|
537
545
|
+ `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
|
|
538
546
|
);
|
|
539
|
-
this.name = 'MarketPromptMissingRequiredInputError';
|
|
540
547
|
this.missing = missing;
|
|
541
548
|
}
|
|
542
549
|
}
|
|
543
550
|
|
|
544
|
-
export class MarketPromptUnknownRefError extends
|
|
551
|
+
export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
|
|
545
552
|
public readonly entityKind: string;
|
|
546
553
|
public readonly providedRef: string;
|
|
547
554
|
constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
|
|
@@ -549,19 +556,17 @@ export class MarketPromptUnknownRefError extends Error {
|
|
|
549
556
|
`No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
|
|
550
557
|
+ `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
|
|
551
558
|
);
|
|
552
|
-
this.name = 'MarketPromptUnknownRefError';
|
|
553
559
|
this.entityKind = entityKind;
|
|
554
560
|
this.providedRef = providedRef;
|
|
555
561
|
}
|
|
556
562
|
}
|
|
557
563
|
|
|
558
|
-
export class MarketPromptTemplateNotFoundError extends
|
|
564
|
+
export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
|
|
559
565
|
constructor(templateRef: string, knownRefs: string[]) {
|
|
560
566
|
super(
|
|
561
567
|
`No MarketMessageTemplate found with ref \`${templateRef}\`. `
|
|
562
568
|
+ `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
|
|
563
569
|
);
|
|
564
|
-
this.name = 'MarketPromptTemplateNotFoundError';
|
|
565
570
|
}
|
|
566
571
|
}
|
|
567
572
|
|
|
@@ -592,10 +592,18 @@ export const enterpriseProcurementAntiTargetIcp = marketIcpConfig({
|
|
|
592
592
|
| Invariant | Command |
|
|
593
593
|
|--------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
|
|
594
594
|
| Every ICP file uses the typed `MarketICPConfig` contract | `rg -n ":\s+MarketICPConfig" specifications/src/market/customer-profile/icps.ts` |
|
|
595
|
-
| Anti-target ICPs zero out `purposeMix` |
|
|
596
|
-
| Geographies look like ISO codes |
|
|
595
|
+
| Anti-target ICPs zero out `purposeMix` | see the commands below the table |
|
|
596
|
+
| Geographies look like ISO codes | see the commands below the table |
|
|
597
597
|
| No localized-string shapes inside ICPs | `rg -n "LocalizedString" specifications/src/market/customer-profile/` |
|
|
598
598
|
|
|
599
|
+
```bash
|
|
600
|
+
# Anti-target ICPs zero out `purposeMix`
|
|
601
|
+
rg -n "ANTI_TARGET" -A 5 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
|
|
602
|
+
|
|
603
|
+
# Geographies look like ISO codes
|
|
604
|
+
rg -n "geographies:\s*\[" -A 1 specifications/src/market/ | rg -v "'[A-Z]{2,5}'"
|
|
605
|
+
```
|
|
606
|
+
|
|
599
607
|
## Common Rationalizations
|
|
600
608
|
|
|
601
609
|
| Rationalization | Reality |
|
|
@@ -320,7 +320,12 @@ export const contextSwitchingCostPain: MarketPainConfig = {
|
|
|
320
320
|
| Pains use the typed `MarketPainConfig` contract | `rg -n ":\s+MarketPainConfig" specifications/src/market/value-proposition/pains.ts` |
|
|
321
321
|
| Gains use the typed `MarketGainConfig` contract | `rg -n ":\s+MarketGainConfig" specifications/src/market/value-proposition/gains.ts` |
|
|
322
322
|
| Jobs use the typed `MarketJobConfig` contract | `rg -n ":\s+MarketJobConfig" specifications/src/market/customer-profile/jobs.ts` |
|
|
323
|
-
| `weight` values stay within 1–10 |
|
|
323
|
+
| `weight` values stay within 1–10 | see the commands below the table |
|
|
324
|
+
|
|
325
|
+
```bash
|
|
326
|
+
# `weight` values stay within 1–10
|
|
327
|
+
rg -n "weight:\s*([0-9]+)" specifications/src/market/ | rg -v "weight:\s*([1-9]|10)\b"
|
|
328
|
+
```
|
|
324
329
|
|
|
325
330
|
## Common Rationalizations
|
|
326
331
|
|
|
@@ -367,7 +367,12 @@ export const applicationMessageTemplates: MarketMessageTemplateConfig[] = [
|
|
|
367
367
|
|--------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
368
368
|
| Templates declared on the snapshot | `rg -n "messageTemplates:" --type ts` |
|
|
369
369
|
| `requiredInputs` references the enum (not raw strings) | `rg -n "MarketMessageRequiredInput\." --type ts` |
|
|
370
|
-
| `{{output_language}}` is present in every template body |
|
|
370
|
+
| `{{output_language}}` is present in every template body | see the commands below the table |
|
|
371
|
+
|
|
372
|
+
```bash
|
|
373
|
+
# `{{output_language}}` is present in every template body
|
|
374
|
+
rg -n "promptTemplate:" -A 5 --type ts | rg "output_language"
|
|
375
|
+
```
|
|
371
376
|
|
|
372
377
|
## Common Rationalizations
|
|
373
378
|
|