spets 0.1.4 → 0.1.5

package/README.md

@@ -100,13 +100,15 @@ npx spets start "task" --pr 42
 Issue/PR 코멘트로 워크플로우를 제어합니다:
 
 - `/approve` - 현재 스텝 승인하고 다음 스텝 진행
+- `/approve --pr` - 승인하고 Pull Request 생성
+- `/approve --issue` - 승인하고 Issue 생성/업데이트
 - `/revise <feedback>` - 피드백과 함께 현재 스텝 재생성
 - `/reject` - 워크플로우 중단
 
 ### 필요 설정
 
 Repository Secrets에 추가:
-- `ANTHROPIC_API_KEY` - Claude API 키
+- `CLAUDE_CODE_OAUTH_TOKEN` - Claude 인증 토큰 (`claude setup-token`으로 생성)
 
 ## Claude Code Plugin
 
@@ -143,7 +145,7 @@ hooks:
 ## Requirements
 
 - Node.js >= 18
-- Claude CLI (`claude` command) or ANTHROPIC_API_KEY
+- Claude CLI (`claude` command) or CLAUDE_CODE_OAUTH_TOKEN
 - GitHub CLI (`gh`) - GitHub 연동 사용 시
 
 ## License

package/dist/index.js

@@ -76,7 +76,7 @@ async function initCommand(options) {
   console.log("  1. Edit .spets/config.yml to customize your workflow");
   console.log("  2. Customize step instructions in .spets/steps/");
   if (options.github) {
-    console.log("  3. Add ANTHROPIC_API_KEY to your repo secrets");
+    console.log("  3. Add CLAUDE_CODE_OAUTH_TOKEN to your repo secrets");
     console.log('  4. Create a new Issue using the "Spets Task" template');
   } else {
     console.log('  3. Run: spets start "your task description"');
@@ -443,6 +443,11 @@ on:
   issue_comment:
     types: [created]
 
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
 jobs:
   # Start workflow when a spets Issue is created
   start-workflow:
@@ -495,7 +500,7 @@ jobs:
           npx spets start "$TASK" --github --issue ${gh("github.event.issue.number")}
         env:
           TASK: ${gh("steps.parse.outputs.task")}
-          ANTHROPIC_API_KEY: ${gh("secrets.ANTHROPIC_API_KEY")}
+          CLAUDE_CODE_OAUTH_TOKEN: ${gh("secrets.CLAUDE_CODE_OAUTH_TOKEN")}
           GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
 
       - name: Push changes
@@ -553,7 +558,7 @@ jobs:
           npx spets github --issue ${gh("github.event.issue.number")} --comment "$COMMENT"
         env:
           COMMENT: ${gh("github.event.comment.body")}
-          ANTHROPIC_API_KEY: ${gh("secrets.ANTHROPIC_API_KEY")}
+          CLAUDE_CODE_OAUTH_TOKEN: ${gh("secrets.CLAUDE_CODE_OAUTH_TOKEN")}
           GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
 
       - name: Push changes
@@ -697,7 +702,7 @@ var Executor = class {
     this.config = options.config;
     this.cwd = options.cwd || process.cwd();
   }
-  async executeWorkflow(taskId, userQuery, startIndex = 0) {
+  async executeWorkflow(taskId, userQuery, startIndex = 0, feedback) {
     let previousOutput;
     if (startIndex > 0) {
       const prevStepName = this.config.steps[startIndex - 1];
@@ -717,7 +722,9 @@ var Executor = class {
         instruction: stepDef.instruction,
         template: stepDef.template,
         previousOutput,
-        outputPath: getOutputPath(taskId, stepName, this.cwd)
+        outputPath: getOutputPath(taskId, stepName, this.cwd),
+        feedback: i === startIndex ? feedback : void 0
+        // Only apply feedback to the target step
       };
       if (this.config.hooks?.preStep) {
         await runHook(this.config.hooks.preStep, {
@@ -1030,6 +1037,12 @@ function parseGitHubCommand(comment) {
   if (trimmed === "/approve") {
     return { command: "approve" };
   }
+  if (trimmed === "/approve --pr") {
+    return { command: "approve", createPR: true };
+  }
+  if (trimmed === "/approve --issue") {
+    return { command: "approve", createIssue: true };
+  }
   if (trimmed === "/reject") {
     return { command: "reject" };
   }
@@ -1055,6 +1068,7 @@ function parseGitHubCommand(comment) {
 var GitHubPlatform = class extends BasePlatform {
   config;
   currentTaskId;
+  currentOutputPath;
   constructor(config) {
     super();
     this.config = config;
@@ -1064,6 +1078,7 @@ var GitHubPlatform = class extends BasePlatform {
   }
   async generateDocument(context) {
     this.currentTaskId = context.taskId;
+    this.currentOutputPath = context.outputPath;
     const prompt = this.buildPrompt(context);
     const response = await this.callClaude(prompt);
     const { document, questions } = this.parseResponse(response);
@@ -1077,7 +1092,7 @@ var GitHubPlatform = class extends BasePlatform {
     throw new PauseForInputError("questions", questions);
   }
   async requestApproval(doc, stepName) {
-    const comment = this.formatApprovalComment(doc, stepName, this.currentTaskId);
+    const comment = this.formatApprovalComment(doc, stepName, this.currentTaskId, this.currentOutputPath);
     await this.postComment(comment);
     console.log("\n\u23F8\uFE0F  Waiting for approval on GitHub...");
     console.log("   Comment /approve, /revise <feedback>, or /reject on the PR/Issue.");
@@ -1110,20 +1125,31 @@ var GitHubPlatform = class extends BasePlatform {
       lines.push("");
     }
     lines.push("---");
-    lines.push("**Reply with:**");
+    lines.push("");
+    lines.push("**How to answer:**");
+    lines.push("");
     lines.push("```");
     lines.push("/answer");
     for (let i = 0; i < questions.length; i++) {
-      lines.push(`Q${i + 1}: your answer here`);
+      lines.push(`Q${i + 1}: <your answer for question ${i + 1}>`);
     }
     lines.push("```");
+    lines.push("");
+    lines.push("Example:");
+    lines.push("```");
+    lines.push("/answer");
+    lines.push("Q1: Use TypeScript");
+    lines.push("Q2: Yes, add unit tests");
+    lines.push("```");
     return lines.join("\n");
   }
-  formatApprovalComment(doc, stepName, taskId) {
+  formatApprovalComment(doc, stepName, taskId, outputPath) {
+    const relativePath = outputPath ? outputPath.replace(process.cwd() + "/", "") : `.spets/outputs/${taskId}/${stepName}.md`;
     const lines = [
       `## \u{1F4C4} Spets: ${stepName} - Review Required`,
       "",
       `> Task ID: \`${taskId}\``,
+      `> Output: \`${relativePath}\``,
       "",
       "<details>",
       "<summary>\u{1F4DD} View Document</summary>",
@@ -1140,8 +1166,12 @@ var GitHubPlatform = class extends BasePlatform {
       "| Command | Description |",
       "|---------|-------------|",
       "| `/approve` | Approve and continue to next step |",
+      "| `/approve --pr` | Approve and create a Pull Request |",
+      "| `/approve --issue` | Approve and create/update an Issue |",
       "| `/revise <feedback>` | Request changes with feedback |",
-      "| `/reject` | Reject and stop workflow |"
+      "| `/reject` | Reject and stop workflow |",
+      "",
+      "Example: `/revise Please add more details about error handling`"
     ];
     return lines.join("\n");
   }
@@ -1206,12 +1236,11 @@ var GitHubPlatform = class extends BasePlatform {
   async callClaude(prompt) {
     return new Promise((resolve, reject) => {
       const proc = spawn3("claude", [
-        "--print",
+        "-p",
+        prompt,
         "--permission-mode",
         "bypassPermissions"
-      ], { stdio: ["pipe", "pipe", "pipe"] });
-      proc.stdin.write(prompt);
-      proc.stdin.end();
+      ], { stdio: ["ignore", "pipe", "pipe"] });
       let stdout = "";
       let stderr = "";
       proc.stdout.on("data", (data) => {
@@ -1222,7 +1251,7 @@ var GitHubPlatform = class extends BasePlatform {
       });
       proc.on("close", (code) => {
         if (code !== 0) {
-          reject(new Error(`Claude CLI failed: ${stderr}`));
+          reject(new Error(`Claude CLI failed (code ${code}): stderr=${stderr}, stdout=${stdout}`));
         } else {
           resolve(stdout);
         }
@@ -1843,6 +1872,15 @@ async function githubCommand(options) {
     case "approve": {
       console.log(`Approving step: ${state.currentStepName}`);
       updateDocumentStatus(outputPath, "approved");
+      if (parsed.createPR) {
+        console.log("Creating Pull Request...");
+        const prNumber = await createPullRequest(githubConfig, taskId, userQuery, state.currentStepName);
+        console.log(`Created PR #${prNumber}`);
+      }
+      if (parsed.createIssue) {
+        console.log("Creating/Updating Issue...");
+        await createOrUpdateIssue(githubConfig, taskId, userQuery, state.currentStepName);
+      }
       const nextIndex = state.currentStepIndex + 1;
       if (nextIndex >= config.steps.length) {
         console.log("\u2705 Workflow completed!");
@@ -1865,7 +1903,7 @@ async function githubCommand(options) {
       const platform = new GitHubPlatform(githubConfig);
       const executor = new Executor({ platform, config, cwd });
       try {
-        await executor.executeWorkflow(taskId, userQuery, state.currentStepIndex);
+        await executor.executeWorkflow(taskId, userQuery, state.currentStepIndex, parsed.feedback);
       } catch (error) {
         if (error.name !== "PauseForInputError") {
           throw error;
@@ -1934,6 +1972,56 @@ async function postComment(config, body) {
     proc.on("error", reject);
   });
 }
+async function createPullRequest(config, taskId, userQuery, stepName) {
+  const { execSync: execSync5 } = await import("child_process");
+  const { owner, repo } = config;
+  const title = userQuery.slice(0, 50) + (userQuery.length > 50 ? "..." : "");
+  const body = `## Spets Workflow
+
+- Task ID: \`${taskId}\`
+- Current Step: **${stepName}**
+
+### Description
+${userQuery}
+
+---
+_Created by [Spets](https://github.com/eatnug/spets)_`;
+  const result = execSync5(
+    `gh pr create --repo ${owner}/${repo} --title "${title.replace(/"/g, '\\"')}" --body "${body.replace(/"/g, '\\"')}"`,
+    { encoding: "utf-8" }
+  );
+  const match = result.match(/\/pull\/(\d+)/);
+  if (!match) {
+    throw new Error("Failed to parse PR number from gh output");
+  }
+  return parseInt(match[1], 10);
+}
+async function createOrUpdateIssue(config, taskId, userQuery, stepName) {
+  const { execSync: execSync5 } = await import("child_process");
+  const { owner, repo, issueNumber } = config;
+  const body = `## Spets Workflow Update
+
+- Task ID: \`${taskId}\`
+- Current Step: **${stepName}** \u2705 Approved
+
+### Description
+${userQuery}
+
+---
+_Updated by [Spets](https://github.com/eatnug/spets)_`;
+  if (issueNumber) {
+    execSync5(
+      `gh issue comment ${issueNumber} --repo ${owner}/${repo} --body "${body.replace(/"/g, '\\"')}"`,
+      { encoding: "utf-8" }
+    );
+  } else {
+    const title = userQuery.slice(0, 50) + (userQuery.length > 50 ? "..." : "");
+    execSync5(
+      `gh issue create --repo ${owner}/${repo} --title "${title.replace(/"/g, '\\"')}" --body "${body.replace(/"/g, '\\"')}" --label spets`,
+      { encoding: "utf-8" }
+    );
+  }
+}
 
 // src/orchestrator/index.ts
 import { readFileSync, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";

package/package.json

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