spets 0.1.1 → 0.1.3

package/README.md

@@ -5,23 +5,27 @@ Spec Driven Development Execution Framework - 유저가 정의한 스텝대로 S
 ## Installation
 
 ```bash
+# 글로벌 설치 (선택)
 npm install -g spets
+
+# 또는 npx로 바로 사용 (설치 불필요)
+npx spets init
 ```
 
 ## Quick Start
 
 ```bash
 # 프로젝트에서 초기화
-spets init
+npx spets init
 
 # 워크플로우 시작
-spets start "TODO 앱 만들어줘"
+npx spets start "TODO 앱 만들어줘"
 
 # 상태 확인
-spets status
+npx spets status
 
 # 중단된 워크플로우 재개
-spets resume
+npx spets resume
 ```
 
 ## How it Works
@@ -56,10 +60,10 @@ PR/Issue 코멘트로 워크플로우 제어:
 
 ```bash
 # GitHub Actions 워크플로우 포함해서 초기화
-spets init --github
+npx spets init --github
 
 # GitHub 플랫폼으로 시작
-spets start "task" --platform github --owner myorg --repo myrepo --issue 42
+npx spets start "task" --platform github --owner myorg --repo myrepo --issue 42
 ```
 
 코멘트 명령어:
@@ -71,12 +75,14 @@ spets start "task" --platform github --owner myorg --repo myrepo --issue 42
 
 ```bash
 # Claude Code 스킬 설치
-spets plugin install claude
+npx spets plugin install claude
 
 # Claude Code에서 사용
 /spets start "task description"
 ```
 
+스킬이 설치되면 Claude Code 내에서 `npx spets` 명령어를 자동으로 실행합니다. 글로벌 설치 없이도 동작합니다.
+
 ## Configuration
 
 `.sept/config.yml`:

package/dist/{chunk-RW22VIUI.js → chunk-XYU22TND.js}

@@ -52,6 +52,10 @@ function loadStepDefinition(stepName, cwd = process.cwd()) {
     template
   };
 }
+function getGitHubConfig(cwd = process.cwd()) {
+  const config = loadConfig(cwd);
+  return config.github;
+}
 
 // src/core/state.ts
 function generateTaskId() {
@@ -194,6 +198,7 @@ export {
   spetsExists,
   loadConfig,
   loadStepDefinition,
+  getGitHubConfig,
   generateTaskId,
   getTaskDir,
   getOutputPath,

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   generateTaskId,
+  getGitHubConfig,
   getOutputPath,
   getSpetsDir,
   getWorkflowState,
@@ -13,7 +14,7 @@ import {
   saveTaskMetadata,
   spetsExists,
   updateDocumentStatus
-} from "./chunk-RW22VIUI.js";
+} from "./chunk-XYU22TND.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -37,12 +38,14 @@ async function initCommand(options) {
   const templatesDir = join(__dirname, "..", "templates");
   writeFileSync(join(spetsDir, "config.yml"), getDefaultConfig());
   createDefaultSteps(spetsDir);
+  createClaudeCommand(cwd);
   console.log("Initialized spets in .spets/");
   console.log("");
   console.log("Created:");
-  console.log("  .spets/config.yml         - Workflow configuration");
-  console.log("  .spets/steps/01-plan/     - Planning step");
-  console.log("  .spets/steps/02-implement/ - Implementation step");
+  console.log("  .spets/config.yml           - Workflow configuration");
+  console.log("  .spets/steps/01-plan/       - Planning step");
+  console.log("  .spets/steps/02-implement/  - Implementation step");
+  console.log("  .claude/commands/spets.md   - Claude Code command");
   if (options.github) {
     createGitHubWorkflow(cwd);
     console.log("  .github/workflows/spets.yml - GitHub Actions workflow");
@@ -236,6 +239,65 @@ None / List any deviations with justification.
 - Follow-up task 2
 `;
 }
+function createClaudeCommand(cwd) {
+  const commandDir = join(cwd, ".claude", "commands");
+  mkdirSync(commandDir, { recursive: true });
+  writeFileSync(join(commandDir, "spets.md"), getClaudeCommand());
+}
+function getClaudeCommand() {
+  return `# Spets - Spec Driven Development
+
+Run spets workflows from Claude Code.
+
+## Usage
+
+\`\`\`
+/spets start "task description"  - Start a new workflow
+/spets status                     - Show workflow status
+/spets resume                     - Resume paused workflow
+\`\`\`
+
+## Instructions
+
+When the user invokes this command:
+
+1. Parse the subcommand (start, status, resume)
+2. Execute the appropriate spets CLI command using Bash
+3. For 'start', read the generated documents and help iterate
+
+### Start Flow
+
+1. Run: \`npx spets start "<query>"\`
+2. Read the generated plan document from .spets/outputs/<taskId>/
+3. Present the plan to the user
+4. If user approves, continue. If they want changes, provide feedback.
+
+### Status Flow
+
+1. Run: \`npx spets status\`
+2. Present the current workflow state
+
+### Resume Flow
+
+1. Run: \`npx spets resume\`
+2. Continue the workflow from where it paused
+
+## Example Session
+
+User: /spets start "Create a REST API for user management"
+
+Claude:
+1. Runs \`npx spets start "Create a REST API for user management"\`
+2. Reads the generated plan
+3. Asks user: "Here's the plan. [shows plan] Would you like to approve or revise?"
+4. On approve: \`npx spets resume --approve\`
+5. On revise: \`npx spets resume --revise "user feedback"\`
+
+$ARGUMENTS
+command: The spets command to run (start, status, resume)
+args: Additional arguments for the command
+`;
+}
 function createGitHubWorkflow(cwd) {
   const workflowDir = join(cwd, ".github", "workflows");
   mkdirSync(workflowDir, { recursive: true });
@@ -591,7 +653,7 @@ var Executor = class {
 };
 
 // src/platform/cli.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn2, execSync } from "child_process";
 import { input, select, confirm } from "@inquirer/prompts";
 
 // src/platform/interface.ts
@@ -740,6 +802,24 @@ var CliPlatform = class extends BasePlatform {
       });
     });
   }
+  isClaudeInstalled() {
+    try {
+      const command = process.platform === "win32" ? "where" : "which";
+      execSync(`${command} claude`, { stdio: "ignore" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  getClaudeExecutable() {
+    if (this.claudeCommand !== "claude") {
+      return { command: this.claudeCommand, args: [] };
+    }
+    if (this.isClaudeInstalled()) {
+      return { command: "claude", args: [] };
+    }
+    return { command: "npx", args: ["--yes", "@anthropic-ai/claude-code"] };
+  }
   parseResponse(response) {
     const questions = [];
     const questionMatch = response.match(/```questions\n([\s\S]*?)```/);
@@ -1015,19 +1095,24 @@ async function startCommand(query, options) {
   saveTaskMetadata(taskId, query, cwd);
   let platform;
   if (options.platform === "github") {
-    if (!options.owner || !options.repo) {
-      console.error("GitHub platform requires --owner and --repo");
+    const githubConfig = getGitHubConfig(cwd);
+    const owner = options.owner || githubConfig?.owner;
+    const repo = options.repo || githubConfig?.repo;
+    const pr = options.pr || (githubConfig?.defaultPr ? String(githubConfig.defaultPr) : void 0);
+    const issue = options.issue || (githubConfig?.defaultIssue ? String(githubConfig.defaultIssue) : void 0);
+    if (!owner || !repo) {
+      console.error("GitHub platform requires --owner and --repo (or set in .spets/config.yml)");
       process.exit(1);
     }
-    if (!options.pr && !options.issue) {
-      console.error("GitHub platform requires --pr or --issue");
+    if (!pr && !issue) {
+      console.error("GitHub platform requires --pr or --issue (or set defaultPr/defaultIssue in .spets/config.yml)");
       process.exit(1);
     }
     platform = new GitHubPlatform({
-      owner: options.owner,
-      repo: options.repo,
-      prNumber: options.pr ? parseInt(options.pr, 10) : void 0,
-      issueNumber: options.issue ? parseInt(options.issue, 10) : void 0
+      owner,
+      repo,
+      prNumber: pr ? parseInt(pr, 10) : void 0,
+      issueNumber: issue ? parseInt(issue, 10) : void 0
     });
   } else {
     platform = new CliPlatform();
@@ -1188,6 +1273,8 @@ function installClaudePlugin() {
   console.log('  /spets start "your task description"');
   console.log("  /spets status");
   console.log("  /spets resume");
+  console.log("");
+  console.log("Note: The plugin uses npx to run spets, so global installation is not required.");
 }
 async function uninstallPlugin(name) {
   if (name === "claude") {
@@ -1238,21 +1325,23 @@ When the user invokes this command:
 2. Execute the appropriate spets CLI command using Bash
 3. For 'start', read the generated documents and help iterate
 
+**Important**: Use \`npx spets\` to run commands. This ensures the command works even if spets is not globally installed.
+
 ### Start Flow
 
-1. Run: \`spets start "<query>"\`
+1. Run: \`npx spets start "<query>"\`
 2. Read the generated plan document from .spets/outputs/<taskId>/
 3. Present the plan to the user
 4. If user approves, continue. If they want changes, provide feedback.
 
 ### Status Flow
 
-1. Run: \`spets status\`
+1. Run: \`npx spets status\`
 2. Present the current workflow state
 
 ### Resume Flow
 
-1. Run: \`spets resume\`
+1. Run: \`npx spets resume\`
 2. Continue the workflow from where it paused
 
 ## Example Session
@@ -1260,11 +1349,11 @@ When the user invokes this command:
 User: /spets start "Create a REST API for user management"
 
 Claude:
-1. Runs \`spets start "Create a REST API for user management"\`
+1. Runs \`npx spets start "Create a REST API for user management"\`
 2. Reads the generated plan
 3. Asks user: "Here's the plan. [shows plan] Would you like to approve or revise?"
-4. On approve: \`spets resume --approve\`
-5. On revise: \`spets resume --revise "user feedback"\`
+4. On approve: \`npx spets resume --approve\`
+5. On revise: \`npx spets resume --revise "user feedback"\`
 
 $ARGUMENTS
 command: The spets command to run (start, status, resume)
@@ -1279,9 +1368,18 @@ async function githubCommand(options) {
     console.error("Spets not initialized.");
     process.exit(1);
   }
-  const { owner, repo, pr, issue, comment, task } = options;
+  const configGitHub = getGitHubConfig(cwd);
+  const owner = options.owner || configGitHub?.owner;
+  const repo = options.repo || configGitHub?.repo;
+  const pr = options.pr || (configGitHub?.defaultPr ? String(configGitHub.defaultPr) : void 0);
+  const issue = options.issue || (configGitHub?.defaultIssue ? String(configGitHub.defaultIssue) : void 0);
+  const { comment, task } = options;
+  if (!owner || !repo) {
+    console.error("GitHub requires --owner and --repo (or set in .spets/config.yml)");
+    process.exit(1);
+  }
   if (!pr && !issue) {
-    console.error("Either --pr or --issue is required");
+    console.error("Either --pr or --issue is required (or set defaultPr/defaultIssue in .spets/config.yml)");
     process.exit(1);
   }
   const parsed = parseGitHubCommand(comment);
@@ -1299,7 +1397,7 @@ async function githubCommand(options) {
   }
   if (!taskId) {
     const config2 = loadConfig(cwd);
-    const { listTasks: listTasks2 } = await import("./state-34RYXOKQ.js");
+    const { listTasks: listTasks2 } = await import("./state-H2GQS43T.js");
     const tasks = listTasks2(cwd);
     for (const tid of tasks) {
       const state2 = getWorkflowState(tid, config2, cwd);
@@ -1431,6 +1529,6 @@ program.command("init").description("Initialize spets in current directory").opt
 program.command("status").description("Show current workflow status").option("-t, --task <taskId>", "Show status for specific task").action(statusCommand);
 program.command("start").description("Start a new workflow").argument("<query>", "User query describing the task").option("-p, --platform <platform>", "Platform to use (cli, github)", "cli").option("--owner <owner>", "GitHub owner (for github platform)").option("--repo <repo>", "GitHub repo (for github platform)").option("--pr <number>", "GitHub PR number (for github platform)").option("--issue <number>", "GitHub issue number (for github platform)").action(startCommand);
 program.command("resume").description("Resume paused workflow").option("-t, --task <taskId>", "Resume specific task").option("--approve", "Approve current document and proceed").option("--revise <feedback>", "Request revision with feedback").action(resumeCommand);
-program.command("github").description("Handle GitHub Action callback (internal)").requiredOption("--owner <owner>", "GitHub owner").requiredOption("--repo <repo>", "GitHub repo").option("--pr <number>", "PR number").option("--issue <number>", "Issue number").option("-t, --task <taskId>", "Task ID").requiredOption("--comment <comment>", "Comment body").action(githubCommand);
+program.command("github").description("Handle GitHub Action callback (internal)").option("--owner <owner>", "GitHub owner (or set in .spets/config.yml)").option("--repo <repo>", "GitHub repo (or set in .spets/config.yml)").option("--pr <number>", "PR number (or set defaultPr in .spets/config.yml)").option("--issue <number>", "Issue number (or set defaultIssue in .spets/config.yml)").option("-t, --task <taskId>", "Task ID").requiredOption("--comment <comment>", "Comment body").action(githubCommand);
 program.command("plugin").description("Manage plugins").argument("<action>", "Action: install, uninstall, list").argument("[name]", "Plugin name").action(pluginCommand);
 program.parse();

package/dist/{state-34RYXOKQ.js → state-H2GQS43T.js}

@@ -12,7 +12,7 @@ import {
   saveDocument,
   saveTaskMetadata,
   updateDocumentStatus
-} from "./chunk-RW22VIUI.js";
+} from "./chunk-XYU22TND.js";
 export {
   createDocument,
   ensureTaskDir,

package/package.json

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