@shgroup/dsh-serenity-hooks 1.27.14 → 1.28.1

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.27.14",
+  "version": "1.28.1",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/handyman/session_rebuild/skiff_admin + 拦截缝机械约束（safe-mode/路径守卫）+ 高级设定面板（双端口网关/账号管理）+ Skiff 认知子集角色（实验性）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。",
   "engines": {
@@ -19,7 +19,8 @@
       "handyman",
       "session_rebuild",
       "localstore",
-      "skiff_admin"
+      "skiff_admin",
+      "autopilot-trajectory"
     ],
     "skills": []
   }

package/lib/{ccc-CfDrlfA7.js → ccc-CX48YNUL.js}

@@ -59,6 +59,24 @@ function resolveInside(root, p) {
 	return abs;
 }
 /**
+* CCC 名：从 .serenity 标记解析——**跳过 # 注释与空行的首个非空行**。
+* 注册表聚合档路径（.opencode/skills/<cccName>/references/mech-registry.json）以此为准，
+* 是 guards/fs-ops/msm-ops/kit-ops 四处解析的唯一真相源（review P2-2 收口，09-05：
+* 原四处分叉——msm-ops/kit-ops 取严格首行、guards/fs-ops 跳注释——首行为注释/空行时
+* register 目标路径与保护路径分叉，潜在隐患）。
+* @returns CCC 名；无标记/读失败/全注释空行 → null
+*/
+function readCccName(root) {
+	try {
+		const marker = resolve(root, ".serenity");
+		if (!existsSync(marker)) return null;
+		const line = readFileSync(marker, "utf-8").split("\n").map((l) => l.trim()).find((l) => l !== "" && !l.startsWith("#"));
+		return line && line !== "" ? line : null;
+	} catch {
+		return null;
+	}
+}
+/**
 * 解析 handyman 配置（v1.24.0：取代 loop.defaultModel；不兼容旧 loop 配置——用户拍板）。
 * @returns 白名单 + 缺省模型 + 上限；models 未配置返回 null（工具应报错要求配置）
 */
@@ -138,4 +156,4 @@ function matchBlacklist(relPath, rules) {
 	return null;
 }
 //#endregion
-export { findSerenityRoot as a, matchBlacklist as c, readHandymanConfig as d, readUtf8 as f, findGitRoot as i, pathInside as l, SAFE_MODE_MARKER as n, isSafeModeOn as o, resolveInside as p, classifyPath as r, loadSerenityConfig as s, DEFAULT_SERENITY_CONFIG_PATHS as t, readBlacklist as u };
+export { findSerenityRoot as a, matchBlacklist as c, readCccName as d, readHandymanConfig as f, findGitRoot as i, pathInside as l, resolveInside as m, SAFE_MODE_MARKER as n, isSafeModeOn as o, readUtf8 as p, classifyPath as r, loadSerenityConfig as s, DEFAULT_SERENITY_CONFIG_PATHS as t, readBlacklist as u };

package/lib/ccc.d.ts

@@ -22,6 +22,15 @@ export type PathClass = 'inside' | 'outside' | 'same';
 export declare function pathInside(rootAbs: string, abs: string, caseInsensitive?: boolean): boolean;
 export declare function classifyPath(p: string, root: string): PathClass;
 export declare function resolveInside(root: string, p: string): string;
+/**
+ * CCC 名：从 .serenity 标记解析——**跳过 # 注释与空行的首个非空行**。
+ * 注册表聚合档路径（.opencode/skills/<cccName>/references/mech-registry.json）以此为准，
+ * 是 guards/fs-ops/msm-ops/kit-ops 四处解析的唯一真相源（review P2-2 收口，09-05：
+ * 原四处分叉——msm-ops/kit-ops 取严格首行、guards/fs-ops 跳注释——首行为注释/空行时
+ * register 目标路径与保护路径分叉，潜在隐患）。
+ * @returns CCC 名；无标记/读失败/全注释空行 → null
+ */
+export declare function readCccName(root: string): string | null;
 export interface SerenityConfig {
     /** handyman（杂工）配置：模型白名单（v1.24.0 取代 loop） */
     handyman?: {

package/lib/client.js

@@ -3206,44 +3206,18 @@ window.__ModuleLoader__.load({
 			return null;
 		}
 		const CONFIG_PATH = "/serenity/config";
-		/**
-		* 获取已有工作区列表（需求 1：白名单从已有工作区选择而非手输）。
-		* 走 DSH 原生 RPC `POST /api/workspace.list`（JSON RPC 形态）。
-		* 信封必须是完整 ClientRequest：`{ type: 'client-request', rpcId, method, payload }`
-		* （api/rpc.ts wire 契约——缺 type/method → clientRequestSchema 校验失败 → bad-request）。
-		* 返回 { path, title }[]；失败返回空数组（面板显示"暂无可选工作区"）。
-		*/
-		async function fetchWorkspaces() {
-			try {
-				const res = await fetch("/api/workspace.list", {
-					method: "POST",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify({
-						type: "client-request",
-						rpcId: `ws-${Date.now().toString(36)}`,
-						method: "workspace.list",
-						payload: {}
-					})
-				});
-				if (!res.ok) return [];
-				const items = (await res.json())?.result?.value?.items;
-				if (!Array.isArray(items)) return [];
-				return items.filter((i) => typeof i.path === "string" && i.path !== "").map((i) => ({
-					path: i.path,
-					title: typeof i.title === "string" && i.title !== "" ? i.title : i.path
-				}));
-			} catch {
-				return [];
-			}
-		}
-		/** GET 配置（含账号列表；无 hash） */
+		/** GET 配置（含账号列表 + knownWorkspaces；无 hash） */
 		async function fetchConfig() {
 			const res = await fetch(CONFIG_PATH, { headers: {
 				accept: "application/json",
 				"x-serenity-ui": "1"
 			} });
 			if (!res.ok) return null;
-			return (await res.json()).config ?? null;
+			const body = await res.json();
+			return {
+				config: body.config ?? null,
+				knownWorkspaces: body.knownWorkspaces ?? []
+			};
 		}
 		/** PUT 配置（账号 patch + 工作区白名单 + persona 彩蛋 + 开放容器白名单）→ 返回保存后的 wire */
 		async function saveConfig(patch) {
@@ -3303,9 +3277,10 @@ window.__ModuleLoader__.load({
 			const [saved, setSaved] = (0, react.useState)(false);
 			(0, react.useEffect)(() => {
 				let alive = true;
-				Promise.all([fetchConfig(), fetchWorkspaces()]).then(([cfg, wss]) => {
+				fetchConfig().then((resp) => {
 					if (!alive) return;
-					setKnownWorkspaces(wss);
+					const cfg = resp?.config ?? null;
+					setKnownWorkspaces(resp?.knownWorkspaces ?? []);
 					if (cfg) {
 						setConfig(cfg);
 						setHost(cfg.gateway.host);
@@ -3734,8 +3709,8 @@ Instruction-following style:
 				let alive = true;
 				fetchConfig().then((cfg) => {
 					if (!alive || !cfg) return;
-					setMode(cfg.persona?.mode ?? "");
-					setOverrideText(cfg.persona?.overrideText ?? "");
+					setMode(cfg.config?.persona?.mode ?? "");
+					setOverrideText(cfg.config?.persona?.overrideText ?? "");
 					setLoaded(true);
 				});
 				return () => {
@@ -3893,7 +3868,7 @@ Instruction-following style:
 					try {
 						const cfg = await fetchConfig();
 						if (!alive) return;
-						setAllowed(cfg?.publicAsk?.allowed ?? []);
+						setAllowed(cfg?.config?.publicAsk?.allowed ?? []);
 					} catch {}
 				})();
 				return () => {
@@ -4737,7 +4712,7 @@ Instruction-following style:
 				scope.set(field, on);
 			};
 			const setThreshold = (v) => {
-				scope.set("rebuildThreshold", Math.min(1, Math.max(.01, v)));
+				scope.set("rebuildThresholdK", Math.min(4e3, Math.max(50, Math.round(v))));
 			};
 			const setSkiffPort = (v) => {
 				scope.set("skiffDebugPort", Math.min(65535, Math.max(1024, Math.round(v))));
@@ -4754,7 +4729,7 @@ Instruction-following style:
 			});
 			const gatewayOn = value?.gatewayEnabled ?? false;
 			const rebuildOn = value?.rebuildEnabled ?? true;
-			const threshold = value?.rebuildThreshold ?? .9;
+			const thresholdK = value?.rebuildThresholdK ?? 400;
 			const skiffOn = value?.skiffEnabled ?? false;
 			const skiffPort = value?.skiffDebugPort ?? 3099;
 			const acpOn = value?.acpEnabled ?? false;
@@ -4796,22 +4771,18 @@ Instruction-following style:
 							})
 						}) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RowCard, {
 							title: "重建阈值",
-							desc: "上下文占用达到该比例时提示（0.10 ~ 1.00）",
-							help: "重建触发阈值（0.10~1.00，默认 0.90）：\n· 含义：上下文占用达到该比例时，轨迹跟踪器开始提醒重建\n· 调低：更早触发（适合长任务，避免上下文耗尽前措手不及）\n· 调高：更晚触发（适合短对话，减少不必要的重建提示）\n· 仅「超限重建」开启时有意义",
-							control: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "ss-threshold",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-									type: "range",
-									min: .1,
-									max: 1,
-									step: .05,
-									value: threshold,
-									disabled: !rebuildOn,
-									onChange: (e) => setThreshold(Number(e.target.value))
-								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: "ss-value",
-									children: threshold.toFixed(2)
-								})]
+							desc: "上下文占用达到该 K 数值时提示（单位 K token，默认 400）",
+							help: "重建触发阈值（需求①：K 数值，默认 400K，范围 50~4000K）：\n· 含义：上下文 projected tokens 达到 thresholdK × 1000 时，轨迹跟踪器开始提醒重建\n· 纯绝对数值（不再依赖窗口比例）——配多大就多大，无窗口上限保护\n· 迁移：旧版 0~1 比例（settings.yaml rebuildThreshold，如 0.9）已废弃并被忽略——\n  请按 K 数值在此重设（如 0.9 → 900）；若从未设置则默认 400K 生效\n· 调低：更早触发（适合长任务，避免上下文耗尽前措手不及）\n· 调高：更晚触发（适合短对话，减少不必要的重建提示）\n· 仅「超限重建」开启时有意义",
+							control: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: "ss-portInput",
+								type: "number",
+								min: 50,
+								max: 4e3,
+								step: 50,
+								value: thresholdK,
+								disabled: !rebuildOn,
+								title: "重建阈值（K token，默认 400）",
+								onChange: (e) => setThreshold(Number(e.target.value))
 							})
 						}) })]
 					}),

package/lib/config-ops.d.ts

@@ -42,12 +42,6 @@ export interface GatewaySettings {
     /** 是否启用 Authenticator 第二因素（v1.22.4；false = TOTP 完全禁用——登录不要求、绑定入口隐藏） */
     totpEnabled: boolean;
 }
-/** F2 超限重建配置 */
-export interface RebuildSettings {
-    enabled: boolean;
-    /** contextPressure 触发比例（0~1） */
-    thresholdRatio: number;
-}
 /** 彩蛋功能：persona 模式（v1.23.1，S142 用户需求）
  * 配置后替换 ACC 系统提示词中"输出约束/指令遵循约束"部分（EAP 块 + MSM 原则段）；
  * 未配置（mode 空）→ 完全默认行为，零影响。 */
@@ -66,10 +60,15 @@ export interface PublicAskSettings {
     /** 开放容器白名单（CCC 目录名，如 home-serenity）；空数组 = 全部容器开放 */
     allowed: string[];
 }
-/** 高级设定全量（localstore.json 持久化形态；passHash 含 hash） */
+/**
+ * 高级设定全量（~/.dsh/serenity-hooks.json 持久化形态；passHash 含 hash）。
+ * review P2-3：**rebuild 已从高级配置删除**——rebuild 开关/阈值归"简单配置"
+ * （settings.yaml 原生面板，见 settings-section.ts），运行时只读 readSimpleSettings()；
+ * 旧高级 rebuild 字段是死双胞胎（/serenity/config PUT 回显但运行时从不读它）——
+ * 删除防误导（用户在高级面板改了却无效）。历史残留字段被 mergeWithDefaults 忽略（幂等安全）。
+ */
 export interface AdvancedSettings {
     gateway: GatewaySettings;
-    rebuild: RebuildSettings;
     persona: PersonaSettings;
     publicAsk: PublicAskSettings;
 }
@@ -131,7 +130,7 @@ export interface GatewayAccountWire {
     /** 该账号是否已绑定 TOTP（v1.22.4） */
     hasTotp: boolean;
 }
-/** 设定 wire 形态（GET /serenity/config 返回；rebuild 同持久化，gateway 去 hash） */
+/** 设定 wire 形态（GET /serenity/config 返回；gateway 去 hash） */
 export interface AdvancedSettingsWire {
     gateway: {
         enabled: boolean;
@@ -143,7 +142,6 @@ export interface AdvancedSettingsWire {
         allowWorkspaceCreate: boolean;
         totpEnabled: boolean;
     };
-    rebuild: RebuildSettings;
     persona: PersonaSettings;
     publicAsk: {
         /** 开放容器白名单（v1.26.2：容器名数组；空 = 全部开放） */
@@ -152,6 +150,19 @@ export interface AdvancedSettingsWire {
 }
 /** 持久化 → wire（剥离 passHash/totpSecret；只留布尔） */
 export declare function toWire(settings: AdvancedSettings): AdvancedSettingsWire;
+/**
+ * 已知工作区投影（v1.28.0 适配 0.1.2-rc.1 A2 方案 A′）：
+ * rc.1 workspace.list unary 删除 → AccountsEditor 白名单下拉的数据源改走 gateway 自有
+ * /serenity/config 的 knownWorkspaces（host workspaceRegistry.list() 投影，白名单过滤）。
+ * 纯函数可单测。allowPrefixes 空 = 全部放行（向后兼容默认）。
+ */
+export declare function projectKnownWorkspaces(workspaces: Array<{
+    path?: string;
+    title?: string;
+}>, allowPrefixes: readonly string[]): Array<{
+    path: string;
+    title: string;
+}>;
 /**
  * wire → 持久化（面板 PUT 用）：
  * accounts 元素可选带 `pass`：非空 → 重新 hash；空/缺省 → 保留现有 hash（按 id 匹配）。

package/lib/index.d.ts

@@ -14,7 +14,8 @@
 import type { Context } from 'cordis';
 import z from '@deepseek-ai/schemastery';
 export declare const name = "dsh-serenity-hooks";
-/** 主动调用的服务；其余（agent 事件）随 harness 装配必然存在 */
+/** 主动调用的服务；其余（agent 事件）随 harness 装配必然存在
+ *  （v1.28.0 适配 0.1.2-rc.1：+ 'settings'——B4 settings 服务由 provider 插件加载后才有） */
 export declare const inject: string[];
 /** 插件配置（cordis.yml 提供；进程级） */
 export interface Config {
@@ -47,7 +48,7 @@ export interface Config {
     /** F2 超限重建（entry 默认值，运行时经 DSH settings） */
     rebuild?: {
         enabled?: boolean;
-        thresholdRatio?: number;
+        thresholdK?: number;
     };
     /** F4 Skiff（实验性）：调试服务启停（entry 默认值，运行时经 DSH settings） */
     skiff?: {