# Codex 本地 CCRA 规划落地摘要

Date: 2026-06-19

## 1. 当前阶段

项目仍处于 `model_library_mvp`。

本次工作已从项目侧结构规划推进到历史试运行验证。

Local CCRA v0.1.1 已通过 Round 04 `pilot-02` 的两回合历史试运行，可作为本项目正式本地初审使用，但不替代 Owner / Web CCRA。

本次仍不新增 selector、模型、RAG、前端、后端或完整 Round 级自动化平台。

## 2. 本轮目标

把已确认的 Local CCRA 规划转成当前仓库内可执行的文件规则：

- 第一版只服务 `the-mindscape-of-bro-tsong`。
- Local CCRA 是正式本地初审，但不替代 Owner / Web CCRA 关键节点判断。
- 本地评审必须通过真实 CCPE Agent Runtime 子会话，不做主会话模拟。
- 本地评审按公共 round 版本加内部 pass 编号归档。
- skills / companion automation 需求先交给 CCPE 分类，再决定是否转给 `skills-vault`。
- 正式 Web CCRA 包默认不包含 Local CCRA review report。

## 3. 已完成内容

1. 新增 `local_ccra_reviews/` 运行区说明。
2. 新增 CCPE 需求单，请求 `ccra-local-reviewer` Agent Spec、Runtime invocation protocol、session continuation contract 和 companion capability classification。
3. 更新项目边界、工作流、数据契约、文件身份、决策日志、项目简报和 handoff 模板。
4. 新增长期知识资产，说明项目侧 Local CCRA 机制。
5. 运行索引与验证命令。
6. 完成 `pilot-01` 与 Web baseline 的对比，识别 Patch 1 需求。
7. CCPE 完成 Patch 1 后，完成 `pilot-02` 两回合试运行。
8. 完成 Web baseline / pilot-01 / pilot-02 三方对比。
9. 新增 Patch 2 非阻塞硬化需求单。
10. 更新本地机制知识资产到 v0.2。

## 4. 关键文件路径

- `local_ccra_reviews/README.md`
- `requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime.md`
- `requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch1.md`
- `requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch2.md`
- `knowledge_assets/10_本地CCRA评审机制说明.md`
- `local_ccra_reviews/round-04/pilot-01/04_LOCAL_CCRA_REVIEW_REPORT.md`
- `local_ccra_reviews/round-04/pilot-01/05_WEB_LOCAL_CCRA_COMPARISON.md`
- `local_ccra_reviews/round-04/pilot-02/04_LOCAL_CCRA_REVIEW_REPORT.md`
- `local_ccra_reviews/round-04/pilot-02/next-review-requirements.md`
- `local_ccra_reviews/round-04/pilot-02/05_WEB_LOCAL_CCRA_COMPARISON.md`
- `docs/WORKFLOW.md`
- `docs/DECISIONS.md`
- `docs/DATA_CONTRACT.md`
- `docs/FILE_TAXONOMY.md`
- `docs/HANDOFF_TEMPLATE.md`
- `PROJECTS.md`
- `README.md`
- `AGENTS.md`

## 5. 关键规则

Local CCRA run path:

```text
local_ccra_reviews/<public-round>/<local-pass>/
```

Example:

```text
local_ccra_reviews/round-05_selector-calibration-policy/01/
local_ccra_reviews/round-05_selector-calibration-policy/02/
```

Run directory contract:

```text
run-notes.md
review-metadata.json
gate-manifest.yaml
lifecycle-guard-config.yaml
agent-invocation-packet.md
prompt-to-send.md
turn-prompts/
review-context.md
review-file-manifest.json
helper-outputs/
04_LOCAL_CCRA_REVIEW_REPORT.md
next-review-requirements.md
returned-output.md
owner-decision.md
```

Formal Web CCRA bundle path remains:

```text
ccra_review_bundle/round-NN_YYYY-MM-DD_topic/
```

Default Web CCRA upload behavior:

```text
Do not include 04_LOCAL_CCRA_REVIEW_REPORT.md unless Owner explicitly asks.
```

## 6. Assumptions Made

- CCPE will later provide the Runtime interface documentation and invocation contract.
- This repository should not define Runtime command details before CCPE supplies them.
- Local CCRA companion tooling should not be sent directly to `skills-vault` until CCPE or Owner classifies the capability as reusable deterministic automation.
- The new knowledge asset documents project-side workflow only, not the canonical Agent definition.

## 7. Current Local CCRA Runtime Status

- CCPE has supplied Patch 1-level `ccra-local-reviewer` / `ccra-local-review` behavior.
- `pilot-02` verified real child-session invocation and same-child `review_turn` + `planning_turn`.
- `pilot-02` child session id: `019edcde-24be-7593-99b2-5cf014467340`.
- `review_turn` duration: 512317 ms.
- `planning_turn` duration: 342925 ms.
- Readiness: `ready_for_formal_local_first_review_with_conditions`.

Remaining hardening needs are captured in:

```text
requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch2.md
```

Patch 2 is non-blocking if Patch 1 behavior remains intact.

## 8. Needs Product / CCPE Judgment

- CCPE should process Patch 2 hardening: bundle audit profile, gate runner execution policy, routing diff requirement, lifecycle scan scope, and short returned summary.
- Owner must decide per round whether Local CCRA review is required.
- Owner must decide whether any Local CCRA report should be included in a Web CCRA upload package.
- Owner / Web CCRA still need to define the next round's work before this project starts that round.
- Full Round-level automation should be discussed separately as workflow/orchestrator design.

## 9. Validation Results

Commands run:

```powershell
python scripts\rebuild_indexes.py --write
python scripts\rebuild_indexes.py --check
python scripts\validate_model_library.py
```

Results:

- `rebuild_indexes.py --write`: PASS; refreshed `models/model_index.json` generated date and `cards/card_index.md` consistency.
- `rebuild_indexes.py --check`: PASS.
- `validate_model_library.py`: PASS.

Note:

The first `--check` run reported drift because `models/model_index.json.last_updated` was still `2026-06-18` while the generator uses the current date. Model entries and counts were not the source of drift. Running `--write` reconciled the generated index.

## 10. Suggested Next Tasks

1. Send `requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch2.md` to `ccpe-system`.
2. Sync `knowledge_assets/10_本地CCRA评审机制说明.md` v0.2 to the Web CCRA / GPT knowledge side.
3. Do not run a third historical pilot unless CCPE changes mechanism diagnosis, patch scope judgment, same-child continuation, mandatory knowledge-base use, or authority boundaries.
4. Discuss full Round-level automation in a new conversation, because it is a workflow/orchestrator topic rather than a Local CCRA reviewer patch.
