npm - @opengsd/gsd-path - Versions diffs - 1.0.0 → 1.2.0 - Mend

@opengsd/gsd-path 1.0.0 → 1.2.0

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.

Files changed (498) hide show

package/AGENTS.md +33 -13
package/CHANGELOG.md +68 -0
package/DOCS.md +75 -6
package/FULL.md +12 -15
package/HOOKS.md +18 -9
package/QUICK.md +8 -6
package/README.md +218 -14
package/RUNTIME.md +16 -5
package/UPDATE.md +30 -11
package/WORKFLOW.md +35 -16
package/package.json +23 -1
package/platforms/claude/dispatch.md +4 -4
package/platforms/copilot/dispatch.md +4 -4
package/platforms/cursor/dispatch.md +5 -10
package/platforms/grok/dispatch.md +4 -6
package/platforms/kimi/dispatch.md +4 -4
package/platforms/kiro/dispatch.md +4 -6
package/platforms/opencode/dispatch.md +4 -4
package/platforms/qwen/dispatch.md +4 -4
package/platforms/shared-agents/dispatch.md +12 -19
package/scripts/_common.py +5 -0
package/scripts/archive_milestone.py +30 -124
package/scripts/bootstrap_repository.py +33 -4
package/scripts/build_recovery.py +292 -0
package/scripts/build_state.py +2 -0
package/scripts/check_docs_audit.py +7 -3
package/scripts/check_handoffs.py +7 -1
package/scripts/check_task_briefs.py +3 -0
package/scripts/detect_project.py +22 -3
package/scripts/discussion_records.py +3 -0
package/scripts/discussion_validate.py +8 -3
package/scripts/dispatch_driver.py +233 -22
package/scripts/git_guard.py +14 -5
package/scripts/guard_hook.py +11 -1
package/scripts/install.mjs +54 -1448
package/scripts/install.py +155 -188
package/scripts/integration.py +54 -28
package/scripts/isolation.py +24 -6
package/scripts/jev_review.py +138 -0
package/scripts/lean_verification.py +3 -1
package/scripts/loop_run.py +2 -0
package/scripts/model_policy.py +279 -0
package/scripts/path_config.py +248 -0
package/scripts/pipeline_diagnose.py +15 -3
package/scripts/pipeline_git.py +3 -0
package/scripts/pipeline_state.py +117 -186
package/scripts/pipeline_undo.py +14 -7
package/scripts/promote_lookahead.py +33 -162
package/scripts/review_panel.py +11 -0
package/scripts/roadmap.py +326 -0
package/scripts/runtime_store.py +278 -0
package/scripts/skill-resources.json +182 -4
package/scripts/state_checkpoint.py +114 -72
package/scripts/state_promote.py +47 -44
package/scripts/status_runtime.py +92 -6
package/scripts/task_context.py +73 -0
package/scripts/token_budget.py +40 -1
package/scripts/workflow_run.py +128 -8
package/scripts/worktree_paths.py +94 -0
package/skills/gsd-path/BUILD.md +54 -575
package/skills/gsd-path/DECIDE.md +4 -6
package/skills/gsd-path/DEFINE.md +23 -21
package/skills/gsd-path/DOCS-AUDIT.md +2 -0
package/skills/gsd-path/INSPECT.md +32 -8
package/skills/gsd-path/PLAN.md +29 -19
package/skills/gsd-path/RESEARCH.md +5 -6
package/skills/gsd-path/ROADMAP.md +24 -58
package/skills/gsd-path/SHIP.md +29 -17
package/skills/gsd-path/SKILL.md +46 -22
package/skills/gsd-path/references/build-abandon.md +33 -0
package/skills/gsd-path/references/build-native.md +502 -0
package/skills/gsd-path/references/build-recovery.md +78 -0
package/skills/gsd-path/references/coder.md +8 -3
package/skills/gsd-path/references/config.md +57 -0
package/skills/gsd-path/references/dispatch.md +12 -19
package/skills/gsd-path/references/docs-auditor.md +14 -0
package/skills/gsd-path/references/jev-review.md +82 -0
package/skills/gsd-path/references/model-policy.md +139 -0
package/skills/gsd-path/references/reviewer-final.md +21 -0
package/skills/gsd-path/references/reviewer-panel.md +17 -0
package/skills/gsd-path/references/reviewer-skeptic.md +20 -0
package/skills/gsd-path/references/reviewer-wave.md +89 -0
package/skills/gsd-path/references/reviewer.md +12 -148
package/skills/gsd-path/references/runtime-selection.md +25 -0
package/skills/gsd-path/scripts/__pycache__/_common.cpython-312.pyc +0 -0
package/skills/gsd-path/scripts/__pycache__/check_handoffs.cpython-312.pyc +0 -0
package/skills/gsd-path/scripts/_common.py +5 -0
package/skills/gsd-path/scripts/archive_milestone.py +30 -124
package/skills/gsd-path/scripts/bootstrap_repository.py +33 -4
package/skills/gsd-path/scripts/build_recovery.py +292 -0
package/skills/gsd-path/scripts/build_state.py +2 -0
package/skills/gsd-path/scripts/check_docs_audit.py +7 -3
package/skills/gsd-path/scripts/check_handoffs.py +7 -1
package/skills/gsd-path/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path/scripts/detect_project.py +22 -3
package/skills/gsd-path/scripts/discussion_records.py +3 -0
package/skills/gsd-path/scripts/discussion_validate.py +8 -3
package/skills/gsd-path/scripts/dispatch_driver.py +233 -22
package/skills/gsd-path/scripts/git_guard.py +768 -0
package/skills/gsd-path/scripts/integration.py +54 -28
package/skills/gsd-path/scripts/isolation.py +24 -6
package/skills/gsd-path/scripts/jev_review.py +138 -0
package/skills/gsd-path/scripts/lean_verification.py +3 -1
package/skills/gsd-path/scripts/loop_run.py +2 -0
package/skills/gsd-path/scripts/model_policy.py +279 -0
package/skills/gsd-path/scripts/path_config.py +248 -0
package/skills/gsd-path/scripts/pipeline_git.py +3 -0
package/skills/gsd-path/scripts/pipeline_state.py +117 -186
package/skills/gsd-path/scripts/promote_lookahead.py +33 -162
package/skills/gsd-path/scripts/review_panel.py +11 -0
package/skills/gsd-path/scripts/roadmap.py +326 -0
package/skills/gsd-path/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path/scripts/state_promote.py +47 -44
package/skills/gsd-path/scripts/status_runtime.py +208 -0
package/skills/gsd-path/scripts/task_context.py +73 -0
package/skills/gsd-path/scripts/token_budget.py +40 -1
package/skills/gsd-path/scripts/workflow_run.py +128 -8
package/skills/gsd-path/scripts/worktree_paths.py +94 -0
package/skills/gsd-path/templates/skeptic.md +1 -1
package/skills/gsd-path/templates/task.md +2 -0
package/skills/gsd-path/templates/wave-panel.md +1 -1
package/skills/gsd-path/templates/wave-review.md +1 -1
package/skills/gsd-path-build/SKILL.md +54 -575
package/skills/gsd-path-build/references/build-abandon.md +33 -0
package/skills/gsd-path-build/references/build-native.md +502 -0
package/skills/gsd-path-build/references/build-recovery.md +78 -0
package/skills/gsd-path-build/references/coder.md +8 -3
package/skills/gsd-path-build/references/dispatch.md +12 -19
package/skills/gsd-path-build/references/jev-review.md +82 -0
package/skills/gsd-path-build/references/model-policy.md +139 -0
package/skills/gsd-path-build/references/reviewer-final.md +21 -0
package/skills/gsd-path-build/references/reviewer-panel.md +17 -0
package/skills/gsd-path-build/references/reviewer-skeptic.md +20 -0
package/skills/gsd-path-build/references/reviewer-wave.md +89 -0
package/skills/gsd-path-build/references/reviewer.md +12 -148
package/skills/gsd-path-build/references/runtime-selection.md +25 -0
package/skills/gsd-path-build/scripts/__pycache__/_common.cpython-312.pyc +0 -0
package/skills/gsd-path-build/scripts/__pycache__/check_handoffs.cpython-312.pyc +0 -0
package/skills/gsd-path-build/scripts/_common.py +5 -0
package/skills/gsd-path-build/scripts/archive_milestone.py +30 -124
package/skills/gsd-path-build/scripts/build_recovery.py +292 -0
package/skills/gsd-path-build/scripts/build_state.py +2 -0
package/skills/gsd-path-build/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-build/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-build/scripts/detect_project.py +1536 -0
package/skills/gsd-path-build/scripts/discussion_records.py +3 -0
package/skills/gsd-path-build/scripts/discussion_validate.py +8 -3
package/skills/gsd-path-build/scripts/dispatch_driver.py +233 -22
package/skills/gsd-path-build/scripts/integration.py +54 -28
package/skills/gsd-path-build/scripts/isolation.py +24 -6
package/skills/gsd-path-build/scripts/jev_review.py +138 -0
package/skills/gsd-path-build/scripts/loop_run.py +2 -0
package/skills/gsd-path-build/scripts/model_policy.py +279 -0
package/skills/gsd-path-build/scripts/path_config.py +248 -0
package/skills/gsd-path-build/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-build/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-build/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-build/scripts/review_panel.py +11 -0
package/skills/gsd-path-build/scripts/roadmap.py +326 -0
package/skills/gsd-path-build/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-build/scripts/state_promote.py +47 -44
package/skills/gsd-path-build/scripts/task_context.py +73 -0
package/skills/gsd-path-build/scripts/token_budget.py +40 -1
package/skills/gsd-path-build/scripts/workflow_run.py +128 -8
package/skills/gsd-path-build/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-build/templates/skeptic.md +1 -1
package/skills/gsd-path-build/templates/task.md +2 -0
package/skills/gsd-path-build/templates/wave-panel.md +1 -1
package/skills/gsd-path-build/templates/wave-review.md +1 -1
package/skills/gsd-path-decide/SKILL.md +4 -6
package/skills/gsd-path-decide/references/dispatch.md +12 -19
package/skills/gsd-path-decide/references/model-policy.md +139 -0
package/skills/gsd-path-decide/references/runtime-selection.md +25 -0
package/skills/gsd-path-decide/scripts/_common.py +5 -0
package/skills/gsd-path-decide/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-decide/scripts/build_recovery.py +292 -0
package/skills/gsd-path-decide/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-decide/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-decide/scripts/detect_project.py +1536 -0
package/skills/gsd-path-decide/scripts/discussion_records.py +3 -0
package/skills/gsd-path-decide/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-decide/scripts/integration.py +1459 -0
package/skills/gsd-path-decide/scripts/isolation.py +24 -6
package/skills/gsd-path-decide/scripts/loop_run.py +839 -0
package/skills/gsd-path-decide/scripts/model_policy.py +279 -0
package/skills/gsd-path-decide/scripts/path_config.py +248 -0
package/skills/gsd-path-decide/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-decide/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-decide/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-decide/scripts/review_panel.py +564 -0
package/skills/gsd-path-decide/scripts/roadmap.py +326 -0
package/skills/gsd-path-decide/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-decide/scripts/state_promote.py +47 -44
package/skills/gsd-path-decide/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-define/SKILL.md +23 -21
package/skills/gsd-path-define/references/build-recovery.md +78 -0
package/skills/gsd-path-define/references/runtime-selection.md +25 -0
package/skills/gsd-path-define/scripts/_common.py +5 -0
package/skills/gsd-path-define/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-define/scripts/build_recovery.py +292 -0
package/skills/gsd-path-define/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-define/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-define/scripts/detect_project.py +22 -3
package/skills/gsd-path-define/scripts/discussion_records.py +3 -0
package/skills/gsd-path-define/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-define/scripts/integration.py +1459 -0
package/skills/gsd-path-define/scripts/isolation.py +24 -6
package/skills/gsd-path-define/scripts/loop_run.py +839 -0
package/skills/gsd-path-define/scripts/model_policy.py +279 -0
package/skills/gsd-path-define/scripts/path_config.py +248 -0
package/skills/gsd-path-define/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-define/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-define/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-define/scripts/review_panel.py +564 -0
package/skills/gsd-path-define/scripts/roadmap.py +326 -0
package/skills/gsd-path-define/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-define/scripts/state_promote.py +47 -44
package/skills/gsd-path-define/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-discuss/SKILL.md +2 -0
package/skills/gsd-path-discuss/references/runtime-selection.md +25 -0
package/skills/gsd-path-discuss/scripts/_common.py +5 -0
package/skills/gsd-path-discuss/scripts/discussion_records.py +3 -0
package/skills/gsd-path-discuss/scripts/loop_run.py +839 -0
package/skills/gsd-path-discuss/scripts/model_policy.py +279 -0
package/skills/gsd-path-discuss/scripts/path_config.py +248 -0
package/skills/gsd-path-discuss/scripts/review_panel.py +564 -0
package/skills/gsd-path-discuss/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-docs-audit/SKILL.md +2 -0
package/skills/gsd-path-docs-audit/references/dispatch.md +12 -19
package/skills/gsd-path-docs-audit/references/docs-auditor.md +14 -0
package/skills/gsd-path-docs-audit/references/model-policy.md +139 -0
package/skills/gsd-path-docs-audit/references/runtime-selection.md +25 -0
package/skills/gsd-path-docs-audit/scripts/_common.py +5 -0
package/skills/gsd-path-docs-audit/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-docs-audit/scripts/build_recovery.py +292 -0
package/skills/gsd-path-docs-audit/scripts/check_docs_audit.py +7 -3
package/skills/gsd-path-docs-audit/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-docs-audit/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-docs-audit/scripts/detect_project.py +1536 -0
package/skills/gsd-path-docs-audit/scripts/discussion_records.py +3 -0
package/skills/gsd-path-docs-audit/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-docs-audit/scripts/integration.py +1459 -0
package/skills/gsd-path-docs-audit/scripts/isolation.py +24 -6
package/skills/gsd-path-docs-audit/scripts/loop_run.py +839 -0
package/skills/gsd-path-docs-audit/scripts/model_policy.py +279 -0
package/skills/gsd-path-docs-audit/scripts/path_config.py +248 -0
package/skills/gsd-path-docs-audit/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-docs-audit/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-docs-audit/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-docs-audit/scripts/review_panel.py +564 -0
package/skills/gsd-path-docs-audit/scripts/roadmap.py +326 -0
package/skills/gsd-path-docs-audit/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-docs-audit/scripts/state_promote.py +47 -44
package/skills/gsd-path-docs-audit/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-forensics/SKILL.md +9 -5
package/skills/gsd-path-forensics/references/runtime-selection.md +25 -0
package/skills/gsd-path-forensics/scripts/_common.py +5 -0
package/skills/gsd-path-forensics/scripts/discussion_records.py +3 -0
package/skills/gsd-path-forensics/scripts/loop_run.py +839 -0
package/skills/gsd-path-forensics/scripts/model_policy.py +279 -0
package/skills/gsd-path-forensics/scripts/path_config.py +248 -0
package/skills/gsd-path-forensics/scripts/pipeline_diagnose.py +15 -3
package/skills/gsd-path-forensics/scripts/pipeline_undo.py +14 -7
package/skills/gsd-path-forensics/scripts/review_panel.py +564 -0
package/skills/gsd-path-forensics/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-inspect/SKILL.md +32 -8
package/skills/gsd-path-inspect/references/dispatch.md +12 -19
package/skills/gsd-path-inspect/references/docs-auditor.md +14 -0
package/skills/gsd-path-inspect/references/model-policy.md +139 -0
package/skills/gsd-path-inspect/references/runtime-selection.md +25 -0
package/skills/gsd-path-inspect/scripts/__pycache__/_common.cpython-312.pyc +0 -0
package/skills/gsd-path-inspect/scripts/_common.py +5 -0
package/skills/gsd-path-inspect/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-inspect/scripts/build_recovery.py +292 -0
package/skills/gsd-path-inspect/scripts/check_docs_audit.py +7 -3
package/skills/gsd-path-inspect/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-inspect/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-inspect/scripts/detect_project.py +22 -3
package/skills/gsd-path-inspect/scripts/discussion_records.py +3 -0
package/skills/gsd-path-inspect/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-inspect/scripts/integration.py +1459 -0
package/skills/gsd-path-inspect/scripts/isolation.py +24 -6
package/skills/gsd-path-inspect/scripts/loop_run.py +839 -0
package/skills/gsd-path-inspect/scripts/model_policy.py +279 -0
package/skills/gsd-path-inspect/scripts/path_config.py +248 -0
package/skills/gsd-path-inspect/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-inspect/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-inspect/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-inspect/scripts/review_panel.py +564 -0
package/skills/gsd-path-inspect/scripts/roadmap.py +326 -0
package/skills/gsd-path-inspect/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-inspect/scripts/state_promote.py +47 -44
package/skills/gsd-path-inspect/scripts/workflow_run.py +237 -0
package/skills/gsd-path-inspect/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-loop/SKILL.md +2 -0
package/skills/gsd-path-loop/references/runtime-selection.md +25 -0
package/skills/gsd-path-loop/scripts/_common.py +5 -0
package/skills/gsd-path-loop/scripts/discussion_records.py +3 -0
package/skills/gsd-path-loop/scripts/loop_run.py +2 -0
package/skills/gsd-path-loop/scripts/model_policy.py +279 -0
package/skills/gsd-path-loop/scripts/path_config.py +248 -0
package/skills/gsd-path-loop/scripts/review_panel.py +564 -0
package/skills/gsd-path-loop/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-migrate/SKILL.md +2 -0
package/skills/gsd-path-migrate/references/runtime-selection.md +25 -0
package/skills/gsd-path-migrate/scripts/_common.py +185 -0
package/skills/gsd-path-migrate/scripts/discussion_records.py +3 -0
package/skills/gsd-path-migrate/scripts/loop_run.py +839 -0
package/skills/gsd-path-migrate/scripts/model_policy.py +279 -0
package/skills/gsd-path-migrate/scripts/path_config.py +248 -0
package/skills/gsd-path-migrate/scripts/review_panel.py +564 -0
package/skills/gsd-path-plan/SKILL.md +29 -19
package/skills/gsd-path-plan/references/build-recovery.md +78 -0
package/skills/gsd-path-plan/references/dispatch.md +12 -19
package/skills/gsd-path-plan/references/model-policy.md +139 -0
package/skills/gsd-path-plan/references/runtime-selection.md +25 -0
package/skills/gsd-path-plan/scripts/__pycache__/_common.cpython-312.pyc +0 -0
package/skills/gsd-path-plan/scripts/_common.py +5 -0
package/skills/gsd-path-plan/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-plan/scripts/build_recovery.py +292 -0
package/skills/gsd-path-plan/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-plan/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-plan/scripts/detect_project.py +1536 -0
package/skills/gsd-path-plan/scripts/discussion_records.py +3 -0
package/skills/gsd-path-plan/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-plan/scripts/integration.py +1459 -0
package/skills/gsd-path-plan/scripts/isolation.py +24 -6
package/skills/gsd-path-plan/scripts/loop_run.py +839 -0
package/skills/gsd-path-plan/scripts/model_policy.py +279 -0
package/skills/gsd-path-plan/scripts/path_config.py +248 -0
package/skills/gsd-path-plan/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-plan/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-plan/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-plan/scripts/review_panel.py +11 -0
package/skills/gsd-path-plan/scripts/roadmap.py +326 -0
package/skills/gsd-path-plan/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-plan/scripts/state_promote.py +47 -44
package/skills/gsd-path-plan/scripts/workflow_run.py +128 -8
package/skills/gsd-path-plan/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-plan/templates/task.md +2 -0
package/skills/gsd-path-research/SKILL.md +5 -6
package/skills/gsd-path-research/references/dispatch.md +12 -19
package/skills/gsd-path-research/references/model-policy.md +139 -0
package/skills/gsd-path-research/references/runtime-selection.md +25 -0
package/skills/gsd-path-research/scripts/_common.py +5 -0
package/skills/gsd-path-research/scripts/archive_milestone.py +2171 -0
package/skills/gsd-path-research/scripts/build_recovery.py +292 -0
package/skills/gsd-path-research/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-research/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-research/scripts/detect_project.py +1536 -0
package/skills/gsd-path-research/scripts/discussion_records.py +3 -0
package/skills/gsd-path-research/scripts/discussion_validate.py +1326 -0
package/skills/gsd-path-research/scripts/integration.py +1459 -0
package/skills/gsd-path-research/scripts/isolation.py +24 -6
package/skills/gsd-path-research/scripts/loop_run.py +839 -0
package/skills/gsd-path-research/scripts/model_policy.py +279 -0
package/skills/gsd-path-research/scripts/path_config.py +248 -0
package/skills/gsd-path-research/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-research/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-research/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-research/scripts/review_panel.py +564 -0
package/skills/gsd-path-research/scripts/roadmap.py +326 -0
package/skills/gsd-path-research/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-research/scripts/state_promote.py +47 -44
package/skills/gsd-path-research/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-roadmap/SKILL.md +24 -58
package/skills/gsd-path-roadmap/references/dispatch.md +12 -19
package/skills/gsd-path-roadmap/references/model-policy.md +139 -0
package/skills/gsd-path-roadmap/references/runtime-selection.md +25 -0
package/skills/gsd-path-roadmap/scripts/_common.py +5 -0
package/skills/gsd-path-roadmap/scripts/archive_milestone.py +30 -124
package/skills/gsd-path-roadmap/scripts/build_recovery.py +292 -0
package/skills/gsd-path-roadmap/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-roadmap/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-roadmap/scripts/detect_project.py +22 -3
package/skills/gsd-path-roadmap/scripts/discussion_records.py +3 -0
package/skills/gsd-path-roadmap/scripts/discussion_validate.py +8 -3
package/skills/gsd-path-roadmap/scripts/integration.py +54 -28
package/skills/gsd-path-roadmap/scripts/isolation.py +24 -6
package/skills/gsd-path-roadmap/scripts/loop_run.py +839 -0
package/skills/gsd-path-roadmap/scripts/model_policy.py +279 -0
package/skills/gsd-path-roadmap/scripts/path_config.py +248 -0
package/skills/gsd-path-roadmap/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-roadmap/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-roadmap/scripts/promote_lookahead.py +33 -162
package/skills/gsd-path-roadmap/scripts/review_panel.py +11 -0
package/skills/gsd-path-roadmap/scripts/roadmap.py +326 -0
package/skills/gsd-path-roadmap/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-roadmap/scripts/state_promote.py +47 -44
package/skills/gsd-path-roadmap/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-ship/SKILL.md +29 -17
package/skills/gsd-path-ship/references/dispatch.md +12 -19
package/skills/gsd-path-ship/references/jev-review.md +82 -0
package/skills/gsd-path-ship/references/model-policy.md +139 -0
package/skills/gsd-path-ship/references/reviewer-final.md +21 -0
package/skills/gsd-path-ship/references/reviewer-panel.md +17 -0
package/skills/gsd-path-ship/references/reviewer-skeptic.md +20 -0
package/skills/gsd-path-ship/references/reviewer-wave.md +89 -0
package/skills/gsd-path-ship/references/reviewer.md +12 -148
package/skills/gsd-path-ship/references/runtime-selection.md +25 -0
package/skills/gsd-path-ship/scripts/__pycache__/_common.cpython-312.pyc +0 -0
package/skills/gsd-path-ship/scripts/_common.py +5 -0
package/skills/gsd-path-ship/scripts/archive_milestone.py +30 -124
package/skills/gsd-path-ship/scripts/build_recovery.py +292 -0
package/skills/gsd-path-ship/scripts/build_state.py +2 -0
package/skills/gsd-path-ship/scripts/check_handoffs.py +7 -1
package/skills/gsd-path-ship/scripts/check_task_briefs.py +3 -0
package/skills/gsd-path-ship/scripts/detect_project.py +1536 -0
package/skills/gsd-path-ship/scripts/discussion_records.py +3 -0
package/skills/gsd-path-ship/scripts/discussion_validate.py +8 -3
package/skills/gsd-path-ship/scripts/integration.py +54 -28
package/skills/gsd-path-ship/scripts/isolation.py +24 -6
package/skills/gsd-path-ship/scripts/jev_review.py +138 -0
package/skills/gsd-path-ship/scripts/lean_verification.py +3 -1
package/skills/gsd-path-ship/scripts/loop_run.py +839 -0
package/skills/gsd-path-ship/scripts/model_policy.py +279 -0
package/skills/gsd-path-ship/scripts/path_config.py +248 -0
package/skills/gsd-path-ship/scripts/pipeline_git.py +3 -0
package/skills/gsd-path-ship/scripts/pipeline_state.py +117 -186
package/skills/gsd-path-ship/scripts/promote_lookahead.py +286 -0
package/skills/gsd-path-ship/scripts/review_panel.py +11 -0
package/skills/gsd-path-ship/scripts/roadmap.py +326 -0
package/skills/gsd-path-ship/scripts/state_checkpoint.py +114 -72
package/skills/gsd-path-ship/scripts/state_promote.py +47 -44
package/skills/gsd-path-ship/scripts/workflow_run.py +128 -8
package/skills/gsd-path-ship/scripts/worktree_paths.py +94 -0
package/skills/gsd-path-ship/templates/wave-review.md +1 -1
package/skills/gsd-path-undo/SKILL.md +2 -0
package/skills/gsd-path-undo/references/runtime-selection.md +25 -0
package/skills/gsd-path-undo/scripts/_common.py +5 -0
package/skills/gsd-path-undo/scripts/discussion_records.py +3 -0
package/skills/gsd-path-undo/scripts/loop_run.py +839 -0
package/skills/gsd-path-undo/scripts/model_policy.py +279 -0
package/skills/gsd-path-undo/scripts/path_config.py +248 -0
package/skills/gsd-path-undo/scripts/pipeline_undo.py +14 -7
package/skills/gsd-path-undo/scripts/review_panel.py +564 -0
package/skills/gsd-path-undo/scripts/worktree_paths.py +94 -0
package/skills/path/BUILD.md +54 -575
package/skills/path/DECIDE.md +4 -6
package/skills/path/DEFINE.md +23 -21
package/skills/path/DOCS-AUDIT.md +2 -0
package/skills/path/INSPECT.md +32 -8
package/skills/path/PLAN.md +29 -19
package/skills/path/RESEARCH.md +5 -6
package/skills/path/ROADMAP.md +24 -58
package/skills/path/SHIP.md +29 -17
package/skills/path/SKILL.md +46 -22
package/skills/path/references/build-abandon.md +33 -0
package/skills/path/references/build-native.md +502 -0
package/skills/path/references/build-recovery.md +78 -0
package/skills/path/references/coder.md +8 -3
package/skills/path/references/config.md +57 -0
package/skills/path/references/dispatch.md +12 -19
package/skills/path/references/docs-auditor.md +14 -0
package/skills/path/references/jev-review.md +82 -0
package/skills/path/references/model-policy.md +139 -0
package/skills/path/references/reviewer-final.md +21 -0
package/skills/path/references/reviewer-panel.md +17 -0
package/skills/path/references/reviewer-skeptic.md +20 -0
package/skills/path/references/reviewer-wave.md +89 -0
package/skills/path/references/reviewer.md +12 -148
package/skills/path/references/runtime-selection.md +25 -0
package/skills/path/scripts/_common.py +5 -0
package/skills/path/scripts/archive_milestone.py +30 -124
package/skills/path/scripts/bootstrap_repository.py +33 -4
package/skills/path/scripts/build_recovery.py +292 -0
package/skills/path/scripts/build_state.py +2 -0
package/skills/path/scripts/check_docs_audit.py +7 -3
package/skills/path/scripts/check_handoffs.py +7 -1
package/skills/path/scripts/check_task_briefs.py +3 -0
package/skills/path/scripts/detect_project.py +22 -3
package/skills/path/scripts/discussion_records.py +3 -0
package/skills/path/scripts/discussion_validate.py +8 -3
package/skills/path/scripts/dispatch_driver.py +233 -22
package/skills/path/scripts/git_guard.py +768 -0
package/skills/path/scripts/integration.py +54 -28
package/skills/path/scripts/isolation.py +24 -6
package/skills/path/scripts/jev_review.py +138 -0
package/skills/path/scripts/lean_verification.py +3 -1
package/skills/path/scripts/loop_run.py +2 -0
package/skills/path/scripts/model_policy.py +279 -0
package/skills/path/scripts/path_config.py +248 -0
package/skills/path/scripts/pipeline_git.py +3 -0
package/skills/path/scripts/pipeline_state.py +117 -186
package/skills/path/scripts/promote_lookahead.py +33 -162
package/skills/path/scripts/review_panel.py +11 -0
package/skills/path/scripts/roadmap.py +326 -0
package/skills/path/scripts/state_checkpoint.py +114 -72
package/skills/path/scripts/state_promote.py +47 -44
package/skills/path/scripts/status_runtime.py +208 -0
package/skills/path/scripts/task_context.py +73 -0
package/skills/path/scripts/token_budget.py +40 -1
package/skills/path/scripts/workflow_run.py +128 -8
package/skills/path/scripts/worktree_paths.py +94 -0
package/skills/path/templates/skeptic.md +1 -1
package/skills/path/templates/task.md +2 -0
package/skills/path/templates/wave-panel.md +1 -1
package/skills/path/templates/wave-review.md +1 -1

package/skills/gsd-path-migrate/scripts/review_panel.py ADDED Viewed

@@ -0,0 +1,564 @@
+#!/usr/bin/env python3
+# gsd-path project runtime
+"""Resolve optional GSD Path cross-model review panels without model reasoning.
+The orchestrator inspects the host's advertised child-model slugs and passes
+them here. This helper parses PLAN.md / INTENT.md / CHARTER.md (PLAN wins,
+then INTENT, then CHARTER, else off), groups slugs into families, skips the
+parent family, caps the panel at three, and merges family artifacts. It never
+probes a host or overrides the canonical inherit reviewer.
+"""
+from __future__ import annotations
+import argparse
+import json
+import re
+import sys
+# Runtime helpers must not modify their immutable installation.
+sys.dont_write_bytecode = True
+from pathlib import Path
+from typing import Iterable, Optional, Sequence
+KNOWN_FAMILIES = (
+    "claude",
+    "gpt",
+    "grok",
+    "composer",
+    "gemini",
+    "deepseek",
+    "kimi",
+    "qwen",
+)
+FAMILY_ALIASES = {
+    "claude": "claude",
+    "opus": "claude",
+    "sonnet": "claude",
+    "haiku": "claude",
+    "gpt": "gpt",
+    "openai": "gpt",
+    "grok": "grok",
+    "composer": "composer",
+    "gemini": "gemini",
+    "deepseek": "deepseek",
+    "kimi": "kimi",
+    "moonshot": "kimi",
+    "qwen": "qwen",
+}
+MAX_FAMILIES = 3
+PLAN_LINE = re.compile(
+    r"^-\s*review_panel:\s*(\S.*?)\s*(?:<!--.*-->)?\s*$", re.MULTILINE
+)
+INTENT_LINE = re.compile(
+    r"^Review panel:\s*(\S.*?)\s*(?:<!--.*-->)?\s*$", re.MULTILINE
+)
+VERSION_NUMBERS = re.compile(r"\d+")
+TOKEN_SPLIT = re.compile(r"[^a-z0-9]+")
+FINDING_BLOCK = re.compile(
+    r"^###\s+(?P<id>F\d+)\s*$"
+    r"(?P<body>.*?)(?=^###\s+F\d+\s*$|\Z)",
+    re.MULTILINE | re.DOTALL,
+)
+FIELD_LINE = re.compile(r"^-\s*(?P<key>[A-Za-z][A-Za-z ]*):\s*(?P<value>.*)\s*$")
+class ReviewPanelError(RuntimeError):
+    pass
+def _first_token(value: str) -> str:
+    return value.strip().split()[0].strip().strip("`")
+def _split_families(value: str) -> tuple[str, ...]:
+    tokens = [token.strip().casefold() for token in value.split(",") if token.strip()]
+    if not tokens:
+        raise ReviewPanelError("review_panel named list is empty")
+    unknown = [token for token in tokens if token not in KNOWN_FAMILIES]
+    if unknown:
+        raise ReviewPanelError(
+            f"unknown review_panel families: {', '.join(unknown)}"
+        )
+    seen = []
+    for token in tokens:
+        if token not in seen:
+            seen.append(token)
+    if len(seen) > MAX_FAMILIES:
+        raise ReviewPanelError(
+            f"review_panel names at most {MAX_FAMILIES} families"
+        )
+    return tuple(seen)
+def parse_review_panel_value(raw: str) -> dict:
+    value = raw.strip()
+    if not value:
+        raise ReviewPanelError("review_panel value is empty")
+    token = _first_token(value).casefold()
+    if token == "off":
+        return {"mode": "off", "families": ()}
+    if token == "detected":
+        return {"mode": "detected", "families": ()}
+    families = _split_families(value)
+    return {"mode": "named", "families": families}
+def extract_config_value(text: str, pattern: re.Pattern[str], source: str) -> Optional[str]:
+    matches = pattern.findall(text)
+    if not matches:
+        return None
+    if len(matches) > 1:
+        raise ReviewPanelError(f"{source} has multiple review_panel values")
+    return matches[0]
+def parse_sources(
+    plan_text: Optional[str],
+    intent_text: Optional[str],
+    charter_text: Optional[str] = None,
+) -> dict:
+    if plan_text is not None:
+        plan_value = extract_config_value(plan_text, PLAN_LINE, "PLAN.md")
+        if plan_value is not None:
+            parsed = parse_review_panel_value(plan_value)
+            parsed["source"] = "plan"
+            return parsed
+    if intent_text is not None:
+        intent_value = extract_config_value(intent_text, INTENT_LINE, "INTENT.md")
+        if intent_value is not None:
+            parsed = parse_review_panel_value(intent_value)
+            parsed["source"] = "intent"
+            return parsed
+    if charter_text is not None:
+        charter_value = extract_config_value(charter_text, INTENT_LINE, "CHARTER.md")
+        if charter_value is not None:
+            parsed = parse_review_panel_value(charter_value)
+            parsed["source"] = "charter"
+            return parsed
+    return {"mode": "off", "families": (), "source": "default"}
+def read_optional(path: Optional[Path]) -> Optional[str]:
+    if path is None:
+        return None
+    resolved = path.resolve()
+    if resolved.is_symlink() or not resolved.is_file():
+        raise ReviewPanelError(f"path must be a real file: {resolved}")
+    return resolved.read_text(encoding="utf-8")
+def parse_files(
+    plan: Optional[Path],
+    intent: Optional[Path],
+    charter: Optional[Path] = None,
+) -> dict:
+    return parse_sources(
+        read_optional(plan), read_optional(intent), read_optional(charter)
+    )
+def plan_review_panel_enabled(plan_text: str) -> bool:
+    """Archive-safe enabled check: anything other than absent/off is on."""
+    try:
+        parsed = parse_sources(plan_text, None)
+    except ReviewPanelError:
+        return True
+    return parsed["mode"] != "off"
+def family_of_slug(slug: str) -> Optional[str]:
+    normalized = slug.strip().casefold()
+    if not normalized or normalized == "inherit":
+        return None
+    tokens = TOKEN_SPLIT.split(normalized)
+    for token in tokens:
+        if token in FAMILY_ALIASES:
+            return FAMILY_ALIASES[token]
+    for token in tokens:
+        stem = token.rstrip("0123456789")
+        if stem and stem in FAMILY_ALIASES:
+            return FAMILY_ALIASES[stem]
+    return None
+def version_key(slug: str) -> tuple[int, ...]:
+    numbers = tuple(int(part) for part in VERSION_NUMBERS.findall(slug))
+    return numbers if numbers else (0,)
+def latest_slug(slugs: Sequence[str]) -> str:
+    return max(slugs, key=lambda slug: (version_key(slug), len(slug), slug))
+def group_advertised(slugs: Iterable[str]) -> dict[str, list[str]]:
+    grouped: dict[str, list[str]] = {family: [] for family in KNOWN_FAMILIES}
+    for slug in slugs:
+        cleaned = slug.strip()
+        if not cleaned:
+            continue
+        family = family_of_slug(cleaned)
+        if family is None:
+            continue
+        if cleaned not in grouped[family]:
+            grouped[family].append(cleaned)
+    return {family: values for family, values in grouped.items() if values}
+def split_csv(raw: Optional[str]) -> tuple[str, ...]:
+    if not raw:
+        return ()
+    return tuple(part.strip() for part in raw.split(",") if part.strip())
+def resolve_panel(
+    config: dict,
+    advertised: Sequence[str],
+    parent_family: Optional[str] = None,
+    parent_slug: Optional[str] = None,
+    excluded_families: Sequence[str] = (),
+) -> dict:
+    inferred_parent = parent_family or (
+        family_of_slug(parent_slug) if parent_slug else None
+    )
+    grouped = group_advertised(advertised)
+    skipped = []
+    selected = []
+    if config["mode"] == "off":
+        return {
+            "mode": "off",
+            "status": "off",
+            "reason": "review_panel is off",
+            "parent_family": inferred_parent,
+            "selected": [],
+            "skipped": [],
+            "missing": [],
+        }
+    wanted = (
+        list(config["families"])
+        if config["mode"] == "named"
+        else [family for family in KNOWN_FAMILIES if family in grouped]
+    )
+    missing = [family for family in wanted if family not in grouped]
+    if config["mode"] == "named" and missing:
+        raise ReviewPanelError(
+            "named review_panel families are not advertised: " + ", ".join(missing)
+        )
+    if config["mode"] == "named" and set(wanted) & set(excluded_families):
+        raise ReviewPanelError("named review_panel must use an independent family")
+    for family in wanted:
+        if family in excluded_families:
+            skipped.append({"family": family, "reason": "excluded reviewer family"})
+            continue
+        if family == inferred_parent:
+            skipped.append({"family": family, "reason": "parent family"})
+            continue
+        slugs = grouped.get(family)
+        if not slugs:
+            skipped.append({"family": family, "reason": "not advertised"})
+            continue
+        selected.append({"family": family, "slug": latest_slug(slugs)})
+        if len(selected) >= MAX_FAMILIES:
+            overflow = wanted[wanted.index(family) + 1 :]
+            for extra in overflow:
+                if extra != inferred_parent and extra in grouped:
+                    skipped.append({"family": extra, "reason": "cap"})
+            break
+    if selected:
+        return {
+            "mode": config["mode"],
+            "status": "ready",
+            "reason": "panel resolved",
+            "parent_family": inferred_parent,
+            "selected": selected,
+            "skipped": skipped,
+            "missing": missing if config["mode"] == "detected" else [],
+        }
+    if config["mode"] == "named":
+        raise ReviewPanelError(
+            "named review_panel would only repeat the parent family or is empty"
+        )
+    return {
+        "mode": config["mode"],
+        "status": "skipped",
+        "reason": "no advertised cross-model families",
+        "parent_family": inferred_parent,
+        "selected": [],
+        "skipped": skipped,
+        "missing": missing,
+    }
+def _require_field(body: str, key: str, source: str) -> str:
+    for line in body.splitlines():
+        match = FIELD_LINE.fullmatch(line.strip())
+        if match and match.group("key").casefold() == key.casefold():
+            value = match.group("value").strip()
+            if not value:
+                raise ReviewPanelError(f"{source} has an empty {key} field")
+            return value
+    raise ReviewPanelError(f"{source} is missing the {key} field")
+def parse_findings(text: str, source: str) -> list[dict]:
+    findings = []
+    for match in FINDING_BLOCK.finditer(text):
+        body = match.group("body")
+        severity = _require_field(body, "Severity", f"{source} {match.group('id')}").casefold()
+        kind = _require_field(body, "Kind", f"{source} {match.group('id')}").casefold()
+        criterion = _require_field(body, "Criterion", f"{source} {match.group('id')}")
+        evidence = _require_field(body, "Evidence", f"{source} {match.group('id')}")
+        found = _require_field(body, "Found", f"{source} {match.group('id')}")
+        fix = _require_field(body, "Fix direction", f"{source} {match.group('id')}")
+        if severity not in {"high", "medium", "low"}:
+            raise ReviewPanelError(f"{source} {match.group('id')} has an invalid Severity")
+        if kind not in {"criterion", "preference"}:
+            raise ReviewPanelError(f"{source} {match.group('id')} has an invalid Kind")
+        if kind == "criterion" and criterion.casefold() == "none":
+            raise ReviewPanelError(
+                f"{source} {match.group('id')} criterion findings must name a criterion"
+            )
+        findings.append(
+            {
+                "id": match.group("id"),
+                "severity": severity,
+                "kind": kind,
+                "criterion": criterion,
+                "evidence": evidence,
+                "found": found,
+                "fix": fix,
+                "source": source,
+            }
+        )
+    if not findings:
+        findings_heading = re.search(r"^## Findings\s*$", text, re.MULTILINE)
+        if findings_heading:
+            rest = text[findings_heading.end() :]
+            next_heading = re.search(r"^## ", rest, re.MULTILINE)
+            section = rest[: next_heading.start()] if next_heading else rest
+            if re.search(r"^-\s*none\s*$", section, re.MULTILINE):
+                return []
+        raise ReviewPanelError(f"{source} has no findings")
+    return findings
+def parse_family_artifact(path: Path, expected_kind: str) -> dict:
+    if path.is_symlink() or not path.is_file():
+        raise ReviewPanelError(f"panel artifact must be a real file: {path}")
+    text = path.read_text(encoding="utf-8")
+    lines = text.splitlines()
+    if expected_kind == "plan":
+        if not lines or not lines[0].startswith("# Plan panel — "):
+            raise ReviewPanelError(f"{path.name} heading must start with '# Plan panel — '")
+    elif expected_kind == "wave":
+        if not lines or not lines[0].startswith("# Panel — wave "):
+            raise ReviewPanelError(f"{path.name} heading must start with '# Panel — wave '")
+    else:
+        raise ReviewPanelError(f"unknown panel kind: {expected_kind}")
+    family = _require_field(text, "Family", path.name).casefold()
+    model = _require_field(text, "Model", path.name)
+    if family not in KNOWN_FAMILIES:
+        raise ReviewPanelError(f"{path.name} has an unknown Family")
+    if "## Findings" not in text:
+        raise ReviewPanelError(f"{path.name} is missing ## Findings")
+    findings = parse_findings(text, path.name)
+    return {
+        "path": str(path),
+        "family": family,
+        "model": model,
+        "text": text.rstrip() + "\n",
+        "findings": findings,
+    }
+def actionable(finding: dict) -> bool:
+    return finding["kind"] == "criterion" and finding["severity"] == "high"
+def detect_conflicts(findings: Sequence[dict]) -> list[dict]:
+    by_criterion: dict[str, list[dict]] = {}
+    for finding in findings:
+        key = finding["criterion"].strip().casefold()
+        if key in {"", "none"}:
+            continue
+        by_criterion.setdefault(key, []).append(finding)
+    conflicts = []
+    for criterion, group in by_criterion.items():
+        severities = {item["severity"] for item in group}
+        # A conflict is families disagreeing on whether the criterion needs a
+        # fix; wording differences in Found are not conflicts.
+        if len({actionable(item) for item in group}) > 1:
+            conflicts.append(
+                {
+                    "criterion": group[0]["criterion"],
+                    "families": [item["source"] for item in group],
+                    "severities": sorted(severities),
+                }
+            )
+    return conflicts
+def render_finding(finding: dict) -> str:
+    return (
+        f"- {finding['severity']} / {finding['kind']} — {finding['criterion']}\n"
+        f"  evidence: {finding['evidence']}\n"
+        f"  found: {finding['found']}\n"
+        f"  fix: {finding['fix']}\n"
+        f"  source: {finding['source']}\n"
+    )
+def merge_artifacts(
+    kind: str,
+    inputs: Sequence[Path],
+    output: Path,
+    header_fields: Sequence[tuple[str, str]],
+) -> dict:
+    artifacts = [parse_family_artifact(path, kind) for path in inputs]
+    families = [artifact["family"] for artifact in artifacts]
+    if len(families) != len(set(families)):
+        raise ReviewPanelError("panel merge repeats a family")
+    findings = [finding for artifact in artifacts for finding in artifact["findings"]]
+    action = [finding for finding in findings if actionable(finding)]
+    warnings = [finding for finding in findings if not actionable(finding)]
+    conflicts = detect_conflicts(findings)
+    title = "# Plan panel" if kind == "plan" else "# Wave panel"
+    lines = [title, ""]
+    for key, value in header_fields:
+        lines.append(f"{key}: {value}")
+    lines.extend(
+        [
+            f"Families: {', '.join(families)}",
+            f"Actionable: {len(action)}",
+            f"Warnings: {len(warnings)}",
+            f"Conflicts: {len(conflicts)}",
+            "",
+            "## Actionable",
+            "",
+        ]
+    )
+    if action:
+        lines.extend(render_finding(finding) for finding in action)
+    else:
+        lines.append("- none")
+        lines.append("")
+    lines.extend(["## Warnings", ""])
+    if warnings:
+        lines.extend(render_finding(finding) for finding in warnings)
+    else:
+        lines.append("- none")
+        lines.append("")
+    lines.extend(["## Conflicts", ""])
+    if conflicts:
+        for conflict in conflicts:
+            lines.append(
+                f"- {conflict['criterion']} — families {', '.join(conflict['families'])}; "
+                f"severities {', '.join(conflict['severities'])}"
+            )
+        lines.append("")
+    else:
+        lines.append("- none")
+        lines.append("")
+    lines.extend(["## By family", ""])
+    for artifact in artifacts:
+        lines.append(artifact["text"].rstrip())
+        lines.append("")
+    output.parent.mkdir(parents=True, exist_ok=True)
+    output.write_text("\n".join(lines).rstrip() + "\n", encoding="utf-8")
+    return {
+        "output": str(output.resolve()),
+        "families": families,
+        "actionable": len(action),
+        "warnings": len(warnings),
+        "conflicts": len(conflicts),
+    }
+def emit(payload: dict) -> int:
+    json.dump(payload, sys.stdout, indent=2, sort_keys=True)
+    sys.stdout.write("\n")
+    return 0
+def parser() -> argparse.ArgumentParser:
+    result = argparse.ArgumentParser(description=__doc__)
+    result.add_argument(
+        "command", choices=("parse", "resolve", "families", "merge", "validate-plan")
+    )
+    result.add_argument("--plan", type=Path)
+    result.add_argument("--intent", type=Path)
+    result.add_argument("--charter", type=Path)
+    result.add_argument("--advertised", default="")
+    result.add_argument("--parent-family")
+    result.add_argument("--parent-slug")
+    result.add_argument("--exclude-family", action="append", choices=KNOWN_FAMILIES, default=[])
+    result.add_argument("--kind", choices=("plan", "wave"))
+    result.add_argument("--inputs", default="")
+    result.add_argument("--output", type=Path)
+    result.add_argument("--wave")
+    result.add_argument("--cycle")
+    result.add_argument("--mode")
+    return result
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    arguments = parser().parse_args(argv)
+    try:
+        if arguments.command == "families":
+            grouped = group_advertised(split_csv(arguments.advertised))
+            return emit(
+                {
+                    "families": {
+                        family: {"slugs": slugs, "latest": latest_slug(slugs)}
+                        for family, slugs in grouped.items()
+                    }
+                }
+            )
+        if arguments.command == "merge":
+            if arguments.kind is None or arguments.output is None:
+                raise ReviewPanelError("merge requires --kind and --output")
+            inputs = [Path(part) for part in split_csv(arguments.inputs)]
+            if not inputs:
+                raise ReviewPanelError("merge requires --inputs")
+            header = []
+            if arguments.mode:
+                header.append(("Mode", arguments.mode))
+            if arguments.kind == "wave":
+                if not arguments.wave or not arguments.cycle:
+                    raise ReviewPanelError("wave merge requires --wave and --cycle")
+                header.extend(
+                    (("Wave", arguments.wave), ("Cycle", arguments.cycle))
+                )
+            return emit(merge_artifacts(arguments.kind, inputs, arguments.output, header))
+        if arguments.plan is None and arguments.command in {"parse", "resolve", "validate-plan"}:
+            if arguments.command != "parse" or (
+                arguments.intent is None and arguments.charter is None
+            ):
+                raise ReviewPanelError(
+                    f"{arguments.command} requires --plan, --intent, or --charter"
+                )
+        config = parse_files(arguments.plan, arguments.intent, arguments.charter)
+        if arguments.command in {"parse", "validate-plan"}:
+            return emit(config)
+        resolved = resolve_panel(
+            config,
+            split_csv(arguments.advertised),
+            arguments.parent_family,
+            arguments.parent_slug,
+            arguments.exclude_family,
+        )
+        return emit(resolved)
+    except ReviewPanelError as error:
+        json.dump({"status": "error", "error": str(error)}, sys.stdout, indent=2)
+        sys.stdout.write("\n")
+        return 2
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/gsd-path-plan/SKILL.md CHANGED Viewed

@@ -3,6 +3,8 @@ name: gsd-path-plan
 description: Create and validate dependency-ordered GSD Path build waves and complete task contracts. Use only when the user explicitly invokes $gsd-path-plan or an active $gsd-path router explicitly routes to this phase.
 ---
+Before executing project helpers, read [runtime selection](references/runtime-selection.md).
 # GSD Path Planning Phase
 Dispatch one planner, gate its artifacts, and obtain the single approval that
@@ -29,8 +31,11 @@ Before dispatch, enter from `decide/done` or `define/done` with
 `--set-phase plan --set-status active`, and event `planning started`. Resume
 `plan/blocked` through the same helper with event `planning resumed`. Require
 the returned track state to be `plan/active`; never edit STATE directly.
-Any later phase blocks instead of replacing an approved plan. Patch mode is
-the only reopen exception: require an approved plan, no in-progress task, and
+For a blocked build, use the [build recovery contract](references/build-recovery.md).
+The runtime's `build-repair` mode owns structural changes to the remaining task
+inventory and the normal approval checkpoint; it is distinct from append-only
+patch mode. Otherwise later phases block instead of replacing an approved plan.
+Patch mode requires an approved plan, no in-progress task, and
 state `plan/done` or `ship/blocked`; any other state blocks. `build/done` is
 reserved exclusively for the build orchestrator's transition recovery and
 must return there instead of reopening planning. When an active router
@@ -74,10 +79,17 @@ router supplied lookahead mode. Every per-milestone path below, including
 review-panel evidence, is rooted there. Program inputs remain at `.project/`
 as stated in Lookahead mode.
-1. Read the local [plan template](templates/plan.md), [task template](templates/task.md),
-   [plan-panel template](templates/plan-panel.md), `scripts/check_handoffs.py`,
-   and `scripts/review_panel.py`; resolve them to absolute paths.
-2. Read the local [planner role](references/planner.md), then follow the
+1. Resolve the local [plan template](templates/plan.md), [task template](templates/task.md),
+   `scripts/check_handoffs.py`, and `scripts/review_panel.py` to absolute paths.
+   Quick mode reads the plan and task templates because the parent writes
+   those artifacts. Other modes pass their paths to the planner. Execute the
+   helpers through the commands below and consume their results; their Python
+   source is not planning input. Read helper source only when diagnosing a
+   concrete failure that the returned error and documented recovery cannot
+   explain.
+2. In quick mode, skip planner dispatch and follow Quick mode below; do not
+   load the planner role or dispatch contract. In other modes, resolve the
+   local [planner role](references/planner.md) for the child, then follow the
    local [runtime dispatch contract](references/dispatch.md) with deterministic
    logical task name `plan`. Give it absolute role, `AGENTS.md`, `WORKFLOW.md`,
    input, template, and output paths, including `.project/LESSONS.md` when it
@@ -133,7 +145,7 @@ as stated in Lookahead mode.
    - Require a `Review depth` value (`full`, `deep`, or `verify-only`) on
      every wave. Wave 1 and any wave touching authentication, authorization,
      payments, data migration, or concurrency requires `full` or `deep`;
-     quick-lane single waves may use `verify-only`. The planner assigns `deep`
+     this includes quick-lane single waves. The planner assigns `deep`
      sparingly to waves where a wrong merge is irreversible or
      security-critical.
    - When INTENT.md `Surfaces:` is not `none`, require a PLAN.md
@@ -199,11 +211,13 @@ as stated in Lookahead mode.
    - `status: error` or exit 2 — use the same guarded transition to set
      `plan/blocked` with an event naming the helper error, link PLAN.md, and stop.
      A named family that is not advertised is an assertion failure.
-   - `status: ready` — for each selected family, spawn one independent child
+   - `status: ready` — resolve the local
+     [plan-panel template](templates/plan-panel.md) for the reviewers; other
+     statuses do not load this template. For each selected family, spawn one independent child
      with logical task name `review_plan_panel_<family>`, the reviewer role
      in plan-panel mode, the plan-panel template, and the exact helper-returned
-     model slug when the host advertises model selection. Never override the
-     model on the planner. Each child stages its family file under a
+     model slug through the dispatch model-policy contract. Planner choices
+     use that same contract. Each child stages its family file under a
      disposable root; the parent validates and copies those files, removes
      any stale `<track>/review/PLAN-PANEL.skipped.json`, then runs
      `python3 <absolute review_panel.py> merge --kind plan --inputs <family
@@ -257,12 +271,8 @@ as stated in Lookahead mode.
    (event `patch plan approved`) without a plan checkpoint because build's
    patch re-entry commits the artifacts with its `build/active` transition.
    `pipeline_state.py transition` never approves a plan. Confirm approval,
-   link PLAN.md again, and state that
-   build starts next. Do not add another approval gate. When routed by an
-   active `$gsd-path`, return control to that router so its bundled build
-   contract starts. When invoked directly, stop and tell the user to explicitly
-   invoke `$gsd-path`, which routes to build; do not invoke an explicit-only
-   sibling skill yourself.
+   link PLAN.md again, and use the executable phase handoff in AGENTS.md.
+   The plan approval also authorizes build; do not add another approval gate.
 ## Ordering rules
@@ -273,8 +283,8 @@ as stated in Lookahead mode.
 ## Quick mode
 Legal entry: `define/done` where INTENT.md records `Lane: quick` (transition
-to `plan/active`, logging that research and decide were skipped for the
-quick lane). Quick mode dispatches no planner agent — the orchestrator writes
+to `plan/active` using exactly the Preconditions event `planning started`;
+record the skipped research and decide phases in the synthesis). Quick mode dispatches no planner agent — the orchestrator writes
 the artifacts directly:
 1. Write `.project/research/SYNTHESIS.md` containing only `## Settled` lines
@@ -282,7 +292,7 @@ the artifacts directly:
    plus a minimal `## For the planner` naming the walking skeleton. No
    invented decisions or runner-ups.
 2. Write `.project/plan/PLAN.md` with exactly one wave — `Review depth:
-   verify-only` permitted — and at most two deliverable-sized task files
+   full` or `deep` — and at most two deliverable-sized task files
    (project policy),
    honoring every task-contract rule above and `.project/LESSONS.md` when it
    exists. Write `review_panel: off` and `finding_skeptics: off` regardless