@opengsd/get-shit-done-redux 1.0.0

package/sdk/src/query/command-static-catalog-domain.ts

@@ -0,0 +1,111 @@
+import type { QueryHandler } from './utils.js';
+import { agentSkills } from './skills.js';
+import { requirementsMarkComplete } from './roadmap.js';
+import { todoMatchPhase, statsJson, statsTable, progressBar, progressTable, listTodos, todoComplete } from './progress.js';
+import { milestoneComplete } from './phase-lifecycle.js';
+import { summaryExtract, historyDigest } from './summary.js';
+import { commitToSubrepo } from './commit.js';
+import { workstreamGet, workstreamList, workstreamCreate, workstreamSet, workstreamStatus, workstreamComplete, workstreamProgress } from './workstream.js';
+import { docsInit } from './docs-init.js';
+import { websearch } from './websearch.js';
+import { learningsCopy, learningsQuery, learningsListHandler, learningsPrune, learningsDelete, extractMessages, scanSessions, profileSample, profileQuestionnaire } from './profile.js';
+import { skillManifest } from './skill-manifest.js';
+import { auditOpen } from './audit-open.js';
+import { detectCustomFiles } from './detect-custom-files.js';
+import { uatRenderCheckpoint, auditUat } from './uat.js';
+// intel.* handlers intentionally NOT imported — intel (bin/lib/intel.cjs) is
+// out-of-seam (CJS-only) per ADR/PRD docs/adr/3524-cjs-sdk-hard-seam.md §3
+// and docs/prd/3524-cjs-sdk-hard-seam.md L160. Dispatch is handled directly
+// by the `case 'intel':` branch in get-shit-done/bin/gsd-tools.cjs which
+// requires('./lib/intel.cjs') and calls the CJS functions in-process.
+import { writeProfile, generateClaudeProfile, generateDevPreferences, generateClaudeMd } from './profile-output.js';
+import { phaseMvpMode, taskIsBehaviorAdding, userStoryValidate } from './mvp.js';
+import { worktreeCleanupWave, worktreeReapOrphans } from './worktree.js';
+import { promptBudget } from './prompt-budget.js';
+
+export const DOMAIN_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['agent-skills', agentSkills],
+  ['requirements.mark-complete', requirementsMarkComplete],
+  ['requirements mark-complete', requirementsMarkComplete],
+  ['todo.match-phase', todoMatchPhase],
+  ['todo match-phase', todoMatchPhase],
+  ['list-todos', listTodos],
+  ['list.todos', listTodos],
+  ['todo.complete', todoComplete],
+  ['todo complete', todoComplete],
+  ['milestone.complete', milestoneComplete],
+  ['milestone complete', milestoneComplete],
+  ['summary.extract', summaryExtract],
+  ['summary extract', summaryExtract],
+  ['summary-extract', summaryExtract],
+  ['history.digest', historyDigest],
+  ['history digest', historyDigest],
+  ['history-digest', historyDigest],
+  ['stats', statsJson],
+  ['stats.json', statsJson],
+  ['stats json', statsJson],
+  ['stats.table', statsTable],
+  ['stats table', statsTable],
+  ['commit-to-subrepo', commitToSubrepo],
+  ['progress.bar', progressBar],
+  ['progress bar', progressBar],
+  ['progress.table', progressTable],
+  ['progress table', progressTable],
+  ['workstream.get', workstreamGet],
+  ['workstream get', workstreamGet],
+  ['workstream.list', workstreamList],
+  ['workstream list', workstreamList],
+  ['workstream.create', workstreamCreate],
+  ['workstream create', workstreamCreate],
+  ['workstream.set', workstreamSet],
+  ['workstream set', workstreamSet],
+  ['workstream.status', workstreamStatus],
+  ['workstream status', workstreamStatus],
+  ['workstream.complete', workstreamComplete],
+  ['workstream complete', workstreamComplete],
+  ['workstream.progress', workstreamProgress],
+  ['workstream progress', workstreamProgress],
+  ['worktree.cleanup-wave', worktreeCleanupWave],
+  ['worktree cleanup-wave', worktreeCleanupWave],
+  ['worktree.reap-orphans', worktreeReapOrphans],
+  ['worktree reap-orphans', worktreeReapOrphans],
+  ['docs-init', docsInit],
+  ['websearch', websearch],
+  ['learnings.copy', learningsCopy],
+  ['learnings copy', learningsCopy],
+  ['learnings.query', learningsQuery],
+  ['learnings query', learningsQuery],
+  ['learnings.list', learningsListHandler],
+  ['learnings list', learningsListHandler],
+  ['learnings.prune', learningsPrune],
+  ['learnings prune', learningsPrune],
+  ['learnings.delete', learningsDelete],
+  ['learnings delete', learningsDelete],
+  ['skill-manifest', skillManifest],
+  ['skill manifest', skillManifest],
+  ['audit-open', auditOpen],
+  ['audit open', auditOpen],
+  ['detect-custom-files', detectCustomFiles],
+  ['extract-messages', extractMessages],
+  ['extract.messages', extractMessages],
+  ['audit-uat', auditUat],
+  ['uat.render-checkpoint', uatRenderCheckpoint],
+  ['uat render-checkpoint', uatRenderCheckpoint],
+  // intel.* entries removed — see import-section comment above. Intel verbs
+  // dispatch via bin/gsd-tools.cjs `case 'intel':` direct to bin/lib/intel.cjs.
+  ['generate-claude-profile', generateClaudeProfile],
+  ['generate-dev-preferences', generateDevPreferences],
+  ['write-profile', writeProfile],
+  ['profile-questionnaire', profileQuestionnaire],
+  ['profile-sample', profileSample],
+  ['scan-sessions', scanSessions],
+  ['generate-claude-md', generateClaudeMd],
+  // ── MVP umbrella (#2826) — centralized resolution seams ──
+  ['phase.mvp-mode', phaseMvpMode],
+  ['phase mvp-mode', phaseMvpMode],
+  ['task.is-behavior-adding', taskIsBehaviorAdding],
+  ['task is-behavior-adding', taskIsBehaviorAdding],
+  ['user-story.validate', userStoryValidate],
+  ['user-story validate', userStoryValidate],
+  ['prompt-budget', promptBudget],
+] as const;

package/sdk/src/query/command-static-catalog-foundation.ts

@@ -0,0 +1,111 @@
+import type { QueryHandler } from './utils.js';
+import { generateSlug, currentTimestamp } from './utils.js';
+import { frontmatterGet } from './frontmatter.js';
+import { configGet, configPath, resolveModel } from './config-query.js';
+import { stateSnapshot } from './state.js';
+import { findPhase, phasePlanIndex } from './phase.js';
+import { planTaskStructure } from './plan-task-structure.js';
+import { requirementsExtractFromPlans } from './requirements-extract-from-plans.js';
+import { progressJson } from './progress.js';
+import { frontmatterSet, frontmatterMerge, frontmatterValidate } from './frontmatter-mutation.js';
+import { configSet, configSetModelProfile, configNewProject, configEnsureSection } from './config-mutation.js';
+import { commit, checkCommit } from './commit.js';
+import { templateFill, templateSelect } from './template.js';
+import { verifySummary, verifyPathExists } from './verify.js';
+import { decisionsParse } from './decisions.js';
+import { checkDecisionCoveragePlan, checkDecisionCoverageVerify } from './check-decision-coverage.js';
+import { commandsList } from './commands-list.js';
+import { checkConfigGates } from './config-gates.js';
+import { checkAutoMode } from './check-auto-mode.js';
+import { checkPhaseReady } from './phase-ready.js';
+import { routeNextAction } from './route-next-action.js';
+import { detectPhaseType } from './detect-phase-type.js';
+import { checkCompletion } from './check-completion.js';
+import { checkGates } from './check-gates.js';
+import { checkVerificationStatus } from './check-verification-status.js';
+import { checkShipReady } from './check-ship-ready.js';
+import { agentClassifyFailure } from './agent-failure-classifier.js';
+
+export const FOUNDATION_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['generate-slug', generateSlug],
+  ['current-timestamp', currentTimestamp],
+  ['frontmatter.get', frontmatterGet],
+  ['config-get', configGet],
+  ['config-path', configPath],
+  ['resolve-model', resolveModel],
+] as const;
+
+export const STATE_SUPPORT_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['state-snapshot', stateSnapshot],
+  ['find-phase', findPhase],
+  ['phase-plan-index', phasePlanIndex],
+  ['plan.task-structure', planTaskStructure],
+  ['plan task-structure', planTaskStructure],
+  ['requirements.extract-from-plans', requirementsExtractFromPlans],
+  ['requirements extract-from-plans', requirementsExtractFromPlans],
+] as const;
+
+export const MUTATION_SURFACES_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['progress', progressJson],
+  ['progress.json', progressJson],
+  ['frontmatter.set', frontmatterSet],
+  ['frontmatter.merge', frontmatterMerge],
+  ['frontmatter.validate', frontmatterValidate],
+  ['frontmatter validate', frontmatterValidate],
+  ['config-set', configSet],
+  ['config-set-model-profile', configSetModelProfile],
+  ['config-new-project', configNewProject],
+  // Legacy contract: `config-ensure-section` (no positional arg) initialises
+  // the full default .planning/config.json — semantically identical to
+  // `config-new-project` with empty userChoices. Phase 6 originally bound
+  // this to the `configEnsureSection` single-section-ensure handler, which
+  // requires args[0]=sectionName the CLI never passes. Re-binding to
+  // configNewProject restores the legacy contract on the SDK path.
+  // `configEnsureSection` itself remains exported for any future SDK caller
+  // that wants the single-section semantics.
+  ['config-ensure-section', configNewProject],
+  ['commit', commit],
+  ['check-commit', checkCommit],
+  ['template.fill', templateFill],
+  ['template.select', templateSelect],
+  ['template select', templateSelect],
+] as const;
+
+export const VERIFY_DECISION_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['verify-summary', verifySummary],
+  ['verify.summary', verifySummary],
+  ['verify summary', verifySummary],
+  ['verify-path-exists', verifyPathExists],
+  ['verify.path-exists', verifyPathExists],
+  ['verify path-exists', verifyPathExists],
+  ['decisions.parse', decisionsParse],
+  ['decisions parse', decisionsParse],
+  ['check.decision-coverage-plan', checkDecisionCoveragePlan],
+  ['check decision-coverage-plan', checkDecisionCoveragePlan],
+  ['check.decision-coverage-verify', checkDecisionCoverageVerify],
+  ['check decision-coverage-verify', checkDecisionCoverageVerify],
+] as const;
+
+export const DECISION_ROUTING_STATIC_CATALOG: ReadonlyArray<readonly [string, QueryHandler]> = [
+  ['check.config-gates', checkConfigGates],
+  ['check config-gates', checkConfigGates],
+  ['check.auto-mode', checkAutoMode],
+  ['check auto-mode', checkAutoMode],
+  ['check.phase-ready', checkPhaseReady],
+  ['check phase-ready', checkPhaseReady],
+  ['route.next-action', routeNextAction],
+  ['route next-action', routeNextAction],
+  ['detect.phase-type', detectPhaseType],
+  ['detect phase-type', detectPhaseType],
+  ['check.completion', checkCompletion],
+  ['check completion', checkCompletion],
+  ['check.gates', checkGates],
+  ['check gates', checkGates],
+  ['check.verification-status', checkVerificationStatus],
+  ['check verification-status', checkVerificationStatus],
+  ['check.ship-ready', checkShipReady],
+  ['check ship-ready', checkShipReady],
+  ['commands', commandsList],
+  ['agent.classify-failure', agentClassifyFailure],
+  ['agent classify-failure', agentClassifyFailure],
+] as const;

package/sdk/src/query/command-topology.test.ts

@@ -0,0 +1,28 @@
+import { describe, it, expect } from 'vitest';
+import { createRegistry } from './index.js';
+import { createCommandTopology } from './command-topology.js';
+
+describe('command-topology', () => {
+  it('resolves native command with adapter', () => {
+    const registry = createRegistry();
+    const topology = createCommandTopology(registry);
+
+    const out = topology.resolve(['state', 'json']);
+    expect(out.kind).toBe('match');
+    if (out.kind !== 'match') throw new Error('expected match');
+    expect(out.canonical).toBe('state.json');
+    expect(out.args).toEqual([]);
+    expect(typeof out.adapter).toBe('function');
+  });
+
+  it('returns no_match with diagnosis', () => {
+    const registry = createRegistry();
+    const topology = createCommandTopology(registry);
+
+    const out = topology.resolve(['unknown-cmd'], true);
+    expect(out.kind).toBe('no_match');
+    if (out.kind !== 'no_match') throw new Error('expected no_match');
+    expect(out.message).toContain('Unknown command');
+    expect(out.attempted.length).toBeGreaterThanOrEqual(0);
+  });
+});

package/sdk/src/query/command-topology.ts

@@ -0,0 +1,114 @@
+import type { QueryRegistry } from './registry.js';
+import type { QueryHandler } from './utils.js';
+import {
+  resolveQueryCommand,
+  explainQueryCommandNoMatch,
+  type QueryCommandRegistryLike,
+} from './query-command-resolution-strategy.js';
+import { supportsMutationCommand, supportsRawOutputCommand } from './query-policy-capability.js';
+import { UNKNOWN_COMMAND_HINTS } from './query-unknown-command-hints.js';
+import { describeFallbackDisabledPolicy } from './query-fallback-policy.js';
+
+export type CommandTopologyOutputMode = 'json' | 'text' | 'raw';
+
+export interface CommandTopologyMatch {
+  kind: 'match';
+  canonical: string;
+  args: string[];
+  output_mode: CommandTopologyOutputMode;
+  mutation: boolean;
+  adapter: QueryHandler;
+}
+
+export interface CommandTopologyNoMatch {
+  kind: 'no_match';
+  attempted: string[];
+  normalized?: string;
+  hints: string[];
+  message: string;
+}
+
+export type CommandTopologyResult = CommandTopologyMatch | CommandTopologyNoMatch;
+
+export interface CommandTopology {
+  resolve(tokens: string[], fallbackRestricted?: boolean): CommandTopologyResult;
+}
+
+export interface UnknownCommandDiagnosis {
+  normalized: string;
+  attempted: string[];
+  hints: string[];
+  message: string;
+}
+
+export function diagnoseUnknownCommand(
+  command: string,
+  args: string[],
+  registry: QueryCommandRegistryLike,
+  fallbackRestricted: boolean,
+): UnknownCommandDiagnosis {
+  const noMatch = explainQueryCommandNoMatch(command, args, registry);
+  const normalized = [noMatch.normalized.command, ...noMatch.normalized.args].join(' ');
+  const attempted = noMatch.attempted.dotted.slice(0, 2);
+  const hints = [...UNKNOWN_COMMAND_HINTS];
+  const attemptedSuffix = attempted.length > 0 ? ` Attempted dotted: ${attempted.join(' | ')}.` : '';
+  const fallbackClause = fallbackRestricted ? `${describeFallbackDisabledPolicy()} ` : '';
+  const message = `Error: Unknown command: "${normalized}". ${hints[0]} ${hints[1]} ${fallbackClause}${hints[2]}${attemptedSuffix}`;
+
+  return {
+    normalized,
+    attempted,
+    hints,
+    message,
+  };
+}
+
+export function createCommandTopology(registry: QueryRegistry): CommandTopology {
+  return {
+    resolve(tokens: string[], fallbackRestricted = false): CommandTopologyResult {
+      const command = tokens[0];
+      const args = tokens.slice(1);
+      if (!command) {
+        return {
+          kind: 'no_match',
+          attempted: [],
+          hints: [],
+          message: 'Error: "gsd-sdk query" requires a command',
+        };
+      }
+
+      const matched = resolveQueryCommand(command, args, registry);
+      if (!matched) {
+        const diagnosis = diagnoseUnknownCommand(command, args, registry, fallbackRestricted);
+        return {
+          kind: 'no_match',
+          normalized: diagnosis.normalized,
+          attempted: diagnosis.attempted,
+          hints: diagnosis.hints,
+          message: diagnosis.message,
+        };
+      }
+
+      const adapter = registry.getHandler(matched.cmd);
+      if (!adapter) {
+        const diagnosis = diagnoseUnknownCommand(command, args, registry, fallbackRestricted);
+        return {
+          kind: 'no_match',
+          normalized: diagnosis.normalized,
+          attempted: diagnosis.attempted,
+          hints: diagnosis.hints,
+          message: diagnosis.message,
+        };
+      }
+
+      return {
+        kind: 'match',
+        canonical: matched.cmd,
+        args: matched.args,
+        output_mode: supportsRawOutputCommand(matched.cmd) ? 'raw' : 'json',
+        mutation: supportsMutationCommand(matched.cmd),
+        adapter,
+      };
+    },
+  };
+}

package/sdk/src/query/commands-list.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { commandsList } from './commands-list.js';
+
+// Regression test for bug #3121.
+// The `commands` verb was missing from the SDK native registry.
+// `gsd-sdk query commands` fell back to gsd-tools.cjs which threw
+// "Unknown command: commands".
+describe('commands-list handler (#3121)', () => {
+  it('returns a non-empty sorted JSON array of command strings', async () => {
+    const result = await commandsList([], '/tmp', undefined);
+    expect(result.data).toBeDefined();
+    expect(Array.isArray(result.data)).toBe(true);
+    expect((result.data as string[]).length).toBeGreaterThan(10);
+  });
+
+  it('includes known canonical commands', async () => {
+    const result = await commandsList([], '/tmp', undefined);
+    const cmds = result.data as string[];
+    expect(cmds).toContain('state.begin-phase');
+    expect(cmds).toContain('check.decision-coverage-plan');
+    expect(cmds).toContain('commands');
+  });
+
+  it('is sorted alphabetically', async () => {
+    const result = await commandsList([], '/tmp', undefined);
+    const cmds = result.data as string[];
+    const sorted = [...cmds].sort((a, b) => a.localeCompare(b));
+    expect(cmds).toEqual(sorted);
+  });
+
+  it('args and workstream are ignored (introspection verb)', async () => {
+    const r1 = await commandsList([], '/tmp', undefined);
+    const r2 = await commandsList(['ignored'], '/other', 'ws');
+    expect(r1.data).toEqual(r2.data);
+  });
+});

package/sdk/src/query/commands-list.ts

@@ -0,0 +1,19 @@
+import type { QueryHandler } from './utils.js';
+import { createRegistry } from './index.js';
+
+/**
+ * `commands` — return the full list of registered query command strings.
+ *
+ * Closes #3121: the `commands` verb was referenced in workflow files
+ * (references/workstream-flag.md) but had no native SDK handler, causing
+ * a fallback to gsd-tools.cjs which threw "Unknown command: commands".
+ *
+ * Returns: JSON array of all canonical + alias command strings the SDK
+ * registry accepts, sorted alphabetically. Suitable for discoverability
+ * and for agent auto-complete when constructing `gsd-sdk query` calls.
+ */
+export const commandsList: QueryHandler<string[]> = async (_args, _projectDir) => {
+  const registry = createRegistry();
+  const cmds = registry.commands().sort((a, b) => a.localeCompare(b));
+  return { data: cmds };
+};