spets 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 eatnug
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# Spets
+
+Spec Driven Development Execution Framework - 유저가 정의한 스텝대로 SDD를 실행하는 CLI
+
+## Installation
+
+```bash
+npm install -g spets
+```
+
+## Quick Start
+
+```bash
+# 프로젝트에서 초기화
+spets init
+
+# 워크플로우 시작
+spets start "TODO 앱 만들어줘"
+
+# 상태 확인
+spets status
+
+# 중단된 워크플로우 재개
+spets resume
+```
+
+## How it Works
+
+1. **spets init** - `.sept/` 폴더에 설정과 스텝 템플릿 생성
+2. **spets start** - 유저 쿼리로 워크플로우 시작, Claude가 각 스텝 문서 생성
+3. **approve/revise/reject** - 각 스텝마다 유저가 검토하고 승인
+4. **반복** - 모든 스텝 완료까지 진행
+
+## Directory Structure
+
+```
+.sept/
+├── config.yml          # 워크플로우 설정
+├── steps/
+│   ├── 01-plan/
+│   │   ├── instruction.md   # Claude에게 주는 지시
+│   │   └── template.md      # 출력 템플릿
+│   └── 02-implement/
+│       ├── instruction.md
+│       └── template.md
+├── outputs/            # 생성된 문서들
+│   └── <taskId>/
+│       ├── 01-plan.md
+│       └── 02-implement.md
+└── hooks/              # 훅 스크립트
+```
+
+## GitHub Integration
+
+PR/Issue 코멘트로 워크플로우 제어:
+
+```bash
+# GitHub Actions 워크플로우 포함해서 초기화
+spets init --github
+
+# GitHub 플랫폼으로 시작
+spets start "task" --platform github --owner myorg --repo myrepo --issue 42
+```
+
+코멘트 명령어:
+- `/approve` - 승인하고 다음 스텝
+- `/revise <feedback>` - 피드백과 함께 재생성
+- `/reject` - 워크플로우 중단
+
+## Claude Code Plugin
+
+```bash
+# Claude Code 스킬 설치
+spets plugin install claude
+
+# Claude Code에서 사용
+/spets start "task description"
+```
+
+## Configuration
+
+`.sept/config.yml`:
+
+```yaml
+steps:
+  - 01-plan
+  - 02-implement
+
+hooks:
+  preStep: "./hooks/pre-step.sh"
+  postStep: "./hooks/post-step.sh"
+  onApprove: "./hooks/on-approve.sh"
+  onComplete: "./hooks/on-complete.sh"
+```
+
+## Requirements
+
+- Node.js >= 18
+- Claude CLI (`claude` command) or ANTHROPIC_API_KEY
+
+## License
+
+MIT

package/dist/chunk-KZQ5KNMC.js

@@ -0,0 +1,210 @@
+// src/core/state.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2, readdirSync, writeFileSync, mkdirSync } from "fs";
+import { join as join2 } from "path";
+import matter from "gray-matter";
+
+// src/core/config.ts
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { parse as parseYaml } from "yaml";
+var SEPT_DIR = ".sept";
+var CONFIG_FILE = "config.yml";
+var STEPS_DIR = "steps";
+function getSeptDir(cwd = process.cwd()) {
+  return join(cwd, SEPT_DIR);
+}
+function getConfigPath(cwd = process.cwd()) {
+  return join(getSeptDir(cwd), CONFIG_FILE);
+}
+function getStepsDir(cwd = process.cwd()) {
+  return join(getSeptDir(cwd), STEPS_DIR);
+}
+function getOutputsDir(cwd = process.cwd()) {
+  return join(getSeptDir(cwd), "outputs");
+}
+function septExists(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.`);
+  }
+  const content = readFileSync(configPath, "utf-8");
+  const config = parseYaml(content);
+  if (!config.steps || config.steps.length === 0) {
+    throw new Error("Config must define at least one step");
+  }
+  return config;
+}
+function loadStepDefinition(stepName, cwd = process.cwd()) {
+  const stepDir = join(getStepsDir(cwd), stepName);
+  const instructionPath = join(stepDir, "instruction.md");
+  const templatePath = join(stepDir, "template.md");
+  if (!existsSync(instructionPath)) {
+    throw new Error(`Step '${stepName}' instruction not found at ${instructionPath}`);
+  }
+  const instruction = readFileSync(instructionPath, "utf-8");
+  const template = existsSync(templatePath) ? readFileSync(templatePath, "utf-8") : void 0;
+  return {
+    name: stepName,
+    instruction,
+    template
+  };
+}
+
+// src/core/state.ts
+function generateTaskId() {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 6);
+  return `${timestamp}-${random}`;
+}
+function getTaskDir(taskId, cwd = process.cwd()) {
+  return join2(getOutputsDir(cwd), taskId);
+}
+function getOutputPath(taskId, stepName, cwd = process.cwd()) {
+  return join2(getTaskDir(taskId, cwd), `${stepName}.md`);
+}
+function ensureTaskDir(taskId, cwd = process.cwd()) {
+  const taskDir = getTaskDir(taskId, cwd);
+  if (!existsSync2(taskDir)) {
+    mkdirSync(taskDir, { recursive: true });
+  }
+  return taskDir;
+}
+function parseDocumentFrontmatter(content) {
+  try {
+    const { data } = matter(content);
+    return data;
+  } catch {
+    return null;
+  }
+}
+function createDocument(content, frontmatter) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const fm = {
+    status: frontmatter.status || "draft",
+    step: frontmatter.step || "",
+    created_at: frontmatter.created_at || now,
+    updated_at: now,
+    open_questions: frontmatter.open_questions
+  };
+  return matter.stringify(content, fm);
+}
+function updateDocumentStatus(filePath, status) {
+  const content = readFileSync2(filePath, "utf-8");
+  const { content: body, data } = matter(content);
+  data.status = status;
+  data.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+  writeFileSync(filePath, matter.stringify(body, data));
+}
+function saveDocument(taskId, stepName, content, status = "draft", openQuestions, cwd = process.cwd()) {
+  ensureTaskDir(taskId, cwd);
+  const outputPath = getOutputPath(taskId, stepName, cwd);
+  const document = createDocument(content, {
+    status,
+    step: stepName,
+    open_questions: openQuestions
+  });
+  writeFileSync(outputPath, document);
+  return outputPath;
+}
+function loadDocument(taskId, stepName, cwd = process.cwd()) {
+  const outputPath = getOutputPath(taskId, stepName, cwd);
+  if (!existsSync2(outputPath)) {
+    return null;
+  }
+  const raw = readFileSync2(outputPath, "utf-8");
+  const { content, data } = matter(raw);
+  return {
+    content,
+    frontmatter: data
+  };
+}
+function listTasks(cwd = process.cwd()) {
+  const outputsDir = getOutputsDir(cwd);
+  if (!existsSync2(outputsDir)) {
+    return [];
+  }
+  return readdirSync(outputsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
+}
+function getWorkflowState(taskId, config, cwd = process.cwd()) {
+  const taskDir = getTaskDir(taskId, cwd);
+  if (!existsSync2(taskDir)) {
+    return null;
+  }
+  const outputs = /* @__PURE__ */ new Map();
+  let lastApprovedIndex = -1;
+  let currentStatus = "in_progress";
+  let userQuery = "";
+  for (let i = 0; i < config.steps.length; i++) {
+    const stepName = config.steps[i];
+    const doc = loadDocument(taskId, stepName, cwd);
+    if (doc) {
+      outputs.set(stepName, {
+        path: getOutputPath(taskId, stepName, cwd),
+        status: doc.frontmatter.status
+      });
+      if (doc.frontmatter.status === "approved") {
+        lastApprovedIndex = i;
+      } else if (doc.frontmatter.status === "rejected") {
+        currentStatus = "rejected";
+      }
+      if (i === 0 && !userQuery) {
+        const queryMatch = doc.content.match(/## User Query\n\n(.+?)(?=\n\n|$)/s);
+        if (queryMatch) {
+          userQuery = queryMatch[1].trim();
+        }
+      }
+    }
+  }
+  if (lastApprovedIndex === config.steps.length - 1) {
+    currentStatus = "completed";
+  }
+  const currentStepIndex = Math.min(lastApprovedIndex + 1, config.steps.length - 1);
+  const currentStepName = config.steps[currentStepIndex];
+  const currentDoc = loadDocument(taskId, currentStepName, cwd);
+  if (currentDoc?.frontmatter.status === "draft" && currentDoc.frontmatter.open_questions?.length) {
+    currentStatus = "paused";
+  }
+  return {
+    taskId,
+    userQuery,
+    currentStepIndex,
+    currentStepName,
+    status: currentStatus,
+    outputs
+  };
+}
+function saveTaskMetadata(taskId, userQuery, cwd = process.cwd()) {
+  const taskDir = ensureTaskDir(taskId, cwd);
+  const metaPath = join2(taskDir, ".meta.json");
+  writeFileSync(metaPath, JSON.stringify({ userQuery, createdAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
+}
+function loadTaskMetadata(taskId, cwd = process.cwd()) {
+  const metaPath = join2(getTaskDir(taskId, cwd), ".meta.json");
+  if (!existsSync2(metaPath)) {
+    return null;
+  }
+  return JSON.parse(readFileSync2(metaPath, "utf-8"));
+}
+
+export {
+  getSeptDir,
+  septExists,
+  loadConfig,
+  loadStepDefinition,
+  generateTaskId,
+  getTaskDir,
+  getOutputPath,
+  ensureTaskDir,
+  parseDocumentFrontmatter,
+  createDocument,
+  updateDocumentStatus,
+  saveDocument,
+  loadDocument,
+  listTasks,
+  getWorkflowState,
+  saveTaskMetadata,
+  loadTaskMetadata
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node