spets 0.1.0 → 0.1.2

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-KZQ5KNMC.js → chunk-XYU22TND.js}

@@ -7,28 +7,28 @@ import matter from "gray-matter";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 import { parse as parseYaml } from "yaml";
-var SEPT_DIR = ".sept";
+var SPETS_DIR = ".spets";
 var CONFIG_FILE = "config.yml";
 var STEPS_DIR = "steps";
-function getSeptDir(cwd = process.cwd()) {
-  return join(cwd, SEPT_DIR);
+function getSpetsDir(cwd = process.cwd()) {
+  return join(cwd, SPETS_DIR);
 }
 function getConfigPath(cwd = process.cwd()) {
-  return join(getSeptDir(cwd), CONFIG_FILE);
+  return join(getSpetsDir(cwd), CONFIG_FILE);
 }
 function getStepsDir(cwd = process.cwd()) {
-  return join(getSeptDir(cwd), STEPS_DIR);
+  return join(getSpetsDir(cwd), STEPS_DIR);
 }
 function getOutputsDir(cwd = process.cwd()) {
-  return join(getSeptDir(cwd), "outputs");
+  return join(getSpetsDir(cwd), "outputs");
 }
-function septExists(cwd = process.cwd()) {
+function spetsExists(cwd = process.cwd()) {
   return existsSync(getConfigPath(cwd));
 }
 function loadConfig(cwd = process.cwd()) {
   const configPath = getConfigPath(cwd);
   if (!existsSync(configPath)) {
-    throw new Error(`Sept config not found. Run 'sept init' first.`);
+    throw new Error(`Spets config not found. Run 'spets init' first.`);
   }
   const content = readFileSync(configPath, "utf-8");
   const config = parseYaml(content);
@@ -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() {
@@ -190,10 +194,11 @@ function loadTaskMetadata(taskId, cwd = process.cwd()) {
 }
 
 export {
-  getSeptDir,
-  septExists,
+  getSpetsDir,
+  spetsExists,
   loadConfig,
   loadStepDefinition,
+  getGitHubConfig,
   generateTaskId,
   getTaskDir,
   getOutputPath,

package/dist/index.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   generateTaskId,
+  getGitHubConfig,
   getOutputPath,
-  getSeptDir,
+  getSpetsDir,
   getWorkflowState,
   listTasks,
   loadConfig,
@@ -11,9 +12,9 @@ import {
   loadTaskMetadata,
   saveDocument,
   saveTaskMetadata,
-  septExists,
+  spetsExists,
   updateDocumentStatus
-} from "./chunk-KZQ5KNMC.js";
+} from "./chunk-XYU22TND.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -25,32 +26,32 @@ import { fileURLToPath } from "url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 async function initCommand(options) {
   const cwd = process.cwd();
-  const septDir = getSeptDir(cwd);
-  if (septExists(cwd) && !options.force) {
+  const spetsDir = getSpetsDir(cwd);
+  if (spetsExists(cwd) && !options.force) {
     console.error("Spets already initialized. Use --force to overwrite.");
     process.exit(1);
   }
-  mkdirSync(septDir, { recursive: true });
-  mkdirSync(join(septDir, "steps"), { recursive: true });
-  mkdirSync(join(septDir, "outputs"), { recursive: true });
-  mkdirSync(join(septDir, "hooks"), { recursive: true });
+  mkdirSync(spetsDir, { recursive: true });
+  mkdirSync(join(spetsDir, "steps"), { recursive: true });
+  mkdirSync(join(spetsDir, "outputs"), { recursive: true });
+  mkdirSync(join(spetsDir, "hooks"), { recursive: true });
   const templatesDir = join(__dirname, "..", "templates");
-  writeFileSync(join(septDir, "config.yml"), getDefaultConfig());
-  createDefaultSteps(septDir);
-  console.log("Initialized spets in .sept/");
+  writeFileSync(join(spetsDir, "config.yml"), getDefaultConfig());
+  createDefaultSteps(spetsDir);
+  console.log("Initialized spets in .spets/");
   console.log("");
   console.log("Created:");
-  console.log("  .sept/config.yml         - Workflow configuration");
-  console.log("  .sept/steps/01-plan/     - Planning step");
-  console.log("  .sept/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");
   if (options.github) {
     createGitHubWorkflow(cwd);
-    console.log("  .github/workflows/sept.yml - GitHub Actions workflow");
+    console.log("  .github/workflows/spets.yml - GitHub Actions workflow");
   }
   console.log("");
   console.log("Next steps:");
-  console.log("  1. Edit .sept/config.yml to customize your workflow");
-  console.log("  2. Customize step instructions in .sept/steps/");
+  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('  4. Run: spets start "task" --platform github --owner <owner> --repo <repo> --issue <n>');
@@ -75,12 +76,12 @@ steps:
 #   onComplete: "./hooks/on-complete.sh"
 `;
 }
-function createDefaultSteps(septDir) {
-  const planDir = join(septDir, "steps", "01-plan");
+function createDefaultSteps(spetsDir) {
+  const planDir = join(spetsDir, "steps", "01-plan");
   mkdirSync(planDir, { recursive: true });
   writeFileSync(join(planDir, "instruction.md"), getPlanInstruction());
   writeFileSync(join(planDir, "template.md"), getPlanTemplate());
-  const implementDir = join(septDir, "steps", "02-implement");
+  const implementDir = join(spetsDir, "steps", "02-implement");
   mkdirSync(implementDir, { recursive: true });
   writeFileSync(join(implementDir, "instruction.md"), getImplementInstruction());
   writeFileSync(join(implementDir, "template.md"), getImplementTemplate());
@@ -239,7 +240,7 @@ None / List any deviations with justification.
 function createGitHubWorkflow(cwd) {
   const workflowDir = join(cwd, ".github", "workflows");
   mkdirSync(workflowDir, { recursive: true });
-  writeFileSync(join(workflowDir, "sept.yml"), getGitHubWorkflow());
+  writeFileSync(join(workflowDir, "spets.yml"), getGitHubWorkflow());
 }
 function getGitHubWorkflow() {
   const gh = (expr) => `\${{ ${expr} }}`;
@@ -253,8 +254,8 @@ on:
     types: [created]
 
 jobs:
-  handle-sept-command:
-    # Only run if comment contains a sept command
+  handle-spets-command:
+    # Only run if comment contains a spets command
     if: |
       contains(github.event.comment.body, '/approve') ||
       contains(github.event.comment.body, '/revise') ||
@@ -303,7 +304,7 @@ jobs:
 
           Instructions:
           1. Parse the command from the comment (/approve, /revise, /reject, or /answer)
-          2. Find the active sept task in .sept/outputs/
+          2. Find the active spets task in .spets/outputs/
           3. Execute the appropriate action:
              - /approve: Mark current step as approved, generate next step
              - /revise <feedback>: Regenerate current step with feedback
@@ -325,7 +326,7 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git add -A
-          git diff --staged --quiet || git commit -m "Sept: Update from workflow"
+          git diff --staged --quiet || git commit -m "Spets: Update from workflow"
           git push
         env:
           GH_TOKEN: ${gh("secrets.GITHUB_TOKEN")}
@@ -335,7 +336,7 @@ jobs:
 // src/commands/status.ts
 async function statusCommand(options) {
   const cwd = process.cwd();
-  if (!septExists(cwd)) {
+  if (!spetsExists(cwd)) {
     console.error('Spets not initialized. Run "spets init" first.');
     process.exit(1);
   }
@@ -373,7 +374,7 @@ function showAllTasks(config, cwd) {
   if (tasks.length === 0) {
     console.log("No tasks found.");
     console.log("");
-    console.log('Start a new task with: sept start "your task description"');
+    console.log('Start a new task with: spets start "your task description"');
     return;
   }
   console.log("Tasks:");
@@ -393,7 +394,7 @@ function showAllTasks(config, cwd) {
     console.log(`  ... and ${tasks.length - 10} more tasks`);
   }
   console.log("");
-  console.log('Use "sept status -t <taskId>" for details');
+  console.log('Use "spets status -t <taskId>" for details');
 }
 function formatStatus(status) {
   const icons = {
@@ -418,18 +419,18 @@ import { spawn } from "child_process";
 import { existsSync as existsSync2 } from "fs";
 import { join as join2, isAbsolute } from "path";
 async function runHook(hookPath, context, cwd = process.cwd()) {
-  const resolvedPath = isAbsolute(hookPath) ? hookPath : join2(getSeptDir(cwd), hookPath);
+  const resolvedPath = isAbsolute(hookPath) ? hookPath : join2(getSpetsDir(cwd), hookPath);
   if (!existsSync2(resolvedPath)) {
     console.warn(`Hook not found: ${resolvedPath}`);
     return;
   }
   const env = {
     ...process.env,
-    SEPT_TASK_ID: context.taskId,
-    SEPT_STEP_NAME: context.stepName,
-    SEPT_STEP_INDEX: String(context.stepIndex),
-    SEPT_OUTPUT_PATH: context.outputPath,
-    SEPT_CWD: cwd
+    SPETS_TASK_ID: context.taskId,
+    SPETS_STEP_NAME: context.stepName,
+    SPETS_STEP_INDEX: String(context.stepIndex),
+    SPETS_OUTPUT_PATH: context.outputPath,
+    SPETS_CWD: cwd
   };
   return new Promise((resolve, reject) => {
     const proc = spawn(resolvedPath, [], {
@@ -516,7 +517,7 @@ var Executor = class {
         return;
       }
       if (result.paused) {
-        console.log("\n\u23F8\uFE0F  Workflow paused. Resume with: sept resume");
+        console.log("\n\u23F8\uFE0F  Workflow paused. Resume with: spets resume");
         return;
       }
       if (result.approved) {
@@ -591,7 +592,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
@@ -710,9 +711,15 @@ var CliPlatform = class extends BasePlatform {
   }
   async callClaude(prompt) {
     return new Promise((resolve, reject) => {
-      const proc = spawn2(this.claudeCommand, ["-p", prompt], {
+      const proc = spawn2(this.claudeCommand, [
+        "--print",
+        "--permission-mode",
+        "bypassPermissions"
+      ], {
         stdio: ["pipe", "pipe", "pipe"]
       });
+      proc.stdin.write(prompt);
+      proc.stdin.end();
       let stdout = "";
       let stderr = "";
       proc.stdout.on("data", (data) => {
@@ -734,6 +741,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]*?)```/);
@@ -834,7 +859,7 @@ var GitHubPlatform = class extends BasePlatform {
   }
   formatQuestionsComment(questions, taskId) {
     const lines = [
-      "## \u{1F4CB} Sept: Questions Need Answers",
+      "## \u{1F4CB} Spets: Questions Need Answers",
       "",
       `> Task ID: \`${taskId}\``,
       "",
@@ -861,7 +886,7 @@ var GitHubPlatform = class extends BasePlatform {
   }
   formatApprovalComment(doc, stepName, taskId) {
     const lines = [
-      `## \u{1F4C4} Sept: ${stepName} - Review Required`,
+      `## \u{1F4C4} Spets: ${stepName} - Review Required`,
       "",
       `> Task ID: \`${taskId}\``,
       "",
@@ -945,7 +970,13 @@ var GitHubPlatform = class extends BasePlatform {
   }
   async callClaude(prompt) {
     return new Promise((resolve, reject) => {
-      const proc = spawn3("claude", ["-p", prompt], { stdio: ["pipe", "pipe", "pipe"] });
+      const proc = spawn3("claude", [
+        "--print",
+        "--permission-mode",
+        "bypassPermissions"
+      ], { stdio: ["pipe", "pipe", "pipe"] });
+      proc.stdin.write(prompt);
+      proc.stdin.end();
       let stdout = "";
       let stderr = "";
       proc.stdout.on("data", (data) => {
@@ -990,7 +1021,7 @@ var GitHubPlatform = class extends BasePlatform {
 // src/commands/start.ts
 async function startCommand(query, options) {
   const cwd = process.cwd();
-  if (!septExists(cwd)) {
+  if (!spetsExists(cwd)) {
     console.error('Spets not initialized. Run "spets init" first.');
     process.exit(1);
   }
@@ -1003,19 +1034,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();
@@ -1038,7 +1074,7 @@ async function startCommand(query, options) {
 import { select as select2 } from "@inquirer/prompts";
 async function resumeCommand(options) {
   const cwd = process.cwd();
-  if (!septExists(cwd)) {
+  if (!spetsExists(cwd)) {
     console.error('Spets not initialized. Run "spets init" first.');
     process.exit(1);
   }
@@ -1060,7 +1096,7 @@ async function resumeCommand(options) {
     }
     if (resumableTasks.length === 0) {
       console.log("No tasks to resume.");
-      console.log('Start a new task with: sept start "your task description"');
+      console.log('Start a new task with: spets start "your task description"');
       return;
     }
     if (resumableTasks.length === 1) {
@@ -1176,6 +1212,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") {
@@ -1226,21 +1264,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>"\`
-2. Read the generated plan document from .sept/outputs/<taskId>/
+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
@@ -1248,11 +1288,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)
@@ -1263,18 +1303,27 @@ args: Additional arguments for the command
 // src/commands/github.ts
 async function githubCommand(options) {
   const cwd = process.cwd();
-  if (!septExists(cwd)) {
+  if (!spetsExists(cwd)) {
     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);
   if (!parsed.command) {
-    console.log("No sept command found in comment. Ignoring.");
+    console.log("No spets command found in comment. Ignoring.");
     return;
   }
   console.log(`Received command: ${parsed.command}`);
@@ -1287,7 +1336,7 @@ async function githubCommand(options) {
   }
   if (!taskId) {
     const config2 = loadConfig(cwd);
-    const { listTasks: listTasks2 } = await import("./state-MCFJFWJC.js");
+    const { listTasks: listTasks2 } = await import("./state-H2GQS43T.js");
     const tasks = listTasks2(cwd);
     for (const tid of tasks) {
       const state2 = getWorkflowState(tid, config2, cwd);
@@ -1415,10 +1464,10 @@ async function postComment(config, body) {
 // src/index.ts
 var program = new Command();
 program.name("spets").description("Spec Driven Development Execution Framework").version("0.1.0");
-program.command("init").description("Initialize sept in current directory").option("-f, --force", "Overwrite existing config").option("--github", "Add GitHub Actions workflow for PR/Issue integration").action(initCommand);
+program.command("init").description("Initialize spets in current directory").option("-f, --force", "Overwrite existing config").option("--github", "Add GitHub Actions workflow for PR/Issue integration").action(initCommand);
 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-MCFJFWJC.js → state-H2GQS43T.js}

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

package/package.json

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