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

@opengsd/gsd-path 1.0.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 (398) hide show

package/AGENTS.md +397 -0
package/DOCS.md +341 -0
package/FULL.md +475 -0
package/GUIDE.md +23 -0
package/HOOKS.md +273 -0
package/LICENSE +21 -0
package/MIGRATE.md +100 -0
package/QUICK.md +146 -0
package/README.md +280 -0
package/RUNTIME.md +229 -0
package/UPDATE.md +196 -0
package/WORKFLOW.md +683 -0
package/package.json +80 -0
package/platforms/claude/dispatch.md +63 -0
package/platforms/copilot/dispatch.md +61 -0
package/platforms/cursor/agent.md +17 -0
package/platforms/cursor/dispatch.md +63 -0
package/platforms/grok/dispatch.md +61 -0
package/platforms/kimi/dispatch.md +64 -0
package/platforms/kiro/dispatch.md +58 -0
package/platforms/opencode/dispatch.md +62 -0
package/platforms/qwen/dispatch.md +60 -0
package/platforms/shared-agents/dispatch.md +131 -0
package/plugin.json +14 -0
package/scripts/_common.py +180 -0
package/scripts/archive_milestone.py +2265 -0
package/scripts/bootstrap_repository.py +710 -0
package/scripts/build_state.py +854 -0
package/scripts/check_docs_audit.py +463 -0
package/scripts/check_handoffs.py +1855 -0
package/scripts/check_task_briefs.py +376 -0
package/scripts/check_update.py +93 -0
package/scripts/core_hook_gate.py +34 -0
package/scripts/core_hook_settings.py +119 -0
package/scripts/detect_project.py +1517 -0
package/scripts/discussion_records.py +619 -0
package/scripts/discussion_validate.py +1321 -0
package/scripts/dispatch_driver.py +1812 -0
package/scripts/git_guard.py +759 -0
package/scripts/guard_hook.py +2124 -0
package/scripts/install.mjs +3239 -0
package/scripts/install.py +3008 -0
package/scripts/integration.py +1433 -0
package/scripts/isolation.py +3538 -0
package/scripts/lean_verification.py +256 -0
package/scripts/loop_run.py +837 -0
package/scripts/migrate_core.py +169 -0
package/scripts/pipeline_diagnose.py +715 -0
package/scripts/pipeline_git.py +940 -0
package/scripts/pipeline_state.py +2291 -0
package/scripts/pipeline_undo.py +1039 -0
package/scripts/promote_lookahead.py +415 -0
package/scripts/review_findings.py +714 -0
package/scripts/review_panel.py +553 -0
package/scripts/skill-resources.json +340 -0
package/scripts/state_checkpoint.py +1039 -0
package/scripts/state_promote.py +743 -0
package/scripts/status_runtime.py +122 -0
package/scripts/sync_skill_resources.py +259 -0
package/scripts/token_budget.py +146 -0
package/scripts/wizard.mjs +179 -0
package/scripts/workflow_run.py +117 -0
package/skills/gsd-path/BUILD.md +700 -0
package/skills/gsd-path/DECIDE.md +115 -0
package/skills/gsd-path/DEFINE.md +297 -0
package/skills/gsd-path/DOCS-AUDIT.md +190 -0
package/skills/gsd-path/INSPECT.md +167 -0
package/skills/gsd-path/PLAN.md +411 -0
package/skills/gsd-path/RESEARCH.md +159 -0
package/skills/gsd-path/ROADMAP.md +215 -0
package/skills/gsd-path/SHIP.md +412 -0
package/skills/gsd-path/SKILL.md +471 -0
package/skills/gsd-path/agents/openai.yaml +6 -0
package/skills/gsd-path/references/codebase-mapper.md +52 -0
package/skills/gsd-path/references/coder.md +90 -0
package/skills/gsd-path/references/decider.md +36 -0
package/skills/gsd-path/references/dispatch.md +131 -0
package/skills/gsd-path/references/docs-auditor.md +60 -0
package/skills/gsd-path/references/planner.md +104 -0
package/skills/gsd-path/references/researcher.md +42 -0
package/skills/gsd-path/references/reviewer.md +188 -0
package/skills/gsd-path/references/roadmapper.md +48 -0
package/skills/gsd-path/scripts/_common.py +180 -0
package/skills/gsd-path/scripts/archive_milestone.py +2265 -0
package/skills/gsd-path/scripts/bootstrap_repository.py +710 -0
package/skills/gsd-path/scripts/build_state.py +854 -0
package/skills/gsd-path/scripts/check_docs_audit.py +463 -0
package/skills/gsd-path/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path/scripts/check_update.py +93 -0
package/skills/gsd-path/scripts/detect_project.py +1517 -0
package/skills/gsd-path/scripts/discussion_records.py +619 -0
package/skills/gsd-path/scripts/discussion_validate.py +1321 -0
package/skills/gsd-path/scripts/dispatch_driver.py +1812 -0
package/skills/gsd-path/scripts/integration.py +1433 -0
package/skills/gsd-path/scripts/isolation.py +3538 -0
package/skills/gsd-path/scripts/lean_verification.py +256 -0
package/skills/gsd-path/scripts/loop_run.py +837 -0
package/skills/gsd-path/scripts/pipeline_git.py +940 -0
package/skills/gsd-path/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path/scripts/promote_lookahead.py +415 -0
package/skills/gsd-path/scripts/review_findings.py +714 -0
package/skills/gsd-path/scripts/review_panel.py +553 -0
package/skills/gsd-path/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path/scripts/state_promote.py +743 -0
package/skills/gsd-path/scripts/token_budget.py +146 -0
package/skills/gsd-path/scripts/workflow_run.py +117 -0
package/skills/gsd-path/templates/answers.md +29 -0
package/skills/gsd-path/templates/archive-manifest.md +37 -0
package/skills/gsd-path/templates/charter.md +50 -0
package/skills/gsd-path/templates/codebase.md +46 -0
package/skills/gsd-path/templates/dialogue.md +21 -0
package/skills/gsd-path/templates/docs-audit.md +69 -0
package/skills/gsd-path/templates/evidence.md +24 -0
package/skills/gsd-path/templates/final-review.md +27 -0
package/skills/gsd-path/templates/gap-review.md +20 -0
package/skills/gsd-path/templates/intent.md +98 -0
package/skills/gsd-path/templates/loop.md +59 -0
package/skills/gsd-path/templates/patch-findings.md +16 -0
package/skills/gsd-path/templates/plan-panel.md +25 -0
package/skills/gsd-path/templates/plan.md +89 -0
package/skills/gsd-path/templates/repository.md +16 -0
package/skills/gsd-path/templates/research-handoff.md +25 -0
package/skills/gsd-path/templates/roadmap.md +38 -0
package/skills/gsd-path/templates/skeptic.md +36 -0
package/skills/gsd-path/templates/state.md +27 -0
package/skills/gsd-path/templates/synthesis.md +36 -0
package/skills/gsd-path/templates/task.md +74 -0
package/skills/gsd-path/templates/wave-panel.md +25 -0
package/skills/gsd-path/templates/wave-review.md +64 -0
package/skills/gsd-path-build/SKILL.md +700 -0
package/skills/gsd-path-build/agents/openai.yaml +6 -0
package/skills/gsd-path-build/references/coder.md +90 -0
package/skills/gsd-path-build/references/dispatch.md +131 -0
package/skills/gsd-path-build/references/reviewer.md +188 -0
package/skills/gsd-path-build/scripts/_common.py +180 -0
package/skills/gsd-path-build/scripts/archive_milestone.py +2265 -0
package/skills/gsd-path-build/scripts/build_state.py +854 -0
package/skills/gsd-path-build/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-build/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-build/scripts/discussion_records.py +619 -0
package/skills/gsd-path-build/scripts/discussion_validate.py +1321 -0
package/skills/gsd-path-build/scripts/dispatch_driver.py +1812 -0
package/skills/gsd-path-build/scripts/integration.py +1433 -0
package/skills/gsd-path-build/scripts/isolation.py +3538 -0
package/skills/gsd-path-build/scripts/loop_run.py +837 -0
package/skills/gsd-path-build/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-build/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-build/scripts/review_findings.py +714 -0
package/skills/gsd-path-build/scripts/review_panel.py +553 -0
package/skills/gsd-path-build/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-build/scripts/state_promote.py +743 -0
package/skills/gsd-path-build/scripts/token_budget.py +146 -0
package/skills/gsd-path-build/scripts/workflow_run.py +117 -0
package/skills/gsd-path-build/templates/skeptic.md +36 -0
package/skills/gsd-path-build/templates/task.md +74 -0
package/skills/gsd-path-build/templates/wave-panel.md +25 -0
package/skills/gsd-path-build/templates/wave-review.md +64 -0
package/skills/gsd-path-decide/SKILL.md +115 -0
package/skills/gsd-path-decide/agents/openai.yaml +6 -0
package/skills/gsd-path-decide/references/decider.md +36 -0
package/skills/gsd-path-decide/references/dispatch.md +131 -0
package/skills/gsd-path-decide/scripts/_common.py +180 -0
package/skills/gsd-path-decide/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-decide/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-decide/scripts/discussion_records.py +619 -0
package/skills/gsd-path-decide/scripts/isolation.py +3538 -0
package/skills/gsd-path-decide/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-decide/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-decide/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-decide/scripts/state_promote.py +743 -0
package/skills/gsd-path-decide/templates/synthesis.md +36 -0
package/skills/gsd-path-define/SKILL.md +297 -0
package/skills/gsd-path-define/agents/openai.yaml +6 -0
package/skills/gsd-path-define/scripts/_common.py +180 -0
package/skills/gsd-path-define/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-define/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-define/scripts/detect_project.py +1517 -0
package/skills/gsd-path-define/scripts/discussion_records.py +619 -0
package/skills/gsd-path-define/scripts/isolation.py +3538 -0
package/skills/gsd-path-define/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-define/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-define/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-define/scripts/state_promote.py +743 -0
package/skills/gsd-path-define/templates/charter.md +50 -0
package/skills/gsd-path-define/templates/intent.md +98 -0
package/skills/gsd-path-define/templates/state.md +27 -0
package/skills/gsd-path-discuss/SKILL.md +162 -0
package/skills/gsd-path-discuss/agents/openai.yaml +6 -0
package/skills/gsd-path-discuss/scripts/_common.py +180 -0
package/skills/gsd-path-discuss/scripts/discussion_records.py +619 -0
package/skills/gsd-path-discuss/templates/answers.md +29 -0
package/skills/gsd-path-discuss/templates/dialogue.md +21 -0
package/skills/gsd-path-docs-audit/SKILL.md +190 -0
package/skills/gsd-path-docs-audit/agents/openai.yaml +6 -0
package/skills/gsd-path-docs-audit/references/dispatch.md +131 -0
package/skills/gsd-path-docs-audit/references/docs-auditor.md +60 -0
package/skills/gsd-path-docs-audit/scripts/_common.py +180 -0
package/skills/gsd-path-docs-audit/scripts/check_docs_audit.py +463 -0
package/skills/gsd-path-docs-audit/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-docs-audit/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-docs-audit/scripts/discussion_records.py +619 -0
package/skills/gsd-path-docs-audit/scripts/isolation.py +3538 -0
package/skills/gsd-path-docs-audit/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-docs-audit/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-docs-audit/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-docs-audit/scripts/state_promote.py +743 -0
package/skills/gsd-path-docs-audit/templates/docs-audit.md +69 -0
package/skills/gsd-path-forensics/SKILL.md +39 -0
package/skills/gsd-path-forensics/agents/openai.yaml +6 -0
package/skills/gsd-path-forensics/scripts/_common.py +180 -0
package/skills/gsd-path-forensics/scripts/discussion_records.py +619 -0
package/skills/gsd-path-forensics/scripts/pipeline_diagnose.py +715 -0
package/skills/gsd-path-forensics/scripts/pipeline_undo.py +1039 -0
package/skills/gsd-path-inspect/SKILL.md +167 -0
package/skills/gsd-path-inspect/agents/openai.yaml +6 -0
package/skills/gsd-path-inspect/references/codebase-mapper.md +52 -0
package/skills/gsd-path-inspect/references/dispatch.md +131 -0
package/skills/gsd-path-inspect/references/docs-auditor.md +60 -0
package/skills/gsd-path-inspect/scripts/_common.py +180 -0
package/skills/gsd-path-inspect/scripts/check_docs_audit.py +463 -0
package/skills/gsd-path-inspect/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-inspect/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-inspect/scripts/detect_project.py +1517 -0
package/skills/gsd-path-inspect/scripts/discussion_records.py +619 -0
package/skills/gsd-path-inspect/scripts/isolation.py +3538 -0
package/skills/gsd-path-inspect/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-inspect/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-inspect/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-inspect/scripts/state_promote.py +743 -0
package/skills/gsd-path-inspect/templates/codebase.md +46 -0
package/skills/gsd-path-inspect/templates/docs-audit.md +69 -0
package/skills/gsd-path-inspect/templates/state.md +27 -0
package/skills/gsd-path-loop/SKILL.md +98 -0
package/skills/gsd-path-loop/agents/openai.yaml +6 -0
package/skills/gsd-path-loop/examples/ci-repair.LOOP.md +61 -0
package/skills/gsd-path-loop/scripts/_common.py +180 -0
package/skills/gsd-path-loop/scripts/discussion_records.py +619 -0
package/skills/gsd-path-loop/scripts/loop_run.py +837 -0
package/skills/gsd-path-loop/templates/loop.md +59 -0
package/skills/gsd-path-migrate/SKILL.md +134 -0
package/skills/gsd-path-migrate/agents/openai.yaml +6 -0
package/skills/gsd-path-migrate/scripts/core_hook_gate.py +34 -0
package/skills/gsd-path-migrate/scripts/core_hook_settings.py +119 -0
package/skills/gsd-path-migrate/scripts/discussion_records.py +619 -0
package/skills/gsd-path-migrate/scripts/migrate_core.py +169 -0
package/skills/gsd-path-plan/SKILL.md +411 -0
package/skills/gsd-path-plan/agents/openai.yaml +6 -0
package/skills/gsd-path-plan/references/dispatch.md +131 -0
package/skills/gsd-path-plan/references/planner.md +104 -0
package/skills/gsd-path-plan/scripts/_common.py +180 -0
package/skills/gsd-path-plan/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-plan/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-plan/scripts/discussion_records.py +619 -0
package/skills/gsd-path-plan/scripts/isolation.py +3538 -0
package/skills/gsd-path-plan/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-plan/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-plan/scripts/review_panel.py +553 -0
package/skills/gsd-path-plan/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-plan/scripts/state_promote.py +743 -0
package/skills/gsd-path-plan/scripts/workflow_run.py +117 -0
package/skills/gsd-path-plan/templates/patch-findings.md +16 -0
package/skills/gsd-path-plan/templates/plan-panel.md +25 -0
package/skills/gsd-path-plan/templates/plan.md +89 -0
package/skills/gsd-path-plan/templates/task.md +74 -0
package/skills/gsd-path-research/SKILL.md +159 -0
package/skills/gsd-path-research/agents/openai.yaml +6 -0
package/skills/gsd-path-research/references/dispatch.md +131 -0
package/skills/gsd-path-research/references/researcher.md +42 -0
package/skills/gsd-path-research/scripts/_common.py +180 -0
package/skills/gsd-path-research/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-research/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-research/scripts/discussion_records.py +619 -0
package/skills/gsd-path-research/scripts/isolation.py +3538 -0
package/skills/gsd-path-research/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-research/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-research/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-research/scripts/state_promote.py +743 -0
package/skills/gsd-path-research/templates/evidence.md +24 -0
package/skills/gsd-path-research/templates/research-handoff.md +25 -0
package/skills/gsd-path-roadmap/SKILL.md +215 -0
package/skills/gsd-path-roadmap/agents/openai.yaml +6 -0
package/skills/gsd-path-roadmap/references/dispatch.md +131 -0
package/skills/gsd-path-roadmap/references/roadmapper.md +48 -0
package/skills/gsd-path-roadmap/scripts/_common.py +180 -0
package/skills/gsd-path-roadmap/scripts/archive_milestone.py +2265 -0
package/skills/gsd-path-roadmap/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-roadmap/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-roadmap/scripts/detect_project.py +1517 -0
package/skills/gsd-path-roadmap/scripts/discussion_records.py +619 -0
package/skills/gsd-path-roadmap/scripts/discussion_validate.py +1321 -0
package/skills/gsd-path-roadmap/scripts/integration.py +1433 -0
package/skills/gsd-path-roadmap/scripts/isolation.py +3538 -0
package/skills/gsd-path-roadmap/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-roadmap/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-roadmap/scripts/promote_lookahead.py +415 -0
package/skills/gsd-path-roadmap/scripts/review_panel.py +553 -0
package/skills/gsd-path-roadmap/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-roadmap/scripts/state_promote.py +743 -0
package/skills/gsd-path-roadmap/templates/roadmap.md +38 -0
package/skills/gsd-path-ship/SKILL.md +412 -0
package/skills/gsd-path-ship/agents/openai.yaml +6 -0
package/skills/gsd-path-ship/references/dispatch.md +131 -0
package/skills/gsd-path-ship/references/reviewer.md +188 -0
package/skills/gsd-path-ship/scripts/_common.py +180 -0
package/skills/gsd-path-ship/scripts/archive_milestone.py +2265 -0
package/skills/gsd-path-ship/scripts/build_state.py +854 -0
package/skills/gsd-path-ship/scripts/check_handoffs.py +1855 -0
package/skills/gsd-path-ship/scripts/check_task_briefs.py +376 -0
package/skills/gsd-path-ship/scripts/discussion_records.py +619 -0
package/skills/gsd-path-ship/scripts/discussion_validate.py +1321 -0
package/skills/gsd-path-ship/scripts/integration.py +1433 -0
package/skills/gsd-path-ship/scripts/isolation.py +3538 -0
package/skills/gsd-path-ship/scripts/lean_verification.py +256 -0
package/skills/gsd-path-ship/scripts/pipeline_git.py +940 -0
package/skills/gsd-path-ship/scripts/pipeline_state.py +2291 -0
package/skills/gsd-path-ship/scripts/review_panel.py +553 -0
package/skills/gsd-path-ship/scripts/state_checkpoint.py +1039 -0
package/skills/gsd-path-ship/scripts/state_promote.py +743 -0
package/skills/gsd-path-ship/scripts/workflow_run.py +117 -0
package/skills/gsd-path-ship/templates/archive-manifest.md +37 -0
package/skills/gsd-path-ship/templates/final-review.md +27 -0
package/skills/gsd-path-ship/templates/gap-review.md +20 -0
package/skills/gsd-path-ship/templates/patch-findings.md +16 -0
package/skills/gsd-path-ship/templates/wave-review.md +64 -0
package/skills/gsd-path-undo/SKILL.md +45 -0
package/skills/gsd-path-undo/agents/openai.yaml +6 -0
package/skills/gsd-path-undo/scripts/_common.py +180 -0
package/skills/gsd-path-undo/scripts/discussion_records.py +619 -0
package/skills/gsd-path-undo/scripts/pipeline_undo.py +1039 -0
package/skills/path/BUILD.md +700 -0
package/skills/path/DECIDE.md +115 -0
package/skills/path/DEFINE.md +297 -0
package/skills/path/DOCS-AUDIT.md +190 -0
package/skills/path/INSPECT.md +167 -0
package/skills/path/PLAN.md +411 -0
package/skills/path/RESEARCH.md +159 -0
package/skills/path/ROADMAP.md +215 -0
package/skills/path/SHIP.md +412 -0
package/skills/path/SKILL.md +471 -0
package/skills/path/agents/openai.yaml +6 -0
package/skills/path/references/codebase-mapper.md +52 -0
package/skills/path/references/coder.md +90 -0
package/skills/path/references/decider.md +36 -0
package/skills/path/references/dispatch.md +131 -0
package/skills/path/references/docs-auditor.md +60 -0
package/skills/path/references/planner.md +104 -0
package/skills/path/references/researcher.md +42 -0
package/skills/path/references/reviewer.md +188 -0
package/skills/path/references/roadmapper.md +48 -0
package/skills/path/scripts/_common.py +180 -0
package/skills/path/scripts/archive_milestone.py +2265 -0
package/skills/path/scripts/bootstrap_repository.py +710 -0
package/skills/path/scripts/build_state.py +854 -0
package/skills/path/scripts/check_docs_audit.py +463 -0
package/skills/path/scripts/check_handoffs.py +1855 -0
package/skills/path/scripts/check_task_briefs.py +376 -0
package/skills/path/scripts/check_update.py +93 -0
package/skills/path/scripts/detect_project.py +1517 -0
package/skills/path/scripts/discussion_records.py +619 -0
package/skills/path/scripts/discussion_validate.py +1321 -0
package/skills/path/scripts/dispatch_driver.py +1812 -0
package/skills/path/scripts/integration.py +1433 -0
package/skills/path/scripts/isolation.py +3538 -0
package/skills/path/scripts/lean_verification.py +256 -0
package/skills/path/scripts/loop_run.py +837 -0
package/skills/path/scripts/pipeline_git.py +940 -0
package/skills/path/scripts/pipeline_state.py +2291 -0
package/skills/path/scripts/promote_lookahead.py +415 -0
package/skills/path/scripts/review_findings.py +714 -0
package/skills/path/scripts/review_panel.py +553 -0
package/skills/path/scripts/state_checkpoint.py +1039 -0
package/skills/path/scripts/state_promote.py +743 -0
package/skills/path/scripts/token_budget.py +146 -0
package/skills/path/scripts/workflow_run.py +117 -0
package/skills/path/templates/answers.md +29 -0
package/skills/path/templates/archive-manifest.md +37 -0
package/skills/path/templates/charter.md +50 -0
package/skills/path/templates/codebase.md +46 -0
package/skills/path/templates/dialogue.md +21 -0
package/skills/path/templates/docs-audit.md +69 -0
package/skills/path/templates/evidence.md +24 -0
package/skills/path/templates/final-review.md +27 -0
package/skills/path/templates/gap-review.md +20 -0
package/skills/path/templates/intent.md +98 -0
package/skills/path/templates/loop.md +59 -0
package/skills/path/templates/patch-findings.md +16 -0
package/skills/path/templates/plan-panel.md +25 -0
package/skills/path/templates/plan.md +89 -0
package/skills/path/templates/repository.md +16 -0
package/skills/path/templates/research-handoff.md +25 -0
package/skills/path/templates/roadmap.md +38 -0
package/skills/path/templates/skeptic.md +36 -0
package/skills/path/templates/state.md +27 -0
package/skills/path/templates/synthesis.md +36 -0
package/skills/path/templates/task.md +74 -0
package/skills/path/templates/wave-panel.md +25 -0
package/skills/path/templates/wave-review.md +64 -0

package/skills/gsd-path-docs-audit/SKILL.md ADDED Viewed

@@ -0,0 +1,190 @@
+---
+name: gsd-path-docs-audit
+description: Verify Markdown claims against the actual code, commands, and GSD Path artifacts. Use only when the user explicitly invokes $gsd-path-docs-audit or an active $gsd-path router explicitly routes to this phase.
+---
+# GSD Path Docs Audit
+Answer one question with evidence: **does the project do what its documents
+say it does?** Runs standalone at the safe checkpoints below, and as half of
+`$gsd-path-inspect`. Output: `.project/research/DOCS-AUDIT.md`.
+Routing instructions below are caller handoffs under the AGENTS.md handoff
+rule; never invoke an explicit-only sibling skill yourself.
+Before audit work and again before completion, apply the AGENTS.md
+pending-answer rule with the bundled `scripts/discussion_records.py`; a
+follow-up owned by docs audit is resolved in DOCS-AUDIT.md, or the phase
+blocks.
+Require an existing `.project/STATE.md` that passes `python3 <absolute
+pipeline_state.py> validate --repo <absolute root>`; never
+create pipeline state or write into an unowned `.project/`. A missing state
+stops and offers explicit `$gsd-path` initialization; do not invoke it
+automatically. A different marker blocks and reports ownership without writing.
+Embedded inspect mode is legal only at `inspect/active|blocked`.
+Standalone mode is legal only at a stable pre-build boundary
+`inspect|define|research|decide|roadmap|plan` with `status: done`, or at
+`ship/blocked` with no in-progress task. `build/*`, `ship/active`,
+`shipped/done`, and every other state block: changing the canonical audit there
+would dirty execution, invalidate review, or mutate shipped history.
+## Process
+1. Before writing the output, freeze the helper's exact stdout from `python3
+   <absolute check_docs_audit.py> --repo <absolute root> --emit-inventory`
+   (add `--alignment` in alignment mode) in a temporary file. Before any
+   rewrite, preserve an existing canonical audit in a separate temporary file
+   and record its SHA-256. When that audit records an `Audited HEAD` that Git
+   resolves as an ancestor of HEAD, also freeze the changed set — `git -c
+   core.quotePath=false diff --name-only --no-renames <prior HEAD>` plus
+   `git -c core.quotePath=false ls-files --others --exclude-standard`, one
+   path per line — in a temporary file; otherwise there is no changed set and
+   the auditor re-verifies every claim. The frozen inventory and
+   changed set travel inside the dispatch brief and
+   the gate below; never persist them as `.project/` sidecar files — the
+   audit's own path records are the durable copy. If a previous run left an
+   inventory sidecar under `.project/research/`, the orchestrator deletes it
+   when transferring the new audit — a leftover sidecar blocks the archive
+   transaction. Dispatch one docs auditor with deterministic logical task
+   name `docs_audit`, following the local
+   [runtime dispatch contract](references/dispatch.md): local role
+   [docs-auditor](references/docs-auditor.md), template
+   [docs-audit](templates/docs-audit.md), absolute repo root, exact frozen
+   inventory, the changed set when one exists, alignment flag, prior audit as
+   carry-forward input, and output
+   `.project/research/DOCS-AUDIT.md`. When Git has a resolvable HEAD and no
+   non-`.project` worktree changes, the orchestrator creates a verify sidecar
+   with `python3 <absolute isolation.py> isolate-verify --repo <absolute
+   primary> --base <HEAD> --name docs-audit` for project commands. The auditor
+   writes only its assigned output under that sidecar. Gate it there before
+   collection. Then run `python3 <absolute isolation.py> collect-artifact
+   --repo <absolute primary> --source <returned worktree> --base <recorded
+   HEAD> --branch <returned branch> --source-path
+   .project/research/DOCS-AUDIT.md --destination-path
+   .project/research/DOCS-AUDIT.md`, adding `--expected-destination <recorded
+   prior SHA-256>` when a prior audit existed. Require the returned base,
+   branch, source, and destination to match; then non-force retire that exact
+   worktree and branch with `isolation.py retire`. A corrected redispatch is
+   gated before collection and uses the same expected prior hash. Otherwise no
+   project command may run. The dispatch brief carries current HEAD as the
+   audit baseline only when that verify sidecar was created at HEAD; otherwise
+   it carries `none`. The auditor writes that baseline as `Audited HEAD`.
+2. Gate the artifact with the bundled helper: write the frozen inventory to
+   a temporary file (one path per line) and run
+   `python3 <absolute check_docs_audit.py> --repo <docs sidecar> --inventory
+   <file> [--prior-audit <temporary prior-audit file>] [--changed <temporary
+   changed-set file>]`.
+   It enforces the contract — every doc with at least one testable claim has
+   a claims table, every claim a valid type and verdict with evidence, every
+   claimless doc appears once in the `## Descriptive docs` list, the section
+   paths and that list are disjoint and together equal the frozen inventory
+   exactly, the Summary counts match the rows, the remediation queue
+   classifies every non-verified claim, every prior User-ruling row and
+   Planned value survives in order, and every `unchanged:` row satisfies
+   the Delta rule below. A non-zero exit names the failed
+   rule. Redispatch one complete corrected brief under logical task name
+   `docs_audit`, following the runtime dispatch contract. If it still fails,
+   present **Outcome** with the failed gate, **Review** linking DOCS-AUDIT.md or
+   STATE.md when it is missing, and **Next** naming the required correction.
+3. Report to the user: verdict counts, the drift list (stale + aspirational
+   claims), and the remediation queue. Link the resolved absolute
+   `.project/research/DOCS-AUDIT.md` path before asking for any ruling. Do not
+   fix anything in this skill.
+4. **Collect rulings** (standalone runs; during `$gsd-path-inspect` define
+   owns this). Walk the remediation queue with the user — batches of three,
+   an interactive input tool when available. Present the auditor's
+   classification as the first option marked `(recommended)` with its
+   recorded evidence as the one-line reason; a `NEEDS-USER` item where the
+   auditor cannot tell which side is wrong carries no recommendation, stated
+   as such. Each item gets one ruling:
+   - `fix-code` — the doc is the contract; the code must catch up
+   - `fix-doc` — reality is right; the doc must be corrected
+   - `accept-drift` — known and tolerated; recorded so the next audit
+     doesn't resurface it
+   Append every ruling to DOCS-AUDIT.md under `## User rulings`, verbatim.
+   A ruling that contradicts an INTENT.md veto stops the walk — the veto
+   wins until the user amends INTENT.md itself.
+5. **Queue, don't execute.** Every `fix-code` and `fix-doc` ruling enters
+   the alignment queue: its `## User rulings` row is marked
+   `planned: no`. Ruling and executing are separate decisions — the user
+   may not be ready to work the backlog. Close by offering once: plan the
+   patch wave now, or hold. If an active `$gsd-path` routed this audit and the
+   user chooses now, return control with DOCS-AUDIT.md as the patch findings
+   source. When invoked directly, do not invoke an explicit-only sibling;
+   tell a user who chooses now to explicitly invoke `$gsd-path`, which will
+   offer the queued source to plan. On hold — the default — report the queue
+   size and that `$gsd-path` will offer alignment until the
+   queue is drained. Only `accept-drift` rulings → nothing queued, done.
+   After the choice, link the updated DOCS-AUDIT.md and state whether planning
+   starts now or the queue remains for a later router pass.
+## The verification methodology
+The auditor follows this checklist for every doc; the audit file is the
+filled-in checklist, so the method and the artifact stay one thing.
+**Inventory.** Every `.md` in the repo (root, `docs/`, nested), plus
+`.project/` artifacts when present. Excluded: `node_modules`, build output,
+vendored code, `.project/archive/`, and the output audit itself — archives are
+read-only history and are never audited. The orchestrator freezes this list
+before dispatch; the auditor uses it verbatim. Every file is accounted for —
+a doc with no testable claims gets one line in `## Descriptive docs`, not its
+own section and not skipped. Rewriting DOCS-AUDIT.md preserves any
+existing `## User rulings` rows: rulings and `planned` markers carry forward
+verbatim, so a re-audit never wipes the alignment queue.
+**Delta.** A re-audit re-verifies only what could have moved: every doc in
+the changed set, every claim whose evidence names a changed path, every
+command claim, and every prior non-verified claim. Any other prior
+`verified` row is carried with exactly one `unchanged: ` prefix on its
+Evidence. An already-carried row is copied verbatim without adding another
+prefix. The gate rejects a carried row that fails any of those conditions.
+No recorded `Audited HEAD`, or one that is not an ancestor of HEAD, means no
+changed set and a full re-audit.
+**Extract claims.** A claim is any statement reality can contradict:
+| Claim type | Example | Check |
+|------------|---------|-------|
+| command | "run `npm test`" | run it; record exit code |
+| feature | "supports OAuth login" | find the implementing code path |
+| structure | "parsers live in `src/parse/`" | path exists and matches |
+| status | "phase 2 complete", checked box | artifact/commit/code exists |
+| config | "set `API_URL` in `.env`" | variable is actually read |
+| integration | "syncs to Linear" | client code + config present |
+**Verify.** Each claim gets checked by the cheapest sufficient method, in
+order: run the command; read the named code; run the relevant test; check
+git history. Verdicts:
+- `verified` — checked and true, evidence recorded (file:line or command + output)
+- `stale` — was plausibly true once; code has moved on
+- `aspirational` — describes something never built
+- `unverifiable` — cannot be checked from the repo (external service, credentials)
+**Alignment mode** (when `.project/` exists) — the pipeline audits itself:
+- every INTENT.md success criterion → `met` so far / `not yet` / `contradicted`
+- every task with `status: done` → `isolation.py recover` proves its landing
+  commit and its Verify command still passes
+- SYNTHESIS.md decisions → the code actually uses the decided stack/shape
+- STATE.md → agrees with task frontmatter and review files
+**Remediate.** Every non-`verified` claim lands in the remediation queue,
+classified `fix-doc` (reality is right, doc lies) or `fix-code`
+(doc is the contract, code fell short) or `NEEDS-USER` when the auditor
+cannot tell which side is wrong. The queue is input for the user's ruling —
+during inspection it feeds define; mid-project, accepted `fix-code`
+items become a patch wave through `$gsd-path-plan`.
+## Rules
+- Audit is read-only; the auditor never edits docs or code.
+- Build, test, lint, and help commands run only in an agent-specific verify
+  sidecar at a recorded clean revision. If that cannot faithfully
+  represent the claim, use static evidence or mark it `unverifiable`; never run
+  project commands in the source worktree.
+- A verdict without recorded evidence is itself a defect — the audit must
+  meet the same evidence standard it enforces.
+- Never let the auditor decide doc-vs-code conflicts; that is a user ruling.

package/skills/gsd-path-docs-audit/agents/openai.yaml ADDED Viewed

@@ -0,0 +1,6 @@
+interface:
+  display_name: "GSD Path Docs Audit"
+  short_description: "Verify docs against what the code actually does"
+  default_prompt: "Use $gsd-path-docs-audit to verify this project's documentation against the actual code."
+policy:
+  allow_implicit_invocation: false

package/skills/gsd-path-docs-audit/references/dispatch.md ADDED Viewed

@@ -0,0 +1,131 @@
+# Shared Agent Skills dispatch
+Apply this contract whenever a GSD Path skill delegates work from the shared
+`~/.agents/skills` bundle. Inspect the advertised child-agent tool schema and
+use exactly one matching branch:
+- A `spawn_agent` tool exposing `task_name`, `agent_type`, and `fork_turns` is
+  Codex. Use `fork_turns: "none"`; coders use the built-in `worker` type and
+  every other role uses `default`. Reuse a completed logical target with
+  `followup_task`. For Codex reasoning effort, use `high` for the portable
+  `heavy` tier and `low` for the portable `light` tier; leave reasoning effort
+  unset for the session-default tier, and never pass `heavy` or `light` as a
+  literal Codex value.
+- A `spawn_agent` tool without those Codex fields is Zed. Spawn one isolated,
+  full-capability child per brief. Zed children are not resumable, so retries
+  use a fresh child and a complete prompt.
+- An `invoke_subagent` tool advertising `TypeName`, `Workspace`, and `Role` is
+  Antigravity. Use `TypeName: self`, the exact supplied root as `Workspace`,
+  and the logical task name as `Role`. Keep the returned child ID and use
+  `send_message` for follow-up work when available; otherwise start a fresh
+  child with the complete prompt.
+- A `spawn_subagent` tool advertising the `general-purpose` type is Grok. Use
+  `subagent_type: general-purpose`, `capability_mode: all`, the exact supplied
+  root as `cwd`, `isolation: none`, and `background: true`. Supply the logical
+  task name as `description`, keep the returned ID, and use `resume_from` with
+  the complete new prompt for later work. Wait for a colliding active child and
+  collect results with `wait_commands_or_subagents`.
+- A `Task` tool advertising the custom `gsd-path` subagent is Cursor. Use that
+  model-inheriting, full-capability child. Resume it by returned agent ID when
+  available; otherwise retry with a fresh child and a complete prompt.
+- A `Task` tool advertising the built-in `general` subagent is OpenCode. Use
+  that child; if an installed OpenCode v2 host exposes the renamed `subagent`
+  tool instead, use its advertised schema with the built-in `general` agent.
+  Supply the logical task name as the child description. Reuse a returned
+  child-session ID only when the host advertises a resume parameter; otherwise
+  use a fresh `general` child and the complete prompt.
+- A `task` tool advertising the `general-purpose` child is GitHub Copilot CLI.
+  Use that child. Keep its returned ID for follow-up while the host exposes
+  it; otherwise retry with a fresh child and a complete prompt.
+- An `invoke_sub_agent` tool with a `general-purpose` subagent is Kiro. Use
+  that child for every role; there is no worker/default type split. Start a
+  fresh general-purpose child for every correction, retry, post-patch review,
+  repeated audit, or later milestone — Kiro subagents are not resumable and
+  disk artifacts are the source of truth. Supply the logical task name as the
+  task description. Set the child working directory to the exact repository or
+  linked-worktree root supplied by GSD Path; do not ask Kiro or the child to
+  create another worktree. Encode task dependencies explicitly; launch
+  independent children concurrently up to the host's advertised
+  concurrent-subagent capacity.
+For every branch:
+- Supply the deterministic logical task name: `inspect_codebase`,
+  `inspect_docs`, `docs_audit`, `research_<dimension>`, `decide`, `roadmap`,
+  `plan`,
+  `plan_patch`, `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>`
+  (a `deep` wave review appends the lens suffix `_contract` or
+  `_adversarial`; an optional review panel uses
+  `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an optional finding
+  skeptic uses `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or `review_gap_<number>`. Normalize variable parts to
+  lowercase ASCII and replace non-alphanumeric runs with one underscore.
+  Never add a random suffix or collide with a running logical target.
+- Resolve the phase's linked role brief to an absolute path, include it in the
+  prompt, and require the child to read it before acting. The role brief
+  supplies the read-only boundary for auditors and reviewers.
+- Tier hints: use the portable `heavy` tier for `plan`, `plan_patch`, `decide`,
+  and `roadmap`, the portable `light` tier for `inspect_docs` and `docs_audit`,
+  and the session-default tier for every other role. Apply the Codex mapping
+  above when its schema advertises reasoning-effort selection. On every other
+  host, use only an exact native equivalent advertised by that host; otherwise
+  do not override the model or reasoning effort. The only exception is a
+  review-panel child: when the host advertises model selection, pass the exact
+  slug returned by `scripts/review_panel.py resolve` for that family. Never
+  override the model on the canonical reviewer, planner, coder, or any other
+  role.
+  Host isolation: none. The child's working directory is the exact absolute
+  root GSD Path supplied; a host SHA checkout or extra worktree is a contract
+  failure. Never ask the host to create a worktree. Give the child the exact
+  repository or linked-worktree root supplied by GSD Path.
+- Send a self-contained prompt with absolute input, template, and output paths
+  plus the child's bounded responsibility. Every brief also names the absolute
+  `AGENTS.md` and `WORKFLOW.md` paths (or explicitly says they are absent), the
+  next phase that consumes the output, the gate it must satisfy, and the
+  terminal result it must return. A coder prompt also names its isolated
+  linked-worktree root; no child may infer the primary worktree.
+- The parent is the sole dispatcher and lifecycle owner. If the runtime exposes
+  structured Run/Task/Dispatch orchestration, bind one Run, create one Task per
+  independent brief with explicit dependencies, inject the brief, and wait for
+  every `worker_done`, `escalation`, or question before applying the gate.
+  Verify the task and dispatch records before reporting the work as
+  orchestrated. On runtimes without that layer, use the host adapter's
+  equivalent and preserve the same logical name, completion state,
+  timeout/cancellation, and cleanup rules; never silently delegate again from a
+  child.
+- When the structured layer exposes a blocking ask/reply channel, route a
+  coder's `NEEDS-ORCHESTRATOR` question through it as a live question with
+  the worker held alive for the reply, instead of block-and-redispatch. The
+  answer is still appended to the task Log as
+  `Orchestrator answer:` so the portable on-disk record stays complete, and a
+  timed-out or unavailable channel falls back to the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to the
+  canonical project path before removing the exact disposable root. A child
+  never writes a disposable-review output directly into the primary worktree.
+- Launch independent briefs concurrently up to the advertised child capacity,
+  batch any remainder without combining briefs, and collect every result
+  before applying the phase gate. Do not leave an active child, logical task, or
+  temporary worktree after collection; a timeout or cancellation is a blocked
+  result, not a silent success.
+- If the tool schema is ambiguous or the required full-capability child is
+  unavailable, stop and report the missing capability. Do not guess the host
+  or silently collapse an independence boundary into the main context.
+## Configured output budgets
+When the owner supplies token budgets, use the router bundle's
+`scripts/token_budget.py` with the owner's exact task and session values and
+quoted authority. Keep one ledger outside the worktree under the Git common
+directory for the full logical session; resumptions reuse it. Record completed
+parent CLI run events and each native child's session events with stable logical
+task names before the next dispatch. The helper reads host counters and refuses
+incomplete or ambiguous usage; never estimate tokens or reset the ledger.
+Run `admit` for the next task and stop dispatch on a blocked result. Preserve
+its output in the dispatch evidence. This gates observed usage only: concurrent
+or in-flight work can overrun before the host reports usage. Codex CLI has no
+advertised hard output cap; report that limitation once. If the owner requires
+hard generation enforcement, use `admit --require-hard-cap`; unsupported means
+blocked, not budget compliance. Other hosts require a verified native counter
+and cap adapter before any enforcement claim.

package/skills/gsd-path-docs-audit/references/docs-auditor.md ADDED Viewed

@@ -0,0 +1,60 @@
+# Docs auditor role
+Verify that the project's Markdown documentation matches what the project
+actually does. Read-only: change nothing outside your single output file.
+## Input and output
+- Require the absolute repo root, exclusion rule, output path, absolute
+  docs-audit-template path, whether alignment mode applies, and a frozen,
+  sorted Markdown inventory.
+- Read AGENTS.md and the template before auditing. Stop on a missing path.
+- Write only the assigned output using the template. When the brief supplies a
+  disposable root, write the output under that root at the relative handoff
+  path; the orchestrator transfers it after validation. Do not ask the user
+  questions.
+## Method
+1. **Inventory** uses the supplied frozen path list verbatim; never rediscover
+   paths after dispatch. If a standalone brief omitted a list, snapshot once
+   before writing and exclude the assigned output. Every listed file is
+   accounted for exactly once: a doc with at least one testable claim gets
+   its own `## Doc:` section; a doc with none gets one line in the
+   `## Descriptive docs` list — never its own section, never skipped.
+2. **Extract claims** — statements reality can contradict: commands,
+   features, structure, status/checkboxes, config, integrations.
+3. **Verify each claim** by the cheapest sufficient method: run the
+   command, read the named code, run the relevant test, check git history.
+   Record the evidence (file:line, or command + result) with the verdict:
+   - `verified` — checked and true
+   - `stale` — plausibly once true; the code has moved on
+   - `aspirational` — describes something never built
+   - `unverifiable` — not checkable from the repo; say what would be needed
+   When the brief supplies a changed set, carry a prior `verified` row with
+   exactly one `unchanged: ` prefix on its Evidence only when it is not a
+   command claim and neither its doc nor any path its evidence names is in
+   that set. Copy an already-carried row verbatim without adding another
+   prefix. Re-verify every other claim. No changed set means no carried rows.
+4. **Alignment mode** (when `.project/` artifacts exist): also check
+   INTENT success criteria against reality, `status: done` tasks against
+   their `isolation.py recover`-proven landing SHA and a re-run of their Verify command,
+   SYNTHESIS decisions against the code's actual stack and shape, and
+   STATE against task frontmatter. Same verdicts, same evidence bar.
+5. **Classify remediation** for every non-verified claim: `fix-doc`,
+   `fix-code`, or `NEEDS-USER` when the right side of the conflict is not
+   yours to decide.
+## Rules
+- Hold your own output to the standard you enforce: a verdict without
+  recorded evidence is a defect.
+- Build, test, lint, and help commands are not presumed read-safe. Never run a
+  project command in the source worktree. Run it only in the pre-created,
+  agent-specific verify sidecar named in the brief at its recorded clean
+  Git revision. Do not create or remove Git worktrees yourself. Otherwise use
+  static evidence or mark the claim `unverifiable`. Never deploy, publish,
+  migrate, or mutate external state.
+- Contradictions between two docs are findings; report both sides.
+- Return the output path, verdict counts, and the worst drift found in at
+  most three lines.

package/skills/gsd-path-docs-audit/scripts/_common.py ADDED Viewed

@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+# gsd-path project runtime
+"""Helpers shared by the gsd-path scripts.
+Every consuming script binds the names it used before (for example
+``run_git = _common.run_git``) so callers and tests that patch the name on the
+consuming module keep working.
+"""
+from __future__ import annotations
+import json
+import os
+import re
+import subprocess
+from pathlib import Path
+from typing import Optional
+PIPELINE_MARKER = "gsd-path/v2"
+BOUND_BRANCH_RE = re.compile(r"^gsd-path/M(\d{3,})$")
+FIELD_PATTERN = re.compile(r"^(?P<key>[a-z_]+):\s*(?P<value>.*)$")
+INLINE_LIST_PATTERN = re.compile(r"^\[(?P<body>.*)\]$")
+LIST_ITEM_PATTERN = re.compile(r"^\s*-\s+(?P<value>.*)$")
+VERIFY_LEDGER_PATH = ".project/build/verify-ledger.jsonl"
+VERIFY_RESULTS = ("pass", "fail")
+VERIFY_LEDGER_SCHEMA = "gsd-path/verify-ledger/v2"
+VERIFY_BLOCK_PATTERN = re.compile(r"```bash[ \t]*\n(?P<block>.*?)```", re.DOTALL)
+def section_body(text: str, heading: str) -> Optional[str]:
+    """The text under `## <heading>` up to the next `## `, or None when absent."""
+    match = re.search(
+        rf"(?ms)^## {re.escape(heading)}\s*\n(?P<body>.*?)(?=^## |\Z)", text
+    )
+    return match.group("body") if match else None
+def task_verify_command(task_text: str) -> str:
+    """The Verify shell text, excluding the closing fence's separator newline."""
+    body = section_body(task_text, "Verify")
+    block = VERIFY_BLOCK_PATTERN.search(body) if body is not None else None
+    return block.group("block").removesuffix("\n") if block else ""
+def latest_verify_entry(entries: list, command: str, commit: str) -> Optional[dict]:
+    for entry in reversed(entries):
+        if (entry.get("schema") == VERIFY_LEDGER_SCHEMA
+                and entry["command"] == command and entry["commit"] == commit):
+            return entry
+    return None
+def verify_ledger_entries(path: Path) -> list:
+    """Parsed verify-ledger rows; raises ValueError on a malformed line."""
+    if not path.exists():
+        return []
+    return parse_verify_ledger(path.read_text(encoding="utf-8"))
+def parse_verify_ledger(text: str) -> list:
+    entries = []
+    for number, line in enumerate(text.splitlines(), start=1):
+        if not line.strip():
+            continue
+        try:
+            entry = json.loads(line)
+        except json.JSONDecodeError as error:
+            raise ValueError(f"{VERIFY_LEDGER_PATH} line {number} is not JSON: {error}") from error
+        if (
+            not isinstance(entry, dict)
+            or not isinstance(entry.get("command"), str)
+            or not isinstance(entry.get("commit"), str)
+            or entry.get("result") not in VERIFY_RESULTS
+            or not isinstance(entry.get("recorded_at"), str)
+        ):
+            raise ValueError(f"{VERIFY_LEDGER_PATH} line {number} has invalid fields")
+        entries.append(entry)
+    return entries
+def run_command(
+    *arguments: str, cwd: Optional[Path] = None
+) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        arguments,
+        cwd=cwd,
+        text=True,
+        capture_output=True,
+        check=False,
+    )
+def run_git(
+    repo: Path, *arguments: str, input: Optional[str] = None
+) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        ("git", "-C", str(repo), *arguments),
+        input=input,
+        text=True,
+        capture_output=True,
+        check=False,
+    )
+def atomic_replace(path: Path, temporary_path: Path, content: str) -> None:
+    temporary_path.parent.mkdir(parents=True, exist_ok=True)
+    descriptor = None
+    try:
+        if temporary_path.exists() or temporary_path.is_symlink():
+            temporary_path.unlink()
+        descriptor = os.open(
+            temporary_path,
+            os.O_WRONLY | os.O_CREAT | os.O_EXCL,
+            0o666,
+        )
+        handle = os.fdopen(descriptor, "w", encoding="utf-8")
+        descriptor = None
+        with handle:
+            handle.write(content)
+        os.replace(temporary_path, path)
+    finally:
+        if descriptor is not None:
+            os.close(descriptor)
+        if temporary_path.exists() or temporary_path.is_symlink():
+            temporary_path.unlink()
+def atomic_write(path: Path, content: str) -> None:
+    atomic_replace(path, path.parent / f".{path.name}.gsd-path-tmp", content)
+def strip_yaml_comment(value: str) -> str:
+    quote = None
+    previous_significant = None
+    inline_list = value.lstrip().startswith("[")
+    index = 0
+    while index < len(value):
+        character = value[index]
+        if quote == '"':
+            if character == "\\" and index + 1 < len(value):
+                index += 2
+                continue
+            if character == quote:
+                quote = None
+        elif quote == "'":
+            if (
+                character == quote
+                and index + 1 < len(value)
+                and value[index + 1] == quote
+            ):
+                index += 2
+                continue
+            if character == quote:
+                quote = None
+        else:
+            if character in {"'", '"'} and (
+                previous_significant is None
+                or (inline_list and previous_significant in {"[", ","})
+            ):
+                quote = character
+            elif character == "#" and (
+                index == 0 or value[index - 1].isspace()
+            ):
+                return value[:index].rstrip()
+        if quote is None and not character.isspace():
+            previous_significant = character
+        index += 1
+    return value.strip()
+def unquote(value: str) -> str:
+    cleaned = strip_yaml_comment(value).strip()
+    if (
+        len(cleaned) >= 2
+        and cleaned[0] == cleaned[-1]
+        and cleaned[0] in {"'", '"'}
+    ):
+        return cleaned[1:-1]
+    return cleaned