@c-d-cc/reap 0.14.0 → 0.15.1

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.
package/README.ja.md CHANGED
@@ -84,8 +84,9 @@ reap init my-project
84
84
  cd my-project
85
85
  reap init
86
86
 
87
- # 2. Claude Codeで1つのGeneration全体を実行
87
+ # 2. Claude Codeでナレッジを同期してからGeneration全体を実行
88
88
  claude
89
+ > /reap.sync
89
90
  > /reap.evolve "ユーザー認証の実装"
90
91
  ```
91
92
 
@@ -95,12 +96,11 @@ claude
95
96
 
96
97
  ```bash
97
98
  > /reap.start # 新しいGenerationを開始
98
- > /reap.objective # 目標 + 仕様を定義
99
- > /reap.next # 次のステージへ前進
100
- > /reap.planning # 実装計画
101
- > /reap.next
99
+ > /reap.objective # 目標 + 仕様を定義(--phase completeで自動遷移)
100
+ > /reap.planning # 実装計画(--phase completeで自動遷移)
102
101
  > /reap.implementation # AI+Human協力でコード実装
103
- > ...
102
+ > /reap.validation # テスト実行、完了条件の確認
103
+ > /reap.completion # レトロスペクティブ + 最終化
104
104
  ```
105
105
 
106
106
  ## ライフサイクル [↗](https://reap.cc/docs/lifecycle)
@@ -152,7 +152,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
152
152
  - `status: pending` — 未処理項目(デフォルト)
153
153
  - `status: consumed` — 現在の世代で処理完了(`consumedBy: gen-XXX-{hash}`必須)
154
154
 
155
- アーカイブ時点(`/reap.next` from Completion)で`consumed`項目はlineageに移動し、`pending`項目は次の世代のbacklogに繰り越されます。
155
+ アーカイブ時点(Completion中)で`consumed`項目はlineageに移動し、`pending`項目は次の世代のbacklogに繰り越されます。
156
156
 
157
157
  **部分完了は正常** — Genome変更に依存するタスクは`[deferred]`とマークし、次の世代に引き継ぎます。
158
158
 
@@ -222,7 +222,9 @@ Machine A:
222
222
  | `reap init <name>` | プロジェクト初期化。`.reap/`構造を作成 |
223
223
  | `reap status` | 現在のGeneration状態を確認 |
224
224
  | `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
225
- | `reap fix` | `.reap/`構造の診断と修復 |
225
+ | `reap fix` | `.reap/`構造の診断と修復(`--check`で読み取り専用モード) |
226
+ | `reap clean` | 対話式オプションでREAPプロジェクトをリセット |
227
+ | `reap destroy` | プロジェクトからすべてのREAPファイルを削除("yes destroy"の入力で確認) |
226
228
  | `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力(バージョン + 最新状況表示) |
227
229
  | `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行(1行`.md`ラッパーが内部的に使用) |
228
230
 
@@ -240,16 +242,17 @@ REAPはスラッシュコマンドとセッションフックを通じてAIエ
240
242
 
241
243
  ### Script Orchestratorアーキテクチャ
242
244
 
243
- v0.11.0より、28個のスラッシュコマンドが**1行`.md`ラッパー + TypeScriptスクリプト**構造に移行しました。各`.md`ファイルは`reap run <cmd>`を呼び出し、TSスクリプト(`src/cli/commands/run/`)がすべての決定論的ロジックを処理して、AIエージェントにstructured JSONで指示します。一貫性とテスト容易性が大幅に向上しました。
245
+ v0.11.0より、31個のスラッシュコマンドが**1行`.md`ラッパー + TypeScriptスクリプト**構造に移行しました。各`.md`ファイルは`reap run <cmd>`を呼び出し、TSスクリプト(`src/cli/commands/run/`)がすべての決定論的ロジックを処理して、AIエージェントにstructured JSONで指示します。一貫性とテスト容易性が大幅に向上しました。
244
246
 
245
247
  ### 署名ベースロック(Signature-Based Locking) [↗](https://reap.cc/docs/advanced)
246
248
 
247
- REAPは暗号学的nonceチェーンを使用してステージの順序を強制します。ステージコマンドが実行されると、スクリプトがワンタイムnonceを生成し、そのハッシュを`current.yml`に保存して、nonceをAIエージェントに返します。`/reap.next`はこのnonceがなければ進行できず、なければ拒否されます。
249
+ REAPは暗号学的nonceチェーンを使用してステージの順序を強制します。`--phase complete`が実行されると、ワンタイムnonceを生成してハッシュを`current.yml`に保存し、自動的に次のステージへ遷移します。次のステージコマンドは進入時にnonceを検証し、有効でなければ拒否されます。
248
250
 
249
251
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
252
+ --phase complete current.yml 次のステージ進入
253
+ ──────────────── ─────────── ────────────────
252
254
  nonce生成 ────────────→ hash(nonce)を保存
255
+ 自動遷移 ─────────────→ ステージ前進
253
256
  AIにnonce返却 ←── AIがnonceを渡す
254
257
  hash(nonce)を検証
255
258
  ✓ ステージ前進
@@ -302,7 +305,7 @@ autoIssueReport: true # デフォルト: true(gh CLIがある場合)
302
305
  | `/reap.implementation` | AI+Human協力でコード実装 |
303
306
  | `/reap.validation` | テスト実行、完了条件の確認 |
304
307
  | `/reap.completion` | レトロスペクティブ + Genome変更反映 + lineage圧縮 |
305
- | `/reap.next` | 次のライフサイクルステージへ前進 |
308
+ | `/reap.next` | 自動遷移の確認(フォールバック) |
306
309
  | `/reap.back` | 前のステージに回帰(micro loop) |
307
310
  | `/reap.abort` | 現在のGenerationを中断(rollback/stash/hold + backlog保存) |
308
311
  | `/reap.status` | 現在のGeneration状態とプロジェクト健全性を表示 |
@@ -313,7 +316,9 @@ autoIssueReport: true # デフォルト: true(gh CLIがある場合)
313
316
  | `/reap.report` | REAPプロジェクトにバグ/フィードバックを報告(プライバシー保護) |
314
317
  | `/reap.help` | 24+トピックのcontextual AIヘルプ |
315
318
  | `/reap.update` | REAPパッケージのアップグレード + コマンド/テンプレート/hook同期 |
319
+ | `/reap.update-genome` | Generationなしで保留中のgenome-change backlogを適用 |
316
320
  | **`/reap.evolve`** | **1つのGeneration全体を最初から最後まで実行(推奨)** |
321
+ | **`/reap.evolve.recovery`** | **失敗/中断したGenerationからの復旧** |
317
322
  | **`/reap.pull <branch>`** | **Fetch + マージGeneration全体を実行(分散版 `/reap.evolve`)** |
318
323
  | **`/reap.merge <branch>`** | **ローカルブランチのマージGeneration全体を実行(fetchなし)** |
319
324
  | `/reap.push` | REAP状態を検証して現在のブランチをpush |
package/README.ko.md CHANGED
@@ -84,8 +84,9 @@ reap init my-project
84
84
  cd my-project
85
85
  reap init
86
86
 
87
- # 2. Claude Code에서 한 Generation 전체 실행
87
+ # 2. Claude Code에서 지식 동기화 후 한 Generation 전체 실행
88
88
  claude
89
+ > /reap.sync
89
90
  > /reap.evolve "사용자 인증 구현"
90
91
  ```
91
92
 
@@ -95,12 +96,11 @@ claude
95
96
 
96
97
  ```bash
97
98
  > /reap.start # 새 Generation 시작
98
- > /reap.objective # 목표 + 명세 정의
99
- > /reap.next # 다음 단계로 전진
100
- > /reap.planning # 구현 계획
101
- > /reap.next
99
+ > /reap.objective # 목표 + 명세 정의 (--phase complete에서 자동 전환)
100
+ > /reap.planning # 구현 계획 (--phase complete에서 자동 전환)
102
101
  > /reap.implementation # AI+Human 협업 코드 구현
103
- > ...
102
+ > /reap.validation # 테스트 실행, 완료 조건 점검
103
+ > /reap.completion # 회고 + 마무리
104
104
  ```
105
105
 
106
106
  ## 생애주기 (Life Cycle)
@@ -152,7 +152,7 @@ Application의 유전 정보 — 아키텍처 원칙, 비즈니스 규칙, 개
152
152
  - `status: pending` — 미처리 항목 (기본값)
153
153
  - `status: consumed` — 현재 세대에서 처리 완료 (`consumedBy: gen-XXX-{hash}` 필수)
154
154
 
155
- 아카이빙 시점(`/reap.next` from Completion)에 `consumed` 항목은 lineage로 이동하고, `pending` 항목은 다음 세대 backlog로 이월됩니다.
155
+ 아카이빙 시점(Completion )에 `consumed` 항목은 lineage로 이동하고, `pending` 항목은 다음 세대 backlog로 이월됩니다.
156
156
 
157
157
  **부분 완료는 정상** — Genome 변경에 의존하는 태스크는 `[deferred]`로 마킹하고 다음 세대로 인계합니다.
158
158
 
@@ -222,7 +222,9 @@ Machine A:
222
222
  | `reap init <name>` | 프로젝트 초기화. `.reap/` 구조 생성 |
223
223
  | `reap status` | 현재 Generation 상태 확인 |
224
224
  | `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
225
- | `reap fix` | `.reap/` 구조 진단 및 복구 |
225
+ | `reap fix` | `.reap/` 구조 진단 및 복구 (`--check`로 읽기 전용 모드) |
226
+ | `reap clean` | 대화형 옵션으로 REAP 프로젝트 초기화 |
227
+ | `reap destroy` | 프로젝트에서 모든 REAP 파일 제거 ("yes destroy" 입력으로 확인) |
226
228
  | `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
227
229
  | `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
228
230
 
@@ -240,16 +242,17 @@ REAP은 슬래시 커맨드와 세션 훅을 통해 AI 에이전트와 통합됩
240
242
 
241
243
  ### Script Orchestrator 아키텍처
242
244
 
243
- v0.11.0부터 28개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스크립트** 구조로 전환되었습니다. 각 `.md` 파일은 `reap run <cmd>`를 호출하고, TS 스크립트(`src/cli/commands/run/`)가 모든 결정적 로직을 처리하여 AI에게 structured JSON으로 지시합니다. 일관성과 테스트 용이성이 크게 향상되었습니다.
245
+ v0.11.0부터 31개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스크립트** 구조로 전환되었습니다. 각 `.md` 파일은 `reap run <cmd>`를 호출하고, TS 스크립트(`src/cli/commands/run/`)가 모든 결정적 로직을 처리하여 AI에게 structured JSON으로 지시합니다. 일관성과 테스트 용이성이 크게 향상되었습니다.
244
246
 
245
247
  ### 서명 기반 잠금 (Signature-Based Locking) [↗](https://reap.cc/docs/advanced)
246
248
 
247
- REAP은 암호학적 nonce 체인을 사용하여 stage 순서를 강제합니다. stage 커맨드가 실행되면 스크립트가 일회용 nonce를 생성하여 해시를 `current.yml`에 저장하고, nonce를 AI 에이전트에게 반환합니다. `/reap.next`는 nonce가 있어야 다음 단계로 진행할 있으며, 없으면 진행이 거부됩니다.
249
+ REAP은 암호학적 nonce 체인을 사용하여 stage 순서를 강제합니다. `--phase complete`가 실행되면 일회용 nonce를 생성하여 해시를 `current.yml`에 저장하고, 자동으로 다음 stage로 전환합니다. 다음 stage 커맨드는 진입 nonce를 검증하며, 유효하지 않으면 진입이 거부됩니다.
248
250
 
249
251
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
252
+ --phase complete current.yml 다음 Stage 진입
253
+ ──────────────── ─────────── ────────────────
252
254
  nonce 생성 ──────────→ hash(nonce) 저장
255
+ 자동 전환 ───────────→ stage 전진
253
256
  AI에게 nonce 반환 ←── AI가 nonce 전달
254
257
  hash(nonce) 검증
255
258
  ✓ stage 전진
@@ -302,7 +305,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
302
305
  | `/reap.implementation` | AI+Human 협업 코드 구현 |
303
306
  | `/reap.validation` | 테스트 실행, 완료 조건 점검 |
304
307
  | `/reap.completion` | 회고 + Genome 변경 반영 + lineage 압축 |
305
- | `/reap.next` | 다음 Life Cycle stage로 전진 |
308
+ | `/reap.next` | 자동 전환 확인 (폴백) |
306
309
  | `/reap.back` | 이전 stage로 복귀 (micro loop) |
307
310
  | `/reap.abort` | 현재 Generation 중단 (rollback/stash/hold + backlog 저장) |
308
311
  | `/reap.status` | 현재 Generation 상태 및 프로젝트 건강 상태 표시 |
@@ -313,7 +316,9 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
313
316
  | `/reap.report` | REAP 프로젝트에 버그/피드백 보고 (개인정보 보호) |
314
317
  | `/reap.help` | 24+ 주제의 contextual AI 도움말 |
315
318
  | `/reap.update` | REAP 패키지 업그레이드 + 커맨드/템플릿/훅 동기화 |
319
+ | `/reap.update-genome` | Generation 없이 대기 중인 genome-change backlog 적용 |
316
320
  | **`/reap.evolve`** | **한 Generation 전체를 처음부터 끝까지 실행 (권장)** |
321
+ | **`/reap.evolve.recovery`** | **실패/중단된 Generation에서 복구** |
317
322
  | **`/reap.pull <branch>`** | **Fetch + 전체 머지 Generation 실행 (분산 `/reap.evolve`)** |
318
323
  | **`/reap.merge <branch>`** | **로컬 브랜치 전체 머지 Generation 실행 (fetch 없음)** |
319
324
  | `/reap.push` | REAP 상태 검증 후 현재 브랜치 push |
package/README.md CHANGED
@@ -84,8 +84,9 @@ reap init my-project
84
84
  cd my-project
85
85
  reap init
86
86
 
87
- # 2. Open Claude Code and run a full generation
87
+ # 2. Open Claude Code, sync knowledge, then run a full generation
88
88
  claude
89
+ > /reap.sync
89
90
  > /reap.evolve "Implement user authentication"
90
91
  ```
91
92
 
@@ -95,12 +96,11 @@ You can also drive each stage manually if you need finer control:
95
96
 
96
97
  ```bash
97
98
  > /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
99
+ > /reap.objective # Define objective + spec (--phase complete auto-advances)
100
+ > /reap.planning # Create implementation plan (--phase complete auto-advances)
102
101
  > /reap.implementation # Build with AI + human collaboration
103
- > ...
102
+ > /reap.validation # Run tests, verify completion criteria
103
+ > /reap.completion # Retrospective + finalize
104
104
  ```
105
105
 
106
106
  ## Life Cycle [↗](https://reap.cc/docs/lifecycle)
@@ -151,7 +151,7 @@ Each item also carries a `status` field:
151
151
  - `status: pending` — Not yet processed (default)
152
152
  - `status: consumed` — Processed in the current generation (requires `consumedBy: gen-XXX-{hash}`)
153
153
 
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.
154
+ At archiving time (during Completion), `consumed` items move to lineage while `pending` items are carried forward to the next generation's backlog.
155
155
 
156
156
  **Partial completion is normal** — Tasks that depend on Genome changes are marked `[deferred]` and handed off to the next generation.
157
157
 
@@ -221,7 +221,9 @@ All distributed operations run through your AI agent:
221
221
  | `reap init <name>` | Initialize project. Creates the `.reap/` structure |
222
222
  | `reap status` | Check the current generation's status |
223
223
  | `reap update` | Sync commands/templates/hooks to the latest version |
224
- | `reap fix` | Diagnose and repair the `.reap/` structure |
224
+ | `reap fix` | Diagnose and repair the `.reap/` structure (`--check` for read-only mode) |
225
+ | `reap clean` | Reset REAP project with interactive options |
226
+ | `reap destroy` | Remove all REAP files from project (requires typing "yes destroy" to confirm) |
225
227
  | `reap help` | Print CLI commands, slash commands, and workflow summary |
226
228
  | `reap run <cmd>` | Execute a slash command's script directly (used internally by 1-line `.md` wrappers) |
227
229
 
@@ -239,17 +241,18 @@ REAP integrates with AI agents through slash commands and session hooks. Current
239
241
 
240
242
  ### Script Orchestrator Architecture
241
243
 
242
- Since v0.11.0, all 28 slash commands follow a **1-line `.md` wrapper + TypeScript script** pattern. Each `.md` file simply calls `reap run <cmd>`, and the TS script (`src/cli/commands/run/`) handles all deterministic logic — returning structured JSON instructions for the AI agent. This ensures consistency and testability.
244
+ Since v0.11.0, all 31 slash commands follow a **1-line `.md` wrapper + TypeScript script** pattern. Each `.md` file simply calls `reap run <cmd>`, and the TS script (`src/cli/commands/run/`) handles all deterministic logic — returning structured JSON instructions for the AI agent. This ensures consistency and testability.
243
245
 
244
246
  ### Signature-Based Locking [↗](https://reap.cc/docs/advanced)
245
247
 
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.
248
+ 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
249
 
248
250
  ```
249
- Stage Command current.yml /reap.next
250
- ───────────── ─────────── ──────────
251
+ --phase complete current.yml Next Stage Entry
252
+ ──────────────── ─────────── ────────────────
251
253
  generate nonce ──────→ store hash(nonce)
252
- return nonce to AI ←── AI passes nonce
254
+ auto-transition ─────→ advance stage
255
+ ←── verify nonce at entry
253
256
  verify hash(nonce)
254
257
  ✓ advance stage
255
258
  ```
@@ -301,7 +304,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
301
304
  | `/reap.implementation` | Code implementation with AI + human |
302
305
  | `/reap.validation` | Run tests, verify completion criteria |
303
306
  | `/reap.completion` | Retrospective + apply Genome changes + lineage compression |
304
- | `/reap.next` | Advance to the next life cycle stage |
307
+ | `/reap.next` | Confirm auto-transition (fallback) |
305
308
  | `/reap.back` | Return to a previous stage (micro loop) |
306
309
  | `/reap.abort` | Abort current generation (rollback/stash/hold + backlog save) |
307
310
  | `/reap.status` | Show current generation state and project health |
@@ -312,7 +315,9 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
312
315
  | `/reap.report` | Report a bug or feedback to the REAP project (privacy-safe) |
313
316
  | `/reap.help` | Contextual AI help with 24+ topics |
314
317
  | `/reap.update` | Upgrade REAP package + sync commands/templates/hooks |
318
+ | `/reap.update-genome` | Apply pending genome-change backlog without a generation |
315
319
  | **`/reap.evolve`** | **Run an entire generation from start to finish (recommended)** |
320
+ | **`/reap.evolve.recovery`** | **Recover from a failed/interrupted generation** |
316
321
  | **`/reap.pull <branch>`** | **Fetch + run full merge generation (distributed `/reap.evolve`)** |
317
322
  | **`/reap.merge <branch>`** | **Run full merge generation for a local branch (no fetch)** |
318
323
  | `/reap.push` | Validate REAP state and push current branch |
package/README.zh-CN.md CHANGED
@@ -84,8 +84,9 @@ reap init my-project
84
84
  cd my-project
85
85
  reap init
86
86
 
87
- # 2. 在Claude Code中运行一个完整的Generation
87
+ # 2. 在Claude Code中同步知识后运行一个完整的Generation
88
88
  claude
89
+ > /reap.sync
89
90
  > /reap.evolve "实现用户认证"
90
91
  ```
91
92
 
@@ -95,12 +96,11 @@ claude
95
96
 
96
97
  ```bash
97
98
  > /reap.start # 开始新的Generation
98
- > /reap.objective # 定义目标 + 规格
99
- > /reap.next # 前进到下一阶段
100
- > /reap.planning # 实施计划
101
- > /reap.next
99
+ > /reap.objective # 定义目标 + 规格(--phase complete自动转换)
100
+ > /reap.planning # 实施计划(--phase complete自动转换)
102
101
  > /reap.implementation # AI+人类协作编写代码
103
- > ...
102
+ > /reap.validation # 执行测试、检查完成条件
103
+ > /reap.completion # 回顾 + 最终化
104
104
  ```
105
105
 
106
106
  ## 生命周期 [↗](https://reap.cc/docs/lifecycle)
@@ -152,7 +152,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
152
152
  - `status: pending` — 未处理项目(默认)
153
153
  - `status: consumed` — 在当前世代中已处理(需要`consumedBy: gen-XXX-{hash}`)
154
154
 
155
- 归档时(`/reap.next` from Completion),`consumed`项目移至lineage,`pending`项目结转到下一个世代的backlog。
155
+ 归档时(Completion期间),`consumed`项目移至lineage,`pending`项目结转到下一个世代的backlog。
156
156
 
157
157
  **部分完成是正常的** — 依赖Genome变更的任务标记为`[deferred]`并交接到下一个世代。
158
158
 
@@ -222,7 +222,9 @@ Machine A:
222
222
  | `reap init <name>` | 初始化项目。创建`.reap/`结构 |
223
223
  | `reap status` | 查看当前Generation状态 |
224
224
  | `reap update` | 将命令/模板/hook同步到最新版本 |
225
- | `reap fix` | 诊断和修复`.reap/`结构 |
225
+ | `reap fix` | 诊断和修复`.reap/`结构(`--check`为只读模式) |
226
+ | `reap clean` | 通过交互式选项重置REAP项目 |
227
+ | `reap destroy` | 从项目中删除所有REAP文件(需输入"yes destroy"确认) |
226
228
  | `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要(显示版本 + 最新状态) |
227
229
  | `reap run <cmd>` | 直接执行斜杠命令的脚本(由1行`.md` wrapper内部调用) |
228
230
 
@@ -240,16 +242,17 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
240
242
 
241
243
  ### Script Orchestrator架构
242
244
 
243
- 从v0.11.0开始,28个斜杠命令全部采用**1行`.md` wrapper + TypeScript脚本**模式。每个`.md`文件仅调用`reap run <cmd>`,TS脚本(`src/cli/commands/run/`)处理所有确定性逻辑,以structured JSON形式指示AI代理。大幅提升了一致性和可测试性。
245
+ 从v0.11.0开始,31个斜杠命令全部采用**1行`.md` wrapper + TypeScript脚本**模式。每个`.md`文件仅调用`reap run <cmd>`,TS脚本(`src/cli/commands/run/`)处理所有确定性逻辑,以structured JSON形式指示AI代理。大幅提升了一致性和可测试性。
244
246
 
245
247
  ### 签名锁定(Signature-Based Locking) [↗](https://reap.cc/docs/advanced)
246
248
 
247
- REAP使用加密nonce链来强制执行阶段顺序。当阶段命令运行时,脚本生成一次性nonce,将其哈希存储在`current.yml`中,并将nonce返回给AI代理。`/reap.next`需要此nonce才能推进没有它,推进将被拒绝。
249
+ REAP使用加密nonce链来强制执行阶段顺序。当`--phase complete`运行时,生成一次性nonce并将其哈希存储在`current.yml`中,然后自动转换到下一个阶段。下一个阶段命令在进入时验证nonce — 如果无效则被拒绝。
248
250
 
249
251
  ```
250
- Stage Command current.yml /reap.next
251
- ───────────── ─────────── ──────────
252
+ --phase complete current.yml 下一阶段进入
253
+ ──────────────── ─────────── ────────────────
252
254
  生成nonce ────────────→ 存储hash(nonce)
255
+ 自动转换 ─────────────→ 阶段前进
253
256
  将nonce返回给AI ←── AI传递nonce
254
257
  验证hash(nonce)
255
258
  ✓ 阶段推进
@@ -302,7 +305,7 @@ autoIssueReport: true # 默认值: true(检测到gh CLI时)
302
305
  | `/reap.implementation` | AI+人类协作编写代码 |
303
306
  | `/reap.validation` | 执行测试、检查完成条件 |
304
307
  | `/reap.completion` | 回顾 + 应用Genome变更 + lineage压缩 |
305
- | `/reap.next` | 前进到下一个生命周期阶段 |
308
+ | `/reap.next` | 确认自动转换(后备) |
306
309
  | `/reap.back` | 回到前一个阶段(micro loop) |
307
310
  | `/reap.abort` | 中止当前Generation(rollback/stash/hold + backlog保存) |
308
311
  | `/reap.status` | 显示当前Generation状态和项目健康度 |
@@ -313,7 +316,9 @@ autoIssueReport: true # 默认值: true(检测到gh CLI时)
313
316
  | `/reap.report` | 向REAP项目报告bug/反馈(隐私保护) |
314
317
  | `/reap.help` | 24+主题的上下文AI帮助 |
315
318
  | `/reap.update` | 升级REAP包 + 同步命令/模板/hook |
319
+ | `/reap.update-genome` | 无需Generation即可应用待处理的genome-change backlog |
316
320
  | **`/reap.evolve`** | **从头到尾运行一个完整的Generation(推荐)** |
321
+ | **`/reap.evolve.recovery`** | **从失败/中断的Generation中恢复** |
317
322
  | **`/reap.pull <branch>`** | **Fetch + 运行完整合并Generation(分布式 `/reap.evolve`)** |
318
323
  | **`/reap.merge <branch>`** | **本地分支完整合并Generation(无需fetch)** |
319
324
  | `/reap.push` | 验证REAP状态并push当前分支 |