@tinygem/soda-agent 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,3 @@
+export declare function isAuthRequired(): boolean;
+export declare function isAuthenticated(): boolean;
+export declare function authenticate(code: string): boolean;

package/dist/auth.js

@@ -0,0 +1,40 @@
+// 초대 코드 기반 접근 제어
+// SHA-256 해시로 코드 검증, ~/.soda/auth.json에 인증 캐시
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const AUTH_DIR = join(homedir(), ".soda");
+const AUTH_FILE = join(AUTH_DIR, "auth.json");
+// 유효한 초대 코드의 SHA-256 해시 목록
+// 새 코드 추가: echo -n "코드" | sha256sum → 해시를 배열에 추가 → npm publish
+const VALID_CODE_HASHES = [
+    "63480d1058157eac3adce6c45ba7da6ed320d4737c073296eda6705de8a4de5d", // cj26
+];
+function hashCode(code) {
+    return createHash("sha256").update(code.trim()).digest("hex");
+}
+// 코드 해시 목록이 비어있으면 인증 불필요 (개발 모드)
+export function isAuthRequired() {
+    return VALID_CODE_HASHES.length > 0;
+}
+export function isAuthenticated() {
+    if (!existsSync(AUTH_FILE))
+        return false;
+    try {
+        const data = JSON.parse(readFileSync(AUTH_FILE, "utf-8"));
+        return typeof data.codeHash === "string" && VALID_CODE_HASHES.includes(data.codeHash);
+    }
+    catch {
+        return false;
+    }
+}
+export function authenticate(code) {
+    const hash = hashCode(code);
+    if (!VALID_CODE_HASHES.includes(hash))
+        return false;
+    mkdirSync(AUTH_DIR, { recursive: true });
+    writeFileSync(AUTH_FILE, JSON.stringify({ codeHash: hash, authenticatedAt: Date.now() }, null, 2), { mode: 0o600 });
+    return true;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,8CAA8C;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE9C,2BAA2B;AAC3B,+DAA+D;AAC/D,MAAM,iBAAiB,GAAa;IAClC,kEAAkE,EAAE,OAAO;CAC5E,CAAC;AAEF,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,cAAc;IAC5B,OAAO,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/circuit-breaker.d.ts

@@ -0,0 +1,5 @@
+import type { Limits, RunState } from "./types.js";
+export declare class CircuitBreakerError extends Error {
+    constructor(message: string);
+}
+export declare function checkCircuitBreaker(state: RunState, limits: Limits): void;

package/dist/circuit-breaker.js

@@ -0,0 +1,23 @@
+// 안전 장치: 반복/시간/연속 실패 제한
+export class CircuitBreakerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CircuitBreakerError";
+    }
+}
+export function checkCircuitBreaker(state, limits) {
+    if (state.iterations >= limits.maxIterations) {
+        throw new CircuitBreakerError(`최대 반복 횟수(${limits.maxIterations})를 초과했습니다. ` +
+            `현재: ${state.iterations}회`);
+    }
+    const elapsedMinutes = (Date.now() - state.startTime) / 60_000;
+    if (elapsedMinutes >= limits.maxTimeMinutes) {
+        throw new CircuitBreakerError(`최대 실행 시간(${limits.maxTimeMinutes}분)을 초과했습니다. ` +
+            `경과: ${Math.round(elapsedMinutes)}분`);
+    }
+    if (state.consecutiveFailures >= limits.maxConsecutiveFails) {
+        throw new CircuitBreakerError(`연속 실패 횟수(${limits.maxConsecutiveFails})를 초과했습니다. ` +
+            `현재: ${state.consecutiveFailures}회 연속 실패`);
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../src/circuit-breaker.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAIxB,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAe,EAAE,MAAc;IACjE,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,IAAI,mBAAmB,CAC3B,YAAY,MAAM,CAAC,aAAa,aAAa;YAC3C,OAAO,KAAK,CAAC,UAAU,GAAG,CAC7B,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IAC/D,IAAI,cAAc,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,IAAI,mBAAmB,CAC3B,YAAY,MAAM,CAAC,cAAc,cAAc;YAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CACvC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,mBAAmB,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC5D,MAAM,IAAI,mBAAmB,CAC3B,YAAY,MAAM,CAAC,mBAAmB,aAAa;YACjD,OAAO,KAAK,CAAC,mBAAmB,SAAS,CAC5C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+// soda CLI 진입점: 인자 파싱, 인증, 오케스트레이터 시작
+import { readFileSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_LIMITS, getErrorMessage } from "./types.js";
+import { checkClaudeCLI } from "./executor.js";
+import { run } from "./orchestrator.js";
+import { logError, logInfo, logSuccess, logWarn } from "./logger.js";
+import { clearState, cleanupPidFile, isLocked, writeClarifyPending, writePidFile } from "./state.js";
+import { isAuthRequired, isAuthenticated, authenticate } from "./auth.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let VERSION = "0.1.0";
+try {
+    VERSION = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8")).version;
+}
+catch { /* dist 외부에서 실행 시 폴백 사용 */ }
+const HELP = `
+soda v${VERSION} — 자율 개발 에이전트
+
+사용법:
+  npx soda "작업 내용"              작업 실행
+  npx soda --resume                이전 작업 재개
+  npx soda --clear                 저장된 작업 상태 삭제
+  npx soda --help                  도움말
+
+옵션:
+  --max-iterations N     최대 반복 횟수 (기본: ${DEFAULT_LIMITS.maxIterations})
+  --max-time N           최대 실행 시간(분) (기본: ${DEFAULT_LIMITS.maxTimeMinutes})
+  --resume               이전 작업 재개
+  --help, -h             도움말
+
+사전 요구사항:
+  - Claude Code가 설치되어 있어야 합니다.
+  - claude --dangerously-skip-permissions 를 1회 실행하여 약관에 동의해야 합니다.
+  - root 사용자로는 실행할 수 없습니다.
+`;
+function parseArgs(argv) {
+    const result = {
+        goal: "",
+        resume: false,
+        limits: { ...DEFAULT_LIMITS },
+        clear: false,
+        help: false,
+        pluginMode: false,
+    };
+    const args = argv.slice(2); // node, script 제외
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case "--help":
+            case "-h":
+                result.help = true;
+                break;
+            case "--resume":
+                result.resume = true;
+                break;
+            case "--clear":
+                result.clear = true;
+                break;
+            case "--max-iterations": {
+                i++;
+                const maxIter = parseInt(args[i] ?? "", 10);
+                if (Number.isFinite(maxIter) && maxIter > 0) {
+                    result.limits.maxIterations = maxIter;
+                }
+                else {
+                    logWarn(`잘못된 --max-iterations 값: "${args[i]}". 기본값 ${DEFAULT_LIMITS.maxIterations}을 사용합니다.`);
+                }
+                break;
+            }
+            case "--max-time": {
+                i++;
+                const maxTime = parseInt(args[i] ?? "", 10);
+                if (Number.isFinite(maxTime) && maxTime > 0) {
+                    result.limits.maxTimeMinutes = maxTime;
+                }
+                else {
+                    logWarn(`잘못된 --max-time 값: "${args[i]}". 기본값 ${DEFAULT_LIMITS.maxTimeMinutes}을 사용합니다.`);
+                }
+                break;
+            }
+            // 내부 플래그 — Claude Code 플러그인에서 자동으로 사용되며
+            // 사용자가 직접 사용할 필요 없으므로 --help에 표시하지 않음
+            case "--plugin-mode":
+                result.pluginMode = true;
+                break;
+            default:
+                if (arg.startsWith("--")) {
+                    logWarn(`알 수 없는 옵션: ${arg}`);
+                }
+                else {
+                    result.goal = result.goal ? `${result.goal} ${arg}` : arg;
+                }
+                break;
+        }
+        i++;
+    }
+    return result;
+}
+// CLARIFY 멀티턴 대화: NPX 모드 (터미널 입력)
+function createTerminalInput() {
+    return async (clarifyOutput) => {
+        console.log(`\n${clarifyOutput}\n`);
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const answer = await new Promise((resolve) => {
+                rl.question("[soda] 답변을 입력하세요: ", resolve);
+            });
+            return answer.trim() || null;
+        }
+        finally {
+            rl.close();
+        }
+    };
+}
+// CLARIFY 멀티턴 대화: Plugin 모드 (파일 기반 시그널링)
+function createPluginInput() {
+    return async (clarifyOutput, workingDir) => {
+        writeClarifyPending(workingDir, clarifyOutput);
+        logInfo("CLARIFY 질문이 .soda/clarify-pending.json에 저장되었습니다.");
+        return null;
+    };
+}
+async function main() {
+    const parsed = parseArgs(process.argv);
+    // 도움말
+    if (parsed.help) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    // 상태 삭제
+    if (parsed.clear) {
+        clearState(process.cwd());
+        logInfo("작업 상태가 삭제되었습니다.");
+        process.exit(0);
+    }
+    // root 사용자 차단 (Claude Code가 root에서 --dangerously-skip-permissions 차단)
+    if (typeof process.getuid === "function" && process.getuid() === 0) {
+        logError("root 사용자로는 soda를 실행할 수 없습니다.");
+        logError("Claude Code가 root에서 --dangerously-skip-permissions를 차단합니다.");
+        logError("일반 사용자로 전환 후 실행하세요.");
+        process.exit(1);
+    }
+    // Claude CLI 확인
+    const hasClaude = await checkClaudeCLI();
+    if (!hasClaude) {
+        logError("claude CLI를 찾을 수 없습니다.");
+        logError("Claude Code를 먼저 설치하세요: https://docs.anthropic.com/en/docs/claude-code");
+        process.exit(1);
+    }
+    // 초대 코드 인증 확인
+    if (isAuthRequired() && !isAuthenticated()) {
+        const code = process.env.SODA_INVITE_CODE;
+        if (code) {
+            if (!authenticate(code)) {
+                logError("유효하지 않은 초대 코드입니다.");
+                process.exit(1);
+            }
+            logInfo("인증 완료.");
+        }
+        else {
+            // 터미널 입력으로 초대 코드 요청
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            const inputCode = await new Promise((resolve) => {
+                rl.question("[soda] 초대 코드를 입력하세요: ", resolve);
+            });
+            rl.close();
+            if (!authenticate(inputCode)) {
+                logError("유효하지 않은 초대 코드입니다.");
+                process.exit(1);
+            }
+            logSuccess("인증 완료!");
+        }
+    }
+    // goal 또는 resume 확인
+    if (!parsed.goal && !parsed.resume) {
+        logError("작업 내용을 입력하세요.");
+        console.log(HELP);
+        process.exit(1);
+    }
+    // goal과 resume 동시 지정 시 경고
+    if (parsed.goal && parsed.resume) {
+        logWarn("--resume과 작업 내용이 동시에 지정되었습니다. 이전 작업을 재개합니다.");
+        // resume 우선 — 새 goal은 무시
+    }
+    const cwd = process.cwd();
+    // 동시 실행 보호 — PID 기록 전에 확인
+    if (isLocked(cwd)) {
+        logError("다른 soda 인스턴스가 이 디렉토리에서 이미 실행 중입니다.");
+        process.exit(1);
+    }
+    // PID 파일 기록
+    writePidFile(cwd);
+    // 시작 메시지
+    logSuccess("soda 시작");
+    if (parsed.resume) {
+        logInfo("이전 작업을 재개합니다...");
+    }
+    else {
+        logInfo(`작업: ${parsed.goal}`);
+    }
+    // 오케스트레이터 실행
+    try {
+        await run({
+            goal: parsed.goal,
+            workingDir: cwd,
+            resume: parsed.resume,
+            limits: parsed.limits,
+            pluginMode: parsed.pluginMode,
+            getUserInput: parsed.pluginMode ? createPluginInput() : createTerminalInput(),
+        });
+    }
+    finally {
+        cleanupPidFile(cwd);
+    }
+}
+main().catch((err) => {
+    logError(`치명적 오류: ${getErrorMessage(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,3 @@
+import type { PhaseConfig, PhaseResult } from "./types.js";
+export declare function executeClaudePhase(config: PhaseConfig): Promise<PhaseResult>;
+export declare function checkClaudeCLI(): Promise<boolean>;

package/dist/executor.js

@@ -0,0 +1,146 @@
+// claude -p subprocess 실행기
+// 각 호출은 새 세션 (fresh context) — 컨텍스트 열화 방지
+import { spawn } from "node:child_process";
+import { logError } from "./logger.js";
+const PHASE_TIMEOUT_MS = 30 * 60 * 1000; // 30분
+const MAX_BUFFER_SIZE = 10 * 1024 * 1024; // 10MB
+export async function executeClaudePhase(config) {
+    const args = ["-p"];
+    // 시스템 프롬프트 추가 (구현/검증 규칙 주입)
+    if (config.systemPromptAppend) {
+        args.push("--append-system-prompt", config.systemPromptAppend);
+    }
+    // 도구 제한
+    if (config.allowedTools?.length) {
+        args.push("--allowedTools", ...config.allowedTools);
+    }
+    // 자율 실행 모드
+    if (config.skipPermissions) {
+        args.push("--dangerously-skip-permissions");
+    }
+    // JSON 출력
+    args.push("--output-format", "json");
+    return new Promise((resolve, reject) => {
+        const child = spawn("claude", args, {
+            cwd: config.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let settled = false;
+        // #5: escalation 타이머를 저장하여 close 시 정리
+        let escalationTimer = null;
+        // 타임아웃: 30분 후 강제 종료
+        const timer = setTimeout(() => {
+            if (!settled) {
+                child.kill("SIGTERM");
+                escalationTimer = setTimeout(() => {
+                    if (!settled)
+                        try {
+                            child.kill("SIGKILL");
+                        }
+                        catch { /* already exited */ }
+                }, 10_000);
+                escalationTimer.unref();
+            }
+        }, PHASE_TIMEOUT_MS);
+        // stdin 에러 처리 (자식 프로세스가 즉시 종료된 경우 pipe 깨짐 방지)
+        child.stdin.on("error", () => { });
+        child.stdin.write(config.prompt);
+        child.stdin.end();
+        let stdout = "";
+        let stderr = "";
+        let truncated = false;
+        child.stdout.on("data", (data) => {
+            const remaining = MAX_BUFFER_SIZE - stdout.length;
+            if (remaining > 0) {
+                const chunk = data.toString();
+                stdout += remaining >= chunk.length ? chunk : chunk.slice(0, remaining);
+            }
+            else if (!truncated) {
+                truncated = true;
+                logError("stdout 버퍼 제한 초과 — 출력이 잘렸습니다.");
+            }
+        });
+        child.stderr.on("data", (data) => {
+            if (stderr.length < MAX_BUFFER_SIZE) {
+                stderr += data.toString();
+            }
+        });
+        child.on("error", (err) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                if (escalationTimer)
+                    clearTimeout(escalationTimer);
+                reject(new Error(`claude 실행 실패: ${err.message}`));
+            }
+        });
+        child.on("close", (code, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (escalationTimer)
+                clearTimeout(escalationTimer);
+            if (signal === "SIGTERM" || signal === "SIGKILL") {
+                reject(new Error(`claude 프로세스가 타임아웃으로 종료되었습니다 (${PHASE_TIMEOUT_MS / 60_000}분).`));
+                return;
+            }
+            // #12: 비정상 종료 + 출력 없음 → 에러로 처리
+            if (code !== 0) {
+                logError(`claude 종료 코드: ${code}`);
+                if (stderr)
+                    logError(`stderr: ${stderr.slice(0, 500)}`);
+                if (!stdout.trim()) {
+                    reject(new Error(`claude가 출력 없이 종료되었습니다 (종료 코드: ${code}).`));
+                    return;
+                }
+            }
+            try {
+                const parsed = JSON.parse(stdout);
+                resolve({
+                    text: parsed.result ?? stdout,
+                    sessionId: parsed.session_id ?? "",
+                });
+            }
+            catch {
+                // JSON 파싱 실패 시 원시 텍스트 반환
+                resolve({
+                    text: stdout || stderr,
+                    sessionId: "",
+                });
+            }
+        });
+    });
+}
+// claude CLI 존재 여부 확인
+const CLI_CHECK_TIMEOUT_MS = 10_000;
+export async function checkClaudeCLI() {
+    return new Promise((resolve) => {
+        let done = false;
+        const child = spawn("claude", ["--version"], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const timer = setTimeout(() => {
+            if (!done) {
+                done = true;
+                child.kill("SIGTERM");
+                resolve(false);
+            }
+        }, CLI_CHECK_TIMEOUT_MS);
+        child.on("close", (code) => {
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolve(code === 0);
+            }
+        });
+        child.on("error", () => {
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolve(false);
+            }
+        });
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/external-help.d.ts

@@ -0,0 +1,5 @@
+export interface ExternalHelpResult {
+    source: string;
+    advice: string;
+}
+export declare function getExternalHelp(problem: string, cwd: string): Promise<ExternalHelpResult | null>;

package/dist/external-help.js

@@ -0,0 +1,78 @@
+// 외부 AI 도움: 연속 실패 시 gemini/codex CLI로 조언 요청
+import { spawn } from "node:child_process";
+import { logInfo, logWarn } from "./logger.js";
+const HELP_TIMEOUT_MS = 5 * 60 * 1000; // 5분
+const MAX_OUTPUT_SIZE = 50_000; // 50KB
+export async function getExternalHelp(problem, cwd) {
+    // gemini CLI 시도
+    const geminiResult = await tryGemini(problem, cwd);
+    if (geminiResult)
+        return geminiResult;
+    // codex CLI 시도
+    const codexResult = await tryCodex(problem, cwd);
+    if (codexResult)
+        return codexResult;
+    logWarn("외부 AI 도움을 받을 수 없습니다 (gemini, codex 모두 실패).");
+    return null;
+}
+async function tryGemini(problem, cwd) {
+    try {
+        logInfo("gemini CLI로 도움 요청 중...");
+        const output = await runCli("gemini", ["-p", problem], cwd);
+        if (output)
+            return { source: "gemini", advice: output };
+    }
+    catch {
+        logWarn("gemini CLI 실행 실패.");
+    }
+    return null;
+}
+async function tryCodex(problem, cwd) {
+    try {
+        logInfo("codex CLI로 도움 요청 중...");
+        const output = await runCli("codex", ["exec", problem], cwd);
+        if (output)
+            return { source: "codex", advice: output };
+    }
+    catch {
+        logWarn("codex CLI 실행 실패.");
+    }
+    return null;
+}
+function runCli(command, args, cwd) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const child = spawn(command, args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                child.kill("SIGTERM");
+                resolve(null);
+            }
+        }, HELP_TIMEOUT_MS);
+        let stdout = "";
+        child.stdout.on("data", (data) => {
+            if (stdout.length < MAX_OUTPUT_SIZE) {
+                stdout += data.toString();
+            }
+        });
+        child.on("error", () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(null);
+            }
+        });
+        child.on("close", (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(code === 0 && stdout.trim() ? stdout.trim() : null);
+            }
+        });
+    });
+}
+//# sourceMappingURL=external-help.js.map

package/dist/external-help.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+import { Phase } from "./types.js";
+export declare function logPhaseStart(phase: Phase, iteration: number): void;
+export declare function logPhaseResult(phase: Phase, success: boolean): void;
+export declare function logInfo(message: string): void;
+export declare function logWarn(message: string): void;
+export declare function logError(message: string): void;
+export declare function logSuccess(message: string): void;

package/dist/logger.js

@@ -0,0 +1,49 @@
+// 콘솔 출력 포맷
+import { Phase } from "./types.js";
+// 비TTY(파일 리다이렉트, 플러그인 모드 등)에서 ANSI 코드 비활성화
+const USE_COLORS = process.stdout.isTTY ?? false;
+const COLORS = USE_COLORS
+    ? {
+        reset: "\x1b[0m",
+        bold: "\x1b[1m",
+        dim: "\x1b[2m",
+        green: "\x1b[32m",
+        yellow: "\x1b[33m",
+        blue: "\x1b[34m",
+        cyan: "\x1b[36m",
+        red: "\x1b[31m",
+    }
+    : {
+        reset: "", bold: "", dim: "", green: "", yellow: "",
+        blue: "", cyan: "", red: "",
+    };
+const PHASE_LABELS = {
+    [Phase.CLARIFY]: "요구사항 확인",
+    [Phase.IMPLEMENT]: "구현",
+    [Phase.VERIFY]: "검증",
+    [Phase.DONE]: "완료",
+};
+export function logPhaseStart(phase, iteration) {
+    const label = PHASE_LABELS[phase];
+    console.log(`\n${COLORS.bold}${COLORS.cyan}[soda]${COLORS.reset} ` +
+        `${COLORS.blue}${label}${COLORS.reset} ` +
+        `${COLORS.dim}(반복 #${iteration})${COLORS.reset}`);
+}
+export function logPhaseResult(phase, success) {
+    const label = PHASE_LABELS[phase];
+    const icon = success ? `${COLORS.green}✓` : `${COLORS.red}✗`;
+    console.log(`${COLORS.bold}${icon} ${label}${COLORS.reset}`);
+}
+export function logInfo(message) {
+    console.log(`${COLORS.cyan}[soda]${COLORS.reset} ${message}`);
+}
+export function logWarn(message) {
+    console.log(`${COLORS.yellow}[soda 경고]${COLORS.reset} ${message}`);
+}
+export function logError(message) {
+    console.error(`${COLORS.red}[soda 오류]${COLORS.reset} ${message}`);
+}
+export function logSuccess(message) {
+    console.log(`${COLORS.green}${COLORS.bold}[soda]${COLORS.reset} ${COLORS.green}${message}${COLORS.reset}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,WAAW;AAEX,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,2CAA2C;AAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;AAEjD,MAAM,MAAM,GAAG,UAAU;IACvB,CAAC,CAAC;QACE,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,UAAU;KAChB;IACH,CAAC,CAAC;QACE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QACnD,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;KAC5B,CAAC;AAEN,MAAM,YAAY,GAA0B;IAC1C,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS;IAC1B,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI;IACvB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI;IACpB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,SAAiB;IAC3D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CACT,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,KAAK,GAAG;QACpD,GAAG,MAAM,CAAC,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG;QACxC,GAAG,MAAM,CAAC,GAAG,QAAQ,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAAgB;IAC3D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,YAAY,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7G,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,11 @@
+import { type Limits } from "./types.js";
+interface OrchestratorOptions {
+    goal: string;
+    workingDir: string;
+    resume: boolean;
+    limits: Limits;
+    pluginMode?: boolean;
+    getUserInput?: (clarifyOutput: string, workingDir: string) => Promise<string | null>;
+}
+export declare function run(options: OrchestratorOptions): Promise<void>;
+export {};