spets 0.1.39 → 0.1.41

package/dist/index.js

@@ -1360,7 +1360,7 @@ function buildConsolidatePrompt(params) {
     outputPath: group.outputPath
   };
 }
-function buildDraftPrompt(params) {
+function buildExecutePrompt(params) {
   const cwd = params.cwd || process.cwd();
   const config = loadConfig(cwd);
   const stepsDir = getStepsDir(cwd);
@@ -1386,9 +1386,9 @@ function buildDraftPrompt(params) {
     }
   }
   const parts = [];
-  parts.push("# Draft Phase - Document Generation");
+  parts.push("# Execute Phase - Document/Code Generation");
   parts.push("");
-  parts.push("Generate the document based on the explored context and user answers.");
+  parts.push("Generate the document/code based on the explored context and user answers.");
   parts.push("");
   parts.push("## Step Instruction");
   parts.push("");
@@ -1775,7 +1775,7 @@ var Orchestrator = class {
   }
   /**
    * Phase 3: Document generation
-   * @deprecated Use responsePhaseDraft instead
+   * @deprecated Use responsePhaseExecute instead
    */
   responsePhaseGenerate(state) {
     const steps = this.getSteps();
@@ -1811,9 +1811,9 @@ var Orchestrator = class {
     };
   }
   /**
-   * Phase 3 (New): Document generation with explore output
+   * Phase 3 (New): Document/code generation with explore output
    */
-  responsePhaseDraft(state) {
+  responsePhaseExecute(state) {
     const steps = this.getSteps();
     const outputPath = this.getOutputPath();
     let previousOutput;
@@ -1839,7 +1839,7 @@ ${issues}`;
       constraints: [],
       dependencies: []
     };
-    const { prompt } = buildDraftPrompt({
+    const { prompt } = buildExecutePrompt({
       taskId: state.taskId,
       step: state.currentStep,
       description: state.description,
@@ -1853,7 +1853,7 @@ ${issues}`;
     });
     return {
       type: "phase",
-      phase: "draft",
+      phase: "execute",
       step: state.currentStep,
       stepIndex: state.stepIndex,
       totalSteps: state.totalSteps,
@@ -1870,7 +1870,7 @@ ${issues}`;
         revisionFeedback: state.revisionFeedback,
         verifyFeedback
       },
-      onComplete: `draft-done ${state.taskId}`
+      onComplete: `execute-done ${state.taskId}`
     };
   }
   /**
@@ -2180,11 +2180,11 @@ ${issues}`;
       this.saveState(state);
       return this.responsePhaseGenerateSections(state);
     }
-    state.status = "phase_draft";
+    state.status = "phase_execute";
     state.phase = "draft";
     state.verifyAttempts = 0;
     this.saveState(state);
-    return this.responsePhaseDraft(state);
+    return this.responsePhaseExecute(state);
   }
   /**
    * Human answered questions, loop back to clarify phase
@@ -2209,7 +2209,7 @@ ${issues}`;
   }
   /**
    * Phase 3 complete: Document generated, move to approve checkpoint
-   * @deprecated Use cmdDraftDone instead for new workflow
+   * @deprecated Use cmdExecuteDone instead for new workflow
    */
   cmdGenerateDone(taskId) {
     const state = this.loadState(taskId);
@@ -2226,9 +2226,9 @@ ${issues}`;
     return this.responseCheckpointApprove(state);
   }
   /**
-   * Phase 3 complete (New): Draft generated, move to verify phase
+   * Phase 3 complete (New): Execution complete, move to verify phase
    */
-  cmdDraftDone(taskId) {
+  cmdExecuteDone(taskId) {
     const state = this.loadState(taskId);
     if (!state) {
       return this.responseError(`No workflow found: ${taskId}`, taskId);
@@ -2243,10 +2243,16 @@ ${issues}`;
     this.saveState(state);
     return this.responsePhaseVerify(state);
   }
+  /**
+   * @deprecated Use cmdExecuteDone instead
+   */
+  cmdDraftDone(taskId) {
+    return this.cmdExecuteDone(taskId);
+  }
   /**
    * Phase 4 complete (New): Verification done
    * If passed → approve_pending
-   * If failed → phase_draft (auto-fix, max 3 attempts)
+   * If failed → phase_execute (auto-fix, max 3 attempts)
    * If max attempts reached → approve_pending with warning
    */
   cmdVerifyDone(taskId, verifyOutput) {
@@ -2269,13 +2275,13 @@ ${issues}`;
       const response = this.responseCheckpointApprove(state);
       return response;
     }
-    state.status = "phase_draft";
+    state.status = "phase_execute";
     state.phase = "draft";
     this.saveState(state);
-    return this.responsePhaseDraft(state);
+    return this.responsePhaseExecute(state);
   }
   /**
-   * @deprecated Use cmdExploreDone, cmdClarifyDone, cmdDraftDone, cmdVerifyDone instead
+   * @deprecated Use cmdExploreDone, cmdClarifyDone, cmdExecuteDone, cmdVerifyDone instead
    */
   cmdDone(taskId) {
     const state = this.loadState(taskId);
@@ -2345,13 +2351,13 @@ ${issues}`;
     if (!state) {
       return this.responseError(`No workflow found: ${taskId}`, taskId);
     }
-    state.status = "phase_draft";
+    state.status = "phase_execute";
     state.phase = "draft";
     state.revisionFeedback = feedback;
     state.verifyOutput = void 0;
     state.verifyAttempts = 0;
     this.saveState(state);
-    return this.responsePhaseDraft(state);
+    return this.responsePhaseExecute(state);
   }
   /**
    * Reject and stop workflow
@@ -2508,6 +2514,8 @@ ${issues}`;
         return this.responsePhaseContext(state);
       case "phase_generate":
         return this.responsePhaseGenerate(state);
+      case "phase_draft":
+        return this.responsePhaseExecute(state);
       // New 5-phase workflow
       case "phase_explore":
         return this.responsePhaseExplore(state);
@@ -2515,8 +2523,8 @@ ${issues}`;
         return this.responsePhaseClarify(state);
       case "clarify_pending":
         return this.responseCheckpointClarify(state);
-      case "phase_draft":
-        return this.responsePhaseDraft(state);
+      case "phase_execute":
+        return this.responsePhaseExecute(state);
       case "phase_verify":
         return this.responsePhaseVerify(state);
       // Section-based workflow
@@ -2706,14 +2714,14 @@ var StepExecutor = class {
     return { phase: "generate" };
   }
   // ==========================================================================
-  // Phase 3 (New): Draft - Document Generation with Explore Output
+  // Phase 3 (New): Execute - Document/Code Generation with Explore Output
   // ==========================================================================
   /**
-   * Execute draft phase - AI creates document using explore output
+   * Execute the execute phase - AI creates document/code using explore output
    */
-  async executeDraftPhase(step, context) {
+  async executeExecutePhase(step, context) {
     const attemptInfo = context.verifyAttempts && context.verifyAttempts > 1 ? ` (attempt ${context.verifyAttempts}/3)` : "";
-    this.adapter.io.notify(`Phase 3/5: Drafting document for ${step}${attemptInfo}`, "info");
+    this.adapter.io.notify(`Phase 3/5: Executing for ${step}${attemptInfo}`, "info");
     if (!context.exploreOutput && !context.gatheredContext) {
       throw new Error("Explore phase must be completed before draft phase");
     }
@@ -2736,13 +2744,19 @@ var StepExecutor = class {
       verifyFeedback: context.verifyFeedback,
       cwd: this.cwd
     };
-    const { prompt, outputPath } = buildDraftPrompt(params);
+    const { prompt, outputPath } = buildExecutePrompt(params);
     await this.adapter.ai.execute({ prompt, outputPath });
     if (!existsSync6(outputPath)) {
       throw new Error(`AI did not create document at ${outputPath}`);
     }
-    this.adapter.io.notify(`Document drafted: ${outputPath}`, "success");
-    return { phase: "draft" };
+    this.adapter.io.notify(`Document created: ${outputPath}`, "success");
+    return { phase: "execute" };
+  }
+  /**
+   * @deprecated Use executeExecutePhase instead
+   */
+  async executeDraftPhase(step, context) {
+    return this.executeExecutePhase(step, context);
   }
   // ==========================================================================
   // Phase 4 (New): Verify - Self-Validation
@@ -3791,23 +3805,23 @@ async function startCommand(query, options) {
           };
           const result = await stepExecutor.executeClarifyPhase(clarifyResp.step, stepContext);
           response = orchestrator.cmdClarifyDone(taskId, result.questions || []);
-        } else if (phaseResponse.phase === "draft") {
-          const draftResp = phaseResponse;
-          const attemptInfo = draftResp.context.verifyFeedback ? " (auto-fix)" : "";
-          console.log(`Phase 3/5: Drafting document${attemptInfo}...
+        } else if (phaseResponse.phase === "execute" || phaseResponse.phase === "draft") {
+          const executeResp = phaseResponse;
+          const attemptInfo = executeResp.context.verifyFeedback ? " (auto-fix)" : "";
+          console.log(`Phase 3/5: Executing${attemptInfo}...
 `);
           const stepContext = {
-            taskId: draftResp.taskId,
-            description: draftResp.description,
-            stepIndex: draftResp.stepIndex,
-            totalSteps: draftResp.totalSteps,
-            exploreOutput: draftResp.exploreOutput,
-            answers: draftResp.answers,
-            revisionFeedback: draftResp.context.revisionFeedback,
-            verifyFeedback: draftResp.context.verifyFeedback
+            taskId: executeResp.taskId,
+            description: executeResp.description,
+            stepIndex: executeResp.stepIndex,
+            totalSteps: executeResp.totalSteps,
+            exploreOutput: executeResp.exploreOutput,
+            answers: executeResp.answers,
+            revisionFeedback: executeResp.context.revisionFeedback,
+            verifyFeedback: executeResp.context.verifyFeedback
           };
-          await stepExecutor.executeDraftPhase(draftResp.step, stepContext);
-          response = orchestrator.cmdDraftDone(taskId);
+          await stepExecutor.executeExecutePhase(executeResp.step, stepContext);
+          response = orchestrator.cmdExecuteDone(taskId);
         } else if (phaseResponse.phase === "verify") {
           const verifyResp = phaseResponse;
           console.log(`Phase 4/5: Verifying document (attempt ${verifyResp.verifyAttempts}/${verifyResp.maxAttempts})...
@@ -4113,23 +4127,23 @@ async function resumeCommand(options) {
           };
           const result = await stepExecutor.executeClarifyPhase(clarifyResp.step, stepContext);
           response = orchestrator.cmdClarifyDone(taskId, result.questions || []);
-        } else if (phaseResponse.phase === "draft") {
-          const draftResp = phaseResponse;
-          const attemptInfo = draftResp.context.verifyFeedback ? " (auto-fix)" : "";
-          console.log(`Phase 3/5: Drafting document${attemptInfo}...
+        } else if (phaseResponse.phase === "execute" || phaseResponse.phase === "draft") {
+          const executeResp = phaseResponse;
+          const attemptInfo = executeResp.context.verifyFeedback ? " (auto-fix)" : "";
+          console.log(`Phase 3/5: Executing${attemptInfo}...
 `);
           const stepContext = {
-            taskId: draftResp.taskId,
-            description: draftResp.description,
-            stepIndex: draftResp.stepIndex,
-            totalSteps: draftResp.totalSteps,
-            exploreOutput: draftResp.exploreOutput,
-            answers: draftResp.answers,
-            revisionFeedback: draftResp.context.revisionFeedback,
-            verifyFeedback: draftResp.context.verifyFeedback
+            taskId: executeResp.taskId,
+            description: executeResp.description,
+            stepIndex: executeResp.stepIndex,
+            totalSteps: executeResp.totalSteps,
+            exploreOutput: executeResp.exploreOutput,
+            answers: executeResp.answers,
+            revisionFeedback: executeResp.context.revisionFeedback,
+            verifyFeedback: executeResp.context.verifyFeedback
           };
-          await stepExecutor.executeDraftPhase(draftResp.step, stepContext);
-          response = orchestrator.cmdDraftDone(taskId);
+          await stepExecutor.executeExecutePhase(executeResp.step, stepContext);
+          response = orchestrator.cmdExecuteDone(taskId);
         } else if (phaseResponse.phase === "verify") {
           const verifyResp = phaseResponse;
           console.log(`Phase 4/5: Verifying document (attempt ${verifyResp.verifyAttempts}/${verifyResp.maxAttempts})...
@@ -4390,7 +4404,7 @@ Parse JSON response \u2192 execute action from table below \u2192 loop until \`t
 |---------|--------|
 | \`explore\` | [ACTION_EXPLORE](#action_explore) |
 | \`clarify\` | [ACTION_CLARIFY](#action_clarify) |
-| \`draft\` | [ACTION_DRAFT](#action_draft) |
+| \`execute\` | [ACTION_EXECUTE](#action_execute) |
 | \`verify\` | [ACTION_VERIFY](#action_verify) |
 | \`generate-sections\` | [ACTION_PARALLEL_SECTIONS](#action_parallel_sections) |
 | \`consolidate\` | [ACTION_PARALLEL_CONSOLIDATE](#action_parallel_consolidate) |
@@ -4449,17 +4463,17 @@ This ensures identical behavior across CLI, Claude Code, and GitHub modes.
 4. Parse response \u2192 next action
 \`\`\`
 
-### ACTION_DRAFT
+### ACTION_EXECUTE
 
 \`\`\`
 1. Follow the instructions in response.prompt EXACTLY
 2. The prompt tells you:
    - The instruction and template to follow
    - The explore output and answers to use
-   - Where to save the document (context.output)
+   - Where to save the document/code (context.output)
    - Any revision/verify feedback to address
-3. Write the document to context.output
-4. Bash: npx spets orchestrate draft-done {taskId}
+3. Write the document/code to context.output
+4. Bash: npx spets orchestrate execute-done {taskId}
 5. Parse response \u2192 next action
 \`\`\`
 
@@ -4624,7 +4638,7 @@ npx spets orchestrate init "<description>"
 npx spets orchestrate explore-done <taskId> '<json>'
 npx spets orchestrate clarify-done <taskId> '<json>'
 npx spets orchestrate clarified <taskId> '<json>'
-npx spets orchestrate draft-done <taskId>
+npx spets orchestrate execute-done <taskId>
 npx spets orchestrate verify-done <taskId> '<json>'
 npx spets orchestrate approve <taskId>
 npx spets orchestrate revise <taskId> "<feedback>"
@@ -5244,13 +5258,24 @@ async function orchestrateCommand(action, args) {
         outputJSON(result);
         break;
       }
+      case "execute-done": {
+        const taskId = args[0];
+        if (!taskId) {
+          outputError("Task ID is required for execute-done");
+          return;
+        }
+        const result = orchestrator.cmdExecuteDone(taskId);
+        outputJSON(result);
+        break;
+      }
+      // Legacy alias for execute-done
       case "draft-done": {
         const taskId = args[0];
         if (!taskId) {
           outputError("Task ID is required for draft-done");
           return;
         }
-        const result = orchestrator.cmdDraftDone(taskId);
+        const result = orchestrator.cmdExecuteDone(taskId);
         outputJSON(result);
         break;
       }
@@ -5391,7 +5416,7 @@ async function orchestrateCommand(action, args) {
         break;
       }
       default:
-        outputError(`Unknown action: ${action}. Valid actions: init, explore-done, clarify-done, draft-done, verify-done, clarified, approve, revise, reject, stop, status, sections-done, consolidate-level-done (legacy: context-done, generate-done, done)`);
+        outputError(`Unknown action: ${action}. Valid actions: init, explore-done, clarify-done, execute-done, verify-done, clarified, approve, revise, reject, stop, status, sections-done, consolidate-level-done (legacy: context-done, generate-done, draft-done, done)`);
     }
   } catch (e) {
     outputError(e.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spets",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "Spec Driven Development Execution Framework",
   "type": "module",
   "main": "dist/index.js",