@tinygem/soda-agent 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,52 @@
+tinygem Proprietary License
+
+Copyright (c) 2026 tinygem. All rights reserved.
+
+1. GRANT OF LICENSE
+
+   This software is licensed, not sold. tinygem grants you a limited,
+   non-exclusive, non-transferable, revocable license to use this software
+   solely for your internal purposes, provided that you hold a valid invite
+   code or license key issued by tinygem.
+
+2. RESTRICTIONS
+
+   You may NOT:
+   (a) redistribute, sublicense, sell, lease, or otherwise transfer this
+       software or any portion thereof to any third party;
+   (b) modify, adapt, translate, reverse engineer, decompile, or
+       disassemble this software;
+   (c) remove or alter any proprietary notices, labels, or marks on this
+       software;
+   (d) use this software without a valid invite code or license key;
+   (e) share, publish, or disclose your invite code or license key to
+       any third party.
+
+3. SOURCE CODE VISIBILITY
+
+   The source code of this software may be publicly viewable for
+   transparency purposes. Visibility of the source code does NOT
+   constitute a grant of any rights to use, copy, modify, or distribute
+   the software. All rights not expressly granted herein are reserved.
+
+4. TERMINATION
+
+   This license is effective until terminated. Your rights under this
+   license will terminate automatically and immediately if you fail to
+   comply with any term of this license. Upon termination, you must
+   cease all use of the software.
+
+5. DISCLAIMER OF WARRANTIES
+
+   THIS 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 TINYGEM 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.
+
+6. GOVERNING LAW
+
+   This license shall be governed by and construed in accordance with
+   the laws of the Republic of Korea.

package/README.ko.md

@@ -0,0 +1,107 @@
+# soda
+
+**Claude Code 기반으로 태스크를 끝까지 완수하는 자율 개발 에이전트.**
+
+[English](./README.md)
+
+## soda란?
+
+soda는 Claude Code 위에 구축된 완전 자율 멀티페이즈 개발 에이전트입니다. 각 단계마다 새로운 Claude 세션을 생성하여 컨텍스트 열화를 방지하며, 연속 검증을 통과할 때까지 반복 실행합니다.
+
+## 주요 특징
+
+- **멀티페이즈 사이클** — CLARIFY → IMPLEMENT → VERIFY → DONE
+- **단계별 새로운 컨텍스트** — 각 단계를 새로운 `claude -p` 세션으로 실행하여 컨텍스트 윈도우 열화 방지
+- **연속 검증** — 2회 연속 검증 통과 필요 (리팩토링 작업은 5회)
+- **상태 영속화** — `.soda/state.json`에 진행 상태 저장, `--resume`으로 언제든 재개 가능
+- **서킷 브레이커** — 과도한 반복, 시간 초과, 연속 실패 시 자동 중단
+- **초대 코드 인증** — SHA-256 해시 기반 접근 제어
+
+## 선행 요구사항
+
+- [Claude Code](https://claude.ai/claude-code)가 설치되어 있고 PATH에서 `claude`로 실행 가능해야 함
+- Node.js >= 18
+- `claude --dangerously-skip-permissions`를 1회 실행하여 약관 동의
+- 유효한 **초대 코드**
+
+## 설치
+
+```bash
+# 바로 실행
+npx @tinygem/soda-agent "작업 설명"
+
+# 또는 전역 설치
+npm install -g @tinygem/soda-agent
+soda "작업 설명"
+```
+
+첫 실행 시 초대 코드를 입력하라는 프롬프트가 나타납니다. 환경변수로도 설정할 수 있습니다:
+
+```bash
+export SODA_INVITE_CODE=your-code
+```
+
+## 사용법
+
+```bash
+# 새 작업 시작
+soda "JWT 기반 사용자 인증 구현"
+
+# 이전 작업 재개
+soda --resume
+
+# 저장된 상태 삭제
+soda --clear
+
+# 제한 설정 변경
+soda "결제 모듈 리팩토링" --max-iterations 100 --max-time 300
+```
+
+### CLI 옵션
+
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `--resume` | 저장된 상태에서 이전 작업 재개 | — |
+| `--clear` | 저장된 상태 삭제 후 새로 시작 | — |
+| `--max-iterations <n>` | 최대 반복 횟수 | 50 |
+| `--max-time <분>` | 최대 실행 시간(분) | 180 |
+
+## Claude Code 플러그인
+
+soda는 Claude Code 플러그인으로도 사용할 수 있습니다.
+
+### 플러그인 설치
+
+```bash
+claude plugin add npm:@tinygem/soda-agent
+```
+
+### 플러그인 명령
+
+| 명령 | 설명 |
+|------|------|
+| `/soda <작업>` | soda를 실행하여 작업을 자율적으로 완수 |
+| `/soda-status` | 현재 진행 상황 확인 (단계, 반복 횟수, 상태) |
+| `/soda-cancel` | 실행 중인 에이전트 정상 종료 |
+
+## 작동 방식
+
+```
+┌─────────┐     ┌───────────┐     ┌────────┐     ┌──────┐
+│ CLARIFY │ ──→ │ IMPLEMENT │ ──→ │ VERIFY │ ──→ │ DONE │
+└─────────┘     └───────────┘     └────────┘     └──────┘
+     ↑                ↑               │
+     │                └───── FAIL ─────┘
+     │                      (재시도)
+     └── 명확화 필요
+```
+
+1. **CLARIFY** — 요청을 분석하고, 필요 시 질문하여 목표를 확정
+2. **IMPLEMENT** — 전체 컨텍스트가 포함된 새로운 Claude 세션으로 코드 생성
+3. **VERIFY** — 완성 조건에 대해 독립적으로 검증
+4. **DONE** — 연속 검증 통과 후 작업 완료
+
+## 라이선스
+
+이 소프트웨어는 독점 소프트웨어입니다. 사용하려면 유효한 초대 코드가 필요합니다.
+자세한 내용은 [LICENSE](./LICENSE)를 참고하세요.

package/README.md

@@ -0,0 +1,107 @@
+# soda
+
+**Autonomous development agent that completes tasks end-to-end using Claude Code.**
+
+[한국어](./README.ko.md)
+
+## What is soda?
+
+soda is a fully autonomous multi-phase development agent built on top of Claude Code. It spawns fresh Claude sessions for each phase to prevent context degradation, and runs an iterative cycle until the task passes consecutive verification rounds.
+
+## Key Features
+
+- **Multi-phase cycle** — CLARIFY → IMPLEMENT → VERIFY → DONE
+- **Fresh context per phase** — Each phase runs in a new `claude -p` session, preventing context window degradation
+- **Consecutive verification** — Must pass 2 consecutive verify rounds (5 for refactoring tasks)
+- **State persistence** — Progress saved to `.soda/state.json`; resume anytime with `--resume`
+- **Circuit breaker** — Auto-stops on excessive iterations, time limits, or consecutive failures
+- **Invite code auth** — Access controlled via SHA-256 hashed invite codes
+
+## Prerequisites
+
+- [Claude Code](https://claude.ai/claude-code) installed and available as `claude` in PATH
+- Node.js >= 18
+- Run `claude --dangerously-skip-permissions` once to accept the terms
+- A valid **invite code**
+
+## Installation
+
+```bash
+# Run directly
+npx @tinygem/soda-agent "your task description"
+
+# Or install globally
+npm install -g @tinygem/soda-agent
+soda "your task description"
+```
+
+On first run, you will be prompted for an invite code. You can also set it via environment variable:
+
+```bash
+export SODA_INVITE_CODE=your-code
+```
+
+## Usage
+
+```bash
+# Start a new task
+soda "Implement user authentication with JWT"
+
+# Resume a previous task
+soda --resume
+
+# Clear saved state
+soda --clear
+
+# Custom limits
+soda "Refactor the payment module" --max-iterations 100 --max-time 300
+```
+
+### CLI Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--resume` | Resume previous task from saved state | — |
+| `--clear` | Delete saved state and start fresh | — |
+| `--max-iterations <n>` | Maximum iteration count | 50 |
+| `--max-time <minutes>` | Maximum execution time in minutes | 180 |
+
+## Claude Code Plugin
+
+soda can also run as a Claude Code plugin.
+
+### Install Plugin
+
+```bash
+claude plugin add npm:@tinygem/soda-agent
+```
+
+### Plugin Commands
+
+| Command | Description |
+|---------|-------------|
+| `/soda <task>` | Launch soda to complete a task autonomously |
+| `/soda-status` | Check current progress (phase, iteration, status) |
+| `/soda-cancel` | Gracefully stop the running agent |
+
+## How It Works
+
+```
+┌─────────┐     ┌───────────┐     ┌────────┐     ┌──────┐
+│ CLARIFY │ ──→ │ IMPLEMENT │ ──→ │ VERIFY │ ──→ │ DONE │
+└─────────┘     └───────────┘     └────────┘     └──────┘
+     ↑                ↑               │
+     │                └───── FAIL ─────┘
+     │                      (retry)
+     └── needs clarification
+```
+
+1. **CLARIFY** — Analyzes the request, asks questions if needed, confirms the goal
+2. **IMPLEMENT** — Generates code using a fresh Claude session with full context
+3. **VERIFY** — Independent verification against completion criteria
+4. **DONE** — Task complete after consecutive verification passes
+
+## License
+
+This software is proprietary. A valid invite code is required to use it.
+See [LICENSE](./LICENSE) for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinygem/soda-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "자율 개발 에이전트 - Claude Code 기반으로 태스크를 끝까지 완수한다",
   "bin": {
     "soda-agent": "dist/cli.js",
@@ -24,7 +24,7 @@
     "node": ">=18"
   },
   "type": "module",
-  "license": "UNLICENSED",
+  "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public"
   }