Skip to content

README.md

Latest commit

 

History

History
54 lines (40 loc) · 3.6 KB

README.md

File metadata and controls

54 lines (40 loc) · 3.6 KB
Raw

zcode-acp 設計・実装資料

最終更新: 2026-09-04

このディレクトリには、ZCodeのエージェント機能をACP v1へ公開するzcode-acpのArchitecture Decision Records（ADR）、現行仕様、運用手順、検証結果を格納します。設計を選んだ理由はADR、現在のwire shapeや実測値は各仕様書を正とします。

Architecture Decision Records

ADRの一覧はArchitecture Decision Recordsを参照してください。現在の実装を規定する判断は次の7件です。

  1. ACPアダプターをクライアント非依存とし、UIを外部クライアントに委ねる
  2. ZCode公式ホストサービスを同梱Electronランタイムで起動する
  3. 状態を持つプロトコル変換としてACPとZCodeを接続する
  4. 最新の検証済みZCode 1バージョンだけを厳密にサポートする
  5. ACP v1契約を固定し、将来のプロトコル版を分離する
  6. ネイティブの権限・入力・資格情報の境界を保持する
  7. Linux上で全プラットフォーム向けアダプターのみをビルドする

実装済み構成

flowchart LR
    C["ACP Client"]
    A["zcode-acp<br/>Bun standalone"]
    H["ZCode official host service<br/>worker_threads bridge"]
    R["Installed ZCode<br/>Electron Node runtime"]

    C <-->|"ACP v1 / JSON-RPC stdio"| A
    A <-->|"strict private NDJSON"| H
    H --- R
Loading

インストール済みZCodeの公式host serviceを同梱ElectronのNode modeで起動し、desktopと同じmodel provider、credential、runtime headersの経路を利用します。zcode-acp は異なる状態機械を接続するadapterであり、private RPCをそのまま公開するproxyではありません。

現在の互換性対象

ZCode CLI Host artifact Host protocol
3.11.2 0.16.5 zcode-host-3.11.2 zcode-task-v1

同一versionのCLIとhost内容はOS間で同一と扱います。OS差はinstall layoutとmetadata platformの照合だけに限定し、実行済み検証と未実施項目はImplementation statusに分離して記録します。

現行文書

  1. 調査結果: 現在のZCode配布物から観測した事実
  2. 製品仕様: 公開機能、非目標、要件
  3. アーキテクチャ: component、状態遷移、data flow
  4. ZCode private protocol: 現在のhost contractとfingerprint
  5. ACP v1 adapter specification: ACP wire surfaceと意味変換
  6. Headless Linux運用: install、認証、診断、障害対応
  7. Security and licensing: security controlと配布境界
  8. Testing and compatibility: test、release、ZCode更新手順
  9. Implementation status: 実装済み機能と実機検証結果
  10. References and evidence: 一次資料、再現command、実測値