Remove deprecated goal qualify command

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Removed
+
+- **Deprecated goal qualification command**: Removed the `jumbo goal qualify` command surface. Use `jumbo goal approve` for successful QA review approvals.
+
 ## [3.12.2] - 2026-07-06
 
 ### Fixed

docs/guides/advanced-workflows.md

@@ -27,7 +27,7 @@ Tips:
 
 - Use `jumbo goal update-progress --id <goalId> --task-description "..."` after each meaningful sub-task.
 - If QA finds issues, use `jumbo goal reject --id <goalId> --audit-findings "..."`, fix, then `submit` again.
-- `jumbo goal qualify --id <goalId>` exists for backward compatibility but is deprecated in favor of `goal approve`.
+- Use `jumbo goal approve --id <goalId>` after QA review passes.
 
 ## Control phase handoffs with --continue
 

docs/reference/commands/goal.md

@@ -313,32 +313,6 @@ Approve a goal after successful QA review — transitions from `in-review` to `a
 > jumbo goal approve --id goal_abc123 --continue
 ```
 
----
-
-## jumbo goal qualify
-
-Qualify a goal after successful QA review. This command is deprecated and retained for compatibility. Prefer `jumbo goal approve`.
-
-### Synopsis
-
-```bash
-> jumbo goal qualify --id <goalId>
-```
-
-### Options
-
-| Option | Description |
-|--------|-------------|
-| `-i, --id <goalId>` | ID of the goal to qualify (required) |
-
-### Examples
-
-```bash
-> jumbo goal qualify --id goal_abc123
-```
-
----
-
 ## jumbo goal reject
 
 Reject a goal after failed QA review — transitions from `in-review` back to `doing`.

src/presentation/cli/commands/goals/approve/goal.approve.ts

@@ -5,7 +5,6 @@
  * Transitions goal from 'in-review' to 'approved' status and renders codification instructions.
  *
  * This is the primary command for review approval.
- * See also: goal.qualify (deprecated alias).
  */
 
 import { CommandMetadata, CONTINUE_OPTION } from "../../registry/CommandMetadata.js";
@@ -49,7 +48,7 @@ export async function goalApprove(
   const outputBuilder = new GoalApproveOutputBuilder();
 
   try {
-    // 1. Execute via controller (delegates to same QualifyGoalController)
+    // 1. Execute via the existing approval workflow
     const response = await container.qualifyGoalController.handle({
       goalId: options.id,
     });

src/presentation/cli/commands/goals/reject/goal.reject.ts

@@ -34,7 +34,7 @@ export const metadata: CommandMetadata = {
       description: "Reject a goal with review issues"
     }
   ],
-  related: ["goal review", "goal qualify", "goal start"],
+  related: ["goal review", "goal approve", "goal start"],
   requiresProject: true
 };
 

src/presentation/cli/commands/goals/review/goal.review.ts

@@ -30,7 +30,7 @@ export const metadata: CommandMetadata = {
       description: "Start QA review on a submitted goal"
     }
   ],
-  related: ["goal submit", "goal qualify", "goal reject"],
+  related: ["goal submit", "goal approve", "goal reject"],
   requiresProject: true
 };
 

src/presentation/cli/commands/registry/generated-commands.ts

@@ -49,7 +49,6 @@ import { goalCodify, metadata as goalCodifyMeta } from '../../commands/goals/cod
 import { goalCommit, metadata as goalCommitMeta } from '../../commands/goals/commit/goal.commit.js';
 import { goalsList, metadata as goalsListMeta } from '../../commands/goals/list/goals.list.js';
 import { goalPause, metadata as goalPauseMeta } from '../../commands/goals/pause/goal.pause.js';
-import { goalQualify, metadata as goalQualifyMeta } from '../../commands/goals/qualify/goal.qualify.js';
 import { goalRefine, metadata as goalRefineMeta } from '../../commands/goals/refine/goal.refine.js';
 import { goalReject, metadata as goalRejectMeta } from '../../commands/goals/reject/goal.reject.js';
 import { goalRemove, metadata as goalRemoveMeta } from '../../commands/goals/remove/goal.remove.js';
@@ -300,11 +299,6 @@ export const commands: RegisteredCommand[] = [
     metadata: goalPauseMeta,
     handler: goalPause
   },
-  {
-    path: 'goal qualify',
-    metadata: goalQualifyMeta,
-    handler: goalQualify
-  },
   {
     path: 'goal refine',
     metadata: goalRefineMeta,

tests/presentation/cli/commands/registry/RequiresProjectMetadata.test.ts

@@ -41,4 +41,11 @@ describe("requiresProject metadata", () => {
     expect(command).toBeDefined();
     expect(command?.metadata.requiresProject).toBe(true);
   });
+
+  it("registers goal approve and no longer registers goal qualify", () => {
+    const paths = commands.map((c) => c.path);
+
+    expect(paths).toContain("goal approve");
+    expect(paths).not.toContain("goal qualify");
+  });
 });