spets 0.1.4 → 0.1.6

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,8 @@ function parseGitHubCommand(comment) {
 var GitHubPlatform = class extends BasePlatform {
   config;
   currentTaskId;
+  currentOutputPath;
+  lastQuestions;
   constructor(config) {
     super();
     this.config = config;
@@ -1062,11 +1077,16 @@ var GitHubPlatform = class extends BasePlatform {
   setTaskId(taskId) {
     this.currentTaskId = taskId;
   }
+  setBranch(branch) {
+    this.config.branch = branch;
+  }
   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);
+    this.lastQuestions = questions;
     return { document, questions };
   }
   async askUser(questions) {
@@ -1077,7 +1097,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, this.lastQuestions);
     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,39 +1130,77 @@ 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, openQuestions) {
+    const relativePath = outputPath ? outputPath.replace(process.cwd() + "/", "") : `.spets/outputs/${taskId}/${stepName}.md`;
+    const { owner, repo, branch } = this.config;
+    const fileLink = branch ? `[\`${relativePath}\`](https://github.com/${owner}/${repo}/blob/${branch}/${relativePath})` : `\`${relativePath}\``;
+    const escapedDoc = doc.replace(/```/g, "\\`\\`\\`");
     const lines = [
       `## \u{1F4C4} Spets: ${stepName} - Review Required`,
       "",
       `> Task ID: \`${taskId}\``,
+      `> Output: ${fileLink}`,
       "",
       "<details>",
       "<summary>\u{1F4DD} View Document</summary>",
       "",
-      "```markdown",
-      doc,
-      "```",
-      "",
-      "</details>",
-      "",
-      "---",
+      escapedDoc,
       "",
-      "**Commands:**",
-      "| Command | Description |",
-      "|---------|-------------|",
-      "| `/approve` | Approve and continue to next step |",
-      "| `/revise <feedback>` | Request changes with feedback |",
-      "| `/reject` | Reject and stop workflow |"
+      "</details>"
     ];
+    if (openQuestions && openQuestions.length > 0) {
+      lines.push("");
+      lines.push("---");
+      lines.push("");
+      lines.push("### \u2753 Open Questions");
+      lines.push("");
+      for (let i = 0; i < openQuestions.length; i++) {
+        const q = openQuestions[i];
+        lines.push(`**Q${i + 1}:** ${q.question}`);
+        if (q.context) {
+          lines.push(`> ${q.context}`);
+        }
+        lines.push("");
+      }
+      lines.push("**To answer questions:**");
+      lines.push("```");
+      lines.push("/answer");
+      for (let i = 0; i < openQuestions.length; i++) {
+        lines.push(`Q${i + 1}: <your answer>`);
+      }
+      lines.push("```");
+    }
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push("**Commands:**");
+    lines.push("| Command | Description |");
+    lines.push("|---------|-------------|");
+    lines.push("| `/approve` | Approve and continue to next step |");
+    lines.push("| `/approve --pr` | Approve and create a Pull Request |");
+    lines.push("| `/approve --issue` | Approve and create/update an Issue |");
+    lines.push("| `/revise <feedback>` | Request changes with feedback |");
+    lines.push("| `/reject` | Reject and stop workflow |");
+    lines.push("");
+    lines.push("Example: `/revise Please add more details about error handling`");
     return lines.join("\n");
   }
   async postPRComment(body) {
@@ -1206,12 +1264,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 +1279,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);
         }
@@ -1317,6 +1374,13 @@ _Managed by [Spets](https://github.com/eatnug/spets)_`;
   }
   return parseInt(match[1], 10);
 }
+function getCurrentBranch() {
+  try {
+    return execSync3("git branch --show-current", { encoding: "utf-8" }).trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function findLinkedIssueOrPR(info) {
   try {
     const result = execSync3(
@@ -1386,7 +1450,8 @@ async function startCommand(query, options) {
       owner: githubInfo.owner,
       repo: githubInfo.repo,
       prNumber,
-      issueNumber
+      issueNumber,
+      branch: getCurrentBranch()
     });
     console.log(`Starting workflow: ${taskId}`);
     console.log(`Query: ${query}`);
@@ -1778,6 +1843,13 @@ function getGitHubInfo2(cwd) {
   }
   return null;
 }
+function getCurrentBranch2(cwd) {
+  try {
+    return execSync4("git branch --show-current", { encoding: "utf-8", cwd }).trim();
+  } catch {
+    return void 0;
+  }
+}
 async function githubCommand(options) {
   const cwd = process.cwd();
   if (!spetsExists(cwd)) {
@@ -1837,12 +1909,20 @@ async function githubCommand(options) {
     owner,
     repo,
     prNumber: pr ? parseInt(pr, 10) : void 0,
-    issueNumber: issue ? parseInt(issue, 10) : void 0
+    issueNumber: issue ? parseInt(issue, 10) : void 0,
+    branch: getCurrentBranch2(cwd)
   };
   switch (parsed.command) {
     case "approve": {
       console.log(`Approving step: ${state.currentStepName}`);
       updateDocumentStatus(outputPath, "approved");
+      if (parsed.createPR) {
+        console.log("PR will be created after changes are committed.");
+      }
+      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 +1945,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 +2014,51 @@ async function postComment(config, body) {
     proc.on("error", reject);
   });
 }
+async function createOrUpdateIssue(config, taskId, userQuery, stepName) {
+  const { spawnSync } = 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) {
+    const result = spawnSync("gh", [
+      "issue",
+      "comment",
+      String(issueNumber),
+      "--repo",
+      `${owner}/${repo}`,
+      "--body",
+      body
+    ], { encoding: "utf-8" });
+    if (result.status !== 0) {
+      throw new Error(`Failed to comment on issue: ${result.stderr}`);
+    }
+  } else {
+    const title = userQuery.slice(0, 50) + (userQuery.length > 50 ? "..." : "");
+    const result = spawnSync("gh", [
+      "issue",
+      "create",
+      "--repo",
+      `${owner}/${repo}`,
+      "--title",
+      title,
+      "--body",
+      body,
+      "--label",
+      "spets"
+    ], { encoding: "utf-8" });
+    if (result.status !== 0) {
+      throw new Error(`Failed to create issue: ${result.stderr}`);
+    }
+  }
+}
 
 // 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.6",
   "description": "Spec Driven Development Execution Framework",
   "type": "module",
   "main": "dist/index.js",