spets 0.1.56 → 0.1.58

package/dist/index.js

@@ -264,51 +264,57 @@ async function listPlugins() {
 function getClaudeSkillContent() {
   return `# Spets Workflow Executor
 
-Orchestrator-controlled workflow. Execute commands, parse JSON response, run \`onComplete\`.
+Orchestrator-controlled workflow. Execute immediately.
 
-## Constraints
-
-- NO EnterPlanMode, TaskCreate/TaskUpdate, subprocess spawning
-- Execute immediately - no planning
-
-## Execution Loop
+## Start
 
+Run this command with the user's task description:
 \`\`\`bash
 npx spets orchestrate init "$ARGUMENTS"
 \`\`\`
 
-Loop until \`type: "complete"\` or \`type: "error"\`:
+## Main Loop
+
+Repeat until \`type\` is \`"complete"\` or \`"error"\`:
+
+1. Parse the JSON response
+2. Execute the action for this \`type\`
+3. Run the shell command in \`response.onComplete\`, piping JSON via stdin
+4. Use the new JSON response, go to step 1
 
-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
+## How to Run onComplete
+
+The \`onComplete\` field contains a complete shell command. Pipe your JSON result via stdin:
+
+\`\`\`bash
+echo '<your_json>' | npx spets orchestrate explore-done task-id-123
+\`\`\`
 
-## Actions
+## Actions by Type
 
 ### type: "phase"
 
 | 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 |
+| explore | Follow \`prompt\`, pipe explore JSON to \`onComplete\` |
+| clarify | Follow \`prompt\`, pipe questions JSON to \`onComplete\` |
+| execute | Follow \`prompt\`, write to \`context.output\`, run \`onComplete\` |
+| verify | Follow \`prompt\`, pipe verify JSON to \`onComplete\` |
 
 ### type: "checkpoint"
 
 | 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\` |
+| clarify | Use AskUserQuestion for each item in \`questions\`, pipe answers JSON to \`onComplete\` |
+| approve | Read \`specPath\`, summarize, use AskUserQuestion (Approve/Revise/Reject/Stop), run \`onComplete[choice]\` |
 
 ### type: "complete"
 
-Print message and stop.
+Print \`message\` and stop.
 
 ### type: "error"
 
-Print error and stop.
+Print \`error\` and stop.
 
 ---
 
@@ -324,46 +330,57 @@ description: SDD workflow executor - orchestrator-controlled spec-driven develop
 
 # Spets Workflow Executor
 
-Orchestrator-controlled workflow. Execute commands, parse JSON response, run \`onComplete\`.
+Orchestrator-controlled workflow.
 
-## Execution Loop
+## Start
 
+Run this command with the user's task description:
 \`\`\`bash
-npx spets orchestrate init "$ARGUMENTS"
+npx spets orchestrate init "user's task description here"
 \`\`\`
 
-Loop until \`type: "complete"\` or \`type: "error"\`:
+## Main Loop
+
+Repeat until \`type\` is \`"complete"\` or \`"error"\`:
+
+1. Parse the JSON response
+2. Execute the action for this \`type\`
+3. Run the shell command in \`response.onComplete\`, piping JSON via stdin
+4. Use the new JSON response, go to step 1
+
+## How to Run onComplete
 
-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
+The \`onComplete\` field contains a complete shell command. Pipe your JSON result via stdin:
+
+\`\`\`bash
+echo '<your_json>' | npx spets orchestrate explore-done task-id-123
+\`\`\`
 
-## Actions
+## Actions by Type
 
 ### type: "phase"
 
 | 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 |
+| explore | Follow \`prompt\`, pipe explore JSON to \`onComplete\` |
+| clarify | Follow \`prompt\`, pipe questions JSON to \`onComplete\` |
+| execute | Follow \`prompt\`, write to \`context.output\`, run \`onComplete\` |
+| verify | Follow \`prompt\`, pipe verify JSON to \`onComplete\` |
 
 ### type: "checkpoint"
 
 | 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\` |
+| clarify | Ask user each question in \`questions\`, pipe answers JSON to \`onComplete\` |
+| approve | Read \`specPath\`, summarize, ask user (Approve/Revise/Reject/Stop), run \`onComplete[choice]\` |
 
 ### type: "complete"
 
-Print message and stop.
+Print \`message\` and stop.
 
 ### type: "error"
 
-Print error and stop.
+Print \`error\` and stop.
 
 ---
 
@@ -4142,6 +4159,31 @@ function outputError(error) {
   console.log(JSON.stringify({ type: "error", error }, null, 2));
   process.exit(1);
 }
+async function readStdin() {
+  if (process.stdin.isTTY) {
+    return void 0;
+  }
+  return new Promise((resolve) => {
+    let data = "";
+    const timeout = setTimeout(() => {
+      process.stdin.removeAllListeners();
+      resolve(void 0);
+    }, 100);
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on("end", () => {
+      clearTimeout(timeout);
+      resolve(data.trim() || void 0);
+    });
+    process.stdin.on("error", () => {
+      clearTimeout(timeout);
+      resolve(void 0);
+    });
+    process.stdin.resume();
+  });
+}
 async function orchestrateCommand(action, args) {
   try {
     const orchestrator = new Orchestrator();
@@ -4158,11 +4200,14 @@ async function orchestrateCommand(action, args) {
       }
       case "explore-done": {
         const taskId = args[0];
-        const exploreJson = args[1];
+        let exploreJson = args[1];
         if (!taskId) {
           outputError("Task ID is required for explore-done");
           return;
         }
+        if (!exploreJson) {
+          exploreJson = await readStdin();
+        }
         let exploreOutput = {
           summary: "",
           relevantFiles: [],
@@ -4183,11 +4228,14 @@ async function orchestrateCommand(action, args) {
       }
       case "clarify-done": {
         const taskId = args[0];
-        const questionsJson = args[1];
+        let questionsJson = args[1];
         if (!taskId) {
           outputError("Task ID is required for clarify-done");
           return;
         }
+        if (!questionsJson) {
+          questionsJson = await readStdin();
+        }
         let questions = [];
         if (questionsJson) {
           try {
@@ -4213,11 +4261,14 @@ async function orchestrateCommand(action, args) {
       }
       case "verify-done": {
         const taskId = args[0];
-        const verifyJson = args[1];
+        let verifyJson = args[1];
         if (!taskId) {
           outputError("Task ID is required for verify-done");
           return;
         }
+        if (!verifyJson) {
+          verifyJson = await readStdin();
+        }
         let verifyOutput = {
           passed: false,
           score: {
@@ -4243,9 +4294,16 @@ async function orchestrateCommand(action, args) {
       }
       case "clarified": {
         const taskId = args[0];
-        const answersJson = args[1];
-        if (!taskId || !answersJson) {
-          outputError("Task ID and answers JSON are required for clarified");
+        let answersJson = args[1];
+        if (!taskId) {
+          outputError("Task ID is required for clarified");
+          return;
+        }
+        if (!answersJson) {
+          answersJson = await readStdin();
+        }
+        if (!answersJson) {
+          outputError("Answers JSON is required for clarified (via argument or stdin)");
           return;
         }
         let answers;

package/package.json

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