@tinygem/soda-agent 0.1.0

package/dist/state.js

@@ -0,0 +1,209 @@
+// 상태 저장/복원 - .soda/state.json
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { Phase, SCHEMA_VERSION, getErrorMessage } from "./types.js";
+import { logWarn } from "./logger.js";
+const STATE_DIR = ".soda";
+const STATE_FILE = "state.json";
+const PID_FILE = "engine.pid";
+const CANCEL_FILE = "cancel";
+const CLARIFY_PENDING_FILE = "clarify-pending.json";
+const CLARIFY_ANSWER_FILE = "clarify-answer.txt";
+const MAX_FAILURE_HISTORY = 10;
+export function createInitialState(goal) {
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        goal,
+        goalConfirmed: null,
+        phase: Phase.CLARIFY,
+        verifyPass: 0,
+        iterations: 0,
+        consecutiveFailures: 0,
+        failureHistory: [],
+        startTime: Date.now(),
+        implementationSummary: null,
+        lastVerifyResult: null,
+        clarifyRetries: 0,
+    };
+}
+// #7: 런타임 필드 검증 — unsafe cast 대신 모든 필드를 확인
+function isValidGoalConfirmed(gc) {
+    if (gc === null)
+        return true; // null은 유효 (CLARIFY 전)
+    if (typeof gc !== "object" || gc === null)
+        return false;
+    const obj = gc;
+    return (typeof obj.summary === "string" &&
+        Array.isArray(obj.tasks) &&
+        obj.tasks.length > 0 &&
+        obj.tasks.every((t) => typeof t === "string") &&
+        Array.isArray(obj.completionCriteria) &&
+        obj.completionCriteria.length > 0 &&
+        obj.completionCriteria.every((c) => typeof c === "string"));
+}
+function isValidClarifyMessages(msgs) {
+    if (msgs === undefined)
+        return true; // optional 필드
+    if (!Array.isArray(msgs))
+        return false;
+    return msgs.every((m) => {
+        if (typeof m !== "object" || m === null)
+            return false;
+        const msg = m;
+        return (msg.role === "assistant" || msg.role === "user") && typeof msg.content === "string";
+    });
+}
+function isValidRunState(data) {
+    return (data.schemaVersion === SCHEMA_VERSION &&
+        typeof data.goal === "string" &&
+        typeof data.phase === "string" &&
+        Object.values(Phase).includes(data.phase) &&
+        typeof data.verifyPass === "number" &&
+        typeof data.iterations === "number" &&
+        typeof data.consecutiveFailures === "number" &&
+        Array.isArray(data.failureHistory) &&
+        typeof data.startTime === "number" &&
+        isValidGoalConfirmed(data.goalConfirmed) &&
+        isValidClarifyMessages(data.clarifyMessages));
+}
+export function loadState(workingDir) {
+    const path = join(workingDir, STATE_DIR, STATE_FILE);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        if (data.schemaVersion !== undefined && data.schemaVersion !== SCHEMA_VERSION) {
+            logWarn(`상태 파일 버전 불일치 (파일: ${data.schemaVersion}, 현재: ${SCHEMA_VERSION}). 이전 상태를 사용할 수 없습니다.`);
+            return null;
+        }
+        if (!isValidRunState(data))
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// #11: saveState는 입력 객체를 변이하지 않는다
+// #19: existsSync + mkdirSync 중복 제거
+export function saveState(workingDir, state) {
+    const dir = join(workingDir, STATE_DIR);
+    mkdirSync(dir, { recursive: true });
+    // failureHistory 길이 제한 — 원본을 변이하지 않고 직렬화 시점에 자름
+    const trimmedHistory = state.failureHistory.length > MAX_FAILURE_HISTORY
+        ? state.failureHistory.slice(-MAX_FAILURE_HISTORY)
+        : state.failureHistory;
+    const json = JSON.stringify({ ...state, failureHistory: trimmedHistory }, null, 2);
+    // 원자적 쓰기: temp 파일에 쓴 후 rename
+    const filePath = join(dir, STATE_FILE);
+    const tmpPath = filePath + ".tmp";
+    writeFileSync(tmpPath, json);
+    renameSync(tmpPath, filePath);
+}
+export function clearState(workingDir) {
+    const path = join(workingDir, STATE_DIR, STATE_FILE);
+    if (existsSync(path)) {
+        unlinkSync(path);
+    }
+}
+export function writePidFile(workingDir) {
+    const dir = join(workingDir, STATE_DIR);
+    mkdirSync(dir, { recursive: true });
+    const pidPath = join(dir, PID_FILE);
+    try {
+        writeFileSync(pidPath, process.pid.toString(), { flag: "wx" });
+    }
+    catch {
+        // 파일이 이미 존재하면 덮어쓰기 (stale PID 파일 처리)
+        writeFileSync(pidPath, process.pid.toString());
+    }
+}
+export function cleanupPidFile(workingDir) {
+    const path = join(workingDir, STATE_DIR, PID_FILE);
+    try {
+        unlinkSync(path);
+    }
+    catch { /* 파일 없으면 무시 */ }
+}
+// 동시 실행 보호 — PID 파일로 다른 인스턴스가 실행 중인지 확인
+export function isLocked(workingDir) {
+    const pidPath = join(workingDir, STATE_DIR, PID_FILE);
+    if (!existsSync(pidPath))
+        return false;
+    try {
+        const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
+        if (!Number.isFinite(pid))
+            return false;
+        if (pid === process.pid)
+            return false; // 자기 자신은 잠금 대상 아님
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // EPERM: 프로세스 존재하지만 다른 사용자 소유 → 잠금
+        if (e && typeof e === "object" && e.code === "EPERM") {
+            return true;
+        }
+        // ESRCH: 프로세스 없음 → 잠금 해제
+        return false;
+    }
+}
+export function isCancelled(workingDir) {
+    const path = join(workingDir, STATE_DIR, CANCEL_FILE);
+    try {
+        unlinkSync(path); // 존재하면 삭제 후 true, ENOENT면 catch
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// CLARIFY 대화: 답변 파일 읽기 + 정리
+export function readClarifyAnswer(workingDir) {
+    const answerPath = join(workingDir, STATE_DIR, CLARIFY_ANSWER_FILE);
+    if (!existsSync(answerPath))
+        return null;
+    try {
+        const answer = readFileSync(answerPath, "utf-8").trim();
+        unlinkSync(answerPath);
+        const pendingPath = join(workingDir, STATE_DIR, CLARIFY_PENDING_FILE);
+        try {
+            unlinkSync(pendingPath);
+        }
+        catch { /* 없으면 무시 */ }
+        return answer || null;
+    }
+    catch {
+        return null;
+    }
+}
+// CLARIFY 대화: 질문 파일 작성 (plugin 모드)
+export function writeClarifyPending(workingDir, question) {
+    const dir = join(workingDir, STATE_DIR);
+    mkdirSync(dir, { recursive: true });
+    const pendingPath = join(dir, CLARIFY_PENDING_FILE);
+    writeFileSync(pendingPath, JSON.stringify({ question, timestamp: Date.now() }, null, 2));
+}
+// .soda/가 .gitignore에 없으면 추가
+export function ensureSodaIgnored(workingDir) {
+    const gitignorePath = join(workingDir, ".gitignore");
+    if (!existsSync(gitignorePath)) {
+        logWarn(".gitignore가 없습니다. .soda/ 디렉토리가 버전 관리에 포함될 수 있습니다.");
+        return;
+    }
+    try {
+        const content = readFileSync(gitignorePath, "utf-8");
+        const lines = content.split("\n");
+        const hasSodaEntry = lines.some((line) => {
+            const trimmed = line.trim();
+            return trimmed === ".soda" || trimmed === ".soda/" || trimmed === "/.soda" || trimmed === "/.soda/";
+        });
+        if (hasSodaEntry)
+            return;
+        appendFileSync(gitignorePath, "\n# soda agent state\n.soda/\n");
+    }
+    catch (e) {
+        logWarn(`gitignore 업데이트 실패: ${getErrorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+export declare const SCHEMA_VERSION = 4;
+export declare enum Phase {
+    CLARIFY = "clarify",
+    IMPLEMENT = "implement",
+    VERIFY = "verify",
+    DONE = "done"
+}
+export interface GoalConfirmed {
+    summary: string;
+    tasks: string[];
+    completionCriteria: string[];
+    isRefactoring?: boolean;
+    isUIWork?: boolean;
+}
+export interface ClarifyMessage {
+    role: "assistant" | "user";
+    content: string;
+}
+export interface RunState {
+    schemaVersion: number;
+    goal: string;
+    goalConfirmed: GoalConfirmed | null;
+    phase: Phase;
+    verifyPass: number;
+    iterations: number;
+    consecutiveFailures: number;
+    failureHistory: string[];
+    startTime: number;
+    implementationSummary: string | null;
+    lastVerifyResult: string | null;
+    clarifyRetries?: number;
+    clarifyMessages?: ClarifyMessage[];
+}
+export interface Limits {
+    maxIterations: number;
+    maxTimeMinutes: number;
+    maxConsecutiveFails: number;
+}
+export declare const DEFAULT_LIMITS: Limits;
+export interface PhaseConfig {
+    phase: Phase;
+    prompt: string;
+    systemPromptAppend: string;
+    allowedTools?: string[];
+    skipPermissions: boolean;
+    cwd: string;
+}
+export interface PhaseResult {
+    text: string;
+    sessionId: string;
+}
+export interface PhaseTransition {
+    nextPhase: Phase;
+    verdict: {
+        pass: boolean;
+        reason: string;
+    } | null;
+}
+export declare function getErrorMessage(e: unknown): string;

package/dist/types.js

@@ -0,0 +1,18 @@
+// soda 전체에서 사용되는 타입 정의
+export const SCHEMA_VERSION = 4;
+export var Phase;
+(function (Phase) {
+    Phase["CLARIFY"] = "clarify";
+    Phase["IMPLEMENT"] = "implement";
+    Phase["VERIFY"] = "verify";
+    Phase["DONE"] = "done";
+})(Phase || (Phase = {}));
+export const DEFAULT_LIMITS = {
+    maxIterations: 50,
+    maxTimeMinutes: 180,
+    maxConsecutiveFails: 10,
+};
+export function getErrorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAN,IAAY,KAKX;AALD,WAAY,KAAK;IACf,4BAAmB,CAAA;IACnB,gCAAuB,CAAA;IACvB,0BAAiB,CAAA;IACjB,sBAAa,CAAA;AACf,CAAC,EALW,KAAK,KAAL,KAAK,QAKhB;AAqCD,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,GAAG;IACnB,mBAAmB,EAAE,EAAE;CACxB,CAAC;AAqBF,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@tinygem/soda-agent",
+  "version": "0.1.0",
+  "description": "자율 개발 에이전트 - Claude Code 기반으로 태스크를 끝까지 완수한다",
+  "bin": {
+    "soda-agent": "dist/cli.js",
+    "soda": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "plugin/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "pretest": "npm run build",
+    "test": "node --test test/*.test.js",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "soda",
+  "version": "0.1.0",
+  "description": "Autonomous development agent - completes tasks end-to-end via fresh Claude sessions per phase",
+  "author": {
+    "name": "soda"
+  },
+  "commands": "./commands/",
+  "skills": "./skills/",
+  "keywords": ["autonomous", "agent", "development", "verification"]
+}

package/plugin/commands/soda-cancel.md

@@ -0,0 +1,23 @@
+---
+name: soda-cancel
+description: Cancel a running soda agent gracefully
+---
+
+Cancel the running soda engine by creating a cancel sentinel file.
+
+Run this command via Bash:
+
+```bash
+if [ -f .soda/engine.pid ]; then
+  PID=$(cat .soda/engine.pid)
+  if kill -0 "$PID" 2>/dev/null; then
+    touch .soda/cancel
+    echo "Cancel signal sent to PID $PID. soda will stop after the current phase completes."
+    echo "State is saved — you can resume later with: npx @tinygem/soda-agent --resume"
+  else
+    echo "soda engine (PID $PID) is no longer running. No cancel needed."
+  fi
+else
+  echo "No running soda session found."
+fi
+```

package/plugin/commands/soda-status.md

@@ -0,0 +1,31 @@
+---
+name: soda-status
+description: Check the current status of a running soda agent
+---
+
+Check the soda engine status by reading its state and process information.
+
+Run this command via Bash:
+
+```bash
+if [ -f .soda/state.json ]; then
+  echo "=== soda state ==="
+  cat .soda/state.json
+  echo ""
+  if [ -f .soda/engine.pid ]; then
+    PID=$(cat .soda/engine.pid)
+    if kill -0 "$PID" 2>/dev/null; then
+      echo "STATUS: running (PID $PID)"
+    else
+      echo "STATUS: finished"
+    fi
+  else
+    echo "STATUS: no PID file (engine may have completed)"
+  fi
+else
+  echo "STATUS: no soda session found"
+fi
+```
+
+Report to the user: current phase, iteration count, consecutive failures, and whether
+the engine is still running.

package/plugin/skills/soda/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: soda
+description: Launch the soda autonomous development agent to complete a complex task end-to-end with multi-phase verification. Use when the user wants fully autonomous implementation with quality guarantees.
+disable-model-invocation: true
+---
+
+# soda Autonomous Agent
+
+soda runs as a background process that spawns fresh `claude -p` sessions for each phase
+(CLARIFY -> IMPLEMENT -> VERIFY), preventing context degradation.
+
+## Prerequisites
+
+- Claude Code가 설치되어 있어야 합니다.
+- `claude --dangerously-skip-permissions` 를 1회 실행하여 약관에 동의해야 합니다. soda는 내부적으로 이 플래그를 사용하여 자율 실행합니다.
+- root 사용자로는 실행할 수 없습니다 (Claude Code 제한).
+
+## Instructions
+
+1. If the user provides no task description, ask them what they want soda to do before launching.
+
+2. Launch soda in the background using the Bash tool:
+
+```bash
+npx @tinygem/soda-agent --plugin-mode "$ARGUMENTS" > .soda/output.log 2>&1
+```
+
+Use `run_in_background: true` on the Bash tool call.
+
+3. Tell the user that soda has been launched and is running in the background.
+
+4. To check progress, read the state file:
+
+```bash
+if [ -f .soda/state.json ]; then
+  cat .soda/state.json
+  echo ""
+  if [ -f .soda/engine.pid ]; then
+    PID=$(cat .soda/engine.pid 2>/dev/null)
+    [ -n "$PID" ] && kill -0 "$PID" 2>/dev/null && echo "STATUS: running" || echo "STATUS: finished"
+  fi
+  if [ -f .soda/clarify-pending.json ]; then
+    echo "CLARIFY_PENDING: true"
+    cat .soda/clarify-pending.json
+  fi
+else
+  echo "No soda session found."
+fi
+```
+
+5. Report the current phase, iteration count, and status to the user.
+
+6. **CLARIFY 대화 처리**: soda가 종료되고 `.soda/clarify-pending.json`이 존재하면:
+   - 파일의 `question` 내용을 사용자에게 보여준다.
+   - 사용자의 답변을 받는다.
+   - 답변을 `.soda/clarify-answer.txt`에 기록한다:
+     ```bash
+     echo "사용자의 답변 내용" > .soda/clarify-answer.txt
+     ```
+   - soda를 재개한다:
+     ```bash
+     npx @tinygem/soda-agent --plugin-mode --resume > .soda/output.log 2>&1
+     ```
+     Use `run_in_background: true` on the Bash tool call.
+
+## Important Rules
+
+- Always run soda in the background. It can take a long time.
+- The engine writes progress to `.soda/state.json` after each phase.
+- If the user asks to stop, use `/soda-cancel`.
+- When finished, `.soda/state.json` will show `"phase": "done"`.
+- To resume a stopped session: `npx @tinygem/soda-agent --plugin-mode --resume`