Skip to content

v0.2.0-alpha.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@wudy29 wudy29 released this 05 Aug 02:55
· 72 commits to main since this release
v0.2.0-alpha.2
4ffa975

Engineering Bridge v0.2.0-alpha.2

中文说明

这是 Engineering Bridge 的一个 alpha 预发布版本。

本版本在保留“只读优先”设计的基础上，加入了受控写入流程，让用户可以先查看 Codex 生成的修改方案和完整补丁，再通过明确的 APPLY 确认执行修改。

Engineering Bridge 用于连接支持 MCP 的聊天客户端与本地 Codex CLI。用户可以直接在聊天窗口中发出任务，由 Bridge 将任务交给本地 Codex 执行，而不必再手工往返搬运提示词、进度和结果。

本版本主要更新

  • 新增受控补丁流程：

    • 由 Codex 生成修改 proposal；
    • 用户可以先审阅完整 diff；
    • 只有在明确执行 APPLY 后才会真正修改文件；
    • 如果 Git HEAD 已发生变化，旧 proposal 会被拒绝，避免补丁应用到错误基线。

  • 保留原有只读任务流程。

  • 为全部 5 个 MCP 工具补充了准确的工具说明。

  • 修复 macOS 下 /tmp 与 /private/tmp 实际指向同一路径时，workspace 校验失败的问题。

  • 重写中英文 README，使首次访问者可以更容易理解：

    • Bridge 解决什么问题；
    • 聊天客户端、Bridge、Codex CLI 与 MCP/STDIO 各自负责什么；
    • 如何完成第一次只读体验；
    • 如何完成完整的受控写入流程；
    • 当前兼容条件与使用限制。

  • 更新架构、安全说明和威胁模型文档。

  • 新增 MCP 工具参考和版本说明。

验证结果

本版本已通过：

  • TypeScript 类型检查；
  • 正式构建；
  • 31 项自动化测试；
  • npm package dry-run；
  • STDIO MCP 初始化；
  • 5 个 MCP 工具及其 description 的实际发现；
  • macOS /tmp workspace 的真实 proposal 验证；
  • 真实 Codex 只读任务；
  • 真实 Codex proposal 与明确 APPLY 的完整闭环。

真实写入验收确认：

  • 用户批准前，目标文件没有发生变化；
  • APPLY 后只修改了预期的一行内容；
  • 没有自动执行 git stage；
  • 没有自动创建 commit；
  • 没有自动 push。

当前限制

这仍然是 alpha 预发布版本。

目前尚未提供：

  • npm registry 发布；
  • 任务、proposal 和日志的持久化；
  • executor cancellation；
  • 产品级任务 timeout；
  • 调用方身份认证；
  • 普通只读任务的操作系统级读取隔离；
  • 自动 commit 或自动 push。

使用本项目需要：

  • 支持 MCP/STDIO 的客户端；
  • 本地可用的 Codex CLI 环境；
  • 预先登记允许访问的 workspace。

安装与使用

当前版本通过 GitHub 源码仓库发布，尚未发布到 npm registry。

安装、workspace 登记、MCP 配置、首次只读任务和受控写入示例，请查看：

  • README.zh-CN.md：中文说明
  • README.md：English documentation

English

This is an alpha prerelease of Engineering Bridge.

This release adds a controlled-write workflow while preserving the project's read-only-first design. Users can review a Codex-generated proposal and its complete patch before explicitly confirming the change with APPLY.

Engineering Bridge connects an MCP-capable chat client to a local Codex CLI executor. It allows users to submit tasks from a chat interface without manually relaying prompts, progress updates, and results between tools.

Highlights

  • Added a controlled patch workflow:

    • Codex generates a proposed change;
    • users can review the complete diff;
    • files are modified only after an explicit APPLY confirmation;
    • stale proposals are rejected when the Git base HEAD has changed.

  • Preserved the existing read-only task workflow.

  • Added accurate descriptions for all five MCP tools.

  • Fixed macOS workspace validation when /tmp and /private/tmp resolve to the same canonical path.

  • Reworked the English and Chinese READMEs to explain:

    • what problem the Bridge solves;
    • the roles of the chat client, Bridge, Codex CLI, and MCP/STDIO;
    • the first read-only workflow;
    • the complete controlled-write workflow;
    • compatibility requirements and current limitations.

  • Updated the architecture, security, and threat-model documentation.

  • Added an MCP tool reference and release notes.

Validation

This release passed:

  • TypeScript type checking;
  • production build;
  • all 31 automated tests;
  • npm package dry-run validation;
  • STDIO MCP initialization;
  • discovery of all five MCP tools and their descriptions;
  • a real macOS /tmp workspace proposal test;
  • a real Codex read-only task;
  • a real Codex proposal and explicit APPLY flow.

The end-to-end write validation confirmed that:

  • no files changed before approval;
  • only the expected line changed after APPLY;
  • no files were automatically staged;
  • no commit was automatically created;
  • no push was performed.

Current limitations

This remains an alpha prerelease.

It does not currently provide:

  • npm registry publishing;
  • task, proposal, or log persistence;
  • executor cancellation;
  • product-level task timeouts;
  • caller authentication;
  • OS-level read containment for ordinary read-only tasks;
  • automatic commit or push operations.

A compatible MCP/STDIO client, a locally available Codex CLI environment, and a registered workspace are required.

Installation and usage

This version is distributed through the GitHub source repository and is not yet published to the npm registry.

For installation, workspace registration, MCP configuration, and first-use examples, see:

  • README.zh-CN.md for Chinese documentation
  • README.md for English documentation
Assets 2
Loading