Tom Boucher f104dab332 refactor(query): deepen dispatch policy seam with structured result contract (#3066) ...

* refactor(query): deepen dispatch policy seam with structured result contract

Closes #3065.

- unify query dispatch outcome as typed success/failure union
- include error kind/details + final exit_code in failure path
- align native and fallback paths under one dispatch policy seam
- make CLI query path consume seam result (thin adapter)
- add ADR + context term for Dispatch Policy Module

* refactor(query): strengthen dispatch seam with shared error mapper and typed details

- add query-dispatch-error-mapper module shared by native/fallback paths
- remove ad-hoc inline mapping in dispatch/fallback executors
- lock error-details schema in mapper + dispatch tests
- document structured dispatch contract in QUERY-HANDLERS.md

* fix(query): return structured fallback failure when path resolution throws

- guard resolveGsdToolsPath in cjs dispatch path
- map thrown resolution errors to fallback_failure result
- add regression test for structured failure contract

2026-05-03 14:30:27 -04:00

..

audit-open.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

check-auto-mode.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-auto-mode.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-completion.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-completion.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-decision-coverage.test.ts

feat: add gates ensuring discuss-phase decisions are translated to plans and verified (closes #2492) (#2611)

2026-04-23 00:26:53 -04:00

check-decision-coverage.ts

fix(#2613): preserve STATE.md frontmatter on write path (option 2) (#2622)

2026-04-23 08:22:42 -04:00

check-gates.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-gates.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

check-ship-ready.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-ship-ready.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-verification-status.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

check-verification-status.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

command-aliases.generated.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-catalog.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

command-family-handlers.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

command-manifest.init.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.phase.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.phases.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.roadmap.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.state.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.types.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.validate.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-manifest.verify.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-resolution.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

command-resolution.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

command-seam-coverage.test.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

command-static-catalog-domain.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

command-static-catalog-foundation.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

commit.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

commit.ts

fix(query): thread workstream through all query handlers

2026-04-26 10:53:17 -04:00

config-gates.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

config-gates.ts

feat: add gates ensuring discuss-phase decisions are translated to plans and verified (closes #2492) (#2611)

2026-04-23 00:26:53 -04:00

config-mutation.test.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

config-mutation.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

config-query.test.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

config-query.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

config-schema.ts

feat(#3024): dynamic routing with failure-tier escalation (#3031)

2026-05-02 14:26:35 -04:00

decisions.test.ts

feat: add gates ensuring discuss-phase decisions are translated to plans and verified (closes #2492) (#2611)

2026-04-23 00:26:53 -04:00

decisions.ts

feat: add gates ensuring discuss-phase decisions are translated to plans and verified (closes #2492) (#2611)

2026-04-23 00:26:53 -04:00

decomposed-handlers.test.ts

refactor(tests): extract assertMilestoneSuccess helper in decomposed-handlers.test.ts

2026-04-26 11:24:31 -04:00

detect-custom-files.ts

fix: exclude non-wiped dirs from custom-file scan; warn on non-Claude model profiles (#2511)

2026-04-21 10:10:10 -04:00

detect-phase-type.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

detect-phase-type.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

docs-init.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

frontmatter-array.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

frontmatter-mutation.test.ts

feat(sdk): Phase 1 typed query foundation (gsd-sdk query) (#2118)

2026-04-12 18:15:04 -04:00

frontmatter-mutation.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

frontmatter.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

frontmatter.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

helpers.test.ts

fix(#2623): resolve parent .planning root for sub_repos workspaces in SDK query dispatch (#2629)

2026-04-23 11:58:23 -04:00

helpers.ts

fix(#2623): resolve parent .planning root for sub_repos workspaces in SDK query dispatch (#2629)

2026-04-23 11:58:23 -04:00

index-thin-seam.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

index.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

init-complex.test.ts

test(query): add failing tests for workstream path threading in init-complex

2026-04-26 10:38:10 -04:00

init-complex.ts

fix(query): thread workstream through all query handlers

2026-04-26 10:53:17 -04:00

init-progress-precedence.test.ts

fix(#2674): align initProgress with initManager ROADMAP [x] precedence (#2681)

2026-04-24 20:20:11 -04:00

init.test.ts

fix(#2769): tolerate Requirements header with colon inside bold delimiters (#2782)

2026-04-27 12:31:49 -04:00

init.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

intel.test.ts

feat(sdk): Phase 1 typed query foundation (gsd-sdk query) (#2118)

2026-04-12 18:15:04 -04:00

intel.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

mutation-event-decorator.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

mutation-event-decorator.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

mutation-event-mapper.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

mutation-event-mapper.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

normalize-query-command.test.ts

refactor(query): manifest-backed routing seam + family adapters (#2908)

2026-04-30 14:04:50 -04:00

normalize-query-command.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

phase-lifecycle.test.ts

Merge pull request #2743 from gsd-build/fix/2714-workstream-config-inheritance

2026-04-26 11:49:30 -04:00

phase-lifecycle.ts

Merge pull request #2743 from gsd-build/fix/2714-workstream-config-inheritance

2026-04-26 11:49:30 -04:00

phase-list-queries.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

phase-list-queries.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

phase-ready.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

phase-ready.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

phase.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

phase.ts

fix(sdk): fix executor plan loading, plan ID derivation, and verification outcome parsing

2026-04-25 14:08:05 -06:00

pipeline.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

pipeline.ts

feat(sdk): Phase 1 typed query foundation (gsd-sdk query) (#2118)

2026-04-12 18:15:04 -04:00

plan-task-structure.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

plan-task-structure.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

policy-convergence.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

policy-convergence.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

profile-extract-messages.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile-output.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile-questionnaire-data.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile-sample.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile-scan-sessions.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

profile.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

progress.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

progress.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

query-command-semantics.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

query-dispatch-contract.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-dispatch-error-mapper.test.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-dispatch-error-mapper.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-dispatch.test.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-dispatch.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-fallback-executor.test.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

query-fallback-executor.ts

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

QUERY-HANDLERS.md

refactor(query): deepen dispatch policy seam with structured result contract (#3066)

2026-05-03 14:30:27 -04:00

registry-assembly-invariants.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

registry-assembly.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

registry-assembly.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

registry.test.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

registry.ts

refactor(query): extract command catalog seam for registry wiring (#3060)

2026-05-03 13:57:32 -04:00

requirements-extract-from-plans.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

requirements-extract-from-plans.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

roadmap-update-plan-progress.test.ts

fix(tests): derive STATE.md phase number from phaseDir in setupProject fixture

2026-04-26 11:46:57 -04:00

roadmap-update-plan-progress.ts

fix(#2796): roadmap-update-plan-progress accepts --phase flag form (#2815)

2026-04-28 20:22:30 -04:00

roadmap.test.ts

fix(#2619): prevent extractCurrentMilestone from truncating on phase-vX.Y headings (#2624)

2026-04-23 11:53:20 -04:00

roadmap.ts

fix(#2619): prevent extractCurrentMilestone from truncating on phase-vX.Y headings (#2624)

2026-04-23 11:53:20 -04:00

route-next-action.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

route-next-action.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

schema-detect.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

secrets.test.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

secrets.ts

fix(#2997): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999)

2026-05-02 00:17:45 -04:00

skill-manifest.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

skills.test.ts

fix(query/agent-skills): emit raw <agent_skills> block instead of JSON-wrapped string (#2917)

2026-05-01 12:21:06 -04:00

skills.ts

fix(query/agent-skills): emit raw <agent_skills> block instead of JSON-wrapped string (#2917)

2026-05-01 12:21:06 -04:00

state-mutation.test.ts

fix(#2662): add state.add-roadmap-evolution SDK handler; insert-phase uses it (#2683)

2026-04-24 20:20:02 -04:00

state-mutation.ts

fix(#2662): add state.add-roadmap-evolution SDK handler; insert-phase uses it (#2683)

2026-04-24 20:20:02 -04:00

state-project-load.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

state.test.ts

fix(#2618): thread --ws through query dispatch and sync root STATE.md on workstream.set (#2627)

2026-04-23 11:54:34 -04:00

state.ts

fix(#2618): thread --ws through query dispatch and sync root STATE.md on workstream.set (#2627)

2026-04-23 11:54:34 -04:00

sub-repos-root.integration.test.ts

fix(#2623): resolve parent .planning root for sub_repos workspaces in SDK query dispatch (#2629)

2026-04-23 11:58:23 -04:00

summary.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

summary.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

template.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

template.ts

fix(sdk): forward --ws workstream flag through query dispatch (#2546)

2026-04-21 20:33:24 -04:00

uat.test.ts

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341)

2026-04-20 18:09:02 -04:00

uat.ts

fix(#2788): audit-uat reads human_verification items from frontmatter (#2814)

2026-04-28 20:22:59 -04:00

utils.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

utils.ts

fix(query/agent-skills): emit raw <agent_skills> block instead of JSON-wrapped string (#2917)

2026-05-01 12:21:06 -04:00

validate.test.ts

fix(#2633): ROADMAP.md is the authority for current-milestone phase counts (#2665)

2026-04-24 18:11:12 -04:00

validate.ts

feat(#2792): namespace meta-skills + keyword-tag descriptions + context utilization guard (#2825)

2026-04-30 01:04:41 -04:00

verify.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

verify.ts

feat: auto-remap codebase after significant phase execution (closes #2003) (#2605)

2026-04-22 21:21:44 -04:00

websearch.test.ts

feat(sdk): Phase 1 typed query foundation (gsd-sdk query) (#2118)

2026-04-12 18:15:04 -04:00

websearch.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

workspace.test.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

workspace.ts

fix(2137): skip worktree isolation when .gitmodules detected (#2144)

2026-04-12 08:33:04 -04:00

workstream.test.ts

fix(#2618): thread --ws through query dispatch and sync root STATE.md on workstream.set (#2627)

2026-04-23 11:54:34 -04:00

workstream.ts

fix(#2618): thread --ws through query dispatch and sync root STATE.md on workstream.set (#2627)

2026-04-23 11:54:34 -04:00