spets 0.1.8 → 0.1.10

package/dist/{chunk-YK5ZZE4P.js → chunk-NOS3N4GT.js}

@@ -10,6 +10,9 @@ import { parse as parseYaml } from "yaml";
 var SPETS_DIR = ".spets";
 var CONFIG_FILE = "config.yml";
 var STEPS_DIR = "steps";
+var configCache = null;
+var configCachePath = null;
+var stepDefinitionCache = /* @__PURE__ */ new Map();
 function getSpetsDir(cwd = process.cwd()) {
   return join(cwd, SPETS_DIR);
 }
@@ -27,6 +30,9 @@ function spetsExists(cwd = process.cwd()) {
 }
 function loadConfig(cwd = process.cwd()) {
   const configPath = getConfigPath(cwd);
+  if (configCache && configCachePath === configPath) {
+    return configCache;
+  }
   if (!existsSync(configPath)) {
     throw new Error(`Spets config not found. Run 'spets init' first.`);
   }
@@ -35,9 +41,15 @@ function loadConfig(cwd = process.cwd()) {
   if (!config.steps || config.steps.length === 0) {
     throw new Error("Config must define at least one step");
   }
+  configCache = config;
+  configCachePath = configPath;
   return config;
 }
 function loadStepDefinition(stepName, cwd = process.cwd()) {
+  const cacheKey = `${cwd}:${stepName}`;
+  if (stepDefinitionCache.has(cacheKey)) {
+    return stepDefinitionCache.get(cacheKey);
+  }
   const stepDir = join(getStepsDir(cwd), stepName);
   const instructionPath = join(stepDir, "instruction.md");
   const templatePath = join(stepDir, "template.md");
@@ -46,19 +58,58 @@ function loadStepDefinition(stepName, cwd = process.cwd()) {
   }
   const instruction = readFileSync(instructionPath, "utf-8");
   const template = existsSync(templatePath) ? readFileSync(templatePath, "utf-8") : void 0;
-  return {
+  const stepDef = {
     name: stepName,
     instruction,
     template
   };
+  stepDefinitionCache.set(cacheKey, stepDef);
+  return stepDef;
 }
 function getGitHubConfig(cwd = process.cwd()) {
   const config = loadConfig(cwd);
   return config.github;
 }
 
+// src/core/slug.ts
+function generateRandomSuffix() {
+  return Math.random().toString(36).substring(2, 6);
+}
+function generateDatePrefix() {
+  const now = /* @__PURE__ */ new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function sanitizeDescription(description) {
+  let sanitized = description.toLowerCase();
+  sanitized = sanitized.replace(/[^\x00-\x7F]/g, "");
+  sanitized = sanitized.replace(/[^a-z0-9\s]/g, "");
+  sanitized = sanitized.trim();
+  sanitized = sanitized.replace(/\s+/g, " ");
+  sanitized = sanitized.replace(/\s+/g, "-");
+  if (sanitized.length > 10) {
+    sanitized = sanitized.substring(0, 10);
+  }
+  sanitized = sanitized.replace(/-+$/, "");
+  if (sanitized === "") {
+    sanitized = "task";
+  }
+  return sanitized;
+}
+function generateSlug(description) {
+  const datePrefix = generateDatePrefix();
+  const meaningfulName = sanitizeDescription(description);
+  const randomSuffix = generateRandomSuffix();
+  return `${datePrefix}-${meaningfulName}-${randomSuffix}`;
+}
+
 // src/core/state.ts
-function generateTaskId() {
+function generateTaskId(description) {
+  if (description) {
+    return generateSlug(description);
+  }
   const timestamp = Date.now().toString(36);
   const random = Math.random().toString(36).substring(2, 6);
   return `${timestamp}-${random}`;
@@ -132,11 +183,68 @@ function listTasks(cwd = process.cwd()) {
   }
   return readdirSync(outputsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
 }
+function getStateCachePath(taskId, cwd = process.cwd()) {
+  return join2(getTaskDir(taskId, cwd), ".state-cache.json");
+}
+function loadStateCache(taskId, cwd = process.cwd()) {
+  const cachePath = getStateCachePath(taskId, cwd);
+  if (!existsSync2(cachePath)) {
+    return null;
+  }
+  try {
+    const cached = JSON.parse(readFileSync2(cachePath, "utf-8"));
+    return cached;
+  } catch {
+    return null;
+  }
+}
+function saveStateCache(taskId, state, cwd = process.cwd()) {
+  const cachePath = getStateCachePath(taskId, cwd);
+  const stepStatuses = {};
+  for (const [stepName, output] of state.outputs.entries()) {
+    stepStatuses[stepName] = output.status;
+  }
+  const cached = {
+    lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
+    taskId: state.taskId,
+    userQuery: state.userQuery,
+    currentStepIndex: state.currentStepIndex,
+    currentStepName: state.currentStepName,
+    status: state.status,
+    stepStatuses
+  };
+  try {
+    writeFileSync(cachePath, JSON.stringify(cached, null, 2));
+  } catch {
+  }
+}
+function isStateCacheValid(cached, maxAgeMs = 5e3) {
+  const age = Date.now() - new Date(cached.lastUpdated).getTime();
+  return age < maxAgeMs;
+}
 function getWorkflowState(taskId, config, cwd = process.cwd()) {
   const taskDir = getTaskDir(taskId, cwd);
   if (!existsSync2(taskDir)) {
     return null;
   }
+  const cached = loadStateCache(taskId, cwd);
+  if (cached && isStateCacheValid(cached)) {
+    const outputs2 = /* @__PURE__ */ new Map();
+    for (const [stepName, status] of Object.entries(cached.stepStatuses)) {
+      outputs2.set(stepName, {
+        path: getOutputPath(taskId, stepName, cwd),
+        status
+      });
+    }
+    return {
+      taskId: cached.taskId,
+      userQuery: cached.userQuery,
+      currentStepIndex: cached.currentStepIndex,
+      currentStepName: cached.currentStepName,
+      status: cached.status,
+      outputs: outputs2
+    };
+  }
   const outputs = /* @__PURE__ */ new Map();
   let lastApprovedIndex = -1;
   let currentStatus = "in_progress";
@@ -171,7 +279,7 @@ function getWorkflowState(taskId, config, cwd = process.cwd()) {
   if (currentDoc?.frontmatter.status === "draft" && currentDoc.frontmatter.open_questions?.length) {
     currentStatus = "paused";
   }
-  return {
+  const state = {
     taskId,
     userQuery,
     currentStepIndex,
@@ -179,6 +287,8 @@ function getWorkflowState(taskId, config, cwd = process.cwd()) {
     status: currentStatus,
     outputs
   };
+  saveStateCache(taskId, state, cwd);
+  return state;
 }
 function saveTaskMetadata(taskId, userQuery, cwd = process.cwd()) {
   const taskDir = ensureTaskDir(taskId, cwd);
@@ -192,6 +302,21 @@ function loadTaskMetadata(taskId, cwd = process.cwd()) {
   }
   return JSON.parse(readFileSync2(metaPath, "utf-8"));
 }
+function extractPlanSummary(taskId, cwd = process.cwd()) {
+  const doc = loadDocument(taskId, "01-plan", cwd);
+  if (!doc) {
+    return null;
+  }
+  const summaryMatch = doc.content.match(/## Summary\n\n(.+?)(?=\n\n##|\n\n$|$)/s);
+  if (summaryMatch) {
+    return summaryMatch[1].trim();
+  }
+  const goalMatch = doc.content.match(/## Goal\n\n(.+?)(?=\n\n##|\n\n$|$)/s);
+  if (goalMatch) {
+    return goalMatch[1].trim();
+  }
+  return null;
+}
 
 export {
   getSpetsDir,
@@ -213,5 +338,6 @@ export {
   listTasks,
   getWorkflowState,
   saveTaskMetadata,
-  loadTaskMetadata
+  loadTaskMetadata,
+  extractPlanSummary
 };

package/dist/index.js

@@ -16,13 +16,13 @@ import {
   saveTaskMetadata,
   spetsExists,
   updateDocumentStatus
-} from "./chunk-YK5ZZE4P.js";
+} from "./chunk-NOS3N4GT.js";
 
 // src/index.ts
 import { Command } from "commander";
 
 // src/commands/init.ts
-import { mkdirSync, writeFileSync } from "fs";
+import { mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -121,155 +121,20 @@ function createDefaultSteps(spetsDir) {
   writeFileSync(join(implementDir, "template.md"), getImplementTemplate());
 }
 function getPlanInstruction() {
-  return `# Plan Step
-
-You are creating a technical plan for the given task.
-
-## Your Goal
-
-Analyze the user's request and create a detailed implementation plan.
-
-## Process
-
-1. **Understand the Request**
-   - Parse the user's query to identify the core requirements
-   - Identify any ambiguities or missing information
-
-2. **Ask Clarifying Questions** (if needed)
-   - If requirements are unclear, list questions in the \`open_questions\` section
-   - Questions should be specific and actionable
-
-3. **Create the Plan**
-   - Break down the task into concrete steps
-   - Identify files to create/modify
-   - Consider edge cases and potential issues
-
-## Output Format
-
-Follow the template provided. Include:
-- Summary of what will be built
-- Step-by-step implementation plan
-- Files to be created/modified
-- Any open questions (if requirements are unclear)
-`;
+  const fullTemplate = readFileSync(join(__dirname, "..", ".spets", "steps", "01-plan", "instruction.md"), "utf-8");
+  return fullTemplate;
 }
 function getPlanTemplate() {
-  return `# Plan: {{title}}
-
-## Summary
-
-Brief description of what will be implemented.
-
-## Requirements
-
-- Requirement 1
-- Requirement 2
-
-## Implementation Steps
-
-### Step 1: [Description]
-
-Details...
-
-### Step 2: [Description]
-
-Details...
-
-## Files to Modify
-
-| File | Action | Description |
-|------|--------|-------------|
-| path/to/file | Create/Modify | What changes |
-
-## Open Questions
-
-<!-- Remove this section if no questions -->
-
-- Question 1?
-- Question 2?
-
-## Risks & Considerations
-
-- Risk 1
-- Risk 2
-`;
+  const fullTemplate = readFileSync(join(__dirname, "..", ".spets", "steps", "01-plan", "template.md"), "utf-8");
+  return fullTemplate;
 }
 function getImplementInstruction() {
-  return `# Implement Step
-
-You are implementing the plan from the previous step.
-
-## Your Goal
-
-Write the actual code based on the approved plan.
-
-## Process
-
-1. **Review the Plan**
-   - Read the approved plan document carefully
-   - Understand all requirements and steps
-
-2. **Implement**
-   - Follow the plan step by step
-   - Write clean, well-documented code
-   - Handle edge cases identified in the plan
-
-3. **Document Changes**
-   - List all files created/modified
-   - Explain key decisions made during implementation
-
-## Output Format
-
-Follow the template provided. Include:
-- Summary of implementation
-- List of all changes made
-- Any deviations from the plan (with justification)
-- Testing notes
-`;
+  const fullTemplate = readFileSync(join(__dirname, "..", ".spets", "steps", "02-implement", "instruction.md"), "utf-8");
+  return fullTemplate;
 }
 function getImplementTemplate() {
-  return `# Implementation: {{title}}
-
-## Summary
-
-Brief description of what was implemented.
-
-## Changes Made
-
-### New Files
-
-| File | Description |
-|------|-------------|
-| path/to/file | What it does |
-
-### Modified Files
-
-| File | Changes |
-|------|---------|
-| path/to/file | What changed |
-
-## Key Decisions
-
-- Decision 1: Explanation
-- Decision 2: Explanation
-
-## Deviations from Plan
-
-<!-- Remove if no deviations -->
-
-None / List any deviations with justification.
-
-## Testing
-
-- [ ] Manual testing completed
-- [ ] Unit tests added
-- [ ] Integration tests pass
-
-## Next Steps
-
-- Follow-up task 1
-- Follow-up task 2
-`;
+  const fullTemplate = readFileSync(join(__dirname, "..", ".spets", "steps", "02-implement", "template.md"), "utf-8");
+  return fullTemplate;
 }
 function createClaudeCommand(cwd) {
   const commandDir = join(cwd, ".claude", "commands");
@@ -458,7 +323,13 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Setup Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
 
       - name: Parse Issue body
         id: parse
@@ -479,17 +350,33 @@ jobs:
 
       - name: Create and checkout branch
         run: |
+          git remote set-url origin https://x-access-token:${gh("secrets.PAT_TOKEN")}@github.com/${gh("github.repository")}.git
           git checkout -b ${gh("steps.parse.outputs.branch")}
           git push -u origin ${gh("steps.parse.outputs.branch")}
-        env:
-          GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
+          cache: 'npm'
+
+      - name: Cache global npm packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${gh("runner.os")}-npm-global-${gh("hashFiles('package-lock.json')")}
+          restore-keys: |
+            ${gh("runner.os")}-npm-global-
+
+      - name: Cache Claude Code
+        id: cache-claude
+        uses: actions/cache@v4
+        with:
+          path: /usr/local/lib/node_modules/@anthropic-ai/claude-code
+          key: claude-code-${gh("runner.os")}-v1
 
       - name: Install Claude Code
+        if: steps.cache-claude.outputs.cache-hit != 'true'
         run: npm install -g @anthropic-ai/claude-code
 
       - name: Install dependencies
@@ -505,13 +392,10 @@ jobs:
 
       - name: Push changes
         run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git remote set-url origin https://x-access-token:${gh("secrets.PAT_TOKEN")}@github.com/${gh("github.repository")}.git
           git add -A
           git diff --staged --quiet || git commit -m "Spets: Start workflow for #${gh("github.event.issue.number")}"
           git push
-        env:
-          GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
 
   # Handle commands from Issue/PR comments
   handle-command:
@@ -524,38 +408,108 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Find linked branch
+      - name: Find branch from Issue or PR
         id: branch
+        env:
+          GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
         run: |
-          # Try to find branch linked to this issue
-          BRANCH=$(gh api repos/${gh("github.repository")}/issues/${gh("github.event.issue.number")} --jq '.body' | grep -oP 'spets/\\d+' || echo "")
-          if [ -z "$BRANCH" ]; then
-            BRANCH="spets/${gh("github.event.issue.number")}"
+          # Check if this is a PR (has pull_request field)
+          PR_BRANCH=$(gh api repos/${gh("github.repository")}/issues/${gh("github.event.issue.number")} --jq '.pull_request.url // empty' 2>/dev/null)
+
+          if [ -n "$PR_BRANCH" ]; then
+            # It's a PR - get head branch directly
+            BRANCH=$(gh api repos/${gh("github.repository")}/pulls/${gh("github.event.issue.number")} --jq '.head.ref')
+            echo "Found PR head branch: $BRANCH"
+          else
+            # It's an Issue - try to parse branch name from body
+            ISSUE_BODY=$(gh api repos/${gh("github.repository")}/issues/${gh("github.event.issue.number")} --jq '.body')
+            CUSTOM_BRANCH=$(echo "$ISSUE_BODY" | sed -n '/### Branch Name/,/###/{/###/!p;}' | sed '/^$/d' | head -1)
+
+            if [ -n "$CUSTOM_BRANCH" ]; then
+              BRANCH="$CUSTOM_BRANCH"
+            else
+              BRANCH="spets/${gh("github.event.issue.number")}"
+            fi
+          fi
+
+          echo "Checking for branch: $BRANCH"
+
+          # Check if branch exists on remote using gh api
+          if gh api "repos/${gh("github.repository")}/branches/$BRANCH" --silent 2>/dev/null; then
+            echo "name=$BRANCH" >> $GITHUB_OUTPUT
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "Branch $BRANCH found!"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "expected=$BRANCH" >> $GITHUB_OUTPUT
+            echo "::error::Branch $BRANCH not found. Start workflow first by creating an Issue with 'spets' label."
           fi
-          echo "name=$BRANCH" >> $GITHUB_OUTPUT
+
+      - name: Post error comment
+        if: steps.branch.outputs.exists == 'false'
+        run: |
+          gh issue comment ${gh("github.event.issue.number")} \\
+            -R "${gh("github.repository")}" \\
+            --body "\u274C **Spets Error**: Branch \\\`${gh("steps.branch.outputs.expected")}\\\` not found.
+
+          Please make sure the workflow was started properly. You can:
+          1. Add the \\\`spets\\\` label to this issue to trigger the start workflow
+          2. Or manually create the branch and run \\\`spets start\\\`"
         env:
           GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
 
+      - name: Exit if branch not found
+        if: steps.branch.outputs.exists == 'false'
+        run: exit 1
+
       - name: Checkout
         uses: actions/checkout@v4
         with:
           ref: ${gh("steps.branch.outputs.name")}
-          fetch-depth: 0
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Setup Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
+          cache: 'npm'
+
+      - name: Cache global npm packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${gh("runner.os")}-npm-global-${gh("hashFiles('package-lock.json')")}
+          restore-keys: |
+            ${gh("runner.os")}-npm-global-
+
+      - name: Cache Claude Code
+        id: cache-claude
+        uses: actions/cache@v4
+        with:
+          path: /usr/local/lib/node_modules/@anthropic-ai/claude-code
+          key: claude-code-${gh("runner.os")}-v1
 
       - name: Install Claude Code
+        if: steps.cache-claude.outputs.cache-hit != 'true'
         run: npm install -g @anthropic-ai/claude-code
 
       - name: Install dependencies
         run: npm ci
 
       - name: Run Spets command
+        id: spets
         run: |
           npx spets github --issue ${gh("github.event.issue.number")} --comment "$COMMENT"
+          # Check if PR should be created
+          if [[ "$COMMENT" == "/approve --pr"* ]]; then
+            echo "create_pr=true" >> $GITHUB_OUTPUT
+          fi
         env:
           COMMENT: ${gh("github.event.comment.body")}
           CLAUDE_CODE_OAUTH_TOKEN: ${gh("secrets.CLAUDE_CODE_OAUTH_TOKEN")}
@@ -563,13 +517,33 @@ jobs:
 
       - name: Push changes
         run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git remote set-url origin https://x-access-token:${gh("secrets.PAT_TOKEN")}@github.com/${gh("github.repository")}.git
           git add -A
           git diff --staged --quiet || git commit -m "Spets: Update from #${gh("github.event.issue.number")}"
           git push
+
+      - name: Create PR
+        if: steps.spets.outputs.create_pr == 'true'
+        run: |
+          PR_BODY="Closes #${gh("github.event.issue.number")}
+
+          ---
+
+          ## Spets Commands
+
+          | Command | Description |
+          |---------|-------------|
+          | \\\`/approve\\\` | Approve current step and continue |
+          | \\\`/approve --pr\\\` | Approve and create PR |
+          | \\\`/revise <feedback>\\\` | Request changes with feedback |
+          | \\\`/reject\\\` | Reject and stop workflow |"
+
+          gh pr create \\
+            --title "Spets: Issue #${gh("github.event.issue.number")}" \\
+            --body "$PR_BODY" \\
+            --repo ${gh("github.repository")}
         env:
-          GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
+          GH_TOKEN: ${gh("secrets.PAT_TOKEN")}
 `;
 }
 
@@ -702,6 +676,16 @@ var Executor = class {
     this.config = options.config;
     this.cwd = options.cwd || process.cwd();
   }
+  /**
+   * Preload all step definitions into cache for better performance
+   */
+  async preloadSteps() {
+    await Promise.all(
+      this.config.steps.map(
+        (stepName) => Promise.resolve(loadStepDefinition(stepName, this.cwd))
+      )
+    );
+  }
   async executeWorkflow(taskId, userQuery, startIndex = 0, feedback) {
     let previousOutput;
     if (startIndex > 0) {
@@ -954,7 +938,6 @@ var CliPlatform = class extends BasePlatform {
   async callClaude(prompt) {
     return new Promise((resolve, reject) => {
       const proc = spawn2(this.claudeCommand, [
-        "--print",
         "--permission-mode",
         "bypassPermissions"
       ], {
@@ -1024,6 +1007,21 @@ var CliPlatform = class extends BasePlatform {
 
 // src/platform/github.ts
 import { spawn as spawn3 } from "child_process";
+async function retryWithBackoff(fn, maxRetries = 3, initialDelayMs = 1e3) {
+  let lastError = null;
+  for (let i = 0; i < maxRetries; i++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (i === maxRetries - 1) break;
+      const delay = initialDelayMs * Math.pow(2, i);
+      console.log(`Retry ${i + 1}/${maxRetries} after ${delay}ms...`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+  throw lastError || new Error("Retry failed");
+}
 var PauseForInputError = class extends Error {
   constructor(inputType, data) {
     super(`Paused waiting for ${inputType}`);
@@ -1211,26 +1209,39 @@ var GitHubPlatform = class extends BasePlatform {
     const { owner, repo, issueNumber } = this.config;
     await this.runGh(["issue", "comment", String(issueNumber), "--body", body, "-R", `${owner}/${repo}`]);
   }
-  async runGh(args) {
-    return new Promise((resolve, reject) => {
-      const proc = spawn3("gh", args, { stdio: ["pipe", "pipe", "pipe"] });
-      let stdout = "";
-      let stderr = "";
-      proc.stdout.on("data", (data) => {
-        stdout += data.toString();
-      });
-      proc.stderr.on("data", (data) => {
-        stderr += data.toString();
-      });
-      proc.on("close", (code) => {
-        if (code !== 0) {
-          reject(new Error(`gh command failed: ${stderr}`));
-        } else {
-          resolve(stdout);
-        }
-      });
-      proc.on("error", (err) => {
-        reject(new Error(`Failed to run gh: ${err.message}`));
+  async runGh(args, timeoutMs = 3e4) {
+    return retryWithBackoff(async () => {
+      return new Promise((resolve, reject) => {
+        const proc = spawn3("gh", args, { stdio: ["pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let isTimedOut = false;
+        const timeoutId = setTimeout(() => {
+          isTimedOut = true;
+          proc.kill();
+          reject(new Error(`gh command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        proc.stdout.on("data", (data) => {
+          stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+          stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+          clearTimeout(timeoutId);
+          if (isTimedOut) return;
+          if (code !== 0) {
+            reject(new Error(`gh command failed: ${stderr}`));
+          } else {
+            resolve(stdout);
+          }
+        });
+        proc.on("error", (err) => {
+          clearTimeout(timeoutId);
+          if (!isTimedOut) {
+            reject(new Error(`Failed to run gh: ${err.message}`));
+          }
+        });
       });
     });
   }
@@ -1264,11 +1275,9 @@ var GitHubPlatform = class extends BasePlatform {
   async callClaude(prompt) {
     return new Promise((resolve, reject) => {
       const proc = spawn3("claude", [
-        "-p",
-        prompt,
         "--permission-mode",
         "bypassPermissions"
-      ], { stdio: ["ignore", "pipe", "pipe"] });
+      ], { stdio: ["pipe", "pipe", "pipe"] });
       let stdout = "";
       let stderr = "";
       proc.stdout.on("data", (data) => {
@@ -1277,6 +1286,8 @@ var GitHubPlatform = class extends BasePlatform {
       proc.stderr.on("data", (data) => {
         stderr += data.toString();
       });
+      proc.stdin.write(prompt);
+      proc.stdin.end();
       proc.on("close", (code) => {
         if (code !== 0) {
           reject(new Error(`Claude CLI failed (code ${code}): stderr=${stderr}, stdout=${stdout}`));
@@ -1402,7 +1413,7 @@ async function startCommand(query, options) {
     process.exit(1);
   }
   const config = loadConfig(cwd);
-  const taskId = generateTaskId();
+  const taskId = generateTaskId(query);
   saveTaskMetadata(taskId, query, cwd);
   let platform;
   if (options.github || options.issue !== void 0 || options.pr !== void 0) {
@@ -1612,28 +1623,28 @@ function installClaudePlugin() {
   const claudeDir = join3(homedir(), ".claude");
   const commandsDir = join3(claudeDir, "commands");
   mkdirSync2(commandsDir, { recursive: true });
-  const skillPath = join3(commandsDir, "sdd-do.md");
+  const skillPath = join3(commandsDir, "spets.md");
   writeFileSync2(skillPath, getClaudeSkillContent());
   console.log("Installed Claude Code plugin.");
   console.log(`Location: ${skillPath}`);
   console.log("");
   console.log("Usage in Claude Code:");
-  console.log('  /sdd-do "your task description"');
+  console.log('  /spets "your task description"');
   console.log("");
   console.log("This skill runs deterministically within your Claude Code session.");
   console.log("No additional Claude processes are spawned.");
 }
 async function uninstallPlugin(name) {
   if (name === "claude") {
-    const oldSkillPath = join3(homedir(), ".claude", "commands", "spets.md");
-    const newSkillPath = join3(homedir(), ".claude", "commands", "sdd-do.md");
+    const skillPath = join3(homedir(), ".claude", "commands", "spets.md");
+    const legacySkillPath = join3(homedir(), ".claude", "commands", "sdd-do.md");
     let uninstalled = false;
-    if (existsSync3(oldSkillPath)) {
-      rmSync(oldSkillPath);
+    if (existsSync3(skillPath)) {
+      rmSync(skillPath);
       uninstalled = true;
     }
-    if (existsSync3(newSkillPath)) {
-      rmSync(newSkillPath);
+    if (existsSync3(legacySkillPath)) {
+      rmSync(legacySkillPath);
       uninstalled = true;
     }
     if (uninstalled) {
@@ -1649,11 +1660,11 @@ async function uninstallPlugin(name) {
 async function listPlugins() {
   console.log("Available plugins:");
   console.log("");
-  console.log("  claude - Claude Code /sdd-do skill");
+  console.log("  claude - Claude Code /spets skill");
   console.log("");
-  const oldSkillPath = join3(homedir(), ".claude", "commands", "spets.md");
-  const newSkillPath = join3(homedir(), ".claude", "commands", "sdd-do.md");
-  const claudeInstalled = existsSync3(oldSkillPath) || existsSync3(newSkillPath);
+  const skillPath = join3(homedir(), ".claude", "commands", "spets.md");
+  const legacySkillPath = join3(homedir(), ".claude", "commands", "sdd-do.md");
+  const claudeInstalled = existsSync3(skillPath) || existsSync3(legacySkillPath);
   console.log("Installed:");
   if (claudeInstalled) {
     console.log("  - claude");
@@ -1662,7 +1673,7 @@ async function listPlugins() {
   }
 }
 function getClaudeSkillContent() {
-  return `# SDD-Do Skill
+  return `# Spets - Spec Driven Development
 
 Spec-Driven Development workflow execution skill for Claude Code.
 
@@ -1671,7 +1682,7 @@ Spec-Driven Development workflow execution skill for Claude Code.
 ## When to Use This Skill
 
 Automatically invoked when user uses:
-- \`/sdd-do\` - Run SDD workflow
+- \`/spets\` - Run Spets workflow
 
 ---
 
@@ -1893,7 +1904,7 @@ async function githubCommand(options) {
   }
   if (!taskId) {
     const config2 = loadConfig(cwd);
-    const { listTasks: listTasks2 } = await import("./state-JLYPJWUT.js");
+    const { listTasks: listTasks2 } = await import("./state-54IS3PZH.js");
     const tasks = listTasks2(cwd);
     for (const tid of tasks) {
       const state2 = getWorkflowState(tid, config2, cwd);
@@ -2072,7 +2083,7 @@ _Updated by [Spets](https://github.com/eatnug/spets)_`;
 }
 
 // src/orchestrator/index.ts
-import { readFileSync, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";
 import { join as join4, dirname as dirname2 } from "path";
 import matter from "gray-matter";
 var Orchestrator = class {
@@ -2110,7 +2121,7 @@ var Orchestrator = class {
     if (!existsSync4(statePath)) {
       return null;
     }
-    const data = JSON.parse(readFileSync(statePath, "utf-8"));
+    const data = JSON.parse(readFileSync2(statePath, "utf-8"));
     return data;
   }
   saveState(state) {
@@ -2129,7 +2140,7 @@ var Orchestrator = class {
     if (!existsSync4(specPath)) {
       return [];
     }
-    const content = readFileSync(specPath, "utf-8");
+    const content = readFileSync2(specPath, "utf-8");
     const { data } = matter(content);
     const questions = [];
     if (data.open_questions && Array.isArray(data.open_questions)) {
@@ -2148,11 +2159,6 @@ var Orchestrator = class {
     }
     return questions;
   }
-  generateTaskId(description) {
-    const timestamp = Date.now().toString(36);
-    const random = Math.random().toString(36).substring(2, 6);
-    return `${timestamp}-${random}`;
-  }
   // ===========================================================================
   // Protocol Response Builders
   // ===========================================================================
@@ -2258,7 +2264,7 @@ var Orchestrator = class {
   cmdInit(description) {
     try {
       const steps = this.getSteps();
-      const taskId = this.generateTaskId(description);
+      const taskId = generateTaskId(description);
       const state = {
         taskId,
         description,
@@ -2306,7 +2312,7 @@ var Orchestrator = class {
     }
     const specPath = this.getSpecPath(taskId, state.currentStep);
     if (existsSync4(specPath)) {
-      const content = readFileSync(specPath, "utf-8");
+      const content = readFileSync2(specPath, "utf-8");
       const { content: body, data } = matter(content);
       if (data.open_questions && Array.isArray(data.open_questions)) {
         data.open_questions = data.open_questions.map((q, i) => ({
@@ -2333,7 +2339,7 @@ var Orchestrator = class {
     const steps = this.getSteps();
     const specPath = this.getSpecPath(taskId, state.currentStep);
     if (existsSync4(specPath)) {
-      const content = readFileSync(specPath, "utf-8");
+      const content = readFileSync2(specPath, "utf-8");
       const { content: body, data } = matter(content);
       data.status = "approved";
       data.updated_at = (/* @__PURE__ */ new Date()).toISOString();
@@ -2375,7 +2381,7 @@ var Orchestrator = class {
     }
     const specPath = this.getSpecPath(taskId, state.currentStep);
     if (existsSync4(specPath)) {
-      const content = readFileSync(specPath, "utf-8");
+      const content = readFileSync2(specPath, "utf-8");
       const { content: body, data } = matter(content);
       data.status = "rejected";
       data.updated_at = (/* @__PURE__ */ new Date()).toISOString();

package/dist/{state-JLYPJWUT.js → state-54IS3PZH.js}

@@ -1,6 +1,7 @@
 import {
   createDocument,
   ensureTaskDir,
+  extractPlanSummary,
   generateTaskId,
   getOutputPath,
   getTaskDir,
@@ -12,10 +13,11 @@ import {
   saveDocument,
   saveTaskMetadata,
   updateDocumentStatus
-} from "./chunk-YK5ZZE4P.js";
+} from "./chunk-NOS3N4GT.js";
 export {
   createDocument,
   ensureTaskDir,
+  extractPlanSummary,
   generateTaskId,
   getOutputPath,
   getTaskDir,

package/package.json

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