@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
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Build Dispatch —
|
|
1
|
+
# Build Dispatch — Build-Plan Tasks → Verified Coding-Agent Runs, in Parallel Waves
|
|
2
2
|
|
|
3
3
|
### Target Application Framing
|
|
4
4
|
|
|
@@ -12,14 +12,14 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
12
12
|
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
13
13
|
|
|
14
14
|
|
|
15
|
-
> **
|
|
16
|
-
>
|
|
17
|
-
>
|
|
18
|
-
>
|
|
19
|
-
>
|
|
20
|
-
>
|
|
21
|
-
>
|
|
22
|
-
>
|
|
15
|
+
> **The build runs in parallel by default.** One run of this playbook starts a
|
|
16
|
+
> **wave**: up to N build-plan tasks at once, N being the application's **build
|
|
17
|
+
> parallelism** (`wildo workbench parallelism`, 5 unless the person set it). Each
|
|
18
|
+
> task in the wave follows the same per-task contract — its own coding run, its
|
|
19
|
+
> change-set captured, verified outside the coding agent, recorded, the failure
|
|
20
|
+
> disposition applied. With a build parallelism of `1` a run dispatches exactly
|
|
21
|
+
> ONE task, which is the single-flight mode. A `revert_changeset` failure path is
|
|
22
|
+
> still a **later phase** (see the boundary section).
|
|
23
23
|
|
|
24
24
|
## Where you are in the journey
|
|
25
25
|
|
|
@@ -33,9 +33,10 @@ here — you are turning one *approved, ordered* task into a *dispatched, verifi
|
|
|
33
33
|
change to the application.
|
|
34
34
|
|
|
35
35
|
Upstream, the **build-decompose** playbook produced the ordered task graph you
|
|
36
|
-
consume
|
|
37
|
-
|
|
38
|
-
|
|
36
|
+
consume. The **scale** playbook describes the same wave from the scheduling side —
|
|
37
|
+
the ready-set, the width, the reconciliation — and runs through the same runtime
|
|
38
|
+
branch as this one; prefer this playbook to start a build. **You author the task
|
|
39
|
+
graph neither here nor there** — see the boundary section.
|
|
39
40
|
|
|
40
41
|
## The typed task you dispatch
|
|
41
42
|
|
|
@@ -173,6 +174,17 @@ export enum BuildPlanTaskTargetKind {
|
|
|
173
174
|
* catalogue, so the website re-typed the business model's prices by hand.
|
|
174
175
|
*/
|
|
175
176
|
BILLING_CATALOG = 'BILLING_CATALOG',
|
|
177
|
+
/**
|
|
178
|
+
* The application's own ROLES — `CUSTOM_ROLES_CONFIGURATION` in `shared-lib/src/engine/roles.ts`, the
|
|
179
|
+
* organization types that offer them (`availableOrgRoles` in `wildo.saas.config.ts`), their
|
|
180
|
+
* specifications, and the `roles` of the operations they unlock (#2490).
|
|
181
|
+
*
|
|
182
|
+
* Its own kind because none of the others reaches it: the role table is application-wide and lives in
|
|
183
|
+
* the shared library's ENGINE module. Before it existed a requirement naming user groups ("office and
|
|
184
|
+
* field users see different things") had no task able to declare a role, so app-creation-test-005
|
|
185
|
+
* modelled roles as an access-role RESOURCE that nothing reads.
|
|
186
|
+
*/
|
|
187
|
+
APPLICATION_ROLES = 'APPLICATION_ROLES',
|
|
176
188
|
}
|
|
177
189
|
|
|
178
190
|
/**
|
|
@@ -419,6 +431,16 @@ export enum BuildPlanTaskProductKind {
|
|
|
419
431
|
* money and the pricing-surface facts (recommended, price disclosure, availability) the plan implies.
|
|
420
432
|
*/
|
|
421
433
|
APPLICATION_BILLING_PRODUCT = 'APPLICATION_BILLING_PRODUCT',
|
|
434
|
+
/**
|
|
435
|
+
* One data seed a module declares — rows the application creates for itself, named by the seed's
|
|
436
|
+
* `seedKey` (`crm:demo-customers`).
|
|
437
|
+
*
|
|
438
|
+
* The seed is its own file, `backend-api/src/modules/<module>/seeds/<seedKey with ':' as '.'>.seed.ts`,
|
|
439
|
+
* and it lands only once the module registers it — a seed file nothing imports never runs. Its
|
|
440
|
+
* {@link BuildPlanDataSeedContent} says whether it is REFERENCE data the application needs everywhere
|
|
441
|
+
* or DEMONSTRATION data that must never reach production.
|
|
442
|
+
*/
|
|
443
|
+
APPLICATION_DATA_SEED = 'APPLICATION_DATA_SEED',
|
|
422
444
|
/** One website page, registered in the website root config by its manifest. */
|
|
423
445
|
WEBSITE_PAGE = 'WEBSITE_PAGE',
|
|
424
446
|
/** One section of one website page, declared in that page's sections file. */
|
|
@@ -435,8 +457,43 @@ export enum BuildPlanTaskProductKind {
|
|
|
435
457
|
* registered. Produced once per channel the integration plan declares (`inboundChannels`).
|
|
436
458
|
*/
|
|
437
459
|
INBOUND_CHANNEL_HANDLER = 'INBOUND_CHANNEL_HANDLER',
|
|
460
|
+
/**
|
|
461
|
+
* One role the application declares, named by its role name (`FIELD_TECHNICIAN`), which is its key in
|
|
462
|
+
* `CUSTOM_ROLES_CONFIGURATION`. The NAME, not the file: `wildo init` writes `roles.ts` with an empty
|
|
463
|
+
* table, so the file proves nothing (#2490).
|
|
464
|
+
*/
|
|
465
|
+
APPLICATION_ROLE = 'APPLICATION_ROLE',
|
|
438
466
|
}
|
|
439
467
|
|
|
468
|
+
|
|
469
|
+
/**
|
|
470
|
+
* What a data seed's rows ARE, which decides where they may exist.
|
|
471
|
+
*
|
|
472
|
+
* - `REFERENCE` — rows the application needs to work wherever it runs: a closed list, a default
|
|
473
|
+
* record, a system template. Every environment, production included.
|
|
474
|
+
* - `DEMONSTRATION` — sample rows that make a freshly created application look lived-in (customers,
|
|
475
|
+
* projects, a few records per list). They must never sit beside real rows, so the seed declares
|
|
476
|
+
* `allowedApplicationEnvironments` without `production`, and the task lands only once it does.
|
|
477
|
+
*/
|
|
478
|
+
export enum BuildPlanDataSeedContent {
|
|
479
|
+
REFERENCE = 'REFERENCE',
|
|
480
|
+
DEMONSTRATION = 'DEMONSTRATION',
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
/**
|
|
484
|
+
* A data seed's key: kebab-case segments joined by `:` (`crm:demo-customers`), the convention a
|
|
485
|
+
* `DataSeedDefinition` documents. Constrained here because the seed's FILE is derived from it.
|
|
486
|
+
*/
|
|
487
|
+
/**
|
|
488
|
+
* An application role's name, as `CUSTOM_ROLES_CONFIGURATION` keys it: upper snake case (`FIELD_TECHNICIAN`).
|
|
489
|
+
* A core role (`ORG_MEMBER`, `APP_ADMIN_SUPER_ADMIN`) is not something an application declares, so the
|
|
490
|
+
* product refuses one: a plan naming it would claim to create a role the engine already owns.
|
|
491
|
+
*/
|
|
492
|
+
export const APPLICATION_ROLE_NAME_PATTERN: RegExp = /^[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*$/;
|
|
493
|
+
const CORE_ROLE_NAMES: ReadonlySet<string> = new Set<string>([...Object.values(CORE_APP_ROLES), ...Object.values(CORE_ORG_ROLES)]);
|
|
494
|
+
|
|
495
|
+
export const DATA_SEED_KEY_PATTERN: RegExp = /^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*)*$/;
|
|
496
|
+
|
|
440
497
|
/**
|
|
441
498
|
* One artifact a task is accountable for. Closed by construction: a product the
|
|
442
499
|
* host cannot ask a question about is a product that can never be shown to have
|
|
@@ -506,6 +563,19 @@ export const BuildPlanTaskProductSchema = z.discriminatedUnion('kind', [
|
|
|
506
563
|
scope: z.enum(ProviderBindingScope).systemEnum('ProviderBindingScope'),
|
|
507
564
|
}),
|
|
508
565
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT).systemEnum('BuildPlanTaskProductKind'), productKey: SlugSchema }),
|
|
566
|
+
z.strictObject({
|
|
567
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_ROLE).systemEnum('BuildPlanTaskProductKind'),
|
|
568
|
+
roleRef: z.string().regex(APPLICATION_ROLE_NAME_PATTERN).refine((roleRef) => !CORE_ROLE_NAMES.has(roleRef), {
|
|
569
|
+
message: 'A core role is the engine\'s; an application role needs a name of its own.',
|
|
570
|
+
}),
|
|
571
|
+
}),
|
|
572
|
+
z.strictObject({
|
|
573
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_DATA_SEED).systemEnum('BuildPlanTaskProductKind'),
|
|
574
|
+
seedKey: z.string().regex(DATA_SEED_KEY_PATTERN),
|
|
575
|
+
/** The resource whose rows the seed writes — the `resourceType` it declares. */
|
|
576
|
+
resourceRef: SlugSchema,
|
|
577
|
+
content: z.enum(BuildPlanDataSeedContent).systemEnum('BuildPlanDataSeedContent'),
|
|
578
|
+
}),
|
|
509
579
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_PAGE).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema }),
|
|
510
580
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_SECTION).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema, sectionRef: SlugSchema }),
|
|
511
581
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER).systemEnum('BuildPlanTaskProductKind'), chapterRef: SlugSchema }),
|
|
@@ -588,6 +658,11 @@ export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): r
|
|
|
588
658
|
return [`${product.kind}:${product.scope}:${product.providerRef}`];
|
|
589
659
|
case BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT:
|
|
590
660
|
return [`${product.kind}:${product.productKey}`];
|
|
661
|
+
case BuildPlanTaskProductKind.APPLICATION_ROLE:
|
|
662
|
+
return [`${product.kind}:${product.roleRef}`];
|
|
663
|
+
// The key alone: two seeds may write one resource, and the key is what the seed run ledger tracks.
|
|
664
|
+
case BuildPlanTaskProductKind.APPLICATION_DATA_SEED:
|
|
665
|
+
return [`${product.kind}:${product.seedKey}`];
|
|
591
666
|
case BuildPlanTaskProductKind.WEBSITE_PAGE:
|
|
592
667
|
return [`${product.kind}:${product.pageRef}`];
|
|
593
668
|
case BuildPlanTaskProductKind.WEBSITE_SECTION:
|
|
@@ -611,6 +686,34 @@ export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): r
|
|
|
611
686
|
*/
|
|
612
687
|
export const BILLING_CATALOG_SKILL_REF = 'configure-billing';
|
|
613
688
|
|
|
689
|
+
/**
|
|
690
|
+
* The skill every application-roles task is authored with (#2490): the role table, the organization
|
|
691
|
+
* types that offer a role, and the operation roles that make it matter. The dispatch derives it from an
|
|
692
|
+
* `APPLICATION_ROLE` product whatever the decomposer wrote.
|
|
693
|
+
*/
|
|
694
|
+
export const APPLICATION_ROLES_SKILL_REF = 'application-roles-authoring';
|
|
695
|
+
|
|
696
|
+
/**
|
|
697
|
+
* The skill every data-seed task is authored with (#2234): levels, modes, business keys, and the
|
|
698
|
+
* environment restriction that keeps demonstration rows out of production. The dispatch derives it from
|
|
699
|
+
* an `APPLICATION_DATA_SEED` product whatever the decomposer wrote.
|
|
700
|
+
*/
|
|
701
|
+
export const DATA_SEED_SKILL_REF = 'seeding-authoring';
|
|
702
|
+
|
|
703
|
+
/**
|
|
704
|
+
* The skill every PDF-template task is authored with (#2495): the template contract, the file field it fills, and
|
|
705
|
+
* where the generated file is stored. The dispatch derives it from a `PDF_TEMPLATE` product whatever the decomposer
|
|
706
|
+
* wrote.
|
|
707
|
+
*/
|
|
708
|
+
export const PDF_TEMPLATE_SKILL_REF = 'pdf-template-authoring';
|
|
709
|
+
|
|
710
|
+
/**
|
|
711
|
+
* The skill a resource CONFIG task carries when the resource DECLARES personal data (#2495): its retention binding
|
|
712
|
+
* lives in that configuration file, and storage limitation is a duty about personal data. The dispatch reads the
|
|
713
|
+
* declaration from the resource's schema (the engine's personal-data markers), whatever the decomposer wrote.
|
|
714
|
+
*/
|
|
715
|
+
export const RESOURCE_RETENTION_SKILL_REF = 'resource-retention-binding';
|
|
716
|
+
|
|
614
717
|
export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
615
718
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef: ModuleRefSchema }),
|
|
616
719
|
z.strictObject({
|
|
@@ -668,6 +771,7 @@ export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
|
668
771
|
}),
|
|
669
772
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.PROVIDER_BINDING), providerRef: SlugSchema }),
|
|
670
773
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.BILLING_CATALOG) }),
|
|
774
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.APPLICATION_ROLES) }),
|
|
671
775
|
]);
|
|
672
776
|
export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
673
777
|
|
|
@@ -738,15 +842,18 @@ export const BuildPlanTaskSchema = z.strictObject({
|
|
|
738
842
|
/**
|
|
739
843
|
* What this task is accountable to — traceability only, NEVER scope authority.
|
|
740
844
|
*
|
|
741
|
-
* The vocabulary is the
|
|
742
|
-
* and non-functional requirements, roadmap phases,
|
|
743
|
-
* constraints
|
|
744
|
-
*
|
|
745
|
-
*
|
|
845
|
+
* The vocabulary is the target aspects `BUILD_PLAN_FAMILY_ASPECTS` declares for this edge:
|
|
846
|
+
* functional and non-functional requirements, roadmap phases, the vision's success criteria and
|
|
847
|
+
* constraints, drafted features, pricing plans, and the brand's name, logo direction and visual
|
|
848
|
+
* tone. Each target after the first three was added because a producer had already been writing
|
|
849
|
+
* it (#629, #1433, #1835, #2221). A companion generation step serves what it consumes: the `logo`
|
|
850
|
+
* step serves the brand's logo direction and name.
|
|
746
851
|
*
|
|
747
|
-
*
|
|
748
|
-
*
|
|
749
|
-
*
|
|
852
|
+
* This schema accepts any non-empty string. Generation does not: the edge is DECLARED, so a key
|
|
853
|
+
* that resolves to no element of a target family (when that family has landed) is a dangling
|
|
854
|
+
* reference. The model is told so on retry, and the landing refuses it. That is why widening the
|
|
855
|
+
* vocabulary to what producers genuinely mean matters: a true link the vocabulary does not name
|
|
856
|
+
* fails generation. The workbench renders a key outside the vocabulary as visibly unresolved.
|
|
750
857
|
*/
|
|
751
858
|
servesRefs: z.array(NonEmptyStringSchema).default([]),
|
|
752
859
|
/**
|
|
@@ -770,9 +877,11 @@ export type BuildPlanTask = z.infer<typeof BuildPlanTaskSchema>;
|
|
|
770
877
|
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
771
878
|
* 'build-plan'` (the `family` vocabulary stays an open string owned by the
|
|
772
879
|
* selector surface; this note is the single place tying the SHAPE to the
|
|
773
|
-
* NAME). Produced by the build-decompose playbook, consumed
|
|
774
|
-
*
|
|
775
|
-
*
|
|
880
|
+
* NAME). Produced by the build-decompose playbook, consumed by
|
|
881
|
+
* build-dispatch (and build-scale, which runs the same branch): ready tasks
|
|
882
|
+
* are dispatched in parallel waves of up to the application's build
|
|
883
|
+
* parallelism (`wildo workbench parallelism`, 5 by default; 1 = one at a
|
|
884
|
+
* time).
|
|
776
885
|
*
|
|
777
886
|
* Invariants enforced here: unique task refs; every prerequisite names a task
|
|
778
887
|
* in this graph; no self-prerequisite. Cycle detection and ordering
|
|
@@ -864,14 +973,16 @@ Most of the D4 dispatch contract is **runner mechanism**, not prose you re-imple
|
|
|
864
973
|
the runner composes the context pack, opens a coding session with the agent over the
|
|
865
974
|
Agent Client Protocol and sends one prompt turn, answers the agent's permission
|
|
866
975
|
requests within the declared ceiling, captures the change-set, runs the verify hook,
|
|
867
|
-
|
|
976
|
+
keeps each task from being built twice at once, fills the wave to the configured width,
|
|
977
|
+
and applies its configured execution limits. Your method here is the **declarative recipe** the runner interprets —
|
|
868
978
|
*which* task to dispatch next, *when* it is authorized, and *how* its outcome is
|
|
869
979
|
judged. Do not hand-compose a dispatch prompt or drive git yourself; let the runner
|
|
870
980
|
own composition and change-set capture.
|
|
871
981
|
|
|
872
982
|
## Read state first — no artifact to write
|
|
873
983
|
|
|
874
|
-
This playbook is **idempotent** and, on a re-run, *advances the
|
|
984
|
+
This playbook is **idempotent** and, on a re-run, *advances the build by one wave*
|
|
985
|
+
(by one task when the build parallelism is `1`).
|
|
875
986
|
Before dispatching anything:
|
|
876
987
|
|
|
877
988
|
1. Read the current journey state and scope from what this run is given — the loaded
|
|
@@ -948,21 +1059,36 @@ Two smaller things belong in the same section, because both were observed costin
|
|
|
948
1059
|
- **Do not name a task so it reads as a fixture.** An agent that concludes it is looking at a
|
|
949
1060
|
smoke test will say so and stop. Name the task after the product change it makes.
|
|
950
1061
|
|
|
951
|
-
## Step 1 — Select the
|
|
952
|
-
|
|
953
|
-
Walk the build plan in its authored order
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
1062
|
+
## Step 1 — Select the ready tasks (the wave)
|
|
1063
|
+
|
|
1064
|
+
Walk the build plan in its authored order. A task is **ready** when it is not yet
|
|
1065
|
+
dispatched (or a previously-**failed** task cleared for retry — see Step 5), it is
|
|
1066
|
+
not already running, and its declared prerequisites have all **succeeded**. The
|
|
1067
|
+
runner selects ready tasks in that order and keeps up to the build parallelism of
|
|
1068
|
+
them running; when a run settles, its slot is refilled with whatever is ready THEN,
|
|
1069
|
+
so a task that just landed unlocks its dependents within the same wave. If **no**
|
|
1070
|
+
task is ready — every task has already succeeded, or the only undispatched tasks
|
|
1071
|
+
are blocked behind a still-unresolved failure — there is nothing to dispatch:
|
|
1072
|
+
report the build as done (or blocked on the failed task) and stop. An empty build
|
|
1073
|
+
plan is the same.
|
|
1074
|
+
|
|
1075
|
+
- **How many run at once is the build parallelism, and it is the person's call.**
|
|
1076
|
+
`wildo workbench parallelism` shows it (5 by default) and sets it; `1` means one
|
|
1077
|
+
workspace-mutating run at a time. The runner reads it at the start of every wave,
|
|
1078
|
+
so a change needs no restart. Do not try to widen a wave beyond it.
|
|
1079
|
+
- **The runs share ONE worktree, by design.** Concurrent runs may edit the same
|
|
1080
|
+
files. The runner does not prevent that; it prevents only a task being built
|
|
1081
|
+
twice at once, and it REPAIRS the rest when the wave's runs have settled: it
|
|
1082
|
+
commits what the runs' own accepts left as one change naming every run whose
|
|
1083
|
+
writes it carries, then re-runs ALONE each task whose finished product a sibling
|
|
1084
|
+
overwrote. Each run's record says which runs overlapped it (`concurrency`), and
|
|
1085
|
+
whether a failure is suspected to come from a sibling (`interferenceSuspected`).
|
|
1086
|
+
- **One wave is bounded.** A call takes at most four tasks per slot, and runs each
|
|
1087
|
+
generation step at most once; it then stops taking tasks, waits for its runs and
|
|
1088
|
+
returns. The next run of this playbook continues from where the build stands.
|
|
1089
|
+
- **One wave at a time.** A second wave is refused while one runs, including during
|
|
1090
|
+
its end-of-wave commit and repair: start the next only once the running one has
|
|
1091
|
+
ended.
|
|
966
1092
|
- **A prerequisite must have SUCCEEDED, not merely been attempted.** A task is ready
|
|
967
1093
|
only when every task it depends on is dispatched-and-succeeded (verify passed).
|
|
968
1094
|
A prerequisite that is dispatched-and-**failed** (its change-set is flagged for
|
|
@@ -974,15 +1100,16 @@ empty build plan is the same: nothing to dispatch, stop.
|
|
|
974
1100
|
- **Companion-generation steps are not coding-agent dispatches.** A build-plan task
|
|
975
1101
|
marked as a companion-owned generation step (labels / i18n, email templates,
|
|
976
1102
|
seeds) runs through its deterministic companion endpoint, not the coding-agent
|
|
977
|
-
dispatch lane. Route it there; do not dispatch a coding agent for it.
|
|
978
|
-
|
|
979
|
-
|
|
1103
|
+
dispatch lane. Route it there; do not dispatch a coding agent for it. In a wave
|
|
1104
|
+
the runner runs a ready generation step in its turn while the coding runs already
|
|
1105
|
+
started keep going.
|
|
980
1106
|
|
|
981
1107
|
## Step 2 — Check the actual host authorization boundary
|
|
982
1108
|
|
|
983
1109
|
A coding dispatch writes the application workspace. Read its selected task, readiness,
|
|
984
1110
|
mutation scope and the configured coding host's authorization policy before invoking it.
|
|
985
|
-
|
|
1111
|
+
Every run of a wave writes the same shared workspace; each is confined to its own task's
|
|
1112
|
+
mutation scope, and nothing confines it from its siblings (Step 1).
|
|
986
1113
|
|
|
987
1114
|
The playbook's `approval` declaration and the journey autonomy presets express policy
|
|
988
1115
|
intent. The current playbook runner does not interpret them as pre-dispatch gates,
|
|
@@ -1052,7 +1179,10 @@ so the agent cannot mark its own homework:
|
|
|
1052
1179
|
is the *trust-but-verify reviewer* pass. It is **declarative** — the creator's
|
|
1053
1180
|
review checklist; the compiled build-dispatch Evaluation Treatment is what the
|
|
1054
1181
|
runtime judges with, and the deterministic typecheck above is what runs
|
|
1055
|
-
automatically.
|
|
1182
|
+
automatically. **In a wave the runtime does not compose this judge per run**: each
|
|
1183
|
+
run's record carries its outcome, its checks, and what it overlapped, and the
|
|
1184
|
+
wave's end-of-run repair is on the wave's result. Read those; with a build
|
|
1185
|
+
parallelism of `1` the judge runs on the single dispatch as before.
|
|
1056
1186
|
|
|
1057
1187
|
## Step 5 — Record the result and apply the failure disposition
|
|
1058
1188
|
|
|
@@ -1082,8 +1212,8 @@ is a deferred build-loop-resilience concern, and human triage is the v1 disposit
|
|
|
1082
1212
|
here the loop simply surfaces the failure and stops advancing that dependency chain.
|
|
1083
1213
|
|
|
1084
1214
|
Then **loop**: on the next run of this playbook, the build plan's task records reflect the
|
|
1085
|
-
just
|
|
1086
|
-
(Step 1). Close a significant stretch of dispatches with a progress summary — what was
|
|
1215
|
+
outcomes of the wave that just ran (`wildo build tasks`), and the next wave selects from
|
|
1216
|
+
what is ready now (Step 1). Close a significant stretch of dispatches with a progress summary — what was
|
|
1087
1217
|
produced, which change-sets landed, what verify said, and any failed task left
|
|
1088
1218
|
flagged for triage.
|
|
1089
1219
|
|
|
@@ -1103,17 +1233,16 @@ flagged for triage.
|
|
|
1103
1233
|
|
|
1104
1234
|
## Scaffold-depth boundary (owned by a sibling, or deferred to a later phase)
|
|
1105
1235
|
|
|
1106
|
-
Keep this playbook at **
|
|
1107
|
-
here**:
|
|
1236
|
+
Keep this playbook at **dispatch depth**: which tasks run, under what contract, and
|
|
1237
|
+
what each run's outcome was. Explicitly **out of scope here**:
|
|
1108
1238
|
|
|
1109
1239
|
- **Re-decomposition.** You do NOT split modules/resources into tasks, re-order the
|
|
1110
1240
|
graph, or add tasks — the **build-decompose** playbook owns the task graph. You
|
|
1111
1241
|
read it and dispatch from it.
|
|
1112
|
-
- **
|
|
1113
|
-
|
|
1114
|
-
|
|
1115
|
-
|
|
1116
|
-
concurrency schedule.
|
|
1242
|
+
- **The width and the isolation model.** How many tasks run at once is the
|
|
1243
|
+
application's build parallelism, set by the person; the runs share one worktree and
|
|
1244
|
+
are repaired, not isolated. You do NOT choose a width, partition the worktree, or
|
|
1245
|
+
design a different schedule.
|
|
1117
1246
|
- **A `revert_changeset` failure path.** Undoing a failed run's edits is a mutating
|
|
1118
1247
|
git op outside the read-only change-set carve-out — deferred. `keep_and_flag` (keep
|
|
1119
1248
|
+ flag the captured change-set for triage) is the v1 disposition.
|
|
@@ -1126,8 +1255,8 @@ here**:
|
|
|
1126
1255
|
catch yourself writing application code or a resource schema here, stop — that is
|
|
1127
1256
|
the dispatched agent's job, not the orchestrator's.
|
|
1128
1257
|
|
|
1129
|
-
If you find yourself designing how MANY agents run concurrently
|
|
1130
|
-
|
|
1258
|
+
If you find yourself designing how MANY agents run concurrently, stop: the width is
|
|
1259
|
+
the build parallelism and the schedule is the runner's.
|
|
1131
1260
|
|
|
1132
1261
|
## What you emit
|
|
1133
1262
|
|
|
@@ -1139,8 +1268,8 @@ journey artifact family: the task row already *is* the dispatch record, and a se
|
|
|
1139
1268
|
home for the same record would drift.
|
|
1140
1269
|
|
|
1141
1270
|
Dispatch uses the configured host's actual authorization boundary. The creator reviews
|
|
1142
|
-
the recorded change-
|
|
1143
|
-
|
|
1271
|
+
the recorded change-sets and verification outcomes afterwards, wave by wave, until the
|
|
1272
|
+
build plan is fully dispatched.
|
|
1144
1273
|
|
|
1145
1274
|
## References
|
|
1146
1275
|
|
|
@@ -1151,4 +1280,4 @@ one verified task at a time, until the build plan is fully dispatched.
|
|
|
1151
1280
|
|
|
1152
1281
|
Formerly authored as an `llm_judge` quality gate; the generic rubric-only gate kind was retired at the flexible-intelligence hard cut (judgment now runs only through a compiled Evaluation Treatment). The checklist itself is creator-facing review guidance and is kept here, verbatim (minus the retired runner's closing sentence, and with repository-specific wording made application-neutral):
|
|
1153
1282
|
|
|
1154
|
-
Judge whether ONE dispatched build-plan task ran soundly under the D4 dispatch contract — the trust-but-verify reviewer pass OUTSIDE the coding agent. Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) TASK ACCOMPLISHED — the change-set the run produced actually implements the dispatched task's target + stage (e.g. a schema task added the persisted shape; a ui-behavior task added field displays); a run whose change-set does not advance the task's stated target is a GAP (the dispatch produced nothing useful), and an empty change-set on a task that should have authored files is a GAP. (2) CHANGE-SET SCOPED TO THE TASK — the files touched belong to the task's target (its module / resource / stage) and the app workspace; edits sprawling into unrelated modules, Wildo package source outside the application workspace, or files no build-plan task owns are a CONCERN (scope creep the reviewer must flag). Files attributed BASELINE_DIRTY_AMBIGUOUS were already dirty and changed again during the run; this establishes uncertainty, not ownership by a parallel editor. Every changed path outside the declared scope — ambiguous or not, and including a parallel session's edits, which the capture cannot tell apart from the run's own — is RECORDED on the result as `outOfScopePaths`; nothing refuses the run for it. Treat each as a CONCERN and resolve its authorship during review, never as a GAP by itself. Committed-window entries and recognized concurrent host-lane paths are classified separately and left off that list. (3) VERIFY RAN + PASSED — the deterministic verify gate (typecheck) ran OUTSIDE the coding agent after the run and passed; a run recorded as succeeded whose typecheck the reviewer cannot confirm passed is a CONCERN, and a run whose typecheck FAILED but was recorded succeeded is a GAP. (4) ATTRIBUTION
|
|
1283
|
+
Judge whether ONE dispatched build-plan task ran soundly under the D4 dispatch contract — the trust-but-verify reviewer pass OUTSIDE the coding agent. Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) TASK ACCOMPLISHED — the change-set the run produced actually implements the dispatched task's target + stage (e.g. a schema task added the persisted shape; a ui-behavior task added field displays); a run whose change-set does not advance the task's stated target is a GAP (the dispatch produced nothing useful), and an empty change-set on a task that should have authored files is a GAP. (2) CHANGE-SET SCOPED TO THE TASK — the files touched belong to the task's target (its module / resource / stage) and the app workspace; edits sprawling into unrelated modules, Wildo package source outside the application workspace, or files no build-plan task owns are a CONCERN (scope creep the reviewer must flag). Files attributed BASELINE_DIRTY_AMBIGUOUS were already dirty and changed again during the run; this establishes uncertainty, not ownership by a parallel editor. Every changed path outside the declared scope — ambiguous or not, and including a parallel session's edits, which the capture cannot tell apart from the run's own — is RECORDED on the result as `outOfScopePaths`; nothing refuses the run for it. Treat each as a CONCERN and resolve its authorship during review, never as a GAP by itself. Committed-window entries and recognized concurrent host-lane paths are classified separately and left off that list. (3) VERIFY RAN + PASSED — the deterministic verify gate (typecheck) ran OUTSIDE the coding agent after the run and passed; a run recorded as succeeded whose typecheck the reviewer cannot confirm passed is a CONCERN, and a run whose typecheck FAILED but was recorded succeeded is a GAP. (4) ATTRIBUTION READ AGAINST THE WAVE — the run's edits are cleanly attributable to it in the captured change-set (files classed RUN_EXCLUSIVE or APPEARED_DURING_RUN). In a wave the runs share one worktree, so overlap is expected and RECORDED rather than prevented: the run's `concurrency` entry names the runs that overlapped it and the paths they both touched. A change-set dominated by BASELINE_DIRTY_AMBIGUOUS overlap, or captured across a HEAD that moved mid-run, is a CONCERN the reviewer resolves using that record before accepting the run; a run marked `interferenceSuspected`, or whose product a sibling overwrote, is a CONCERN until its re-run alone has landed. Overlap alone is not a GAP. (5) FAILURE DISPOSITION CORRECT — a failed/timed-out run's captured change-set is KEPT + FLAGGED for human triage (keep_and_flag), never silently reverted nor silently left as an un-recorded half-applied state; a failed run with no recorded change-set flag is a GAP (F-5 workspace-safety violation). (6) BOUNDARY DISCIPLINE — the dispatch stays at dispatch depth: it runs the ready tasks up to the build parallelism, captures + verifies + records each, and applies onFailure. It does NOT re-decompose the plan (the build-decompose playbook owns the task graph), does NOT choose its own width or a different isolation model (the build parallelism is the person's setting, and the runs share one worktree by design), and does NOT itself author schemas / fields / code (the coding agent does that at dispatch time). Evidence of re-decomposition, a width other than the configured one, or the dispatcher authoring code itself is a CONCERN (scope creep out of the dispatch lane). (The checklist is declarative: nothing executes it; the current host's deterministic checks apply; the approval enum alone adds no gate.)
|