Skip to content

About

A multi-agent coding system focused on context intelligence, prompt contracts, and extensible development workflows.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

15,291 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenCode Enhanced

Current release: V0.6.0 — Brand New Day.

Release notes

V0.6.0 introduces the crash-safe Runtime foundation, qualified through real Context, Model, streaming, mutation, validation, and local Git slices. The new Runtime does not yet replace the production Task execution path.

OpenCode Enhanced 是以 OpenCode 现有代码为独立开发基线的 coding Agent 工程化项目。它关注的不是“加入更多 Agent”,而是让执行边界更清楚:简单任务保持轻量,复杂任务保留明确意图,自动化只在现有证据允许时继续。

Why Enhanced?

Coding Agent 不只需要生成修改,还需要决定何时可以直接行动、哪些信息必须保留、验证结果能证明什么,以及证据不足时该把控制权交还给谁。

V0.5 0810 将这些问题收敛为一套执行纪律:

  • 少用不必要的流程和上下文;
  • 将当前指令、约束和澄清结果作为权威任务输入;
  • 只有超过 Context budget 时才压缩,并保护不可丢失的信息;
  • Recovery 有明确上限,不无限重试;
  • 只对确认的新回归自动撤销;
  • 重要区域无法充分判断时,由用户决定继续或撤销;
  • 完成信息描述已有证据,不承诺绝对正确。

V0.5 0810 — Less Is More, Fin.

Simple work stays simple

明确、局部、单一目标的请求可以直接执行,不额外调用模型进行路由,也不进入 Contract、Context compression、Managed validation 或 Task Receipt 流程。带有条件、例外、多目标或不明确范围的请求会保守地进入完整任务流程。

Intent before execution

复杂任务使用 Canonical Contract 保存当前用户指令、约束和已解决的澄清事实。系统最多请求一次关键澄清;如果回答后仍然不明确,会转为只读探索或普通对话,而不是反复询问或猜测性修改。

当前明确指令优先于历史任务解释。只在直接冲突可以确定时 supersede 旧 rejection,历史记录不会成为永久项目真相。

Context only when needed

Context 在进入 Agent 前被区分为受保护内容、可压缩语义内容和引用内容。低于 budget 时不启动 compression;超过边界时才使用现有规则或语义压缩。确定性 integrity check 验证受保护内容和结构锚点没有丢失或降级。

Token 数字如被报告,均为现有估算器结果,不等同于 provider billing。

Recovery has an end

Compression integrity 失败后最多经历两个有界阶段:关闭语义摘要的 relaxed attempt,以及依据当前 Contract 重建 Context。仍无法保留必要信息时返回结构化停止,不进行第三次 Recovery。

Change, check, undo

Managed mutation 在修改前保存 transaction baseline,并比较修改前后的现有 validation evidence。原有错误保持不变时不会触发误回滚;只有稳定、可识别的新 diagnostic 或命令回归会被视为 confirmed regression,并尝试恢复到本次 transaction 前的内容。

Know when not to decide

验证结果不充分时,普通非保护区域保持修改并记录 Trace。若直接或间接影响内置或项目显式保护的区域,系统暂停并提供 Continue / Revert 选择。用户 Continue 不会被记作 checks passed。

A receipt, not a promise

一个 Managed task 在自然完成边界最多产生一份聚合 Task Receipt。它说明发生了多少次修改、哪些检查通过、哪些修改被自动或由用户撤销,以及是否还有一个明确的下一步。Receipt 不声称代码“完全正确”或“完全安全”。

Current architecture

flowchart TD
    R[Request] --> Q{Conservatively bounded?}
    Q -->|Yes| F[Execute lightweight request]
    Q -->|No| C[Canonical Contract]
    C --> X[Selective Context]
    X --> E[Execute]
    E --> V[Compare available validation evidence]
    V -->|Confirmed new regression| B[Rollback transaction]
    V -->|Uncertain protected effect| U[Continue / Revert review]
    V -->|Otherwise| K[Keep change]
    B --> T[Task Receipt]
    U --> T
    K --> T
Loading

/init and Kiko.md

/init
→ deterministic project scan
→ instruction loading
→ Project Contract
→ Kiko.md
→ SQLite persistence

Kiko.md 是 OpenCode Enhanced 的原生项目指令文件。AGENTS.md、Agent.md、CLAUDE.md 和 Claude.md 作为兼容的只读输入;/init 不覆盖或删除这些文件,也不会向它们同步写入内容。手工维护的 Kiko.md 同样受到保护。

V0.5 0810 Mini Benchmark

V0.5 0810 Integrated Mini Benchmark 使用 20 个确定性合成场景检查路由效率、意图保持、Context discipline、bounded Recovery、mutation rollback、protected review 和 Task Receipt。它衡量可观察的 runtime policy,不使用 LLM judge 或主观代码质量评分。

Category Passed Scenarios
Simple Request Efficiency 5 5
Intent Preservation 3 3
Context Discipline 6 6
Mutation Safety & Trust Calibration 6 6
Total 20 20
Measured property Result
Fast selections correctly labeled local/explicit 4 / 4
Fast additional routing LLM calls 0
Fast Context Builder / compression / integrity / recovery calls 0 / 0 / 0 / 0
Below-budget compression calls 0
Recovery maximum attempts observed 2
Confirmed regressions detected / rolled back / false rollbacks 1 / 1 / 0
Task Receipts emitted / duplicated 1 / 0
Additional LLM judge calls / embedding calls 0 / 0

这些结果只适用于仓库内冻结的 synthetic fixtures,不代表对任意真实项目的普遍正确率、安全率或代码质量保证。完整场景、环境、limitations 和复现方法见:

从 packages/opencode 复现:

bun run benchmark:v05-0810
bun test test/benchmark/v0.5-0810.test.ts --timeout 60000

Install and run

需要 Bun 1.3.x。安装依赖并启动开发版本:

bun install
bun run dev

仓库根测试脚本禁止直接运行测试。OpenCode package 的常用验证命令为:

cd packages/opencode
bun typecheck
bun test test/collaboration --timeout 60000
bun test test/tool/edit.test.ts test/tool/write.test.ts test/tool/apply_patch.test.ts --timeout 60000
bun run benchmark:v05-0810

CLI build smoke test 同样从 packages/opencode 执行:

bun run build -- --single --skip-install --skip-embed-web-ui

--skip-embed-web-ui 只用于本地 build smoke test;正式发布产物使用完整生产构建流程。

Read-only collaboration API

现有 /collaboration/* HTTP 查询接口提供 Project/Task Contract、Typed Context、Context Snapshot、collaboration events、/init status 和 runtime capability 的只读视图。接口边界见 Read-only HTTP API documentation。WebSocket、远程控制和移动端接入不属于当前 V0.5 0810 runtime。

Development History

V0.5.2 — Shut Up

集中于 Canonical Contract、用户意图规范化、Typed Context、减少重复 active prompt 内容,以及首个可复现的 Token Less 专项 benchmark。参见 design note、release notes 和 historical benchmark。

V0.5.3 — Less Is More

扩展了 Context ranking、token-budget semantics、C/C++ build-context ingestion、model profile routing 和无可观察副作用前的 bounded fallback。参见 V0.5.3 release notes。

V0.5 0810 — Less Is More, Fin.

将 V0.5 统一为一套完整执行纪律:保守路由、Contract preservation、按需 Context compression、确定性 integrity check、bounded recovery、baseline-aware mutation validation、rollback、uncertainty review 和 Task Receipt。

Roadmap

下一代为 V0.6 — Brand New Day。未实现的 V0.6 设计不会作为当前 V0.5 0810 能力展示。

Upstream and license

OpenCode Enhanced 以 anomalyco/opencode 的现有代码为独立开发基线,不再持续同步 OpenCode 的后续更新。项目继续保留并遵守上游 MIT License、版权与来源说明;OpenCode Enhanced 的路线与发布由本项目独立维护。

About

A multi-agent coding system focused on context intelligence, prompt contracts, and extensible development workflows.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages