@surething/cockpit 1.0.209 → 1.0.211

package/.next-prod/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/project" | "/review/[id]"
-type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/global-state" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/search" | "/api/projects" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version"
+type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/dev/spans" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/global-state" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/search" | "/api/projects" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -84,8 +84,12 @@ interface ParamMap {
   "/api/pinned-sessions": {}
   "/api/project-settings": {}
   "/api/project-state": {}
+  "/api/projectGraph/callees": {}
+  "/api/projectGraph/callers": {}
+  "/api/projectGraph/coedit": {}
   "/api/projectGraph/file": {}
   "/api/projectGraph/file-functions": {}
+  "/api/projectGraph/impact": {}
   "/api/projectGraph/search": {}
   "/api/projects": {}
   "/api/redis/command": {}

package/.next-prod/types/validator.ts

@@ -722,6 +722,33 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/projectGraph/callees/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/callees">> = Specific
+  const handler = {} as typeof import("../../src/app/api/projectGraph/callees/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/projectGraph/callers/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/callers">> = Specific
+  const handler = {} as typeof import("../../src/app/api/projectGraph/callers/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/projectGraph/coedit/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/coedit">> = Specific
+  const handler = {} as typeof import("../../src/app/api/projectGraph/coedit/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/projectGraph/file-functions/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/file-functions">> = Specific
@@ -740,6 +767,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/projectGraph/impact/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/impact">> = Specific
+  const handler = {} as typeof import("../../src/app/api/projectGraph/impact/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/projectGraph/search/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/projectGraph/search">> = Specific

package/README.md

@@ -80,6 +80,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 - Git **blame**, diff view, branch switching, **worktree** management
 - **LSP integration** — go to definition, find references, hover info
 - **Code Map** — every function as a chip with caller / callee pins; click to walk the call graph. Multi-language: TS/JS, Python, Go, Rust. No LSP, no project setup, works offline.
+- **CodeGraph** — a **code graph** for the agent: same tree-sitter index exposed as 6 HTTP endpoints (`search` / `callers` / `callees` / `impact` / `file` / `coedit`) so the agent queries coordinates instead of grepping text; trigger with `/cg` from chat. Coordinates only, never source — precise, cheap, and catches the conventional coupling no regex can.
 - Fuzzy file search (Cmd+F), JSON viewer, Markdown preview
 
 ### Console — Terminal & smart Bubbles
@@ -104,6 +105,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 - `/fx` — **Diagnose-only**: bug evidence chain, never edit
 - `/review` — read the diff, write notes, no rewrites
 - `/commit` — stage + draft a message in your repo's style + commit
+- `/cg` — **CodeGraph** project exploration: 6 HTTP endpoints for symbol / callers / impact / co-edit queries (precise where grep is fuzzy)
 - **Custom**: drop any `*.md` into `~/.claude/commands/` or `./.claude/commands/` → instant slash command
 
 ### Scheduled tasks — Cron for AI
@@ -189,7 +191,8 @@ cockpit terminal <id> output       # get terminal output
 | Cross-project search | grep | per-window | local | **Cmd+K** |
 | Browser / DB control | ❌ | usually ❌ | ❌ | **✅ Bubbles** |
 | Code review surface | git tools | PR provider | git | **LAN-shared** |
-| Slash modes | manual | per-plugin | yes | **`/qa /fx /review /commit` + custom** |
+| Slash modes | manual | per-plugin | yes | **`/qa /fx /review /commit /cg` + custom** |
+| Project-graph API for agent | ❌ | LSP (per-IDE) | ❌ | **✅ CodeGraph — 6 endpoints, AI-first, coordinates only** |
 | Local-only / no cloud relay | ✅ | varies | ✅ | **✅** |
 | Open source | ✅ | mostly ❌ | ✅ | **✅ MIT** |
 
@@ -197,6 +200,7 @@ Read the long version: [Claude Code GUI: CLI vs Cockpit vs IDE plugins](https://
 
 ## Read more
 
+- 📖 [What is a Code Graph (and why your AI needs one)](https://cocking.cc/en/blog/code-graph-for-ai-agents/)
 - 📖 [Read code as a map, not a tree](https://cocking.cc/en/blog/read-code-as-a-map/)
 - 📖 [How to run 5 Claude Code sessions in parallel](https://cocking.cc/en/blog/parallel-claude-code-sessions/)
 - 📖 [Slash modes in Claude Code: /qa /fx /review /commit](https://cocking.cc/en/blog/slash-modes-claude-code/)

package/README.zh.md

@@ -80,6 +80,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 - Git **blame**、Diff 视图、分支切换、**Worktree** 管理
 - **LSP 集成** —— 跳转定义、查找引用、悬浮类型信息
 - **代码地图（Code Map）** —— 每个函数渲染为 chip，左右两侧分别列出 caller / callee，点击 pin 即可顺着调用图走。多语言支持：TS/JS、Python、Go、Rust。无需 LSP、无需项目预热，离线可用。
+- **CodeGraph（项目图谱）** —— 给 Agent 的**代码图谱（code graph）**：同一份 tree-sitter 索引开放为 6 个 HTTP 接口（`search` / `callers` / `callees` / `impact` / `file` / `coedit`），Agent 直接按坐标精确查询，无须 grep 字面。在 chat 输入 `/cg` 触发。只返坐标不返源码——比 grep 精确、比 Read 省 token，还能抓住 regex 看不见的「约定耦合」。
 - 模糊搜索 (Cmd+F)、JSON 查看器、Markdown 预览
 
 ### Console —— 终端与智能气泡
@@ -104,6 +105,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 - `/fx` —— **只诊断**：Bug 证据链分析，绝不改文件
 - `/review` —— 读 diff、写评审，不动手重写
 - `/commit` —— 暂存改动、按你仓库的风格起草 message、提交
+- `/cg` —— **CodeGraph 项目探索**：6 个 HTTP 接口按符号 / 调用关系 / 影响范围 / 协同编辑精确查询（比 grep 精准）
 - **自定义**：`~/.claude/commands/` 或 `./.claude/commands/` 下任意 `*.md` 即斜杠指令
 
 ### 定时任务 —— 给 AI 的 Cron
@@ -189,7 +191,8 @@ cockpit terminal <id> output       # 获取终端输出
 | 跨项目搜索 | grep | 各窗口独立 | 本地 | **Cmd+K** |
 | 浏览器 / DB 控制 | ❌ | 通常 ❌ | ❌ | **✅ Bubbles** |
 | 代码评审面 | git 工具 | PR 平台 | git | **局域网共享** |
-| 斜杠模式 | 手动 | 各插件 | 有 | **`/qa /fx /review /commit` + 自定义** |
+| 斜杠模式 | 手动 | 各插件 | 有 | **`/qa /fx /review /commit /cg` + 自定义** |
+| 给 Agent 用的项目图谱 API | ❌ | LSP（IDE 内） | ❌ | **✅ CodeGraph —— 6 个接口，AI 优先，只返坐标** |
 | 纯本地 / 不上云 | ✅ | 不一定 | ✅ | **✅** |
 | 开源 | ✅ | 多数 ❌ | ✅ | **✅ MIT** |
 
@@ -197,6 +200,7 @@ cockpit terminal <id> output       # 获取终端输出
 
 ## 阅读更多
 
+- 📖 [Code Graph：给 AI 一张项目图谱](https://cocking.cc/zh/blog/code-graph-for-ai-agents/)
 - 📖 [把代码读成地图，而不是树](https://cocking.cc/zh/blog/read-code-as-a-map/)
 - 📖 [如何同时跑 5 个 Claude Code 会话不疯掉](https://cocking.cc/zh/blog/parallel-claude-code-sessions/)
 - 📖 [Claude Code 斜杠模式实战：/qa、/fx、/review、/commit](https://cocking.cc/zh/blog/slash-modes-claude-code/)