@coralai/sps-cli 0.57.15 → 0.58.1

package/README-CN.md

@@ -21,6 +21,7 @@ v0.51 头条特性是 **Wiki 知识库** — per-project 可选，结构化互
 ## 目录
 
 - [安装与初始化](#安装与初始化)
+- [部署（服务化 / 源码构建）](#部署服务化--源码构建)
 - [Harness 模式（`sps agent`）](#harness-模式sps-agent)
 - [Console 模式（`sps console`）](#console-模式sps-console)
 - [Pipeline 模式（`sps tick`）](#pipeline-模式sps-tick)
@@ -38,7 +39,7 @@ v0.51 头条特性是 **Wiki 知识库** — per-project 可选，结构化互
 ## 安装与初始化
 
 ```bash
-npm install -g @coralai/sps-cli      # 最新 0.51.x
+npm install -g @coralai/sps-cli      # 最新 0.57.x
 sps setup                            # 交互式向导（首次必跑）
 ```
 
@@ -51,7 +52,127 @@ sps setup                            # 交互式向导（首次必跑）
 
 `sps setup --force` 重跑（保留旧值作默认）。**升级 sps-cli 后必须跑 `sps skill sync --force`** 才能拉新版 skill SOP（默认 sync 是非破坏性的，不会覆盖已有 skill）。
 
-**前置条件**：Node ≥ 18；Anthropic API key（或 Claude Pro / Max 订阅）；`claude` CLI 在 PATH。
+**前置条件**：Node ≥ 18（**建议 ≥ 22** —— 代码图谱功能用了 `node:sqlite`,只有 Node 22+ 才有）；Anthropic API key（或 Claude Pro / Max 订阅）；`claude` CLI 在 PATH。
+
+---
+
+## 部署（服务化 / 源码构建）
+
+要把 sps-cli 作为长驻服务跑（Console 网页 + IM 网关 + 流水线），走**源码构建**部署。下面步骤 AI 或运维照着从头到尾即可完成。
+
+### 装完 npm 包后必补(否则跑不起来)
+
+`npm install -g @coralai/sps-cli` **只给你 `sps` 命令**。要真正跑起来,还得补:
+
+1. **Node ≥ 22**(代码图谱用 `node:sqlite`;CLI 其余 ≥ 18 即可)。
+2. **`claude` CLI 在 PATH** —— worker 后端连的就是它(`sps doctor` 检查 `which claude`):
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   ```
+3. **Claude 鉴权**(三选一):`claude` 登录订阅(Pro / Max → `~/.claude/.credentials.json`)、或设 `ANTHROPIC_API_KEY`、或让 worker 指向第三方 Anthropic 端点 / codex-proxy。
+4. **跑一次 `sps setup`** —— 建 `~/.coral/`、全局装 ACP 传输层 `@agentclientprotocol/claude-agent-acp`、写 `~/.coral/env`。
+5. **git** —— 流水线在目标 repo 里开 worktree/分支。
+
+**模型/订阅配置在包外**(secret,本机自配):官方订阅(`claude` 登录)开箱即用;第三方端点写 `~/.coral/game-platform/providers.json`;worker 默认模型 `~/.coral/agents/smartarrange.json`(可省)。
+
+**自检机器是否就绪**:
+```bash
+sps project init demo
+sps doctor demo --fix     # 查 Node、claude 在不在 PATH、目录、配置——缺啥直接报
+```
+
+按需补(用到才配):ChatGPT 订阅 worker → `sps codex-proxy install && sps codex-proxy auth`;IM 网关 → `~/.coral/im/config.json`;远程 Console → `SPS_CONSOLE_TOKEN`。
+
+### 依赖
+
+- **Node ≥ 22** + npm（代码图谱用 `node:sqlite` 的 `DatabaseSync`,需 Node ≥ 22;CLI 其余部分 ≥ 18 即可）。
+- **git**。
+- **Worker 的 Claude 鉴权**：环境里有 `ANTHROPIC_API_KEY`,或已登录的 `claude` CLI（Pro / Max 订阅）。`sps setup` 会全局装 worker 传输层 `@agentclientprotocol/claude-agent-acp`。
+- 无 native/编译依赖 —— `@colbymchenry/codegraph` 等都是纯 JS,普通 `npm install` 即可。
+
+### 1. 克隆、装依赖、构建
+
+```bash
+git clone <repo-url> sps-cli && cd sps-cli
+npm install            # 根依赖
+npm run build          # 唯一正确的构建 —— 见下方警告
+sps setup              # 或 node dist/main.js setup —— 一次性搭 ~/.coral + skills + claude-agent-acp
+```
+
+`npm run build` 会跑**两半**,是唯一正确的构建命令：
+
+- `build:cli` → `rm -rf dist && tsc`（把 `src/` 编译到 `dist/`）。
+- `build:console` → `cd console && npm install && vite build`,再把 `console/dist` 拷到 `dist/console-assets`。**console 有自己独立的 `node_modules`,这一步会帮你装好** —— 你不用单独进 `console/` 再 install。
+
+> ⚠️ **绝不要单跑 `npm run build:cli`。** 它的 `rm -rf dist` 会连 `dist/console-assets` 一起删掉,Console 网页就 500 / 找不到 `index.html`。永远用完整的 `npm run build`。
+
+暴露命令,或直接调 `dist/main.js`：
+
+```bash
+npm link                       # 把 `sps` 挂到 PATH → dist/main.js
+# 或不 link,直接：
+node dist/main.js <command>
+```
+
+### 2. 启动各服务
+
+**Console（网页）：**
+
+```bash
+sps console                                    # 本机：127.0.0.1:4311
+# 服务器：绑所有网卡 + 必须带鉴权 token
+SPS_CONSOLE_TOKEN=$(openssl rand -hex 24) sps console --host 0.0.0.0 --port 4321 --no-open
+# 然后访问  http://<host>:4321/?token=<token>
+```
+
+`SPS_CONSOLE_TOKEN` 控制访问。**绑 `0.0.0.0` 时务必设它** —— 不设 token 网页在网络上就是无鉴权的。启动 banner 会打印带 token 的 URL。
+
+**IM 网关（`sps im`）** —— Telegram / 钉钉（Stream）/ 飞书-Lark / Slack / Discord / Matrix 的收发机器人,支持在会话里切换项目：
+
+```bash
+sps im                         # 前台阻塞;读 ~/.coral/im/config.json
+```
+
+推荐在 Console → **插件 → 频道** 页配置（左频道列表、右设置,自动写文件）。也可直接编辑 `~/.coral/im/config.json`：
+
+```json
+{
+  "console": { "url": "http://localhost:4321", "token": "<SPS_CONSOLE_TOKEN>", "agentKind": "claude" },
+  "adapters": [
+    { "kind": "telegram", "token": "<bot-token>", "allowedChatIds": [123456789] }
+  ]
+}
+```
+
+`console.url` + `token` 把 IM 纯文本消息桥接到项目 agent 对话。**改完配置要重启 `sps im`** 才生效。（只有飞书需要公网回调,其余适配器无需入站端口。）
+
+**流水线：**
+
+```bash
+sps tick my-app                # 单项目前台 tick 循环
+```
+
+### 3. 保活
+
+`sps console`、`sps im`、`sps tick` 都是前台进程。用 nohup 或 systemd 保活：
+
+```bash
+# nohup（简单）
+SPS_CONSOLE_TOKEN=<hex> nohup node dist/main.js console --host 0.0.0.0 --port 4321 --no-open > ~/console.log 2>&1 &
+nohup node dist/main.js im > ~/im.log 2>&1 &
+```
+
+systemd `--user` 服务：`ExecStart=node /abs/path/sps-cli/dist/main.js console --host 0.0.0.0 --port 4321 --no-open`,并 `Environment=SPS_CONSOLE_TOKEN=...`。
+
+### 4. 升级
+
+```bash
+git pull && npm install && npm run build
+sps skill sync --force         # 升级后刷新 skill SOP
+# 然后重启 console + im 进程,让新代码/路由加载
+```
+
+新增的 Console API 路由（如 `/api/channels`）**必须重启 console 进程**才生效 —— 光重新构建不够。
 
 ---
 

package/README.md

@@ -21,6 +21,7 @@ The headline feature in v0.51 is the **Wiki Knowledge Base** — opt-in per proj
 ## Table of contents
 
 - [Install & setup](#install--setup)
+- [Deployment (server / from source)](#deployment-server--from-source)
 - [Harness mode (`sps agent`)](#harness-mode-sps-agent)
 - [Console mode (`sps console`)](#console-mode-sps-console)
 - [Pipeline mode (`sps tick`)](#pipeline-mode-sps-tick)
@@ -38,7 +39,7 @@ The headline feature in v0.51 is the **Wiki Knowledge Base** — opt-in per proj
 ## Install & setup
 
 ```bash
-npm install -g @coralai/sps-cli      # latest 0.51.x
+npm install -g @coralai/sps-cli      # latest 0.57.x
 sps setup                            # interactive wizard (must run once)
 ```
 
@@ -51,7 +52,127 @@ sps setup                            # interactive wizard (must run once)
 
 Re-run safe with `sps setup --force` (keeps existing values as defaults). After upgrading sps-cli later, run **`sps skill sync --force`** to pull updated skill SOPs (default sync is non-destructive — won't overwrite existing skills).
 
-**Prerequisites**: Node ≥ 18; an Anthropic API key (or Claude Pro / Max subscription); `claude` CLI in PATH.
+**Prerequisites**: Node ≥ 18 (**≥ 22 recommended** — the code-graph feature uses `node:sqlite`, only available in Node 22+); an Anthropic API key (or Claude Pro / Max subscription); `claude` CLI in PATH.
+
+---
+
+## Deployment (server / from source)
+
+For running sps-cli as long-lived services (Console web UI + IM gateway + pipeline) on a server, deploy **from source**. An AI or operator can follow the steps below end to end.
+
+### After installing the npm package — required extras
+
+`npm install -g @coralai/sps-cli` gives you the `sps` CLI **only**. To actually run it, also provide:
+
+1. **Node ≥ 22** (code-graph uses `node:sqlite`; the rest of the CLI runs on ≥ 18).
+2. **Claude Code CLI in PATH** — the worker backend drives it (`sps doctor` checks `which claude`):
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   ```
+3. **Claude auth** (one of): log in with `claude` (Pro / Max → `~/.claude/.credentials.json`), or set `ANTHROPIC_API_KEY`, or point workers at a third-party Anthropic endpoint / codex-proxy.
+4. **Run `sps setup` once** — scaffolds `~/.coral/`, installs the ACP transport `@agentclientprotocol/claude-agent-acp` globally, writes `~/.coral/env`.
+5. **git** — pipelines run worktrees/branches inside the target repo.
+
+**Model / subscription config lives outside the package** (secrets, per machine): the official subscription (`claude` login) works out of the box; third-party endpoints go in `~/.coral/game-platform/providers.json`; the worker's default model in `~/.coral/agents/smartarrange.json` (optional).
+
+**Verify the box is ready**:
+```bash
+sps project init demo
+sps doctor demo --fix     # checks Node, claude-in-PATH, dirs, config — reports what's missing
+```
+
+Per-feature extras (only if used): ChatGPT-subscription worker → `sps codex-proxy install && sps codex-proxy auth`; IM gateway → `~/.coral/im/config.json`; remote Console → `SPS_CONSOLE_TOKEN`.
+
+### Dependencies
+
+- **Node ≥ 22** and npm (the code-graph feature imports `node:sqlite` — `DatabaseSync` — which requires Node ≥ 22; the rest of the CLI runs on ≥ 18).
+- **git**.
+- **Claude auth for workers**: either `ANTHROPIC_API_KEY` in the environment, or a logged-in `claude` CLI (Pro / Max subscription). `sps setup` installs the worker transport `@agentclientprotocol/claude-agent-acp` globally.
+- No native/compiled dependencies — `@colbymchenry/codegraph` and the rest are pure JS; a plain `npm install` is enough.
+
+### 1. Clone, install, build
+
+```bash
+git clone <repo-url> sps-cli && cd sps-cli
+npm install            # root dependencies
+npm run build          # THE build — see warning below
+sps setup              # or: node dist/main.js setup — one-time ~/.coral scaffold + skills + claude-agent-acp
+```
+
+`npm run build` runs **both** halves and is the only correct build command:
+
+- `build:cli` → `rm -rf dist && tsc` (compiles `src/` → `dist/`).
+- `build:console` → `cd console && npm install && vite build`, then copies `console/dist` → `dist/console-assets`. **The console has its own `node_modules`; this step installs it for you** — you do not run a separate install in `console/`.
+
+> ⚠️ **Never run `npm run build:cli` alone.** Its `rm -rf dist` wipes `dist/console-assets`, so the Console web UI breaks with a 500 / missing `index.html`. Always use the full `npm run build`.
+
+Expose the binary, or invoke `dist/main.js` directly:
+
+```bash
+npm link                       # puts `sps` on PATH → dist/main.js
+# or, without linking:
+node dist/main.js <command>
+```
+
+### 2. Run the services
+
+**Console (web UI):**
+
+```bash
+sps console                                    # local: 127.0.0.1:4311
+# server: bind all interfaces + REQUIRED auth token
+SPS_CONSOLE_TOKEN=$(openssl rand -hex 24) sps console --host 0.0.0.0 --port 4321 --no-open
+# then open  http://<host>:4321/?token=<the-token>
+```
+
+`SPS_CONSOLE_TOKEN` gates access. **When binding to `0.0.0.0`, always set it** — without a token the UI is unauthenticated on the network. The startup banner prints the tokenized URL.
+
+**IM gateway (`sps im`)** — inbound + outbound bots for Telegram / DingTalk (Stream) / Feishu-Lark / Slack / Discord / Matrix, with in-chat project switching:
+
+```bash
+sps im                         # foreground; reads ~/.coral/im/config.json
+```
+
+Configure channels the easy way in the Console → **Plugins → Channel** page (left = channel list, right = settings; it writes the file for you). Or edit `~/.coral/im/config.json` directly:
+
+```json
+{
+  "console": { "url": "http://localhost:4321", "token": "<SPS_CONSOLE_TOKEN>", "agentKind": "claude" },
+  "adapters": [
+    { "kind": "telegram", "token": "<bot-token>", "allowedChatIds": [123456789] }
+  ]
+}
+```
+
+`console.url` + `token` bridge IM plain-text messages to project-agent chat. **After changing the config, restart `sps im`** for it to take effect. (Feishu is the only adapter needing a public callback; the rest work without inbound ports.)
+
+**Pipeline:**
+
+```bash
+sps tick my-app                # foreground tick loop for one project
+```
+
+### 3. Keep the services alive
+
+`sps console`, `sps im`, and `sps tick` are foreground processes. Use nohup or a systemd unit for persistence:
+
+```bash
+# nohup (simple)
+SPS_CONSOLE_TOKEN=<hex> nohup node dist/main.js console --host 0.0.0.0 --port 4321 --no-open > ~/console.log 2>&1 &
+nohup node dist/main.js im > ~/im.log 2>&1 &
+```
+
+For a systemd `--user` service, point `ExecStart=node /abs/path/sps-cli/dist/main.js console --host 0.0.0.0 --port 4321 --no-open` and set `Environment=SPS_CONSOLE_TOKEN=...`.
+
+### 4. Upgrading
+
+```bash
+git pull && npm install && npm run build
+sps skill sync --force         # refresh skill SOPs after an upgrade
+# then restart the console + im processes so new code/routes load
+```
+
+Newly added Console API routes (e.g. `/api/channels`) only take effect after the console process restarts — rebuild alone is not enough.
 
 ---
 

package/dist/commands/codexProxyCommand.d.ts

@@ -0,0 +1,2 @@
+export declare function executeCodexProxyCommand(sub: string | undefined): Promise<void>;
+//# sourceMappingURL=codexProxyCommand.d.ts.map

package/dist/commands/codexProxyCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexProxyCommand.d.ts","sourceRoot":"","sources":["../../src/commands/codexProxyCommand.ts"],"names":[],"mappings":"AAoBA,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAoErF"}

package/dist/commands/codexProxyCommand.js

@@ -0,0 +1,81 @@
+/**
+ * @module        commands/codexProxyCommand
+ * @description   `sps codex-proxy <start|stop|status>` —— 手动管 claude-code-proxy 后台单例
+ *                (ChatGPT 订阅→Anthropic 兼容翻译)。tick 会在 worker=codex-proxy 时自动拉起,
+ *                本命令供手动起停/排障。
+ * @layer         command
+ * @boundedContext worker-lifecycle
+ */
+import { spawnSync } from 'node:child_process';
+import { CODEX_PROXY_INSTALL_SH, codexProxyBinPath, codexProxyStatus, ensureCodexProxyRunning, stopCodexProxy, } from '../core/agents/sidecar/CodexProxyManager.js';
+const INSTALL_SH = CODEX_PROXY_INSTALL_SH;
+const RELEASES = 'https://github.com/raine/claude-code-proxy/releases';
+export async function executeCodexProxyCommand(sub) {
+    switch (sub) {
+        case 'install': {
+            if (codexProxyBinPath()) {
+                process.stdout.write('claude-code-proxy 已安装。授权:sps codex-proxy auth\n');
+                return;
+            }
+            if (spawnSync('which', ['curl']).status !== 0) {
+                process.stderr.write(`需要 curl。手动装:见 ${RELEASES}(或 brew install raine/claude-code-proxy/claude-code-proxy)\n`);
+                process.exitCode = 1;
+                return;
+            }
+            // 官方安装脚本:检测 os/arch → 下 release 二进制 → /usr/local/bin(可写)否则 ~/.local/bin(无需 sudo)。
+            // CLAUDE_CODE_PROXY_VERSION 可锁版本,CLAUDE_CODE_PROXY_INSTALL_DIR 可指定目录(透传自当前 env)。
+            process.stdout.write(`运行官方安装脚本:curl -fsSL ${INSTALL_SH} | bash\n`);
+            const r = spawnSync('bash', ['-c', `curl -fsSL ${INSTALL_SH} | bash`], { stdio: 'inherit' });
+            if (r.status !== 0) {
+                process.stderr.write(`\n安装脚本失败;可手动装:${RELEASES}\n`);
+                process.exitCode = r.status ?? 1;
+                return;
+            }
+            if (codexProxyBinPath()) {
+                process.stdout.write('装好。下一步授权:sps codex-proxy auth\n');
+            }
+            else {
+                // 多半落在 ~/.local/bin 而不在 PATH。
+                process.stdout.write('已安装,但当前 PATH 未找到——把 ~/.local/bin 加入 PATH(或见脚本输出的路径),再跑 sps codex-proxy auth\n');
+            }
+            return;
+        }
+        case 'auth': {
+            if (!codexProxyBinPath()) {
+                process.stderr.write('未装 claude-code-proxy。先跑:sps codex-proxy install\n');
+                process.exitCode = 1;
+                return;
+            }
+            // 交互式设备码授权,继承 stdio。
+            const r = spawnSync('claude-code-proxy', ['codex', 'auth', 'device'], { stdio: 'inherit' });
+            process.exitCode = r.status ?? 0;
+            return;
+        }
+        case 'start': {
+            const { baseUrl } = await ensureCodexProxyRunning();
+            process.stdout.write(`codex-proxy 运行中:${baseUrl}\n`);
+            return;
+        }
+        case 'stop': {
+            const stopped = stopCodexProxy();
+            process.stdout.write(stopped ? 'codex-proxy 已停\n' : 'codex-proxy 未在运行\n');
+            return;
+        }
+        case 'status':
+        case undefined: {
+            const s = await codexProxyStatus();
+            process.stdout.write([
+                `binary:  ${s.binInstalled ? '已安装' : '缺失(sps codex-proxy install)'}`,
+                `auth:    ${s.authed ? `已授权${s.account ? ` (account ${s.account})` : ''}` : '未授权(sps codex-proxy auth)'}`,
+                `running: ${s.running ? `是 (pid ${s.pid})` : '否'}`,
+                `healthy: ${s.healthy ? '是' : '否'}`,
+                `baseUrl: ${s.baseUrl}`,
+            ].join('\n') + '\n');
+            return;
+        }
+        default:
+            process.stderr.write(`未知子命令 '${sub}'。用法:sps codex-proxy <install|auth|start|stop|status>\n`);
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=codexProxyCommand.js.map

package/dist/commands/codexProxyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexProxyCommand.js","sourceRoot":"","sources":["../../src/commands/codexProxyCommand.ts"],"names":[],"mappings":"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"}

package/dist/commands/graphCommand.d.ts

@@ -0,0 +1,2 @@
+export declare function executeGraphCommand(subcommand: string | null, projectOrPath: string | null, positionals: string[], flags: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=graphCommand.d.ts.map

package/dist/commands/graphCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphCommand.d.ts","sourceRoot":"","sources":["../../src/commands/graphCommand.ts"],"names":[],"mappings":"AA0CA,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/commands/graphCommand.js

@@ -0,0 +1,97 @@
+/**
+ * @module        commands/graphCommand
+ * @description   `sps graph <build|sync|status> [projectOrPath]` —— 项目级代码图谱建图/增量/状态。
+ *                目标目录:受管项目名→其 repoDir;否则当作路径;省略则当前目录(便于对 sps-cli 自身建图)。
+ * @layer         command
+ * @boundedContext codegraph
+ */
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ProjectContext } from '../core/context.js';
+import { buildGraph, READ_SUBCOMMANDS, readGraphStatus, runGraphQuery, syncGraph, } from '../core/codegraph/CodeGraphService.js';
+/** 把 <projectOrPath> 解析成实际代码目录。 */
+function resolveTargetDir(projectOrPath) {
+    if (!projectOrPath)
+        return { dir: process.cwd(), label: process.cwd() };
+    // 优先当作受管项目名(conf 能加载就用其 repoDir)。
+    try {
+        const ctx = ProjectContext.load(projectOrPath);
+        return { dir: ctx.paths.repoDir, label: `${projectOrPath} → ${ctx.paths.repoDir}` };
+    }
+    catch {
+        // 退化:当作目录路径。
+        const p = resolve(projectOrPath);
+        if (existsSync(p) && statSync(p).isDirectory())
+            return { dir: p, label: p };
+        throw new Error(`"${projectOrPath}" 既不是受管项目,也不是有效目录`);
+    }
+}
+function printStatus(st) {
+    const mb = (st.dbSizeBytes / 1024 / 1024).toFixed(2);
+    console.log(`  文件 ${st.files}  节点 ${st.nodes.toLocaleString()}  边 ${st.edges.toLocaleString()}  db ${mb} MB`);
+    const kinds = Object.entries(st.nodesByKind).sort((a, b) => b[1] - a[1]).slice(0, 6);
+    if (kinds.length)
+        console.log(`  主要节点:${kinds.map(([k, c]) => `${k} ${c}`).join(' · ')}`);
+}
+export async function executeGraphCommand(subcommand, projectOrPath, positionals, flags) {
+    const json = Boolean(flags.json);
+    // ── 只读查询(worker 用:`sps graph explore <关键词>` 一次拿回相关代码,省 token)──
+    // 目标目录 = 当前工作目录(worker 的 cwd 即项目);第一个位置参数起都算查询词。
+    if (subcommand && READ_SUBCOMMANDS.includes(subcommand)) {
+        const queryArgs = [projectOrPath, ...positionals].filter((s) => !!s);
+        const r = await runGraphQuery(process.cwd(), subcommand, queryArgs);
+        console.log(r.output || '(无结果)');
+        if (!r.ok)
+            process.exit(1);
+        return;
+    }
+    if (!subcommand || !['build', 'sync', 'status'].includes(subcommand)) {
+        console.error('Usage: sps graph <build|sync|status|explore|node|query|callers|callees|impact> [args] [--json]');
+        process.exit(2);
+    }
+    let target;
+    try {
+        target = resolveTargetDir(projectOrPath);
+    }
+    catch (e) {
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(2);
+        return;
+    }
+    if (subcommand === 'status') {
+        const st = readGraphStatus(target.dir);
+        if (json) {
+            console.log(JSON.stringify(st ?? { exists: false }, null, 2));
+            return;
+        }
+        if (!st) {
+            console.log(`(未建图:${target.label})  跑 sps graph build 生成`);
+            return;
+        }
+        console.log(`代码图谱 · ${target.label}`);
+        printStatus(st);
+        return;
+    }
+    const verb = subcommand === 'build' ? '建图' : '增量同步';
+    if (!json)
+        console.log(`${verb}中 · ${target.label} …`);
+    try {
+        const st = subcommand === 'build' ? await buildGraph(target.dir) : await syncGraph(target.dir);
+        if (json) {
+            console.log(JSON.stringify(st, null, 2));
+            return;
+        }
+        console.log(`✓ ${verb}完成`);
+        printStatus(st);
+    }
+    catch (e) {
+        if (json) {
+            console.log(JSON.stringify({ ok: false, error: e instanceof Error ? e.message : String(e) }, null, 2));
+        }
+        else {
+            console.error(`✗ ${verb}失败:${e instanceof Error ? e.message : String(e)}`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=graphCommand.js.map

package/dist/commands/graphCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphCommand.js","sourceRoot":"","sources":["../../src/commands/graphCommand.ts"],"names":[],"mappings":"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"}

package/dist/commands/imCommand.d.ts

@@ -0,0 +1,2 @@
+export declare function executeImCommand(): Promise<void>;
+//# sourceMappingURL=imCommand.d.ts.map

package/dist/commands/imCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imCommand.d.ts","sourceRoot":"","sources":["../../src/commands/imCommand.ts"],"names":[],"mappings":"AASA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BtD"}

package/dist/commands/imCommand.js

@@ -0,0 +1,34 @@
+/**
+ * @module        commands/imCommand
+ * @description   `sps im` —— 启动 IM 网关(前台阻塞,像 sps console)。读 ~/.coral/im/config.json,
+ *                加载/启动各平台适配器,把 IM 消息路由到项目命令/(P2)agent 对话。Ctrl+C 优雅停。
+ * @layer         command
+ * @boundedContext im-gateway
+ */
+import { IMGatewayManager } from '../im/IMGatewayManager.js';
+export async function executeImCommand() {
+    const mgr = new IMGatewayManager();
+    const n = mgr.load();
+    if (n === 0) {
+        console.log('  没有可用的 IM 适配器。请配置 ~/.coral/im/config.json,例如:');
+        console.log('  { "adapters": [ { "kind": "telegram", "token": "<BotFather token>", "allowedChatIds": [123456] } ] }');
+        process.exit(1);
+    }
+    const shutdown = async (sig) => {
+        process.stderr.write(`\n[im] ${sig} — 停止网关...\n`);
+        await mgr.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    mgr.start();
+    console.log('');
+    console.log(`  ┌───────────────────────────────────────────────┐`);
+    console.log(`  │  SPS IM Gateway 运行中(${String(n).padEnd(2)} 个适配器)            │`);
+    console.log(`  │  IM 里发 /help 看命令。Ctrl+C 停。             │`);
+    console.log(`  └───────────────────────────────────────────────┘`);
+    console.log('');
+    // 保持进程活到 SIGINT
+    await new Promise(() => { });
+}
+//# sourceMappingURL=imCommand.js.map

package/dist/commands/imCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imCommand.js","sourceRoot":"","sources":["../../src/commands/imCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,wGAAwG,CAAC,CAAC;QACtH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,cAAc,CAAC,CAAC;QAClD,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,gBAAgB;IAChB,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/commands/pipelineTick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipelineTick.d.ts","sourceRoot":"","sources":["../../src/commands/pipelineTick.ts"],"names":[],"mappings":"AAaA,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CA2Df"}
+{"version":3,"file":"pipelineTick.d.ts","sourceRoot":"","sources":["../../src/commands/pipelineTick.ts"],"names":[],"mappings":"AAcA,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/commands/pipelineTick.js

@@ -9,10 +9,19 @@ import { ProcessSupervisor } from '../manager/supervisor.js';
 import { WorkerManagerImpl } from '../manager/worker-manager-impl.js';
 import { createNotifier, createRepoBackend, createTaskBackend } from '../providers/registry.js';
 import { makeBackendFactory } from '../manager/makeBackendFactory.js';
+import { ensureCodexProxyIfNeeded } from '../core/agents/sidecar/CodexProxyManager.js';
 export async function executePipelineTick(project, flags) {
     const log = new Logger('pipeline', project);
     const jsonOutput = !!flags.json;
     const dryRun = !!flags['dry-run'];
+    // codex-proxy(ChatGPT 订阅)worker → 先确保翻译 sidecar 在跑;worker≠codex-proxy 则 no-op。
+    try {
+        await ensureCodexProxyIfNeeded();
+    }
+    catch (err) {
+        log.error(`codex-proxy 启动失败:${err instanceof Error ? err.message : String(err)}`);
+        process.exit(4);
+    }
     let ctx;
     try {
         ctx = ProjectContext.load(project);

package/dist/commands/pipelineTick.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipelineTick.js","sourceRoot":"","sources":["../../src/commands/pipelineTick.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipelineTick.js","sourceRoot":"","sources":["../../src/commands/pipelineTick.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsB3C,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuLhF;AASD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB1D"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsB3C,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA0LhF;AASD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB1D"}

package/dist/commands/setup.js

@@ -226,6 +226,9 @@ export async function executeSetup(flags) {
     console.log('  5. Run health check:');
     console.log('     sps doctor <project-name> --fix');
     console.log('');
+    console.log('  (可选) 无 Claude 订阅?用 ChatGPT 订阅跑 worker:');
+    console.log('     sps codex-proxy install   # 装 claude-code-proxy + 授权,再在控制台模型页选 codex-proxy');
+    console.log('');
     prompt.close();
 }
 // ─── Skill Sync ──────────────────────────────────────────────────