@surething/cockpit 1.0.260 → 1.0.262

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

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/m" | "/project" | "/review/[id]"
-type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/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/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/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/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/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/config" | "/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/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/prompts/config" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/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/snapshots" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version" | "/apps/[...path]"
+type AppRouteHandlerRoutes = "/api/agent/test" | "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/deepseek" | "/api/chat/glm" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/chat/stop" | "/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/deepseek/balance" | "/api/deepseek/credentials" | "/api/deepseek/models" | "/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/current-branch" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/glm/credentials" | "/api/glm/models" | "/api/glm/usage" | "/api/global-state" | "/api/health" | "/api/html-apps" | "/api/html-apps/[id]" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/kimi/credentials" | "/api/kimi/models" | "/api/kimi/usage" | "/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/config" | "/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/affected" | "/api/projectGraph/callees" | "/api/projectGraph/callers" | "/api/projectGraph/coedit" | "/api/projectGraph/context" | "/api/projectGraph/file" | "/api/projectGraph/file-functions" | "/api/projectGraph/impact" | "/api/projectGraph/related" | "/api/projectGraph/risk" | "/api/projectGraph/search" | "/api/projects" | "/api/prompts/config" | "/api/push/public-key" | "/api/push/subscribe" | "/api/push/unsubscribe" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/restart" | "/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/shutdown" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/snapshots" | "/api/snapshots/diff" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/update" | "/api/version" | "/apps/[...path]"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -123,6 +123,7 @@ interface ParamMap {
   "/api/redis/get": {}
   "/api/redis/keys": {}
   "/api/redis/set": {}
+  "/api/restart": {}
   "/api/review": {}
   "/api/review/[id]": { "id": string; }
   "/api/review/[id]/comments": { "id": string; }
@@ -141,6 +142,7 @@ interface ParamMap {
   "/api/sessions/projects": {}
   "/api/sessions/projects/[encodedPath]": { "encodedPath": string; }
   "/api/settings": {}
+  "/api/shutdown": {}
   "/api/skills": {}
   "/api/skills/[id]": { "id": string; }
   "/api/skills/content": {}
@@ -151,6 +153,7 @@ interface ParamMap {
   "/api/terminal/bubble-order": {}
   "/api/terminal/env": {}
   "/api/terminal/history": {}
+  "/api/update": {}
   "/api/version": {}
   "/apps/[...path]": { "path": string[]; }
   "/m": {}

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

@@ -1082,6 +1082,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/restart/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/restart">> = Specific
+  const handler = {} as typeof import("../../src/app/api/restart/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/review/[id]/comments/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/review/[id]/comments">> = Specific
@@ -1244,6 +1253,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/shutdown/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/shutdown">> = Specific
+  const handler = {} as typeof import("../../src/app/api/shutdown/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/skills/[id]/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills/[id]">> = Specific
@@ -1334,6 +1352,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/update/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/update">> = Specific
+  const handler = {} as typeof import("../../src/app/api/update/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/version/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/version">> = Specific

package/README.md

@@ -169,6 +169,7 @@ No install, no AI chat (read-only sandbox, 5 min):
 
 ## Prerequisites
 
+- **macOS, Linux, or Windows** — Windows support is experimental ([details](#windows))
 - **Node.js ≥ 20** — [nodejs.org](https://nodejs.org/)
 - **Claude Code** — [docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code) (default engine)
 - **Git** — for git features (blame, diff, worktree, etc.)
@@ -194,6 +195,80 @@ cockpit ~/my-project   # open specified dir
 cockpit -h             # help
 ```
 
+### Running in the background
+
+`cockpit` runs in the foreground, so closing the terminal stops it. To keep it
+running:
+
+```bash
+cockpit start          # start in the background
+cockpit status         # running? which version, port, pid, uptime
+cockpit restart        # restart in place
+cockpit stop
+```
+
+`start` accepts the same flags as `cockpit` (`--port`, `--token`). Output goes
+to `~/.cockpit/logs/server.log`.
+
+`restart` asks the running server to replace itself, so the port and token it
+was started with are preserved — you do not need to repeat them.
+
+> There is no launchd/systemd integration: after a reboot, run `cockpit start`
+> again (or add it to your login items).
+
+### Updating
+
+```bash
+cockpit update
+```
+
+…or click the version pill in the sidebar when an update is available.
+
+If Cockpit is **running**, it updates in place: the server hands off to a
+helper that installs while nothing is holding the install directory, then
+relaunches with the same port and token. A failed install rolls back to the
+previous version and still restarts, so an interrupted update never leaves you
+without a working Cockpit.
+
+If it is **not running**, `cockpit update` simply installs.
+
+Once the new server is up, any browser tab left open from the old version shows
+a "reload" prompt — its cached assets belong to the previous build.
+
+### Windows
+
+Windows support is **experimental** — it is exercised by CI but has far less
+real-world mileage than macOS and Linux. Cockpit runs natively; the Console
+panel uses Git Bash when it is installed and falls back to PowerShell, the same
+order Claude Code applies on Windows.
+
+- Install [Git for Windows](https://git-scm.com/download/win) for a bash
+  terminal. Without it the Console panel runs PowerShell, and the
+  `cockpit.bash` channel used by HTML apps is unavailable.
+- The file browser, diff, review and chat panels behave as they do elsewhere.
+
+Prefer a Linux toolchain? Run *all* of Cockpit inside **WSL2**, where it is an
+ordinary Linux install:
+
+```powershell
+wsl --install          # once, from an admin PowerShell, then reboot
+```
+
+```bash
+wsl                                  # enter your Linux shell
+npm install -g @surething/cockpit    # install Node ≥ 20 inside WSL first
+cockpit
+```
+
+Either way, open `http://localhost:3457` in your Windows browser — WSL2
+forwards localhost automatically.
+
+> **Pick one side and stay there.** Running Cockpit on Windows while your
+> project lives inside WSL (or the reverse) gives the agent one set of paths
+> and its terminal another: the same directory is `C:\Users\me\proj` on one
+> side and `/mnt/c/Users/me/proj` on the other, so paths passed between them
+> do not resolve. Keep Cockpit and your code in the same world.
+
 > Both `cockpit` (full name) and `cock` (short alias) ship with the package — use whichever you prefer. Docs and examples use `cockpit`; existing muscle memory keeps working.
 
 ### From source

package/README.zh.md

@@ -169,6 +169,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 
 ## 前置依赖
 
+- **macOS、Linux 或 Windows** —— Windows 支持为实验性（[详见](#windows)）
 - **Node.js ≥ 20** —— [nodejs.org](https://nodejs.org/)
 - **Claude Code** —— [docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)（默认引擎）
 - **Git** —— 用于 Git 相关功能（blame、diff、worktree 等）
@@ -196,6 +197,69 @@ cockpit -h             # 帮助
 
 > `cockpit`（完整名）和 `cock`（短别名）都随包安装 —— 任选其一。文档与示例统一使用 `cockpit`，老用户的肌肉记忆 `cock` 仍然好使。
 
+### 后台运行
+
+`cockpit` 默认在前台运行，关掉终端服务就停了。想让它常驻：
+
+```bash
+cockpit start          # 后台启动
+cockpit status         # 是否在跑：版本、端口、pid、运行时长
+cockpit restart        # 原地重启
+cockpit stop
+```
+
+`start` 支持与 `cockpit` 相同的参数（`--port`、`--token`）。输出写入
+`~/.cockpit/logs/server.log`。
+
+`restart` 是让运行中的服务自己完成替换，因此启动时用的端口和 token 会被保留 ——
+不需要重新指定一遍。
+
+> 没有集成 launchd/systemd：重启电脑后需要再次执行 `cockpit start`（或把它加进系统的登录启动项）。
+
+### 升级
+
+```bash
+cockpit update
+```
+
+也可以在有新版本时点击侧边栏的版本药丸。
+
+如果 Cockpit **正在运行**，升级会原地完成：服务把工作交接给一个辅助进程，由它在无人
+占用安装目录的情况下安装，然后用相同的端口和 token 重新拉起。安装失败会回滚到原版本
+并照常重启 —— 中断的升级不会让你失去一个可用的 Cockpit。
+
+如果**没有运行**，`cockpit update` 就是单纯地安装。
+
+新服务起来后，此前一直开着的浏览器标签页会出现"刷新"提示 —— 它持有的是旧版本的静态资源。
+
+### Windows
+
+Windows 支持为**实验性** —— CI 会覆盖，但实际使用量远少于 macOS 和 Linux。Cockpit
+以原生方式运行；Console 面板在装有 Git Bash 时使用它，否则回落到 PowerShell，与
+Claude Code 在 Windows 上的优先级一致。
+
+- 安装 [Git for Windows](https://git-scm.com/download/win) 可获得 bash 终端。不装的话
+  Console 面板会运行 PowerShell，且 HTML 应用使用的 `cockpit.bash` 通道不可用。
+- 文件浏览、diff、review、chat 等面板的行为与其他平台一致。
+
+想要 Linux 工具链？把**整个** Cockpit 放进 **WSL2** 运行，那里它就是一个普通的 Linux 安装：
+
+```powershell
+wsl --install          # 管理员 PowerShell 里执行一次，然后重启
+```
+
+```bash
+wsl                                  # 进入 Linux shell
+npm install -g @surething/cockpit    # 先在 WSL 内装好 Node ≥ 20
+cockpit
+```
+
+两种方式都在 Windows 浏览器里打开 `http://localhost:3457` —— WSL2 会自动转发 localhost。
+
+> **选一边，别混用。** 在 Windows 上跑 Cockpit 而项目放在 WSL 里（或者反过来），会让
+> agent 和它的终端拿到两套路径：同一个目录一边是 `C:\Users\me\proj`，另一边是
+> `/mnt/c/Users/me/proj`，互相传递的路径无法解析。让 Cockpit 和你的代码待在同一个世界里。
+
 ### 从源码安装
 
 ```bash

package/apps/devkit/app.jsx

@@ -6,6 +6,9 @@
  * buy a ~50ms process spawn per keystroke and a "is that binary installed?"
  * failure mode. MD5 comes from ./md5.js, SHA from the browser's crypto.subtle.
  */
+// React/ReactDOM come from the /html-lib script tags in index.html; `md5` is
+// the global exported by the sibling ./md5.js script tag.
+/* global React, ReactDOM, md5 */
 const { useState, useEffect, useMemo, useCallback, useRef, useContext, createContext } = React;
 
 /* ------------------------------------------------------------------ utils */
@@ -243,14 +246,14 @@ function TextCodecPanel({ state, patch, kind }) {
   }, [debounced, state.mode, kind]);
 
   const controls = (
-    <React.Fragment>
+    <>
       <Segmented value={state.mode} onChange={(mode) => patch({ mode })}
                  options={[{ value: 'encode', label: 'Encode' }, { value: 'decode', label: 'Decode' }]} />
       <button className="btn" onClick={() => patch({ text: '' })}>Clear</button>
       <span className="bar-note">
         {kind === 'base64' ? 'UTF-8 safe — handles non-ASCII text.' : 'encodeURIComponent / decodeURIComponent.'}
       </span>
-    </React.Fragment>
+    </>
   );
 
   return (
@@ -281,12 +284,12 @@ function JsonPanel({ state, patch }) {
   }, [debounced, state.mode]);
 
   const controls = (
-    <React.Fragment>
+    <>
       <Segmented value={state.mode} onChange={(mode) => patch({ mode })}
                  options={[{ value: 'pretty', label: 'Pretty' }, { value: 'minify', label: 'Minify' }]} />
       <button className="btn" onClick={() => patch({ text: '' })}>Clear</button>
       <span className="bar-note">Parses as you type — the error message doubles as validation.</span>
-    </React.Fragment>
+    </>
   );
 
   return (
@@ -339,14 +342,14 @@ function HashPanel({ state, patch }) {
   }, [debounced]);
 
   const controls = (
-    <React.Fragment>
+    <>
       <button className="btn" onClick={() => patch({ text: '' })}>Clear</button>
       <span className="bar-note">
         {SUBTLE
           ? 'MD5 computed locally; SHA via the browser\'s WebCrypto.'
           : 'SHA needs a secure context — open DevKit over localhost to enable it.'}
       </span>
-    </React.Fragment>
+    </>
   );
 
   return (
@@ -450,7 +453,7 @@ function JwtPanel({ state, patch }) {
             )}
 
             {decoded && decoded.header && (
-              <React.Fragment>
+              <>
                 <div className="section">
                   <div className="section-hd">
                     <span className="section-title">Header</span>
@@ -458,7 +461,7 @@ function JwtPanel({ state, patch }) {
                   </div>
                   <pre className="mono-block">{headerJson}</pre>
                   {algNone && (
-                    <span className="kv-v error">alg is "none" — this token is unsigned.</span>
+                    <span className="kv-v error">alg is &quot;none&quot; — this token is unsigned.</span>
                   )}
                 </div>
 
@@ -488,7 +491,7 @@ function JwtPanel({ state, patch }) {
                   <span className="section-title">Signature</span>
                   <pre className="mono-block muted">{decoded.signature || '(empty)'}</pre>
                 </div>
-              </React.Fragment>
+              </>
             )}
           </div>
         </div>
@@ -546,12 +549,12 @@ function TimestampPanel({ state, patch }) {
               <div className="kv"><span className="kv-v error">{fromEpoch.error}</span></div>
             )}
             {fromEpoch && fromEpoch.date && (
-              <React.Fragment>
+              <>
                 <div className="kv"><span className="kv-k">Detected</span><span className="kv-v muted">{fromEpoch.unit}</span></div>
                 <div className="kv"><span className="kv-k">Local</span><span className="kv-v">{formatLocal(fromEpoch.date)}</span></div>
                 <div className="kv"><span className="kv-k">UTC</span><span className="kv-v">{formatUTC(fromEpoch.date)}</span></div>
                 <div className="kv"><span className="kv-k">ISO</span><span className="kv-v">{fromEpoch.date.toISOString()}</span></div>
-              </React.Fragment>
+              </>
             )}
           </div>
         </div>
@@ -570,7 +573,7 @@ function TimestampPanel({ state, patch }) {
               <div className="kv"><span className="kv-v error">{fromDate.error}</span></div>
             )}
             {fromDate && fromDate.date && (
-              <React.Fragment>
+              <>
                 <div className="kv">
                   <span className="kv-k">Seconds</span>
                   <span className="kv-v">{Math.floor(fromDate.date.getTime() / 1000)}</span>
@@ -582,7 +585,7 @@ function TimestampPanel({ state, patch }) {
                   <CopyButton text={String(fromDate.date.getTime())} label="Milliseconds" />
                 </div>
                 <div className="kv"><span className="kv-k">ISO</span><span className="kv-v">{fromDate.date.toISOString()}</span></div>
-              </React.Fragment>
+              </>
             )}
           </div>
         </div>
@@ -603,7 +606,6 @@ function UuidPanel({ state, patch }) {
   listRef.current = state.list;
   useEffect(() => {
     if (listRef.current.length === 0) generate(state.count);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
   const shown = useMemo(() => state.list.map((u) => {
@@ -680,13 +682,13 @@ function App() {
   const [state, setState] = useState(INITIAL);
   const [toastMsg, setToastMsg] = useState(null);
 
-  const toastTimer = useRef(null);
+  const toastTimerRef = useRef(null);
   const toast = useCallback((message) => {
     setToastMsg(message);
-    clearTimeout(toastTimer.current);
-    toastTimer.current = setTimeout(() => setToastMsg(null), 1600);
+    clearTimeout(toastTimerRef.current);
+    toastTimerRef.current = setTimeout(() => setToastMsg(null), 1600);
   }, []);
-  useEffect(() => () => clearTimeout(toastTimer.current), []);
+  useEffect(() => () => clearTimeout(toastTimerRef.current), []);
 
   const patchers = useMemo(() => {
     const out = {};