@coralai/sps-cli 0.89.19 → 0.89.21

package/docs/help/05-api.md

@@ -2,7 +2,7 @@
 title: 开放 API
 generated: true
 source: src/console/routes/*.ts
-version: 0.89.19
+version: 0.89.21
 ---
 
 # 开放 API
@@ -10,7 +10,7 @@ version: 0.89.19
 > ⚠️ **本页由 `scripts/gen-help-api.mjs` 从路由代码扫出,不要手改。**
 > 门禁 `check:help` 会在代码与本页不一致时报红。
 
-共 **177** 条路由(其中 110 条尚无说明)。版本 `0.89.19`。
+共 **175** 条路由(其中 110 条尚无说明)。版本 `0.89.21`。
 
 > ℹ️ 口径:这里**逐条列**(同一路径的不同方法算两条)。门禁 `check:api-docs` 报的是
 > **归一去重后的唯一路径数**,两个数字不相等是正常的 —— 别拿它们互相"对账"。
@@ -173,7 +173,6 @@ version: 0.89.19
 | `GET` | `/api/memory/entries` | — |
 | `GET` | `/api/memory/recall` | — |
 | `GET` | `/api/memory/digest` | — |
-| `GET` | `/api/memory/external` | 外部派生智能(agentmemory profile + graph);external 未启用返 {profile:null,graph:null}。 |
 | `GET` | `/api/memory/entries/:id` | — |
 | `POST` | `/api/memory/entries` | — |
 | `DELETE` | `/api/memory/entries/:id` | — |
@@ -378,7 +377,6 @@ version: 0.89.19
 
 | 方法 | 路径 | 说明 |
 |---|---|---|
-| `GET` | `/api/memory-cfg` | 记忆 viewer 配置:设了 SPS_CONSOLE_MEMORY_VIEWER_URL(如 https://mem.coralbot.top,反代 agentmemory 仪表板 :3113)→ 前端 iframe 内嵌该仪表板;没设  |
 | `GET` | `/docs` | — |
 | `GET` | `/docs/*` | 命不中静态文件 → 回 docs 的 404 页(而不是落到 console SPA)。 |
 | `GET` | `/` | — |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-cli",
-  "version": "0.89.19",
+  "version": "0.89.21",
   "description": "SPS CLI — AI-driven development pipeline orchestrator",
   "type": "module",
   "main": "dist/main.js",
@@ -27,6 +27,7 @@
     "build:packages": "for d in packages/*/; do (cd \"$d\" && npx tsc -p tsconfig.json) || exit 1; done",
     "build:seam-clients": "node scripts/build-seam-clients.mjs",
     "gen:help": "node scripts/gen-help-commands.mjs && node scripts/gen-help-api.mjs",
+    "version": "npm run gen:help && git add docs/help",
     "check:help": "node scripts/gen-help-commands.mjs --check && node scripts/gen-help-api.mjs --check"
   },
   "engines": {

package/dist/core/memory2/external/agentMemory.d.ts

@@ -1,35 +0,0 @@
-/** external 是否启用:mode 含 external + 配了 URL。 */
-export declare function externalEnabled(): boolean;
-export interface ExternalHit {
-    id: string;
-    title: string;
-    score: number;
-    type?: string;
-    timestamp?: string;
-}
-/** 相关性检索 agentmemory(POST /smart-search)。不可用/失败 → 返 []。 */
-export declare function externalRecall(query: string, limit?: number): Promise<ExternalHit[]>;
-/** 尽力把一条记忆镜像进 agentmemory(POST /remember)。project 让其 per-project profile/graph 能按项目归类。
- *  fire-and-forget,返回是否成功(仅日志用)。注:线上实例 type/tags 不认,只可靠 content+project+title。 */
-export declare function externalRemember(content: string, opts?: {
-    title?: string;
-    project?: string;
-}): Promise<boolean>;
-/** 转发一条 worker 工具观测到 agentmemory(POST /observe),喂它的 profile/graph 长出跨会话智能。
- *  红线:只送归一化事件里有的 toolName/detail,不碰 jsonl(无 tool 完整 input/output)。best-effort。 */
-export declare function externalObserve(o: {
-    sessionId: string;
-    project: string;
-    cwd: string;
-    toolName: string;
-    output?: string;
-}): Promise<boolean>;
-/** 项目画像:top 概念/文件/惯例/常见错。null=不可用。 */
-export declare function externalProfile(project: string): Promise<unknown | null>;
-/** 知识图谱查询(BFS 遍历)。返回 {edges,depth} 或 null。 */
-export declare function externalGraph(query?: Record<string, unknown>): Promise<unknown | null>;
-/** 抽取的实体关系。 */
-export declare function externalRelations(limit?: number): Promise<unknown | null>;
-/** 识别的重复模式(按 project)。 */
-export declare function externalPatterns(project: string): Promise<unknown | null>;
-//# sourceMappingURL=agentMemory.d.ts.map

package/dist/core/memory2/external/agentMemory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentMemory.d.ts","sourceRoot":"","sources":["../../../../src/core/memory2/external/agentMemory.ts"],"names":[],"mappings":"AAWA,8CAA8C;AAC9C,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AA6BD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CASrF;AAED;kFACkF;AAClF,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzH;AAED;kFACkF;AAClF,wBAAsB,eAAe,CAAC,CAAC,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACpF,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB;AAoBD,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAI9E;AAED,8CAA8C;AAC9C,wBAAsB,aAAa,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGhG;AAED,eAAe;AACf,wBAAsB,iBAAiB,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAI3E;AAED,0BAA0B;AAC1B,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAI/E"}

package/dist/core/memory2/external/agentMemory.js

@@ -1,127 +0,0 @@
-/**
- * @module        core/memory2/external/agentMemory
- * @description   external 后端适配器:agentmemory(设计 §8 的 external/local+external)。
- *                读 = POST /smart-search;写 = POST /remember(content 必填)。**本地始终真源**,
- *                此适配器是可选增补:读做候选合并、写做尽力镜像,**任何失败/超时都静默降级、绝不阻断**
- *                (agentmemory 后端本身可能抖动)。URL 取 SPS_MEMORY_EXTERNAL_URL;mode 含 external 才启用。
- * @layer         core
- * @boundedContext memory
- */
-import { memoryEnv, memoryMode } from '../config.js';
-/** external 是否启用:mode 含 external + 配了 URL。 */
-export function externalEnabled() {
-    const m = memoryMode();
-    return (m === 'external' || m === 'local+external') && !!externalUrl();
-}
-function externalUrl() {
-    return (memoryEnv('SPS_MEMORY_EXTERNAL_URL') ?? '').replace(/\/+$/, '');
-}
-const RECALL_TIMEOUT_MS = 2500;
-const WRITE_TIMEOUT_MS = 3000;
-async function postJson(path, body, timeoutMs) {
-    const url = externalUrl();
-    if (!url)
-        return null;
-    const ac = new AbortController();
-    const timer = setTimeout(() => ac.abort(), timeoutMs);
-    try {
-        const r = await fetch(`${url}${path}`, {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify(body),
-            signal: ac.signal,
-        });
-        if (!r.ok)
-            return null;
-        return await r.json();
-    }
-    catch {
-        return null; // 超时 / 网络 / 解析失败 → 静默降级
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-/** 相关性检索 agentmemory(POST /smart-search)。不可用/失败 → 返 []。 */
-export async function externalRecall(query, limit = 6) {
-    if (!externalEnabled() || !query.trim())
-        return [];
-    const data = await postJson('/smart-search', { query, limit }, RECALL_TIMEOUT_MS);
-    if (!data?.results)
-        return [];
-    return data.results
-        .filter((r) => r.obsId && r.title)
-        .map((r) => ({ id: `ext:${r.obsId}`, title: String(r.title), score: Number(r.score ?? 0), type: r.type, timestamp: r.timestamp }));
-}
-/** 尽力把一条记忆镜像进 agentmemory(POST /remember)。project 让其 per-project profile/graph 能按项目归类。
- *  fire-and-forget,返回是否成功(仅日志用)。注:线上实例 type/tags 不认,只可靠 content+project+title。 */
-export async function externalRemember(content, opts = {}) {
-    if (!externalEnabled() || !content.trim())
-        return false;
-    const body = { content };
-    if (opts.title)
-        body.title = opts.title;
-    if (opts.project)
-        body.project = opts.project;
-    const data = await postJson('/remember', body, WRITE_TIMEOUT_MS);
-    return data != null;
-}
-/** 转发一条 worker 工具观测到 agentmemory(POST /observe),喂它的 profile/graph 长出跨会话智能。
- *  红线:只送归一化事件里有的 toolName/detail,不碰 jsonl(无 tool 完整 input/output)。best-effort。 */
-export async function externalObserve(o) {
-    if (!externalEnabled())
-        return false;
-    const data = await postJson('/observe', {
-        hookType: 'PostToolUse', sessionId: o.sessionId, project: o.project, cwd: o.cwd,
-        timestamp: `${Date.now()}`, toolName: o.toolName, output: o.output ?? '',
-    }, WRITE_TIMEOUT_MS);
-    return data != null;
-}
-async function getJson(path, timeoutMs = RECALL_TIMEOUT_MS) {
-    const url = externalUrl();
-    if (!url)
-        return null;
-    const ac = new AbortController();
-    const timer = setTimeout(() => ac.abort(), timeoutMs);
-    try {
-        const r = await fetch(`${url}${path}`, { signal: ac.signal });
-        if (!r.ok)
-            return null;
-        return await r.json();
-    }
-    catch {
-        return null;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-// ─── 派生智能(agentmemory 跨会话算出、本地产不出的)——只读,external 启用才有 ───
-/** 项目画像:top 概念/文件/惯例/常见错。null=不可用。 */
-export async function externalProfile(project) {
-    if (!externalEnabled() || !project)
-        return null;
-    const d = await getJson(`/profile?project=${encodeURIComponent(project)}`);
-    return d?.profile ?? null;
-}
-/** 知识图谱查询(BFS 遍历)。返回 {edges,depth} 或 null。 */
-export async function externalGraph(query = {}) {
-    if (!externalEnabled())
-        return null;
-    return postJson('/graph/query', query, RECALL_TIMEOUT_MS);
-}
-/** 抽取的实体关系。 */
-export async function externalRelations(limit = 20) {
-    if (!externalEnabled())
-        return null;
-    const d = await getJson(`/relations?limit=${limit}`);
-    return d?.relations ?? null;
-}
-/** 识别的重复模式(按 project)。 */
-export async function externalPatterns(project) {
-    if (!externalEnabled() || !project)
-        return null;
-    const d = await postJson('/patterns', { project }, RECALL_TIMEOUT_MS);
-    return d?.patterns ?? null;
-}
-//# sourceMappingURL=agentMemory.js.map

package/dist/core/memory2/external/agentMemory.js.map

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

package/dist/core/memory2/external/federate.d.ts

@@ -1,23 +0,0 @@
-import type { ScopeRef } from '../types.js';
-export interface FederatedHit {
-    id: string;
-    source: 'local' | 'external';
-    title: string;
-    snippet: string;
-    score: number;
-    scope?: string;
-    project?: string;
-    category?: string;
-    tags?: string[];
-    type?: string;
-}
-/**
- * 融合召回:本地(含 FTS)+ agentmemory,RRF 交错。mode 决定权重:
- * - local:纯本地;external:纯外部;local+external:两者 RRF 合并。
- * external 关或不可用时自动只出本地。
- */
-export declare function recallFederated(refs: ScopeRef[], query: string, opts?: {
-    tags?: string[];
-    limit?: number;
-}): Promise<FederatedHit[]>;
-//# sourceMappingURL=federate.d.ts.map

package/dist/core/memory2/external/federate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"federate.d.ts","sourceRoot":"","sources":["../../../../src/core/memory2/external/federate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,YAAY,EAAE,CAAC,CA0BzB"}

package/dist/core/memory2/external/federate.js

@@ -1,43 +0,0 @@
-/**
- * @module        core/memory2/external/federate
- * @description   local+external 召回融合(设计 §8)。本地 BM25 分与 agentmemory cosine 分**不可比**,
- *                用 RRF(Reciprocal Rank Fusion)只按各自排名交错,天然归一。external 未启用 → 纯本地。
- *                external 失败/超时 → 静默退化为纯本地(externalRecall 内部已兜底返 [])。
- * @layer         core
- * @boundedContext memory
- */
-import { recall } from '../retrieve.js';
-import { externalEnabled, externalRecall } from './agentMemory.js';
-const RRF_K = 60;
-/**
- * 融合召回:本地(含 FTS)+ agentmemory,RRF 交错。mode 决定权重:
- * - local:纯本地;external:纯外部;local+external:两者 RRF 合并。
- * external 关或不可用时自动只出本地。
- */
-export async function recallFederated(refs, query, opts = {}) {
-    const limit = opts.limit ?? 6;
-    const mode = externalEnabled();
-    const local = recall(refs, query, { tags: opts.tags, limit: limit * 2 });
-    const localHits = local.map((h, i) => ({
-        id: `local:${h.entry.id}`, source: 'local', title: h.entry.title,
-        snippet: h.entry.body.slice(0, 200), score: 1 / (RRF_K + i),
-        scope: h.entry.scope, project: h.entry.project, category: h.entry.category, tags: h.entry.tags,
-    }));
-    if (!mode)
-        return localHits.slice(0, limit).map((h, i) => ({ ...h, score: 1 / (RRF_K + i) }));
-    const ext = await externalRecall(query, limit * 2);
-    const extHits = ext.map((e, i) => ({
-        id: e.id, source: 'external', title: e.title, snippet: e.title, score: 1 / (RRF_K + i), type: e.type,
-    }));
-    // RRF 合并:两列表各自 1/(k+rank),同 id 相加(此处两列 id 空间不交,等于公平交错)。
-    const merged = new Map();
-    for (const h of [...localHits, ...extHits]) {
-        const prev = merged.get(h.id);
-        if (prev)
-            prev.score += h.score;
-        else
-            merged.set(h.id, { ...h });
-    }
-    return [...merged.values()].sort((a, b) => b.score - a.score).slice(0, limit);
-}
-//# sourceMappingURL=federate.js.map

package/dist/core/memory2/external/federate.js.map

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

package/dist/core/memory2/external/importTranscript.d.ts

@@ -1,7 +0,0 @@
-/**
- * best-effort 把某会话 transcript 导入 agentmemory。异步 spawn,立即返回,失败静默。
- * @param cwd       worker 的工作目录(游戏 repo)——用于定位 claude transcript 目录。
- * @param sessionId 该 worker 的 claude sessionId。
- */
-export declare function importSessionToExternal(cwd: string, sessionId: string | null | undefined): void;
-//# sourceMappingURL=importTranscript.d.ts.map

package/dist/core/memory2/external/importTranscript.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"importTranscript.d.ts","sourceRoot":"","sources":["../../../../src/core/memory2/external/importTranscript.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAY/F"}

package/dist/core/memory2/external/importTranscript.js

@@ -1,44 +0,0 @@
-/**
- * @module        core/memory2/external/importTranscript
- * @description   方案 C:卡/会话完成时,把该 worker 会话的**完整 claude transcript** 交给
- *                `agentmemory import-jsonl` 导入 → agentmemory 用它自己的 LLM 压成全 I/O 观测、按项目归类
- *                (补齐 agentmemory 的 session/timeline/profile/graph)。
- *                🔴 红线:sps **不解析 jsonl**,只用现成 sanctioned helper(runtimePaths.claudeJsonlFile)定位路径,
- *                把路径交给 agentmemory 自己读。best-effort、异步、失败静默、不阻断流水线。
- *                门控:external 启用 + SPS_MEMORY_IMPORT=on + `agentmemory` CLI 存在。import-jsonl 自带 dedup,重导安全。
- * @layer         core
- * @boundedContext memory
- */
-import { execFile } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { claudeJsonlFile } from '../../../shared/runtimePaths.js';
-import { memoryEnv } from '../config.js';
-import { externalEnabled } from './agentMemory.js';
-/** 是否启用完成时导入(SPS_MEMORY_IMPORT=on 且 external 启用)。 */
-function importEnabled() {
-    return externalEnabled() && (memoryEnv('SPS_MEMORY_IMPORT') ?? '').toLowerCase() === 'on';
-}
-let cliMissing = false; // 探测过一次 agentmemory 不存在就不再试
-/**
- * best-effort 把某会话 transcript 导入 agentmemory。异步 spawn,立即返回,失败静默。
- * @param cwd       worker 的工作目录(游戏 repo)——用于定位 claude transcript 目录。
- * @param sessionId 该 worker 的 claude sessionId。
- */
-export function importSessionToExternal(cwd, sessionId) {
-    if (cliMissing || !importEnabled() || !sessionId || !cwd)
-        return;
-    const file = claudeJsonlFile(cwd, sessionId); // 现成 helper,不自算编码
-    if (!existsSync(file))
-        return;
-    try {
-        execFile('agentmemory', ['import-jsonl', file], { timeout: 180000 }, (err) => {
-            // ENOENT = 没装 agentmemory CLI → 标记,后续不再试。其余失败静默(best-effort)。
-            if (err && err.code === 'ENOENT')
-                cliMissing = true;
-        });
-    }
-    catch {
-        /* spawn 失败也静默 */
-    }
-}
-//# sourceMappingURL=importTranscript.js.map

package/dist/core/memory2/external/importTranscript.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"importTranscript.js","sourceRoot":"","sources":["../../../../src/core/memory2/external/importTranscript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,qDAAqD;AACrD,SAAS,aAAa;IACpB,OAAO,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;AAC5F,CAAC;AAED,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,4BAA4B;AAEpD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,SAAoC;IACvF,IAAI,UAAU,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG;QAAE,OAAO;IACjE,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,kBAAkB;IAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,IAAI,CAAC;QACH,QAAQ,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3E,8DAA8D;YAC9D,IAAI,GAAG,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,UAAU,GAAG,IAAI,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC"}