@c-d-cc/reap 0.16.6 → 0.17.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.
- package/README.de.md +48 -0
- package/README.ja.md +48 -0
- package/README.ko.md +50 -0
- package/README.md +28 -0
- package/README.zh-CN.md +50 -0
- package/RELEASE_NOTICE.md +6 -0
- package/dist/cli/index.js +518 -444
- package/dist/templates/agents/reap-evaluate.md +21 -0
- package/dist/templates/agents/reap-evolve.md +49 -0
- package/dist/templates/reap-guide.md +78 -0
- package/package.json +1 -1
package/README.de.md
CHANGED
|
@@ -246,6 +246,50 @@ Wechseln Sie Clients, indem Sie `.reap/config.yml` bearbeiten, dann `reap instal
|
|
|
246
246
|
|
|
247
247
|
`/reap.evolve` kann die gesamte Generation an einen Subagenten delegieren, der autonom alle Phasen durchläuft und sich nur meldet, wenn er tatsächlich blockiert ist.
|
|
248
248
|
|
|
249
|
+
### Evaluator Agent (opt-in)
|
|
250
|
+
|
|
251
|
+
REAP liefert eine zweite Subagenten-Definition, `reap-evaluate`, die als **unabhängiger Reviewer** der Builder-Arbeit fungiert. Nur lesend (Read/Glob/Grep/Bash), qualitative Bewertungen (keine Scores), **Advisor**-Rolle — Bedenken werden dem Benutzer angezeigt, aber der Builder trifft das finale Lifecycle-Urteil.
|
|
252
|
+
|
|
253
|
+
Aktivierung durch eine Zeile in `.reap/config.yml`:
|
|
254
|
+
|
|
255
|
+
```yaml
|
|
256
|
+
evaluator: true # Standard: false
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
Wenn aktiviert, startet der Builder `reap-evaluate` als Subagent, bevor er pass/partial/fail erklärt. Der Evaluator:
|
|
260
|
+
- führt typecheck, Build und die vollständige Test-Suite unabhängig aus,
|
|
261
|
+
- gleicht die Fertigstellungskriterien aus `02-planning.md` mit der Implementierung ab,
|
|
262
|
+
- zeigt Bedenken zu Genome-Konventions-Abweichungen, Sycophancy-Warnsignalen und Regressionsrisiken,
|
|
263
|
+
- eskaliert gemäß einer Konfidenz × Einfluss-Matrix.
|
|
264
|
+
|
|
265
|
+
Wenn der Subagenten-Aufruf fehlschlägt, setzt der Builder die normale Validierung fort — der Evaluator ist optionale Beratung, kein Gate.
|
|
266
|
+
|
|
267
|
+
**Fitness-Phase + Cruise-Modus**: Der Evaluator läuft auch in der Fitness-Phase. High-severity-Befunde aus der Validierung **stoppen Cruise-Modus automatisch** beim nächsten Fitness-Phase-Lauf — `cruiseCount` wird aus `config.yml` gelöscht, der Cruise-Prompt durch einen supervised Fallback ersetzt, sodass der Benutzer den Befund prüfen kann.
|
|
268
|
+
|
|
269
|
+
### Code Intelligence Daemon (opt-in)
|
|
270
|
+
|
|
271
|
+
REAP enthält einen lokalen Code-Intelligence-Daemon (`localhost:17224`), der generationsübergreifend einen Tree-sitter-Symbolgraph pflegt. Er parst 15+ Sprachen, speichert den Graph in SQLite und stellt eine HTTP-API für Symbolsuche, Caller/Callee-Analyse, Blast-Radius-Impact, Community-Erkennung und Prozessfluss-Tracing bereit.
|
|
272
|
+
|
|
273
|
+
Aktivierung durch eine Zeile in `.reap/config.yml`:
|
|
274
|
+
|
|
275
|
+
```yaml
|
|
276
|
+
daemon: true # Standard: false
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
Wenn aktiviert, führt REAP automatisch:
|
|
280
|
+
- Projektregistrierung beim Daemon bei Generation-Start,
|
|
281
|
+
- Re-Indexierung an wichtigen Lifecycle-Momenten (learning, implementation complete, completion commit),
|
|
282
|
+
- fügt einen "Code Intelligence"-Abschnitt mit Query-Beispielen und Staleness-Prüfprotokoll in Builder/Evaluator-Prompts ein.
|
|
283
|
+
|
|
284
|
+
Der Daemon startet automatisch beim ersten Gebrauch und fährt nach 30 Minuten Inaktivität herunter:
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
reap daemon status # Status prüfen
|
|
288
|
+
reap daemon stop # Daemon stoppen
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
Der Daemon ist ein Read-only-Beschleuniger — er modifiziert niemals Ihren Code. Bei Nichtverfügbarkeit fallen Agenten auf Standard-Read/Grep/Glob-Tools zurück, ohne den Lifecycle zu unterbrechen.
|
|
292
|
+
|
|
249
293
|
## Projektstruktur
|
|
250
294
|
|
|
251
295
|
```
|
|
@@ -286,6 +330,8 @@ strictEdit: false # Code-Änderungen auf REAP-Lebenszyklus beschr
|
|
|
286
330
|
strictMerge: false # Direktes git pull/push/merge einschränken
|
|
287
331
|
agentClient: claude-code # KI-Agenten-Client
|
|
288
332
|
# cruiseCount: 1/5 # Vorhanden = Cruise-Modus (aktuell/gesamt)
|
|
333
|
+
# evaluator: true # Opt-in: reap-evaluate in Validierung/Fitness starten
|
|
334
|
+
# daemon: true # Opt-in: Lokaler Code-Intelligence-Daemon
|
|
289
335
|
```
|
|
290
336
|
|
|
291
337
|
Wichtige Einstellungen:
|
|
@@ -293,6 +339,8 @@ Wichtige Einstellungen:
|
|
|
293
339
|
- **`strictEdit`**: Beschränkt Code-Änderungen auf die Implementierungsphase innerhalb des geplanten Umfangs.
|
|
294
340
|
- **`strictMerge`**: Beschränkt direktes git pull/push/merge — verwenden Sie stattdessen `/reap.pull`, `/reap.push`, `/reap.merge`.
|
|
295
341
|
- **`agentClient`**: Bestimmt, welcher Adapter für die Skill-Bereitstellung verwendet wird.
|
|
342
|
+
- **`evaluator`**: Opt-in unabhängiger Reviewer. Startet bei `true` den `reap-evaluate` Subagenten als Advisor. Standard `false`. Siehe [Evaluator Agent](#evaluator-agent-opt-in) oben.
|
|
343
|
+
- **`daemon`**: Opt-in lokaler Code-Intelligence-Daemon. Bei `true` indexiert REAP an Lifecycle-Checkpoints automatisch und fügt Daemon-Query-Anweisungen in Agent-Prompts ein. Standard `false`. Siehe [Code Intelligence Daemon](#code-intelligence-daemon-opt-in) oben.
|
|
296
344
|
|
|
297
345
|
## Upgrade von v0.15 [↗](https://reap.cc/docs/migration-guide)
|
|
298
346
|
|
package/README.ja.md
CHANGED
|
@@ -246,6 +246,50 @@ REAPは`agentClient` configフィールドをキーとするアダプタレイ
|
|
|
246
246
|
|
|
247
247
|
`/reap.evolve` はジェネレーション全体を subagent に委任でき、subagent は本当にブロックされた場合のみ介入を求めながら、全ステージを自律的に実行します。
|
|
248
248
|
|
|
249
|
+
### Evaluator Agent(オプトイン)
|
|
250
|
+
|
|
251
|
+
REAP は2つ目のサブエージェント定義 `reap-evaluate` を提供します。ビルダーの作業を独立してレビューする**独立レビュアー**として機能します。読み取り専用(Read/Glob/Grep/Bashのみ)、定性的評価(スコアなし)、**アドバイザー**として動作 — 懸念事項をユーザーに表面化しますが、ビルダーが最終的なライフサイクル判断を下します。
|
|
252
|
+
|
|
253
|
+
`.reap/config.yml` に1行追加して有効化:
|
|
254
|
+
|
|
255
|
+
```yaml
|
|
256
|
+
evaluator: true # デフォルト: false
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
有効化すると、validationステージでビルダーがpass/partial/failを宣言する前に `reap-evaluate` をサブエージェントとして起動します。Evaluatorは:
|
|
260
|
+
- typecheck、ビルド、完全なテストスイートを独立して実行し、
|
|
261
|
+
- `02-planning.md`の完了基準と実装をクロスチェックし、
|
|
262
|
+
- genomコンベンション逸脱、sycophancyの危険信号、リグレッションリスクへの懸念を表面化し、
|
|
263
|
+
- 信頼度 × 影響度マトリクスに従ってエスカレーションします。
|
|
264
|
+
|
|
265
|
+
サブエージェントの呼び出しが失敗しても、ビルダーは通常のvalidationを続行します — evaluatorはオプトインのアドバイスであり、ゲートではありません。
|
|
266
|
+
|
|
267
|
+
**Fitness phase + cruise mode**: evaluatorはfitnessフェーズでも実行されます。validationで記録されたhigh-severity concernは次のfitnessフェーズ実行時に**cruise modeを自動停止**します — `cruiseCount`が `config.yml` から削除され、cruiseプロンプトがsupervised fallbackに置き換えられ、ユーザーが懸念事項を確認した後にfeedbackを作成できます。
|
|
268
|
+
|
|
269
|
+
### Code Intelligence Daemon(オプトイン)
|
|
270
|
+
|
|
271
|
+
REAPはローカルコードインテリジェンスデーモン(`localhost:17224`)を提供します。世代をまたいでTree-sitterシンボルグラフを維持し、15以上の言語を解析し、グラフをSQLiteに保存し、シンボル検索、caller/callee分析、blast-radius影響、コミュニティ検出、プロセスフロートレースのHTTP APIを公開します。
|
|
272
|
+
|
|
273
|
+
`.reap/config.yml` に1行追加して有効化:
|
|
274
|
+
|
|
275
|
+
```yaml
|
|
276
|
+
daemon: true # デフォルト: false
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
有効化すると、REAPが自動的に:
|
|
280
|
+
- generation開始時にデーモンにプロジェクトを登録し、
|
|
281
|
+
- 主要なライフサイクル時点(learning、implementation完了、completion commit)で再インデックスし、
|
|
282
|
+
- ビルダー/evaluatorプロンプトにクエリ例とstaleness確認プロトコルを含む「Code Intelligence」セクションを追加します。
|
|
283
|
+
|
|
284
|
+
デーモンは最初の使用時に自動起動し、30分のアイドル後に自動シャットダウンします:
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
reap daemon status # 実行状況を確認
|
|
288
|
+
reap daemon stop # デーモンを停止
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
デーモンは読み取り専用アクセラレーター — コードを決して変更しません。何らかの理由で利用できない場合、エージェントは標準のRead/Grep/Globツールにフォールバックし、ライフサイクルは中断されません。
|
|
292
|
+
|
|
249
293
|
## プロジェクト構造
|
|
250
294
|
|
|
251
295
|
```
|
|
@@ -286,6 +330,8 @@ strictEdit: false # コード変更をREAPライフサイクルに
|
|
|
286
330
|
strictMerge: false # 直接の git pull/push/merge を制限
|
|
287
331
|
agentClient: claude-code # AIエージェントクライアント
|
|
288
332
|
# cruiseCount: 1/5 # 存在する場合 = cruise mode(現在/合計)
|
|
333
|
+
# evaluator: true # オプトイン: validation/fitnessで reap-evaluate を起動
|
|
334
|
+
# daemon: true # オプトイン: ローカルコードインテリジェンスデーモン
|
|
289
335
|
```
|
|
290
336
|
|
|
291
337
|
主要な設定項目:
|
|
@@ -293,6 +339,8 @@ agentClient: claude-code # AIエージェントクライアント
|
|
|
293
339
|
- **`strictEdit`**: コード変更を、計画されたスコープ内の implementation ステージに制限します。
|
|
294
340
|
- **`strictMerge`**: 直接の git pull/push/merge を制限します — 代わりに `/reap.pull`、`/reap.push`、`/reap.merge` を使用してください。
|
|
295
341
|
- **`agentClient`**: スキルのデプロイに使用するアダプターを決定します。
|
|
342
|
+
- **`evaluator`**: オプトインの独立レビュアー。`true`のとき、validationステージで `reap-evaluate` サブエージェントをアドバイザーとして起動します。デフォルト `false`。上記の [Evaluator Agent](#evaluator-agentオプトイン) を参照。
|
|
343
|
+
- **`daemon`**: オプトインのローカルコードインテリジェンスデーモン。`true`のとき、REAPがライフサイクルチェックポイントで自動インデックスし、エージェントプロンプトにデーモンクエリ指示を含めます。デフォルト `false`。上記の [Code Intelligence Daemon](#code-intelligence-daemonオプトイン) を参照。
|
|
296
344
|
|
|
297
345
|
## v0.15からのアップグレード [↗](https://reap.cc/docs/migration-guide)
|
|
298
346
|
|
package/README.ko.md
CHANGED
|
@@ -246,6 +246,52 @@ REAP는 `agentClient` config 필드를 기준으로 adapter layer를 통해 AI
|
|
|
246
246
|
|
|
247
247
|
`/reap.evolve`는 전체 세대를 서브에이전트에 위임하여 모든 단계를 자율적으로 수행하게 할 수 있으며, 진정으로 막혔을 때만 사용자에게 알립니다.
|
|
248
248
|
|
|
249
|
+
### Evaluator Agent (opt-in)
|
|
250
|
+
|
|
251
|
+
REAP는 두 번째 서브에이전트 정의인 `reap-evaluate`를 제공합니다. 빌더의 작업을 독립적으로 검토하는 **독립 검토자**로 동작합니다. 읽기 전용(Read/Glob/Grep/Bash만 사용), 정성적 평가(점수 없음), **어드바이저** 역할 — 우려 사항을 사용자에게 전달하지만 빌더가 최종 lifecycle 판정을 내립니다.
|
|
252
|
+
|
|
253
|
+
`.reap/config.yml`에 한 줄을 추가하여 활성화합니다:
|
|
254
|
+
|
|
255
|
+
```yaml
|
|
256
|
+
evaluator: true # 기본값: false
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
활성화 시, validation 단계에서 빌더가 pass/partial/fail을 선언하기 전에 `reap-evaluate`를 서브에이전트로 실행합니다. Evaluator는:
|
|
260
|
+
- typecheck, 빌드, 전체 테스트 스위트를 독립적으로 실행하고,
|
|
261
|
+
- `02-planning.md`의 완료 기준과 구현을 교차 검증하며,
|
|
262
|
+
- genome 컨벤션 이탈, sycophancy 위험 신호, 회귀 위험에 대한 우려를 표면화하고,
|
|
263
|
+
- 신뢰도 × 영향도 매트릭스에 따라 에스컬레이션합니다.
|
|
264
|
+
|
|
265
|
+
서브에이전트 호출이 어떤 이유로 실패해도 빌더는 정상 validation을 계속합니다 — evaluator는 opt-in 조언이지 게이트가 아닙니다.
|
|
266
|
+
|
|
267
|
+
**Fitness phase + cruise mode**: evaluator는 fitness 단계에서도 실행됩니다. validation 중 기록된 high-severity concern은 다음 fitness phase 실행 시 **cruise mode를 자동 중단**합니다 — `cruiseCount`가 `config.yml`에서 삭제되고, cruise 프롬프트가 supervised fallback으로 교체되어 사용자가 우려 사항을 검토한 후 fitness 피드백을 작성할 수 있습니다. 우려가 해소되면 `reap cruise <N>`으로 cruise를 재개할 수 있습니다.
|
|
268
|
+
|
|
269
|
+
### Code Intelligence Daemon (opt-in)
|
|
270
|
+
|
|
271
|
+
REAP는 로컬 코드 인텔리전스 데몬(`localhost:17224`)을 제공합니다. 세대에 걸쳐 Tree-sitter 심볼 그래프를 유지하며, 15개 이상의 언어를 파싱하고, 그래프를 SQLite에 저장하고, 심볼 검색, caller/callee 분석, blast-radius 영향, 커뮤니티 감지, 프로세스 흐름 추적을 위한 HTTP API를 제공합니다.
|
|
272
|
+
|
|
273
|
+
`.reap/config.yml`에 한 줄을 추가하여 활성화합니다:
|
|
274
|
+
|
|
275
|
+
```yaml
|
|
276
|
+
daemon: true # 기본값: false
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
활성화 시 REAP가 자동으로:
|
|
280
|
+
- generation 시작 시 데몬에 프로젝트를 등록하고,
|
|
281
|
+
- 주요 lifecycle 시점(learning, implementation 완료, completion commit)에 재인덱싱하며,
|
|
282
|
+
- 빌더/evaluator 프롬프트에 쿼리 예시와 staleness 확인 프로토콜을 포함한 "Code Intelligence" 섹션을 추가합니다.
|
|
283
|
+
|
|
284
|
+
데몬은 첫 사용 시 자동으로 시작되고 30분 유휴 후 자동 종료됩니다. 명시적으로 관리할 수도 있습니다:
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
reap daemon status # 실행 여부 확인
|
|
288
|
+
reap daemon stop # 데몬 종료
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
데몬은 읽기 전용 가속기입니다 — 코드를 절대 수정하지 않습니다. 어떤 이유로 사용 불가 시 에이전트는 표준 Read/Grep/Glob 도구로 폴백하며 lifecycle이 중단되지 않습니다.
|
|
292
|
+
|
|
293
|
+
**Staleness 확인**: 각 인덱싱 실행 시 `lastIndexedCommit`(인덱싱 시점의 `HEAD` 해시)을 기록합니다. 에이전트는 `GET /projects/:id/status`로 현재 `HEAD`와 비교하여 쿼리 전에 재인덱싱이 필요한지 판단할 수 있습니다.
|
|
294
|
+
|
|
249
295
|
## 프로젝트 구조
|
|
250
296
|
|
|
251
297
|
```
|
|
@@ -286,6 +332,8 @@ strictEdit: false # 코드 변경을 REAP 생명 주기로 제한
|
|
|
286
332
|
strictMerge: false # 직접 git pull/push/merge 제한
|
|
287
333
|
agentClient: claude-code # AI 에이전트 클라이언트
|
|
288
334
|
# cruiseCount: 1/5 # 존재 시 = cruise 모드 (현재/전체)
|
|
335
|
+
# evaluator: true # Opt-in: validation/fitness에서 reap-evaluate 실행
|
|
336
|
+
# daemon: true # Opt-in: 로컬 코드 인텔리전스 데몬
|
|
289
337
|
```
|
|
290
338
|
|
|
291
339
|
주요 설정:
|
|
@@ -293,6 +341,8 @@ agentClient: claude-code # AI 에이전트 클라이언트
|
|
|
293
341
|
- **`strictEdit`**: 코드 변경을 계획된 범위 내 구현 단계로 제한합니다.
|
|
294
342
|
- **`strictMerge`**: 직접 git pull/push/merge를 제한합니다 — 대신 `/reap.pull`, `/reap.push`, `/reap.merge`를 사용하세요.
|
|
295
343
|
- **`agentClient`**: 스킬 배포에 사용할 어댑터를 결정합니다.
|
|
344
|
+
- **`evaluator`**: Opt-in 독립 검토자. `true`일 때 validation 단계에서 `reap-evaluate` 서브에이전트를 어드바이저로 실행합니다. 기본값 `false`. 위의 [Evaluator Agent](#evaluator-agent-opt-in) 참조.
|
|
345
|
+
- **`daemon`**: Opt-in 로컬 코드 인텔리전스 데몬. `true`일 때 REAP가 lifecycle 체크포인트에서 자동 인덱싱하고 에이전트 프롬프트에 데몬 쿼리 지시를 포함합니다. 기본값 `false`. 위의 [Code Intelligence Daemon](#code-intelligence-daemon-opt-in) 참조.
|
|
296
346
|
|
|
297
347
|
## v0.15에서 업그레이드 [↗](https://reap.cc/docs/migration-guide)
|
|
298
348
|
|
package/README.md
CHANGED
|
@@ -276,6 +276,32 @@ Agent definitions are installed automatically by `reap install-skills` **and** `
|
|
|
276
276
|
|
|
277
277
|
**Fitness phase + cruise mode** (gen-067): the evaluator also runs during the fitness phase. After receiving its reply, the builder persists the verdict on the generation state via `reap run validation --phase report-evaluator --severity <high|low|none> --summary "..."`. High-severity concerns recorded during validation **automatically abort cruise mode** when the next fitness phase runs — `cruiseCount` is cleared from `config.yml`, the cruise prompt is replaced with a supervised fallback, and the human reviews the concern before composing fitness feedback. Cruise can be resumed manually with `reap cruise <N>` once the concern is resolved. Low-severity concerns surface in the prompt's "Prior Evaluator Concerns" section without aborting cruise.
|
|
278
278
|
|
|
279
|
+
### Code Intelligence Daemon (opt-in)
|
|
280
|
+
|
|
281
|
+
REAP ships a local code-intelligence daemon (`localhost:17224`) that maintains a Tree-sitter symbol graph across generations. It parses 15+ languages, stores the graph in SQLite, and exposes an HTTP API for symbol search, caller/callee analysis, blast-radius impact, community detection, and process flow tracing.
|
|
282
|
+
|
|
283
|
+
Enable it by adding one line to `.reap/config.yml`:
|
|
284
|
+
|
|
285
|
+
```yaml
|
|
286
|
+
daemon: true # default: false
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
When enabled, REAP automatically:
|
|
290
|
+
- registers the project with the daemon on generation start,
|
|
291
|
+
- re-indexes at key lifecycle moments (learning, implementation complete, completion commit),
|
|
292
|
+
- includes a "Code Intelligence" section in the builder/evaluator prompt with query examples and a staleness check protocol.
|
|
293
|
+
|
|
294
|
+
The daemon starts automatically on first use and shuts itself down after 30 minutes of idle time. It can also be managed explicitly:
|
|
295
|
+
|
|
296
|
+
```bash
|
|
297
|
+
reap daemon status # Check if running
|
|
298
|
+
reap daemon stop # Stop the daemon
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
The daemon is a read-only accelerator — it never modifies your code. If it is unreachable for any reason, agents fall back to standard Read/Grep/Glob tools without interrupting the lifecycle.
|
|
302
|
+
|
|
303
|
+
**Staleness check**: each indexing run records `lastIndexedCommit` (the `HEAD` hash at the time of indexing). Agents can compare this against the current `HEAD` via `GET /projects/:id/status` to decide whether to trigger a re-index before querying.
|
|
304
|
+
|
|
279
305
|
## Project Structure
|
|
280
306
|
|
|
281
307
|
```
|
|
@@ -317,6 +343,7 @@ strictMerge: false # Restrict direct git pull/push/merge
|
|
|
317
343
|
agentClient: claude-code # AI agent client
|
|
318
344
|
# cruiseCount: 1/5 # Present = cruise mode (current/total)
|
|
319
345
|
# evaluator: true # Opt-in: launch reap-evaluate during validation
|
|
346
|
+
# daemon: true # Opt-in: local code-intelligence daemon
|
|
320
347
|
```
|
|
321
348
|
|
|
322
349
|
Key settings:
|
|
@@ -326,6 +353,7 @@ Key settings:
|
|
|
326
353
|
- **`strictMerge`**: Restricts direct git pull/push/merge — use `/reap.pull`, `/reap.push`, `/reap.merge` instead.
|
|
327
354
|
- **`agentClient`**: Determines which adapter is used for skill deployment.
|
|
328
355
|
- **`evaluator`**: Opt-in independent reviewer. When `true`, the validation stage launches the `reap-evaluate` subagent as an advisor (read-only, qualitative-only). Default `false` keeps validation byte-identical to pre-gen-066 behaviour. See [Evaluator Agent](#evaluator-agent-opt-in) above.
|
|
356
|
+
- **`daemon`**: Opt-in local code-intelligence daemon. When `true`, REAP auto-indexes at lifecycle checkpoints and includes daemon query instructions in agent prompts. Default `false`. See [Code Intelligence Daemon](#code-intelligence-daemon-opt-in) above.
|
|
329
357
|
|
|
330
358
|
## Upgrading from v0.15 [↗](https://reap.cc/docs/migration-guide)
|
|
331
359
|
|
package/README.zh-CN.md
CHANGED
|
@@ -246,6 +246,52 @@ REAP 通过基于 `agentClient` 配置字段的适配器层与 AI 智能体集
|
|
|
246
246
|
|
|
247
247
|
`/reap.evolve` 可以将整个代际迭代委托给一个子智能体,该子智能体自主运行所有阶段,仅在真正受阻时才浮出。
|
|
248
248
|
|
|
249
|
+
### Evaluator Agent(可选功能)
|
|
250
|
+
|
|
251
|
+
REAP 提供第二个子智能体定义 `reap-evaluate`,作为构建者工作的**独立审查者**运行。只读(仅 Read/Glob/Grep/Bash),定性评估(无评分),**顾问**角色 — 将关注点呈现给用户,但由构建者做出最终生命周期判决。
|
|
252
|
+
|
|
253
|
+
在 `.reap/config.yml` 中添加一行即可启用:
|
|
254
|
+
|
|
255
|
+
```yaml
|
|
256
|
+
evaluator: true # 默认值: false
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
启用后,validation 阶段将在构建者声明 pass/partial/fail 之前启动 `reap-evaluate` 子智能体。Evaluator 将:
|
|
260
|
+
- 独立运行 typecheck、构建和完整测试套件,
|
|
261
|
+
- 对照 `02-planning.md` 的完成标准交叉验证实现,
|
|
262
|
+
- 发现 genome 约定偏离、讨好信号、回归风险等问题,
|
|
263
|
+
- 根据置信度 × 影响度矩阵进行升级处理。
|
|
264
|
+
|
|
265
|
+
子智能体调用失败时,构建者继续正常 validation — evaluator 是可选建议,而非门控。
|
|
266
|
+
|
|
267
|
+
**Fitness 阶段 + Cruise 模式**: evaluator 也在 fitness 阶段运行。validation 期间记录的 high-severity concern 在下次 fitness 阶段运行时会**自动中止 cruise 模式** — `cruiseCount` 从 `config.yml` 中清除,cruise 提示被替换为 supervised fallback,用户审查问题后再撰写 fitness 反馈。
|
|
268
|
+
|
|
269
|
+
### Code Intelligence Daemon(可选功能)
|
|
270
|
+
|
|
271
|
+
REAP 内置本地代码智能守护进程(`localhost:17224`),跨代际维护 Tree-sitter 符号图。解析 15+ 种语言,将图存储在 SQLite 中,并提供符号搜索、调用关系分析、blast-radius 影响、社区检测和进程流追踪的 HTTP API。
|
|
272
|
+
|
|
273
|
+
在 `.reap/config.yml` 中添加一行即可启用:
|
|
274
|
+
|
|
275
|
+
```yaml
|
|
276
|
+
daemon: true # 默认值: false
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
启用后,REAP 自动:
|
|
280
|
+
- 在 generation 开始时向 daemon 注册项目,
|
|
281
|
+
- 在关键生命周期时刻(learning、implementation 完成、completion commit)重新索引,
|
|
282
|
+
- 在构建者/evaluator 提示中添加包含查询示例和 staleness 检查协议的"Code Intelligence"部分。
|
|
283
|
+
|
|
284
|
+
守护进程首次使用时自动启动,30 分钟空闲后自动关闭:
|
|
285
|
+
|
|
286
|
+
```bash
|
|
287
|
+
reap daemon status # 检查运行状态
|
|
288
|
+
reap daemon stop # 停止守护进程
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
守护进程是只读加速器 — 绝不修改代码。不可用时智能体回退到标准 Read/Grep/Glob 工具,生命周期不会中断。
|
|
292
|
+
|
|
293
|
+
**Staleness 检查**: 每次索引运行记录 `lastIndexedCommit`(索引时的 `HEAD` 哈希)。智能体可通过 `GET /projects/:id/status` 与当前 `HEAD` 比较,决定查询前是否需要重新索引。
|
|
294
|
+
|
|
249
295
|
## 项目结构
|
|
250
296
|
|
|
251
297
|
```
|
|
@@ -286,6 +332,8 @@ strictEdit: false # 将代码变更限制在 REAP 生命周期内
|
|
|
286
332
|
strictMerge: false # 限制直接 git pull/push/merge
|
|
287
333
|
agentClient: claude-code # AI 智能体客户端
|
|
288
334
|
# cruiseCount: 1/5 # 存在时 = cruise 模式(当前/总计)
|
|
335
|
+
# evaluator: true # 可选:在 validation/fitness 中启动 reap-evaluate
|
|
336
|
+
# daemon: true # 可选:本地代码智能守护进程
|
|
289
337
|
```
|
|
290
338
|
|
|
291
339
|
关键设置:
|
|
@@ -293,6 +341,8 @@ agentClient: claude-code # AI 智能体客户端
|
|
|
293
341
|
- **`strictEdit`**:将代码变更限制在计划范围内的 implementation 阶段。
|
|
294
342
|
- **`strictMerge`**:限制直接 git pull/push/merge——请改用 `/reap.pull`、`/reap.push`、`/reap.merge`。
|
|
295
343
|
- **`agentClient`**:决定使用哪个适配器进行技能部署。
|
|
344
|
+
- **`evaluator`**:可选独立审查者。`true` 时在 validation 阶段启动 `reap-evaluate` 子智能体作为顾问。默认 `false`。参见上方 [Evaluator Agent](#evaluator-agent可选功能)。
|
|
345
|
+
- **`daemon`**:可选本地代码智能守护进程。`true` 时 REAP 在生命周期检查点自动索引,并在智能体提示中包含 daemon 查询指示。默认 `false`。参见上方 [Code Intelligence Daemon](#code-intelligence-daemon可选功能)。
|
|
296
346
|
|
|
297
347
|
## 从 v0.15 升级 [↗](https://reap.cc/docs/migration-guide)
|
|
298
348
|
|
package/RELEASE_NOTICE.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Release Notices
|
|
2
2
|
|
|
3
|
+
## v0.17.0
|
|
4
|
+
### en
|
|
5
|
+
Code Intelligence Daemon (opt-in `daemon: true`): local Tree-sitter symbol graph at localhost:17224. Auto-indexes at generation start, implementation complete, and completion commit. Agents receive symbol search / caller-callee / blast-radius guidance in prompts. `lastIndexedCommit` exposed for staleness checks. Evaluator Agent fitness-phase integration complete: high-severity concerns now auto-abort cruise mode.
|
|
6
|
+
### ko
|
|
7
|
+
코드 인텔리전스 데몬 (opt-in `daemon: true`): localhost:17224 로컬 Tree-sitter 심볼 그래프. generation 시작, implementation 완료, completion commit 시 자동 인덱싱. agent 프롬프트에 심볼 검색/caller-callee/blast-radius 안내 포함. staleness 확인을 위한 `lastIndexedCommit` 노출. Evaluator Agent fitness phase 통합 완료: high-severity concern 발생 시 cruise mode 자동 중단.
|
|
8
|
+
|
|
3
9
|
## v0.16.6
|
|
4
10
|
### en
|
|
5
11
|
Evaluator Agent integration (opt-in `evaluator: true`): independent `reap-evaluate` subagent runs during validation and fitness phases as an advisor. High-severity concerns automatically abort cruise mode for human review.
|