@c-d-cc/reap 0.14.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.ja.md +12 -10
  2. package/README.ko.md +12 -10
  3. package/README.md +13 -11
  4. package/README.zh-CN.md +12 -10
  5. package/dist/cli.js +845 -264
  6. package/dist/templates/help/en.txt +2 -0
  7. package/dist/templates/help/ko.txt +2 -0
  8. package/dist/templates/hooks/reap-guide.md +8 -6
  9. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -95,12 +95,11 @@ claude
95
95
 
96
96
  ```bash
97
97
  > /reap.start # 新しいGenerationを開始
98
- > /reap.objective # 目標 + 仕様を定義
99
- > /reap.next # 次のステージへ前進
100
- > /reap.planning # 実装計画
101
- > /reap.next
98
+ > /reap.objective # 目標 + 仕様を定義（--phase completeで自動遷移）
99
+ > /reap.planning # 実装計画（--phase completeで自動遷移）
102
100
  > /reap.implementation # AI+Human協力でコード実装
103
- > ...
101
+ > /reap.validation # テスト実行、完了条件の確認
102
+ > /reap.completion # レトロスペクティブ + 最終化
104
103
  ```
105
104
 
106
105
  ## ライフサイクル [↗](https://reap.cc/docs/lifecycle)
@@ -152,7 +151,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
152
151
  - `status: pending` — 未処理項目（デフォルト）
153
152
  - `status: consumed` — 現在の世代で処理完了（`consumedBy: gen-XXX-{hash}`必須）
154
153
 
155
- アーカイブ時点（`/reap.next` from Completion）で`consumed`項目はlineageに移動し、`pending`項目は次の世代のbacklogに繰り越されます。
154
+ アーカイブ時点（Completion中）で`consumed`項目はlineageに移動し、`pending`項目は次の世代のbacklogに繰り越されます。
156
155
 
157
156
  **部分完了は正常** — Genome変更に依存するタスクは`[deferred]`とマークし、次の世代に引き継ぎます。
158
157
 
@@ -223,6 +222,8 @@ Machine A:
223
222
  | `reap status` | 現在のGeneration状態を確認 |
224
223
  | `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
225
224
  | `reap fix` | `.reap/`構造の診断と修復 |
225
+ | `reap clean` | 対話式オプションでREAPプロジェクトをリセット |
226
+ | `reap destroy` | プロジェクトからすべてのREAPファイルを削除（確認が必要） |
226
227
  | `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力（バージョン + 最新状況表示） |
227
228
  | `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行（1行`.md`ラッパーが内部的に使用） |
228
229
 
@@ -244,12 +245,13 @@ v0.11.0より、28個のスラッシュコマンドが**1行`.md`ラッパー +
244
245
 
245
246
  ### 署名ベースロック（Signature-Based Locking） [↗](https://reap.cc/docs/advanced)
246
247
 
247
- REAPは暗号学的nonceチェーンを使用してステージの順序を強制します。ステージコマンドが実行されると、スクリプトがワンタイムnonceを生成し、そのハッシュを`current.yml`に保存して、nonceをAIエージェントに返します。`/reap.next`はこのnonceがなければ進行できず、なければ拒否されます。
248
+ REAPは暗号学的nonceチェーンを使用してステージの順序を強制します。`--phase complete`が実行されると、ワンタイムnonceを生成してハッシュを`current.yml`に保存し、自動的に次のステージへ遷移します。次のステージコマンドは進入時にnonceを検証し、有効でなければ拒否されます。
248
249
 
249
250
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
251
+ --phase complete current.yml 次のステージ進入
252
+ ──────────────── ─────────── ────────────────
252
253
  nonce生成 ────────────→ hash(nonce)を保存
254
+ 自動遷移 ─────────────→ ステージ前進
253
255
  AIにnonce返却 ←── AIがnonceを渡す
254
256
  hash(nonce)を検証
255
257
  ✓ ステージ前進
@@ -302,7 +304,7 @@ autoIssueReport: true # デフォルト: true（gh CLIがある場合）
302
304
  | `/reap.implementation` | AI+Human協力でコード実装 |
303
305
  | `/reap.validation` | テスト実行、完了条件の確認 |
304
306
  | `/reap.completion` | レトロスペクティブ + Genome変更反映 + lineage圧縮 |
305
- | `/reap.next` | 次のライフサイクルステージへ前進 |
307
+ | `/reap.next` | 自動遷移の確認（フォールバック） |
306
308
  | `/reap.back` | 前のステージに回帰（micro loop） |
307
309
  | `/reap.abort` | 現在のGenerationを中断（rollback/stash/hold + backlog保存） |
308
310
  | `/reap.status` | 現在のGeneration状態とプロジェクト健全性を表示 |
package/README.ko.md CHANGED
@@ -95,12 +95,11 @@ claude
95
95
 
96
96
  ```bash
97
97
  > /reap.start # 새 Generation 시작
98
- > /reap.objective # 목표 + 명세 정의
99
- > /reap.next # 다음 단계로 전진
100
- > /reap.planning # 구현 계획
101
- > /reap.next
98
+ > /reap.objective # 목표 + 명세 정의 (--phase complete에서 자동 전환)
99
+ > /reap.planning # 구현 계획 (--phase complete에서 자동 전환)
102
100
  > /reap.implementation # AI+Human 협업 코드 구현
103
- > ...
101
+ > /reap.validation # 테스트 실행, 완료 조건 점검
102
+ > /reap.completion # 회고 + 마무리
104
103
  ```
105
104
 
106
105
  ## 생애주기 (Life Cycle)
@@ -152,7 +151,7 @@ Application의 유전 정보 — 아키텍처 원칙, 비즈니스 규칙, 개
152
151
  - `status: pending` — 미처리 항목 (기본값)
153
152
  - `status: consumed` — 현재 세대에서 처리 완료 (`consumedBy: gen-XXX-{hash}` 필수)
154
153
 
155
- 아카이빙 시점(`/reap.next` from Completion)에 `consumed` 항목은 lineage로 이동하고, `pending` 항목은 다음 세대 backlog로 이월됩니다.
154
+ 아카이빙 시점(Completion 중)에 `consumed` 항목은 lineage로 이동하고, `pending` 항목은 다음 세대 backlog로 이월됩니다.
156
155
 
157
156
  **부분 완료는 정상** — Genome 변경에 의존하는 태스크는 `[deferred]`로 마킹하고 다음 세대로 인계합니다.
158
157
 
@@ -223,6 +222,8 @@ Machine A:
223
222
  | `reap status` | 현재 Generation 상태 확인 |
224
223
  | `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
225
224
  | `reap fix` | `.reap/` 구조 진단 및 복구 |
225
+ | `reap clean` | 대화형 옵션으로 REAP 프로젝트 초기화 |
226
+ | `reap destroy` | 프로젝트에서 모든 REAP 파일 제거 (확인 필요) |
226
227
  | `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
227
228
  | `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
228
229
 
@@ -244,12 +245,13 @@ v0.11.0부터 28개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스
244
245
 
245
246
  ### 서명 기반 잠금 (Signature-Based Locking) [↗](https://reap.cc/docs/advanced)
246
247
 
247
- REAP은 암호학적 nonce 체인을 사용하여 stage 순서를 강제합니다. stage 커맨드가 실행되면 스크립트가 일회용 nonce를 생성하여 해시를 `current.yml`에 저장하고, nonce를 AI 에이전트에게 반환합니다. `/reap.next`는 이 nonce가 있어야 다음 단계로 진행할 수 있으며, 없으면 진행이 거부됩니다.
248
+ REAP은 암호학적 nonce 체인을 사용하여 stage 순서를 강제합니다. `--phase complete`가 실행되면 일회용 nonce를 생성하여 해시를 `current.yml`에 저장하고, 자동으로 다음 stage로 전환합니다. 다음 stage 커맨드는 진입 시 nonce를 검증하며, 유효하지 않으면 진입이 거부됩니다.
248
249
 
249
250
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
251
+ --phase complete current.yml 다음 Stage 진입
252
+ ──────────────── ─────────── ────────────────
252
253
  nonce 생성 ──────────→ hash(nonce) 저장
254
+ 자동 전환 ───────────→ stage 전진
253
255
  AI에게 nonce 반환 ←── AI가 nonce 전달
254
256
  hash(nonce) 검증
255
257
  ✓ stage 전진
@@ -302,7 +304,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
302
304
  | `/reap.implementation` | AI+Human 협업 코드 구현 |
303
305
  | `/reap.validation` | 테스트 실행, 완료 조건 점검 |
304
306
  | `/reap.completion` | 회고 + Genome 변경 반영 + lineage 압축 |
305
- | `/reap.next` | 다음 Life Cycle stage로 전진 |
307
+ | `/reap.next` | 자동 전환 확인 (폴백) |
306
308
  | `/reap.back` | 이전 stage로 복귀 (micro loop) |
307
309
  | `/reap.abort` | 현재 Generation 중단 (rollback/stash/hold + backlog 저장) |
308
310
  | `/reap.status` | 현재 Generation 상태 및 프로젝트 건강 상태 표시 |
package/README.md CHANGED
@@ -95,12 +95,11 @@ You can also drive each stage manually if you need finer control:
95
95
 
96
96
  ```bash
97
97
  > /reap.start # Start a new generation
98
- > /reap.objective # Define objective + spec
99
- > /reap.next # Advance to the next stage
100
- > /reap.planning # Create implementation plan
101
- > /reap.next
98
+ > /reap.objective # Define objective + spec (--phase complete auto-advances)
99
+ > /reap.planning # Create implementation plan (--phase complete auto-advances)
102
100
  > /reap.implementation # Build with AI + human collaboration
103
- > ...
101
+ > /reap.validation # Run tests, verify completion criteria
102
+ > /reap.completion # Retrospective + finalize
104
103
  ```
105
104
 
106
105
  ## Life Cycle [↗](https://reap.cc/docs/lifecycle)
@@ -151,7 +150,7 @@ Each item also carries a `status` field:
151
150
  - `status: pending` — Not yet processed (default)
152
151
  - `status: consumed` — Processed in the current generation (requires `consumedBy: gen-XXX-{hash}`)
153
152
 
154
- At archiving time (`/reap.next` from Completion), `consumed` items move to lineage while `pending` items are carried forward to the next generation's backlog.
153
+ At archiving time (during Completion), `consumed` items move to lineage while `pending` items are carried forward to the next generation's backlog.
155
154
 
156
155
  **Partial completion is normal** — Tasks that depend on Genome changes are marked `[deferred]` and handed off to the next generation.
157
156
 
@@ -222,6 +221,8 @@ All distributed operations run through your AI agent:
222
221
  | `reap status` | Check the current generation's status |
223
222
  | `reap update` | Sync commands/templates/hooks to the latest version |
224
223
  | `reap fix` | Diagnose and repair the `.reap/` structure |
224
+ | `reap clean` | Reset REAP project with interactive options |
225
+ | `reap destroy` | Remove all REAP files from project (requires confirmation) |
225
226
  | `reap help` | Print CLI commands, slash commands, and workflow summary |
226
227
  | `reap run <cmd>` | Execute a slash command's script directly (used internally by 1-line `.md` wrappers) |
227
228
 
@@ -243,13 +244,14 @@ Since v0.11.0, all 28 slash commands follow a **1-line `.md` wrapper + TypeScrip
243
244
 
244
245
  ### Signature-Based Locking [↗](https://reap.cc/docs/advanced)
245
246
 
246
- REAP uses a cryptographic nonce chain to enforce stage ordering. When a stage command runs, the script generates a one-time nonce, stores its hash in `current.yml`, and returns the nonce to the AI agent. `/reap.next` requires this nonce to advance — without it, progression is rejected.
247
+ REAP uses a cryptographic nonce chain to enforce stage ordering. When `--phase complete` runs, it generates a one-time nonce, stores its hash in `current.yml`, and auto-transitions to the next stage. The next stage command verifies the nonce at entry — without it, the stage is rejected.
247
248
 
248
249
  ```
249
- Stage Command current.yml /reap.next
250
- ───────────── ─────────── ──────────
250
+ --phase complete current.yml Next Stage Entry
251
+ ──────────────── ─────────── ────────────────
251
252
  generate nonce ──────→ store hash(nonce)
252
- return nonce to AI ←── AI passes nonce
253
+ auto-transition ─────→ advance stage
254
+ ←── verify nonce at entry
253
255
  verify hash(nonce)
254
256
  ✓ advance stage
255
257
  ```
@@ -301,7 +303,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
301
303
  | `/reap.implementation` | Code implementation with AI + human |
302
304
  | `/reap.validation` | Run tests, verify completion criteria |
303
305
  | `/reap.completion` | Retrospective + apply Genome changes + lineage compression |
304
- | `/reap.next` | Advance to the next life cycle stage |
306
+ | `/reap.next` | Confirm auto-transition (fallback) |
305
307
  | `/reap.back` | Return to a previous stage (micro loop) |
306
308
  | `/reap.abort` | Abort current generation (rollback/stash/hold + backlog save) |
307
309
  | `/reap.status` | Show current generation state and project health |
package/README.zh-CN.md CHANGED
@@ -95,12 +95,11 @@ claude
95
95
 
96
96
  ```bash
97
97
  > /reap.start # 开始新的Generation
98
- > /reap.objective # 定义目标 + 规格
99
- > /reap.next # 前进到下一阶段
100
- > /reap.planning # 实施计划
101
- > /reap.next
98
+ > /reap.objective # 定义目标 + 规格（--phase complete自动转换）
99
+ > /reap.planning # 实施计划（--phase complete自动转换）
102
100
  > /reap.implementation # AI+人类协作编写代码
103
- > ...
101
+ > /reap.validation # 执行测试、检查完成条件
102
+ > /reap.completion # 回顾 + 最终化
104
103
  ```
105
104
 
106
105
  ## 生命周期 [↗](https://reap.cc/docs/lifecycle)
@@ -152,7 +151,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
152
151
  - `status: pending` — 未处理项目（默认）
153
152
  - `status: consumed` — 在当前世代中已处理（需要`consumedBy: gen-XXX-{hash}`）
154
153
 
155
- 归档时（`/reap.next` from Completion），`consumed`项目移至lineage，`pending`项目结转到下一个世代的backlog。
154
+ 归档时（Completion期间），`consumed`项目移至lineage，`pending`项目结转到下一个世代的backlog。
156
155
 
157
156
  **部分完成是正常的** — 依赖Genome变更的任务标记为`[deferred]`并交接到下一个世代。
158
157
 
@@ -223,6 +222,8 @@ Machine A:
223
222
  | `reap status` | 查看当前Generation状态 |
224
223
  | `reap update` | 将命令/模板/hook同步到最新版本 |
225
224
  | `reap fix` | 诊断和修复`.reap/`结构 |
225
+ | `reap clean` | 通过交互式选项重置REAP项目 |
226
+ | `reap destroy` | 从项目中删除所有REAP文件（需要确认） |
226
227
  | `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要（显示版本 + 最新状态） |
227
228
  | `reap run <cmd>` | 直接执行斜杠命令的脚本（由1行`.md` wrapper内部调用） |
228
229
 
@@ -244,12 +245,13 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
244
245
 
245
246
  ### 签名锁定（Signature-Based Locking） [↗](https://reap.cc/docs/advanced)
246
247
 
247
- REAP使用加密nonce链来强制执行阶段顺序。当阶段命令运行时，脚本生成一次性nonce，将其哈希存储在`current.yml`中，并将nonce返回给AI代理。`/reap.next`需要此nonce才能推进 — 没有它，推进将被拒绝。
248
+ REAP使用加密nonce链来强制执行阶段顺序。当`--phase complete`运行时，生成一次性nonce并将其哈希存储在`current.yml`中，然后自动转换到下一个阶段。下一个阶段命令在进入时验证nonce — 如果无效则被拒绝。
248
249
 
249
250
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
251
+ --phase complete current.yml 下一阶段进入
252
+ ──────────────── ─────────── ────────────────
252
253
  生成nonce ────────────→ 存储hash(nonce)
254
+ 自动转换 ─────────────→ 阶段前进
253
255
  将nonce返回给AI ←── AI传递nonce
254
256
  验证hash(nonce)
255
257
  ✓ 阶段推进
@@ -302,7 +304,7 @@ autoIssueReport: true # 默认值: true（检测到gh CLI时）
302
304
  | `/reap.implementation` | AI+人类协作编写代码 |
303
305
  | `/reap.validation` | 执行测试、检查完成条件 |
304
306
  | `/reap.completion` | 回顾 + 应用Genome变更 + lineage压缩 |
305
- | `/reap.next` | 前进到下一个生命周期阶段 |
307
+ | `/reap.next` | 确认自动转换（后备） |
306
308
  | `/reap.back` | 回到前一个阶段（micro loop） |
307
309
  | `/reap.abort` | 中止当前Generation（rollback/stash/hold + backlog保存） |
308
310
  | `/reap.status` | 显示当前Generation状态和项目健康度 |