任务：Evolution Kernel MVP

[Protocol-zero-0]

任务：Evolution Kernel MVP

一句话目标

把 evolution-kernel 做成一个最小可运行的“代码进化内核”：能在受限 sandbox 中尝试一次代码修改，独立评估，接受或回滚，并留下可审计记录。

背景

主项目是 https://github.com/Protocol-zero-0/evolution-kernel 。

可参考 WFHTask/evolution-engine#3 ，但不要另起炉灶。这个 PR 只作为 MVP 设计参考，最终主干应收敛到 https://github.com/Protocol-zero-0/evolution-kernel 。

必须实现

1. 支持一次完整闭环：

config -> observe -> plan/execute -> evaluate -> accept/reject -> ledger

2. 保留 evolution-kernel 的核心机制：

• Git worktree sandbox
• evolution/accepted
• accept 推进 accepted
• reject 不推进 accepted
• ledger 可复盘

3. 增加最小 Observer：

• 支持读取本地文件
• 支持执行 shell command
• 输出 observation.json

4. 增加 mutation scope：

• 只能修改配置中声明的 allowed_paths
• 修改范围外文件必须 reject

5. 增加最小 hard stops：

• max_iterations
• max_consecutive_failures

不要做

• 不做 agent swarm
• 不做 dashboard
• 不做 GitHub PR router
• 不做自动 merge
• 不做长期调度
• 不做并行进化分支
• 不做 URL / DB observer
• 不做复杂 token / 美元预算估算

新增核心运行时代码建议控制在 1000 行以内。超出必须解释。

建议配置形状

mission: "Improve the target project under strict reproducibility constraints."

evidence_sources:
 - type: file
 path: "./metrics.json"
 - type: shell
 command: "bash ./scripts/status.sh"

mutation_scope:
 allowed_paths:
 - "src/"
 - "tests/"

hard_stops:
 max_iterations: 3
 max_consecutive_failures: 2

建议 CLI

python3 -m evolution_kernel.cli \
 --config examples/evolution.yml \
 --repo /path/to/target-repo \
 --ledger /tmp/evolution-ledger

验收标准

必须用测试或 demo 证明以下场景：

1. accept 能推进
   evaluator 返回 accept 后，evolution/accepted 指向 candidate commit。

2. reject 不推进
   evaluator 返回 reject 后，evolution/accepted 保持原 commit。

3. 越界修改会 reject
   如果只允许改 src/，但 patch 修改 README.md，必须 reject，并记录 scope_violation。

4. Observer 可用
   能读取文件和 shell 输出，生成 observation.json。

5. hard stop 可用
   连续失败达到上限后，下一次 run 被阻止；reset 后可继续。

6. ledger 可复盘
   每次 run 至少留下：

config/goal
observation.json
plan.json
patch.diff
candidate_commit.txt
evaluation.json
decision.json
reflection.json

交付物

• 一个 PR 到 evolution-kernel
• 一个最小 demo target
• examples/evolution.yml
• 测试或 demo 命令
• README 更新

PR 描述必须写清：

• 实现了什么
• 没有实现什么
• 如何验收
• 当前限制
• Future Work

成功定义

不是做一个看起来很大的框架，而是做出一个能稳定完成一次“受限代码进化”的小内核。

[Protocol-zero-0]

✅ 阶段 0 验收完成，关闭

本 issue 定义的所有验收标准均已在 PR #2（hitome0123）中实现并通过测试：

验收项	状态
Accept 推进 evolution/accepted	✅
Reject 不推进	✅
Mutation scope 强制执行 + 违规日志	✅
Observer 写入 observation.json（file + shell）	✅
Hard stops halt + reset 恢复	✅
Ledger 包含所有必要 artifact	✅

后续路线图见置顶 Issue #5，当前主线为阶段 2（PR #5）。