Termdock Roadmap — 2026 Q2–Q3

[cyh7789]

For English readers, please scroll down to the English section below.

繁體中文

2026-07 更新：本 roadmap 已對齊實際出貨內容。與早前版本相比，幾個主題的落點有調整：Rust 效能路徑分散在 v1.12 / v1.15 落地、Agent Workstream 移至 v1.14、字型系統併入 v1.16 的 UX polish、Remote / Browser 孵化移至 v1.17。

已完成

✅ v1.15.0 — Terminal Model + Shared Infra

終端模型與共用基礎收尾。CharOffset / ByteOffset 品牌型別統一偏移語意、Rust 驅動的扁平化 scrollback、model-aware 路徑連結、session 還原強化（headless 序列化 + 週期快照 + 原子寫入）、WebGL renderer 預設啟用（renderer CPU 大幅下降）、AST 服務隔離至 utility process、受信任主機偵測、監聽 port 即時顯示。

✅ v1.14.0 — Agent Workstream + MCP Integration

Agent 工作流的結構化呈現與外部整合面。Workstream Feed（agent 決策時間軸）、attention 狀態管理、從 Feed 直接回覆核准與問題、agent CLI hook 安裝器、Termdock MCP surface（外部工具可直接查詢 code graph 與終端能力）、code graph benchmark。

✅ v1.13.0 — Foundation: Tool Runtime + Code Graph

收斂 agent / CLI / AST 的共用底座。Tool Runtime 統一註冊與呼叫（workspace routing、per-resource locking、structured truncation）、code graph DTO 與 freshness 契約、agent-first context 工具（一次呼叫取回任務相關的入口、符號、關聯與摘錄）。

✅ v1.12.0 — Headless Terminal + Terminal API

pty-worker 加入 headless 終端基礎層：背景終端會話、CLI attach、乾淨的 screen state API。Terminal API 的 SSE 事件推送與 output 讀取效率同步改善。

✅ v1.11.0 — Integration Reliability

外部控制 contract、PTY 寫入協調與背壓、Terminal API 邊界回歸測試、shell integration 啟動合約測試、多 Git 倉庫自動切換、CLI entrypoint。

✅ v1.10.0 — Generic Grid Container

終端面板系統泛化為通用容器：終端與文件同佈局共存、分割畫面、統一分頁拖拽。

✅ v1.9.0 / v1.8.x — 幾何統一與時序基礎

resize / restore / 可見性恢復路徑統一；終端 epoch 與時序管理重建。

---

進行中

🔨 v1.16.0 — Graph Intelligence + UX Polish

在 code graph 底座與 MCP surface 之上，補齊高階語意與 Git review 能力。

• Visual Diff Review Surface — 全新的三欄 Git review 介面：commit graph、side-by-side diff（左右變更區塊以彩色連接帶對應、≠ / − / + 記號、token 級變更反白、未變更區摺疊）、檔案樹與逐行 blame。原型已在真實資料上迭代驗證，正式版將支援跨檔導航、大型 diff 虛擬化與 read-only merge review。
• Git Diff Impact Analysis — 從 working / staged / commit diff 映射到受影響的符號、呼叫者與檔案，回答「這次改動的爆炸半徑有多大」。
• Framework Route Nodes — 將 web framework 路由建成一等 graph 節點，impact / context 查詢能回答「哪個 URL 進到這個 handler」。
• Learn / Onboarding Graph Output — 基於 code graph 產生新手導覽與架構摘要。
• UX Polish — renderer 全域字型、Modal / Dialog 系統統一、Git graph tag 訊息顯示。
• 體質 — renderer 型別檢查基建接線（存量凍結、新碼零錯誤 gate）。

---

規劃中

📋 v1.17.0 — Agent Ecosystem + Remote Incubation

• 第四個 agent session provider — HTTP 與互動式兩種模式，統一 provider 型別擴展
• Remote Workspace 孵化 — living spec 先行，SSH 遠端工作區原型（可重連終端會話）跟進
• Agent Browser Automation MVP — agent 驅動的瀏覽器自動化能力孵化

---

English

Updated 2026-07: this roadmap now reflects what actually shipped. Compared to earlier versions, several themes landed differently: Rust performance work landed across v1.12 / v1.15, Agent Workstream moved to v1.14, the font system folded into v1.16 UX polish, and Remote / Browser incubation moved to v1.17.

Completed

✅ v1.15.0 — Terminal Model + Shared Infra

Terminal model and shared infrastructure wrap-up. Branded CharOffset / ByteOffset types unify offset semantics, Rust-backed flat scrollback, model-aware path links, hardened session restore (headless serialization + periodic snapshots + atomic writes), WebGL renderer enabled by default (major renderer CPU reduction), AST service isolated into a utility process, trusted host detection, and live listening-port chips.

✅ v1.14.0 — Agent Workstream + MCP Integration

Structured agent workflow surfaces and external integration. Workstream Feed (a structured timeline of agent decisions), attention state management, replying to agent approvals and questions directly from the Feed, an agent CLI hook installer, the Termdock MCP surface (external tools can query the code graph and terminal capabilities directly), and a code graph benchmark harness.

✅ v1.13.0 — Foundation: Tool Runtime + Code Graph

Converged the shared foundation for agents, CLI, and AST. Unified Tool Runtime registration and invocation (workspace routing, per-resource locking, structured truncation), code graph DTOs with freshness contracts, and an agent-first context tool that returns task-relevant entry points, symbols, relations, and snippets in a single call.

✅ v1.12.0 — Headless Terminal + Terminal API

A headless terminal foundation inside the pty worker: background terminal sessions, CLI attach, and a clean screen-state API. SSE event delivery and output reads in the Terminal API were improved alongside.

✅ v1.11.0 — Integration Reliability

External control contracts, PTY write coordination with backpressure, Terminal API boundary regression tests, shell integration startup contract tests, multi-Git-repository context switching, and the CLI entrypoint.

✅ v1.10.0 — Generic Grid Container

Generalized the terminal panel system into a universal container: terminals and files coexist in the same layout with split view and unified tab drag-and-drop.

✅ v1.9.0 / v1.8.x — Geometry + Timing Foundations

Unified resize / restore / visibility-recovery paths; rebuilt terminal epoch and timing management.

---

In Progress

🔨 v1.16.0 — Graph Intelligence + UX Polish

Building higher-level semantics and Git review capabilities on top of the code graph foundation and MCP surface.

• Visual Diff Review Surface — a new three-column Git review experience: commit graph, side-by-side diff (colored connector bands mapping changed blocks across sides, ≠ / − / + markers, token-level change highlighting, collapsed unchanged regions), file tree, and per-line blame. The prototype has been iterated on real repository data; the full version adds cross-file navigation, large-diff virtualization, and read-only merge review.
• Git Diff Impact Analysis — map working / staged / commit diffs onto affected symbols, callers, and files: "what is the blast radius of this change?"
• Framework Route Nodes — web framework routes as first-class graph nodes, so impact / context queries can answer "which URL reaches this handler".
• Learn / Onboarding Graph Output — generate guided tours and architecture summaries from the code graph.
• UX Polish — renderer-wide font settings, unified Modal / Dialog system, Git graph tag message display.
• Hygiene — renderer type-check infrastructure (frozen baseline for existing debt, zero-error gate for new code).

---

Planned

📋 v1.17.0 — Agent Ecosystem + Remote Incubation

• A fourth agent session provider — HTTP and interactive modes, with a unified provider type extension
• Remote Workspace incubation — living spec first, then an SSH remote workspace prototype with reconnectable terminal sessions
• Agent Browser Automation MVP — incubating agent-driven browser automation