spets 0.1.52 → 0.1.53

package/dist/index.js

@@ -262,195 +262,53 @@ async function listPlugins() {
   }
 }
 function getClaudeSkillContent() {
-  return `# Spets Command Executor
+  return `# Spets Workflow Executor
 
-Execute orchestrator commands. Parse JSON response \u2192 execute matching action.
-
----
+Orchestrator-controlled workflow. Execute commands, parse JSON response, run \`onComplete\`.
 
 ## Constraints
 
-- **NO** EnterPlanMode
-- **NO** TaskCreate/TaskUpdate
-- **NO** subprocess spawning for AI calls
-- **IMMEDIATELY** execute commands, no planning
-
----
+- NO EnterPlanMode, TaskCreate/TaskUpdate, subprocess spawning
+- Execute immediately - no planning
 
-## Start
+## Execution Loop
 
 \`\`\`bash
 npx spets orchestrate init "$ARGUMENTS"
 \`\`\`
 
-Parse JSON response \u2192 execute action from table below \u2192 loop until \`type: "complete"\` or \`type: "error"\`.
-
----
-
-## Command Table
-
-### \`type: "phase"\`
-
-| \`phase\` | Action |
-|---------|--------|
-| \`explore\` | [ACTION_EXPLORE](#action_explore) |
-| \`clarify\` | [ACTION_CLARIFY](#action_clarify) |
-| \`execute\` | [ACTION_EXECUTE](#action_execute) |
-| \`verify\` | [ACTION_VERIFY](#action_verify) |
-
-### \`type: "checkpoint"\`
-
-| \`checkpoint\` | Action |
-|--------------|--------|
-| \`clarify\` | [ACTION_ASK_QUESTIONS](#action_ask_questions) |
-| \`approve\` | [ACTION_ASK_APPROVAL](#action_ask_approval) |
+Loop until \`type: "complete"\` or \`type: "error"\`:
 
-### \`type: "complete"\`
-
-| \`status\` | Action |
-|----------|--------|
-| \`completed\` | Print: "Workflow complete. Outputs: {outputs}" |
-| \`stopped\` | Print: "Workflow paused. Resume with: npx spets resume --task {taskId}" |
-| \`rejected\` | Print: "Workflow rejected." |
-
-### \`type: "error"\`
-
-Print: "Error: {error}" \u2192 STOP
-
----
-
-## Action Definitions
-
-**IMPORTANT:** Each phase response includes a \`prompt\` field containing the exact instructions to follow.
-This ensures identical behavior across CLI, Claude Code, and GitHub modes.
-
-### ACTION_EXPLORE
-
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - What to search for
-   - How to analyze the codebase
-   - The exact JSON output format required
-3. Bash: npx spets orchestrate explore-done {taskId} '{exploreJson}'
-4. Parse response \u2192 next action
-\`\`\`
-
-### ACTION_CLARIFY
-
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - What context to analyze
-   - How to generate questions
-   - The exact JSON output format required
-3. Bash: npx spets orchestrate clarify-done {taskId} '{questionsJson}'
-   - Format: [{"id":"q1","question":"..."},...]
-   - Empty if no questions: []
-4. Parse response \u2192 next action
-\`\`\`
-
-### 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/code (context.output)
-   - Any revision/verify feedback to address
-3. Write the document/code to context.output
-4. Bash: npx spets orchestrate execute-done {taskId}
-5. Parse response \u2192 next action
-\`\`\`
-
-### ACTION_VERIFY
-
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - The document to verify (already included in prompt)
-   - The requirements and template to check against
-   - The scoring criteria and pass conditions
-   - The exact JSON output format required
-3. Bash: npx spets orchestrate verify-done {taskId} '{verifyJson}'
-4. Parse response \u2192 next action
-   - If passed: goes to human review
-   - If failed (attempts < 3): goes back to draft phase (auto-fix)
-   - If failed (attempts >= 3): goes to human review with warning
-\`\`\`
-
-### ACTION_ASK_QUESTIONS
-
-\`\`\`
-1. AskUserQuestion(
-     questions: [
-       FOR EACH q IN questions:
-         {
-           question: q.question,
-           header: "Q{index}",
-           options: q.options OR [
-             {label: "Provide answer", description: "Type your answer"}
-           ]
-         }
-     ]
-   )
-
-2. Collect answers into: [{"questionId":"q1","answer":"..."},...]
-
-3. Bash: npx spets orchestrate clarified {taskId} '{answersJson}'
-
-4. Parse response \u2192 next action
-\`\`\`
+1. Parse JSON response
+2. Execute action based on \`type\` and \`phase\`/\`checkpoint\`
+3. Run the \`onComplete\` command from response
+4. Parse next response \u2192 repeat
 
-### ACTION_ASK_APPROVAL
+## Actions
 
-\`\`\`
-1. Read(specPath)
+### type: "phase"
 
-2. Summarize document (2-3 sentences)
+| phase | Action |
+|-------|--------|
+| explore | Follow \`response.prompt\` \u2192 run \`onComplete\` with JSON result |
+| clarify | Follow \`response.prompt\` \u2192 run \`onComplete\` with questions JSON |
+| execute | Follow \`response.prompt\` \u2192 write to \`context.output\` \u2192 run \`onComplete\` |
+| verify | Follow \`response.prompt\` \u2192 run \`onComplete\` with verify JSON |
 
-3. AskUserQuestion(
-     questions: [{
-       question: "Review {step} document. What would you like to do?",
-       header: "Review",
-       options: [
-         {label: "Approve", description: "Continue to next step"},
-         {label: "Revise", description: "Request changes"},
-         {label: "Reject", description: "Stop workflow"},
-         {label: "Stop", description: "Pause for later"}
-       ]
-     }]
-   )
+### type: "checkpoint"
 
-4. SWITCH answer:
-   - "Approve": Bash: npx spets orchestrate approve {taskId}
-   - "Revise":
-       - Ask for feedback (AskUserQuestion or text input)
-       - Bash: npx spets orchestrate revise {taskId} "{feedback}"
-   - "Reject": Bash: npx spets orchestrate reject {taskId}
-   - "Stop": Bash: npx spets orchestrate stop {taskId}
+| checkpoint | Action |
+|------------|--------|
+| clarify | AskUserQuestion for each \`response.questions\` \u2192 run \`onComplete\` with answers |
+| approve | Read \`specPath\`, summarize, AskUserQuestion (Approve/Revise/Reject/Stop) \u2192 run matching \`onComplete\` |
 
-5. Parse response \u2192 next action
-\`\`\`
+### type: "complete"
 
----
+Print message and stop.
 
-## Orchestrator Commands Reference
+### type: "error"
 
-\`\`\`bash
-# New 5-phase workflow
-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 execute-done <taskId>
-npx spets orchestrate verify-done <taskId> '<json>'
-npx spets orchestrate approve <taskId>
-npx spets orchestrate revise <taskId> "<feedback>"
-npx spets orchestrate reject <taskId>
-npx spets orchestrate stop <taskId>
-\`\`\`
+Print error and stop.
 
 ---
 
@@ -461,147 +319,51 @@ description: Task description for the workflow
 function getCodexSkillContent() {
   return `---
 name: spets
-description: SDD workflow executor - runs spec-driven development workflows within Codex CLI
+description: SDD workflow executor - orchestrator-controlled spec-driven development
 ---
 
-# Spets Command Executor
+# Spets Workflow Executor
 
-Execute orchestrator commands. Parse JSON response \u2192 execute matching action.
+Orchestrator-controlled workflow. Execute commands, parse JSON response, run \`onComplete\`.
 
----
-
-## Constraints
-
-- **IMMEDIATELY** execute commands, no planning
-- **DO NOT** explore or search on your own - ONLY follow response.prompt
-
----
-
-## Start
+## Execution Loop
 
 \`\`\`bash
 npx spets orchestrate init "$ARGUMENTS"
 \`\`\`
 
-Parse JSON response \u2192 execute action from table below \u2192 loop until \`type: "complete"\` or \`type: "error"\`.
-
----
-
-## Command Table
-
-### \`type: "phase"\`
+Loop until \`type: "complete"\` or \`type: "error"\`:
 
-| \`phase\` | Action |
-|---------|--------|
-| \`explore\` | [ACTION_EXPLORE](#action_explore) |
-| \`clarify\` | [ACTION_CLARIFY](#action_clarify) |
-| \`execute\` | [ACTION_EXECUTE](#action_execute) |
-| \`verify\` | [ACTION_VERIFY](#action_verify) |
+1. Parse JSON response
+2. Execute action based on \`type\` and \`phase\`/\`checkpoint\`
+3. Run the \`onComplete\` command from response
+4. Parse next response \u2192 repeat
 
-### \`type: "checkpoint"\`
+## Actions
 
-| \`checkpoint\` | Action |
-|--------------|--------|
-| \`clarify\` | [ACTION_ASK_QUESTIONS](#action_ask_questions) |
-| \`approve\` | [ACTION_ASK_APPROVAL](#action_ask_approval) |
+### type: "phase"
 
-### \`type: "complete"\`
+| phase | Action |
+|-------|--------|
+| explore | Follow \`response.prompt\` \u2192 run \`onComplete\` with JSON result |
+| clarify | Follow \`response.prompt\` \u2192 run \`onComplete\` with questions JSON |
+| execute | Follow \`response.prompt\` \u2192 write to \`context.output\` \u2192 run \`onComplete\` |
+| verify | Follow \`response.prompt\` \u2192 run \`onComplete\` with verify JSON |
 
-| \`status\` | Action |
-|----------|--------|
-| \`completed\` | Print: "Workflow complete. Outputs: {outputs}" |
-| \`stopped\` | Print: "Workflow paused. Resume with: npx spets resume --task {taskId}" |
-| \`rejected\` | Print: "Workflow rejected." |
+### type: "checkpoint"
 
-### \`type: "error"\`
+| checkpoint | Action |
+|------------|--------|
+| clarify | Ask user each \`response.questions\` \u2192 run \`onComplete\` with answers |
+| approve | Read \`specPath\`, summarize, ask user (Approve/Revise/Reject/Stop) \u2192 run matching \`onComplete\` |
 
-Print: "Error: {error}" \u2192 STOP
+### type: "complete"
 
----
-
-## Action Definitions
-
-**IMPORTANT:** Each phase response includes a \`prompt\` field containing the exact instructions to follow.
-You MUST follow the prompt EXACTLY. Do NOT explore or search on your own.
+Print message and stop.
 
-### ACTION_EXPLORE
+### type: "error"
 
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - What to search for
-   - How to analyze the codebase
-   - The exact JSON output format required
-3. Run: npx spets orchestrate explore-done {taskId} '{exploreJson}'
-4. Parse response \u2192 next action
-\`\`\`
-
-### ACTION_CLARIFY
-
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - What context to analyze
-   - How to generate questions
-   - The exact JSON output format required
-3. Run: npx spets orchestrate clarify-done {taskId} '{questionsJson}'
-   - Format: [{"id":"q1","question":"..."},...]
-   - Empty if no questions: []
-4. Parse response \u2192 next action
-\`\`\`
-
-### 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/code (context.output)
-   - Any revision/verify feedback to address
-3. Write the document/code to context.output
-4. Run: npx spets orchestrate execute-done {taskId}
-5. Parse response \u2192 next action
-\`\`\`
-
-### ACTION_VERIFY
-
-\`\`\`
-1. Follow the instructions in response.prompt EXACTLY
-2. The prompt tells you:
-   - The document to verify (already included in prompt)
-   - The requirements and template to check against
-   - The scoring criteria and pass conditions
-   - The exact JSON output format required
-3. Run: npx spets orchestrate verify-done {taskId} '{verifyJson}'
-4. Parse response \u2192 next action
-   - If passed: goes to human review
-   - If failed (attempts < 3): goes back to draft phase (auto-fix)
-   - If failed (attempts >= 3): goes to human review with warning
-\`\`\`
-
-### ACTION_ASK_QUESTIONS
-
-\`\`\`
-1. Ask user each question from response.questions
-2. Collect answers into: [{"questionId":"q1","answer":"..."},...]
-3. Run: npx spets orchestrate clarified {taskId} '{answersJson}'
-4. Parse response \u2192 next action
-\`\`\`
-
-### ACTION_ASK_APPROVAL
-
-\`\`\`
-1. Read the document at context.output
-2. Summarize document (2-3 sentences)
-3. Ask user: "Review {step} document. Approve / Revise / Reject / Stop?"
-4. Based on answer:
-   - Approve: npx spets orchestrate approve {taskId}
-   - Revise: Ask for feedback, then: npx spets orchestrate revise {taskId} "{feedback}"
-   - Reject: npx spets orchestrate reject {taskId}
-   - Stop: npx spets orchestrate stop {taskId}
-5. Parse response \u2192 next action
-\`\`\`
+Print error and stop.
 
 ---
 
@@ -610,10 +372,7 @@ description: Task description for the workflow
 `;
 }
 function getOpenCodeSkillContent() {
-  return getCodexSkillContent().replace(
-    "runs spec-driven development workflows within Codex CLI",
-    "runs spec-driven development workflows within OpenCode"
-  );
+  return getCodexSkillContent();
 }
 
 // src/commands/init.ts

package/package.json

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