@shgroup/dsh-serenity-hooks 1.16.6 → 1.16.8

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.16.6",
+  "version": "1.16.8",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫/会话落盘）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/index.js

@@ -1,6 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { appendFileSync, chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { appendFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
 import { homedir, platform } from "node:os";
@@ -12,7 +12,7 @@ import { randomBytes, randomUUID } from "node:crypto";
 /**
 * ccc.ts — CCC 纯逻辑层（零 DSH 依赖，可独立单测）
 *
-* 职责：CCC 根检测（P1）、git 检测（P2）、.dsh/serenity.json 配置读取、
+* 职责：CCC 根检测（P1）、git 检测（P2）、serenity.json 配置读取（.opencode 规范位置，.dsh 回退）、
 * 路径守卫（P3 语义）、安全模式黑名单匹配。
 *
 * 由 tools/ 与 seams/ 复用；逻辑移植自 dsh-serenity-plugin v0.1-v0.2
@@ -66,7 +66,11 @@ function resolveInside(root, p) {
 	if (classifyPath(abs, root) === "outside") throw new Error(`Path escape blocked: "${p}" resolves outside "${root}"`);
 	return abs;
 }
-const DEFAULT_SERENITY_CONFIG_PATHS = [".dsh/serenity.json", ".opencode/serenity.json"];
+/**
+* ACC 依赖的 CCC 配置路径（S134 修正：兼容历史——历史在 .opencode，规范位置 = .opencode；
+* .dsh 仅作 dsh 运行时回退，不优先）。
+*/
+const DEFAULT_SERENITY_CONFIG_PATHS = [".opencode/serenity.json", ".dsh/serenity.json"];
 function loadSerenityConfig(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
 	for (const candidate of paths) {
 		const p = resolve(root, candidate);
@@ -301,7 +305,7 @@ function runCcFs(root, args) {
 * 进程内注册（取代 v0.1 的 bash spawn runner）：zod/schemastery 参数校验、
 * 规范 JSON 输出、纯 render 投影。逻辑在 fs-ops.ts（可单测）。
 */
-function agentCwd$6(exec) {
+function agentCwd$7(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
 function renderText$9(value) {
@@ -359,7 +363,7 @@ const ccFsTool = defineTool({
 		render: (args, value) => renderText$9(value)
 	},
 	async execute(args, exec) {
-		const root = findSerenityRoot(agentCwd$6(exec));
+		const root = findSerenityRoot(agentCwd$7(exec));
 		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 		return runCcFs(root, args);
 	}
@@ -983,7 +987,7 @@ function appendHeartbeat(sessionMd) {
 * AGENT_SESSIONS/ 全周期管理：list/show/create/health/qa/archive/summary。
 * 逻辑在 session-ops.ts（可单测）。
 */
-function agentCwd$5(exec) {
+function agentCwd$6(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
 /** 当前 dsh 会话 id（use/close 按会话隔离的 scope） */
@@ -1024,7 +1028,7 @@ const sessionTool = defineTool({
 		render: (args, value) => renderText$8(value)
 	},
 	async execute(args, exec) {
-		const root = findSerenityRoot(agentCwd$5(exec));
+		const root = findSerenityRoot(agentCwd$6(exec));
 		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 		if (findEntry(root, "session-tool")) {
 			const r = runMsm(root, {
@@ -1346,7 +1350,7 @@ async function runKit(root, args) {
 /**
 * kit.ts — acc_kit 真实 DSH 工具定义（defineTool）
 */
-function agentCwd$4(exec) {
+function agentCwd$5(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
 function renderText$7(value) {
@@ -1375,12 +1379,284 @@ const kitTool = defineTool({
 		render: (args, value) => renderText$7(value)
 	},
 	async execute(args, exec) {
-		const root = findSerenityRoot(agentCwd$4(exec));
+		const root = findSerenityRoot(agentCwd$5(exec));
 		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 		return await runKit(root, args);
 	}
 });
 //#endregion
+//#region src/localstore-ops.ts
+/**
+* localstore-ops.ts — localstore 纯逻辑层（零 DSH 依赖，可独立单测）
+*
+* S134 重设计（v1.16.7）：存储从 ~/.serenity/ 迁到 **CCC 根根目录 localstore.json**
+* （JSON 格式——方便 MSM 直接 read + JSON.parse 读取，零解析依赖）。
+*
+* git 提交策略（可靠机制 × 用户自由）：
+*   - 配置：.opencode/serenity.json `localstore.gitTrack`: "allow"（可提交）| "deny"（禁提交）
+*   - **缺省 deny（没配就是不提交）**；且 deny 的保证**不依赖 dsh 运行**——
+*     写入时自动确保 .gitignore 含 localstore.json（物理保证：即使 dsh 不在、
+*     用户手动 git commit 也不会误提交），cc_git 检查为第二道防线（拒绝 + 提示）
+*   - allow：放行（文件可提交，用户自行管理 .gitignore）
+*
+* 存储结构（JSON 顶层分节）：
+*   { "credentials": { "HOME_GITLAB_TOKEN": "xxx" }, "<config节>": { "<key>": "v" } }
+*   credentials 为保留节（credential 命名空间，key 大写蛇形）；其余节归 config 命名空间
+*   （path = section.key，如 loop.defaultModel）。
+*/
+const LOCALSTORE_SCOPES = ["credential", "config"];
+/** 存储文件名（CCC 根根目录） */
+const LOCALSTORE_FILENAME = "localstore.json";
+/** 凭据保留节名（JSON 顶层） */
+const CREDENTIALS_SECTION = "credentials";
+/** 凭据 key 规范：大写蛇形，如 HOME_GITLAB_TOKEN */
+const CREDENTIAL_KEY_RE = /^[A-Z][A-Z0-9_]*$/;
+/** 配置节名规范：小写字母数字连字符 */
+const CONFIG_SECTION_RE = /^[a-z][a-z0-9-]*$/;
+/** 配置 key 规范（节内）：小驼峰，如 defaultModel */
+const CONFIG_KEY_RE = /^[a-z][a-zA-Z0-9_]*$/;
+/** 存储文件绝对路径（CCC 根根目录） */
+function localstorePath(root) {
+	return join(root, LOCALSTORE_FILENAME);
+}
+/** git 策略：serenity.json localstore.gitTrack，缺省 deny（不提交） */
+function readGitTrack(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	return loadSerenityConfig(root, paths).localstore?.gitTrack === "allow" ? "allow" : "deny";
+}
+/** .gitignore 是否已覆盖 localstore 文件（非空非注释行含文件名即算） */
+function isLocalstoreGitignored(root) {
+	const gi = join(root, ".gitignore");
+	if (!existsSync(gi)) return false;
+	return readFileSync(gi, "utf-8").split("\n").some((l) => {
+		const t = l.trim();
+		return t !== "" && !t.startsWith("#") && t.includes("localstore.json");
+	});
+}
+/**
+* 确保 .gitignore 含 localstore 文件（deny 时的物理保证，不依赖 dsh 运行）：
+* 写入 localstore 时调用——deny（含缺省）且 .gitignore 未覆盖 → 自动追加一行。
+* allow → 不写入（放行，文件可提交）。
+*/
+function ensureLocalstoreGitignored(root) {
+	if (readGitTrack(root) === "allow") return { status: "allow" };
+	if (isLocalstoreGitignored(root)) return { status: "ignored" };
+	const gi = join(root, ".gitignore");
+	const existing = existsSync(gi) ? readFileSync(gi, "utf-8") : "";
+	const line = `${LOCALSTORE_FILENAME}  # ACC localstore（localstore.gitTrack 缺省 deny，禁提交）`;
+	writeFileSync(gi, (existing.endsWith("\n") || existing === "" ? existing : existing + "\n") + line + "\n", "utf-8");
+	return { status: "appended" };
+}
+/**
+* cc_git 联动检查（第二道防线）：文件存在 && deny && .gitignore 未覆盖 → 不通过。
+* 调用方（cc_git commit）据此拒绝提交；status 可输出 warning。
+*/
+function checkLocalstoreGitCompliance(root) {
+	if (!existsSync(localstorePath(root))) return { ok: true };
+	if (readGitTrack(root) === "allow") return { ok: true };
+	if (isLocalstoreGitignored(root)) return { ok: true };
+	return {
+		ok: false,
+		reason: `localstore.json 禁止提交（localstore.gitTrack=deny 缺省）但 .gitignore 未包含——请将 ${LOCALSTORE_FILENAME} 加入 .gitignore（或改配置 localstore.gitTrack=allow 显式放行）`
+	};
+}
+/** 读取全文件（顶层分节）；文件不存在/坏 JSON 返回空 */
+function readAll(root) {
+	const p = localstorePath(root);
+	if (!existsSync(p)) return {};
+	try {
+		const v = JSON.parse(readFileSync(p, "utf-8"));
+		if (v && typeof v === "object" && !Array.isArray(v)) return v;
+		return {};
+	} catch {
+		return {};
+	}
+}
+/** 写回全文件（2 空格缩进 + 尾换行，方便 MSM 直接读取） */
+function writeAll(root, data) {
+	writeFileSync(localstorePath(root), JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+/** 读取命名空间全部条目：credential → 扁平；config → 分节（剔除 credentials 保留节） */
+function readStore(root, scope) {
+	const all = readAll(root);
+	if (scope === "credential") return all["credentials"] ?? {};
+	const { [CREDENTIALS_SECTION]: _cred, ...rest } = all;
+	return rest;
+}
+/** 校验凭据 key 合法（大写蛇形）；不合法抛错 */
+function assertCredentialKey(key) {
+	if (!CREDENTIAL_KEY_RE.test(key)) throw new Error(`credential key "${key}" 必须匹配大写蛇形 ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）`);
+}
+/** 校验 config 路径（节.key）；不合法抛错 */
+function assertConfigPath(path) {
+	const idx = path.indexOf(".");
+	if (idx <= 0 || idx === path.length - 1) throw new Error(`config path "${path}" 必须为 section.key（如 loop.defaultModel）`);
+	const section = path.slice(0, idx);
+	const key = path.slice(idx + 1);
+	if (!CONFIG_SECTION_RE.test(section)) throw new Error(`config 节 "${section}" 必须匹配 ^[a-z][a-z0-9-]*$`);
+	if (!CONFIG_KEY_RE.test(key)) throw new Error(`config key "${key}" 必须匹配小驼峰 ^[a-z][a-zA-Z0-9_]*$（如 defaultModel）`);
+	return {
+		section,
+		key
+	};
+}
+/** 写入单个条目（自动建文件；deny 默认时同步确保 .gitignore 物理保证） */
+function writeEntry(root, scope, name, value) {
+	const all = readAll(root);
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		all[CREDENTIALS_SECTION] ??= {};
+		all[CREDENTIALS_SECTION][name] = value;
+	} else {
+		const { section, key } = assertConfigPath(name);
+		all[section] ??= {};
+		all[section][key] = value;
+	}
+	writeAll(root, all);
+	ensureLocalstoreGitignored(root);
+}
+/** 删除单个条目（不存在返回 false）；空节自动移除 */
+function unsetEntry(root, scope, name) {
+	const all = readAll(root);
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		const sec = all[CREDENTIALS_SECTION];
+		if (!sec || !(name in sec)) return false;
+		delete sec[name];
+		if (Object.keys(sec).length === 0) delete all[CREDENTIALS_SECTION];
+	} else {
+		const { section, key } = assertConfigPath(name);
+		const sec = all[section];
+		if (!sec || !(key in sec)) return false;
+		delete sec[key];
+		if (Object.keys(sec).length === 0) delete all[section];
+	}
+	writeAll(root, all);
+	return true;
+}
+/** 读取单个条目值；不存在返回 null */
+function getEntry(root, scope, name) {
+	const all = readAll(root);
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		return all["credentials"]?.[name] ?? null;
+	}
+	const { section, key } = assertConfigPath(name);
+	return all[section]?.[key] ?? null;
+}
+/** 列出 key（凭据只返回 key 名，不返回值） */
+function listKeys(root, scope) {
+	const data = readStore(root, scope);
+	if (scope === "credential") return Object.keys(data);
+	return Object.entries(data).flatMap(([section, entries]) => Object.keys(entries).map((key) => `${section}.${key}`));
+}
+/**
+* doc 说明文本：输出存储位置/格式/key 规范/git 策略/读写方法。
+* agent 据此可直接用 fs 工具（read/write）自己读写凭据/配置。
+*/
+function docText(root) {
+	const path = localstorePath(root);
+	return [
+		"# localstore — ACC 本地凭据/配置存储（标准，S134 重设计）",
+		"",
+		"一个工具管理两个命名空间：credential（凭据）+ config（偏好）。",
+		`存储于 CCC 根根目录 ${path}（JSON 格式，MSM 可直接 read + JSON.parse）。`,
+		"",
+		"## git 提交策略",
+		"- 配置：.opencode/serenity.json `localstore.gitTrack`：`\"allow\"`（可提交）| `\"deny\"`（禁提交；.dsh 回退）",
+		"- **缺省 deny（没配就是不提交）**；deny 时写入会自动确保 .gitignore 含 localstore.json",
+		"  （物理保证，不依赖 dsh 运行）；cc_git commit 会检查拒绝",
+		"- 想提交：配置 `\"localstore\": { \"gitTrack\": \"allow\" }`，并从 .gitignore 移除 localstore.json",
+		"",
+		"## 格式（JSON 顶层分节）",
+		"```json",
+		"{",
+		"  \"credentials\": {",
+		"    \"HOME_GITLAB_TOKEN\": \"xxx\"",
+		"  },",
+		"  \"loop\": {",
+		"    \"defaultModel\": \"minimax-cn-coding-plan/MiniMax-M3\"",
+		"  }",
+		"}",
+		"```",
+		"- credentials 为保留节（凭据，key 大写蛇形）；其余节 = config（path = section.key）",
+		"",
+		"## key 规范",
+		"- credential key: ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）",
+		"- config path: section.key（节 ^[a-z][a-z0-9-]*$，key 小驼峰 ^[a-z][a-zA-Z0-9_]*$，如 loop.defaultModel）",
+		"",
+		"## 读取方法（agent 可直接用 fs 工具）",
+		`- 用 read 工具读 ${path} → JSON.parse 解析`,
+		"- 或用 localstore get <name> [--scope credential|config]",
+		"",
+		"## 写入方法",
+		"- 推荐：localstore set <name> <value> [--scope ...]（自动建文件/保留其他条目/联动 .gitignore）",
+		"- 或直接用 write/edit 工具修改文件，保持 JSON 合法",
+		"",
+		"## 安全边界",
+		"- list/show 对 credential 只返回 key 名，不返回值",
+		"- 凭据值应在 agent 内部使用，不要写入对话/日志",
+		"- 默认 deny：文件不会提交 git（.gitignore 物理保证 + cc_git 检查兜底）",
+		""
+	].join("\n");
+}
+/** 运行 localstore 操作（纯逻辑；返回 JSON 值供工具 render） */
+function runLocalStore(root, args) {
+	const scope = args.scope === "config" ? "config" : "credential";
+	switch (args.action) {
+		case "list": return {
+			scope,
+			keys: listKeys(root, scope)
+		};
+		case "get": {
+			if (!args.name) throw new Error("get 需要 name");
+			const value = getEntry(root, scope, args.name);
+			if (value === null) throw new Error(`not found: ${args.name}（scope=${scope}）`);
+			return {
+				scope,
+				name: args.name,
+				value,
+				source: scope
+			};
+		}
+		case "set": {
+			if (!args.name) throw new Error("set 需要 name");
+			if (args.value === void 0) throw new Error("set 需要 value");
+			writeEntry(root, scope, args.name, args.value);
+			const git = checkLocalstoreGitCompliance(root);
+			return {
+				scope,
+				name: args.name,
+				set: true,
+				path: localstorePath(root),
+				gitTrack: readGitTrack(root),
+				gitOk: git.ok,
+				git: git.reason ? { warning: git.reason } : null
+			};
+		}
+		case "unset": {
+			if (!args.name) throw new Error("unset 需要 name");
+			const removed = unsetEntry(root, scope, args.name);
+			return {
+				scope,
+				name: args.name,
+				removed
+			};
+		}
+		case "show": {
+			if (!args.name) throw new Error("show 需要 name");
+			const exists = getEntry(root, scope, args.name) !== null;
+			return {
+				scope,
+				name: args.name,
+				exists,
+				path: localstorePath(root)
+			};
+		}
+		case "doc": return { doc: docText(root) };
+		default: throw new Error(`未知子命令: ${args.action}（可用 list/get/set/unset/show/doc）`);
+	}
+}
+//#endregion
 //#region src/git-ops.ts
 /**
 * git-ops.ts — cc_git 纯操作层（零 DSH 依赖）
@@ -1426,12 +1702,17 @@ function runGit(root, args) {
 				"--porcelain"
 			]);
 			if (!r.ok) throw new Error(`status 失败：${r.stderr.trim()}`);
-			return {
+			const out = {
 				clean: r.stdout.trim() === "",
 				entries: r.stdout.trim() ? r.stdout.trim().split("\n") : []
 			};
+			const ls = checkLocalstoreGitCompliance(root);
+			if (!ls.ok) out.warning = ls.reason;
+			return out;
 		}
 		case "commit": {
+			const ls = checkLocalstoreGitCompliance(root);
+			if (!ls.ok) throw new Error(ls.reason);
 			if (!args.message) throw new Error("commit 需要 message");
 			const add = git(root, ["add", "-A"]);
 			if (!add.ok) throw new Error(`git add 失败：${add.stderr.trim()}`);
@@ -1489,7 +1770,7 @@ function runGit(root, args) {
 /**
 * git.ts — cc_git 真实 DSH 工具定义（defineTool）
 */
-function agentCwd$3(exec) {
+function agentCwd$4(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
 function renderText$6(value) {
@@ -1522,7 +1803,7 @@ const gitTool = defineTool({
 		render: (args, value) => renderText$6(value)
 	},
 	async execute(args, exec) {
-		const root = findSerenityRoot(agentCwd$3(exec));
+		const root = findSerenityRoot(agentCwd$4(exec));
 		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 		return runGit(root, args);
 	}
@@ -1532,7 +1813,7 @@ const gitTool = defineTool({
 /**
 * msm.ts — acc_msm 真实 DSH 工具定义（defineTool）
 */
-function agentCwd$2(exec) {
+function agentCwd$3(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
 function renderText$5(value) {
@@ -1582,7 +1863,7 @@ const msmTool = defineTool({
 		render: (args, value) => renderText$5(value)
 	},
 	async execute(args, exec) {
-		const root = findSerenityRoot(agentCwd$2(exec));
+		const root = findSerenityRoot(agentCwd$3(exec));
 		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 		return runMsmAsync(root, args);
 	}
@@ -1926,7 +2207,7 @@ ${resumeNote}
 * 使 loop agent 继承发起方会话的 agent preset 工具（read/write/edit 等 preset 层工具）。
 * agentPresets 是可选服务——无 preset 装配的环境（无 roster 部署）退化为空工具层（历史行为）。
 */
-function agentCwd$1(exec) {
+function agentCwd$2(exec) {
 	return (exec.agent?.session)?.header?.cwd ?? process.cwd();
 }
 function renderText$1(value) {
@@ -1968,7 +2249,7 @@ function lastAssistantText(agent) {
 function createLoopTool(ctx) {
 	return defineTool({
 		name: "loop",
-		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .dsh/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan",
+		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .opencode/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。轮次不需要调用者指定——对话轮次**无上限**（不完成不返回），agent 非正常停止时自动重启（重启 ≤100 次，防死循环保险阀）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan",
 		parameters: {
 			task: {
 				type: "string",
@@ -1993,11 +2274,11 @@ function createLoopTool(ctx) {
 			render: (_args, value) => renderText$1(value)
 		},
 		async execute(args, exec) {
-			const root = findSerenityRoot(agentCwd$1(exec));
+			const root = findSerenityRoot(agentCwd$2(exec));
 			if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
 			const cfg = loadSerenityConfig(root, DEFAULT_SERENITY_CONFIG_PATHS);
 			const model = args.model ?? cfg.loop?.defaultModel;
-			if (!model) throw new Error("loop 需要 model：传参或配置 .dsh/serenity.json loop.defaultModel");
+			if (!model) throw new Error("loop 需要 model：传参或配置 .opencode/serenity.json loop.defaultModel");
 			const label = args.label;
 			if (!ctx.agentLoop) throw new Error("loop: ctx.agentLoop 不可用");
 			const { provider, model: modelName } = splitModel(model);
@@ -2109,307 +2390,13 @@ function createLoopTool(ctx) {
 	});
 }
 //#endregion
-//#region src/localstore-ops.ts
-/**
-* localstore-ops.ts — localstore 纯逻辑层（零 DSH 依赖，可独立单测）
-*
-* ACC 标准本地凭据/配置存储（S133 设计）：
-*   - 一个工具管理两个命名空间：credential（凭据，0600）+ config（偏好，0644）
-*   - 存储于 ~/.serenity/（平台感知：win %USERPROFILE%\.serenity\）
-*   - 两个 YAML 文件：credentials.yaml（扁平 REF→value）+ settings.yaml（命名空间分节）
-*   - 目录 0700
-*
-* YAML 用轻量自实现子集（零依赖）：扁平 `KEY: value` 映射 + `#` 注释。
-* 凭据/配置本质是给 MSM/agent 用的普通 YAML 文件——agent 可按 doc 子命令
-* 说明直接用 fs 工具（read/write）操作；本工具是管理入口 + 规范文档。
-*/
-const LOCALSTORE_SCOPES = ["credential", "config"];
-/** 根目录名（~/.serenity） */
-const STORE_DIR_NAME = ".serenity";
-/** 凭据文件（0600） */
-const CREDENTIALS_FILENAME = "credentials.yaml";
-/** 配置文件（0644） */
-const SETTINGS_FILENAME = "settings.yaml";
-/** 凭据 key 规范：大写蛇形（命名空间前缀），如 HOME_GITLAB_TOKEN */
-const CREDENTIAL_KEY_RE = /^[A-Z][A-Z0-9_]*$/;
-/** 配置节名规范：小写字母数字连字符 */
-const CONFIG_SECTION_RE = /^[a-z][a-z0-9-]*$/;
-/** 配置 key 规范（节内）：小驼峰（首字母小写，可含大写），如 defaultModel */
-const CONFIG_KEY_RE = /^[a-z][a-zA-Z0-9_]*$/;
-/** 解析 ~/.serenity 根（平台感知：os.homedir() 三平台统一） */
-function serenityDir() {
-	return join(homedir(), STORE_DIR_NAME);
-}
-/** 各命名空间的文件绝对路径 */
-function storeFilePath(scope) {
-	return scope === "credential" ? join(serenityDir(), CREDENTIALS_FILENAME) : join(serenityDir(), SETTINGS_FILENAME);
-}
-/** 确保目录存在并设 0700 */
-function ensureDir(dir) {
-	mkdirSync(dir, { recursive: true });
-	try {
-		chmodSync(dir, 448);
-	} catch {}
-}
-/** 设置文件权限：credential 0600 / config 0644 */
-function applyFileMode(scope, path) {
-	try {
-		chmodSync(path, scope === "credential" ? 384 : 420);
-	} catch {}
-}
-/** 解析扁平映射 YAML → Record<string,string>（忽略 # 注释与空行；值去引号） */
-function parseFlatYaml(text) {
-	const out = {};
-	for (const rawLine of text.split("\n")) {
-		const line = rawLine.trim();
-		if (line === "" || line.startsWith("#")) continue;
-		const idx = line.indexOf(":");
-		if (idx <= 0) continue;
-		const key = line.slice(0, idx).trim();
-		let value = line.slice(idx + 1).trim();
-		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
-		out[key] = value;
-	}
-	return out;
-}
-/** 序列化扁平映射 YAML（保持 key 顺序，值引号包裹含特殊字符的） */
-function renderFlatYaml(entries) {
-	const lines = [];
-	for (const [key, value] of Object.entries(entries)) {
-		const rendered = /[:#\n]/.test(value) || value === "" || /^\s/.test(value) || /\s$/.test(value) ? JSON.stringify(value) : value;
-		lines.push(`${key}: ${rendered}`);
-	}
-	return lines.join("\n") + (lines.length > 0 ? "\n" : "");
-}
-/** 解析分节 YAML（config）：节 → key → value */
-function parseSectionedYaml(text) {
-	const out = {};
-	let section = "";
-	for (const rawLine of text.split("\n")) {
-		const line = rawLine.trim();
-		if (line === "" || line.startsWith("#")) continue;
-		if (rawLine.length - rawLine.trimStart().length === 0 && line.endsWith(":")) {
-			section = line.slice(0, -1).trim();
-			if (!out[section]) out[section] = {};
-			continue;
-		}
-		if (section === "") continue;
-		const idx = line.indexOf(":");
-		if (idx <= 0) continue;
-		const key = line.slice(0, idx).trim();
-		let value = line.slice(idx + 1).trim();
-		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
-		const sectionMap = out[section] ??= {};
-		sectionMap[key] = value;
-	}
-	return out;
-}
-/** 序列化分节 YAML（config）：节 → key → value */
-function renderSectionedYaml(sections) {
-	const lines = [];
-	for (const [section, entries] of Object.entries(sections)) {
-		lines.push(`${section}:`);
-		for (const [key, value] of Object.entries(entries)) {
-			const rendered = /[:#\n]/.test(value) || value === "" || /^\s/.test(value) || /\s$/.test(value) ? JSON.stringify(value) : value;
-			lines.push(`  ${key}: ${rendered}`);
-		}
-	}
-	return lines.join("\n") + (lines.length > 0 ? "\n" : "");
-}
-/** 读取命名空间全部条目（文件不存在返回空） */
-function readStore(scope) {
-	const path = storeFilePath(scope);
-	if (!existsSync(path)) return scope === "credential" ? {} : {};
-	const text = readFileSync(path, "utf-8");
-	return scope === "credential" ? parseFlatYaml(text) : parseSectionedYaml(text);
-}
-/** 校验凭据 key 合法（大写蛇形）；不合法抛错 */
-function assertCredentialKey(key) {
-	if (!CREDENTIAL_KEY_RE.test(key)) throw new Error(`credential key "${key}" 必须匹配大写蛇形 ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）`);
-}
-/** 校验 config 路径（节.key）；不合法抛错 */
-function assertConfigPath(path) {
-	const idx = path.indexOf(".");
-	if (idx <= 0 || idx === path.length - 1) throw new Error(`config path "${path}" 必须为 section.key（如 loop.defaultModel）`);
-	const section = path.slice(0, idx);
-	const key = path.slice(idx + 1);
-	if (!CONFIG_SECTION_RE.test(section)) throw new Error(`config 节 "${section}" 必须匹配 ^[a-z][a-z0-9-]*$`);
-	if (!CONFIG_KEY_RE.test(key)) throw new Error(`config key "${key}" 必须匹配小驼峰 ^[a-z][a-zA-Z0-9_]*$（如 defaultModel）`);
-	return {
-		section,
-		key
-	};
-}
-/** 写入单个条目（自动建目录/设权限；保留其他条目与注释行外内容） */
-function writeEntry(scope, name, value) {
-	const path = storeFilePath(scope);
-	ensureDir(serenityDir());
-	if (scope === "credential") {
-		assertCredentialKey(name);
-		const entries = parseFlatYaml(existsSync(path) ? readFileSync(path, "utf-8") : "");
-		entries[name] = value;
-		writeFileSync(path, renderFlatYaml(entries), "utf-8");
-	} else {
-		const { section, key } = assertConfigPath(name);
-		const sections = parseSectionedYaml(existsSync(path) ? readFileSync(path, "utf-8") : "");
-		if (!sections[section]) sections[section] = {};
-		sections[section][key] = value;
-		writeFileSync(path, renderSectionedYaml(sections), "utf-8");
-	}
-	applyFileMode(scope, path);
-}
-/** 删除单个条目（不存在返回 false） */
-function unsetEntry(scope, name) {
-	const path = storeFilePath(scope);
-	if (!existsSync(path)) return false;
-	if (scope === "credential") {
-		assertCredentialKey(name);
-		const entries = parseFlatYaml(readFileSync(path, "utf-8"));
-		if (!(name in entries)) return false;
-		delete entries[name];
-		writeFileSync(path, renderFlatYaml(entries), "utf-8");
-		return true;
-	}
-	const { section, key } = assertConfigPath(name);
-	const sections = parseSectionedYaml(readFileSync(path, "utf-8"));
-	const sectionMap = sections[section];
-	if (!sectionMap || !(key in sectionMap)) return false;
-	delete sectionMap[key];
-	if (Object.keys(sectionMap).length === 0) delete sections[section];
-	writeFileSync(path, renderSectionedYaml(sections), "utf-8");
-	return true;
-}
-/** 读取单个条目值；不存在返回 null */
-function getEntry(scope, name) {
-	const path = storeFilePath(scope);
-	if (!existsSync(path)) return null;
-	if (scope === "credential") {
-		assertCredentialKey(name);
-		return parseFlatYaml(readFileSync(path, "utf-8"))[name] ?? null;
-	}
-	const { section, key } = assertConfigPath(name);
-	return parseSectionedYaml(readFileSync(path, "utf-8"))[section]?.[key] ?? null;
-}
-/** 列出 key（凭据只返回 key 名，不返回值） */
-function listKeys(scope) {
-	const data = readStore(scope);
-	if (scope === "credential") return Object.keys(data);
-	return Object.entries(data).flatMap(([section, entries]) => Object.keys(entries).map((key) => `${section}.${key}`));
-}
-/**
-* doc 说明文本：输出存储位置/格式/key 规范/权限/读写方法/安全边界。
-* agent 据此可直接用 fs 工具（read/write）自己读写凭据/配置。
-*/
-function docText() {
-	const dir = serenityDir();
-	const credPath = storeFilePath("credential");
-	const cfgPath = storeFilePath("config");
-	return [
-		"# localstore — ACC 本地凭据/配置存储（标准）",
-		"",
-		"一个工具管理两个命名空间：credential（凭据，0600）+ config（偏好，0644）。",
-		"存储于用户主目录，不在任何 CCC git 仓库内。",
-		"",
-		"## 存储位置（平台感知）",
-		`- 根目录: ${dir}  (0700)`,
-		`- 凭据:   ${credPath}  (0600)`,
-		`- 配置:   ${cfgPath}  (0644)`,
-		"- Windows: %USERPROFILE%\\.serenity\\...（与 Linux/macOS 的 $HOME/.serenity 同构）",
-		"",
-		"## 格式",
-		"credentials.yaml（扁平映射，key = 大写蛇形命名空间前缀）：",
-		"```yaml",
-		"HOME_GITLAB_TOKEN: xxx",
-		"SSH_UBUNTU_PASSWORD: xxx",
-		"ANYSEARCH_API_KEY: xxx",
-		"```",
-		"settings.yaml（命名空间分节）：",
-		"```yaml",
-		"loop:",
-		"  defaultModel: minimax-cn-coding-plan/MiniMax-M3",
-		"ui:",
-		"  theme: dark",
-		"```",
-		"",
-		"## key 规范",
-		"- credential key: ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）",
-		"- config path: section.key（节 ^[a-z][a-z0-9-]*$，key 小驼峰 ^[a-z][a-zA-Z0-9_]*$，如 loop.defaultModel）",
-		"",
-		"## 读取方法（agent 可直接用 fs 工具）",
-		"- 用 read 工具读对应文件 → 按上面格式解析 YAML",
-		"- 或用 localstore get <name> [--scope credential|config]",
-		"",
-		"## 写入方法",
-		"- 推荐：localstore set <name> <value> [--scope ...]（自动建目录/设权限/保留其他条目）",
-		"- 或直接用 write/edit 工具修改文件，保持 YAML 合法（键值冒号分隔）",
-		"",
-		"## 安全边界",
-		"- list/show 对 credential 只返回 key 名，不返回值",
-		"- 凭据值应在 agent 内部使用，不要写入对话/日志",
-		"- 文件权限不符（非 0600/0644）时 get/set 会提示 chmod 修复",
-		"- 文件在用户主目录，天然不进入任何 git 仓库",
-		""
-	].join("\n");
-}
-/** 运行 localstore 操作（纯逻辑；返回 JSON 值供工具 render） */
-function runLocalStore(args) {
-	const scope = args.scope === "config" ? "config" : "credential";
-	switch (args.action) {
-		case "list": return {
-			scope,
-			keys: listKeys(scope)
-		};
-		case "get": {
-			if (!args.name) throw new Error("get 需要 name");
-			const value = getEntry(scope, args.name);
-			if (value === null) throw new Error(`not found: ${args.name}（scope=${scope}）`);
-			return {
-				scope,
-				name: args.name,
-				value,
-				source: scope
-			};
-		}
-		case "set":
-			if (!args.name) throw new Error("set 需要 name");
-			if (args.value === void 0) throw new Error("set 需要 value");
-			writeEntry(scope, args.name, args.value);
-			return {
-				scope,
-				name: args.name,
-				set: true
-			};
-		case "unset": {
-			if (!args.name) throw new Error("unset 需要 name");
-			const removed = unsetEntry(scope, args.name);
-			return {
-				scope,
-				name: args.name,
-				removed
-			};
-		}
-		case "show": {
-			if (!args.name) throw new Error("show 需要 name");
-			const exists = getEntry(scope, args.name) !== null;
-			return {
-				scope,
-				name: args.name,
-				exists,
-				path: storeFilePath(scope)
-			};
-		}
-		case "doc": return { doc: docText() };
-		default: throw new Error(`未知子命令: ${args.action}（可用 list/get/set/unset/show/doc）`);
-	}
-}
-//#endregion
 //#region src/tools/localstore.ts
 /**
 * localstore.ts — localstore 真实 DSH 工具定义（defineTool）
 *
-* ACC 标准本地凭据/配置存储（S133 设计）。进程内注册，零 DSH 依赖逻辑在
-* localstore-ops.ts（可单测）。doc 子命令输出存储规范，agent 可直接用 fs
-* 工具（read/write）自己读写。
+* ACC 标准本地凭据/配置存储（S133 设计，S134 重设计：CCC 根 localstore.json）。
+* 进程内注册，零 DSH 依赖逻辑在 localstore-ops.ts（可单测）。
+* doc 子命令输出存储规范，agent 可直接用 fs 工具（read/write）自己读写。
 */
 const ACTIONS = [
 	"list",
@@ -2419,6 +2406,9 @@ const ACTIONS = [
 	"show",
 	"doc"
 ];
+function agentCwd$1(exec) {
+	return exec.agent?.session?.header?.cwd ?? process.cwd();
+}
 function renderText(value) {
 	return [{
 		type: "text",
@@ -2427,7 +2417,7 @@ function renderText(value) {
 }
 const localstoreTool = defineTool({
 	name: "localstore",
-	description: "ACC 标准本地凭据/配置存储：一个工具管理两个命名空间 credential（凭据，0600）与 config（本地偏好，0644）。存储于用户主目录 ~/.serenity/（平台感知，不在任何 git 仓库内）。子命令：list（列 key，凭据不返回值）/ get <name>（读值）/ set <name> <value>（写）/ unset <name>（删）/ show <name>（元数据，凭据不打印值）/ doc（输出存储规范——路径/格式/key 规范/权限，agent 可按说明直接用 read/write 操作文件）。默认 scope=credential；config 需传 --scope config（路径为 section.key，如 loop.defaultModel）。",
+	description: "ACC 标准本地凭据/配置存储：一个工具管理两个命名空间 credential（凭据）与 config（本地偏好）。存储于 CCC 根根目录 localstore.json（JSON 格式，MSM 可直接读取）。git 策略：.opencode/serenity.json localstore.gitTrack（allow 可提交 / deny 禁提交，缺省 deny；.dsh 回退）——deny 时写入自动确保 .gitignore 含该文件（物理保证），cc_git commit 会检查拒绝。子命令：list（列 key，凭据不返回值）/ get <name>（读值）/ set <name> <value>（写）/ unset <name>（删）/ show <name>（元数据，凭据不打印值）/ doc（输出存储规范——路径/格式/key 规范/git 策略，agent 可按说明直接用 read/write 操作文件）。默认 scope=credential；config 需传 --scope config（路径为 section.key，如 loop.defaultModel）。",
 	parameters: {
 		action: {
 			type: "string",
@@ -2453,8 +2443,10 @@ const localstoreTool = defineTool({
 		schema: { type: "json" },
 		render: (args, value) => renderText(value)
 	},
-	async execute(args) {
-		return runLocalStore(args);
+	async execute(args, exec) {
+		const root = findSerenityRoot(agentCwd$1(exec));
+		if (!root) throw new Error("No CCC found: no .serenity file from agent cwd");
+		return runLocalStore(root, args);
 	}
 });
 //#endregion
@@ -2668,7 +2660,9 @@ function accBlock(root) {
 		"  neat     — return the full Neat design collaboration protocol",
 		"  cce      — return the full Cognitive Continuity Engineering framework",
 		"  loop     — 牛马循环：指定模型专用 agent 反复执行",
-		"  localstore — ACC 本地凭据/配置存储（credential 0600 + config 0644，~/.serenity/）；doc 子命令输出规范",
+		"  localstore — ACC 本地凭据/配置存储（CCC 根 localstore.json，JSON 格式；git 策略 localstore.gitTrack 缺省 deny）；doc 子命令输出规范",
+		"",
+		"  ℹ️ CCC 内文件操作（read/write/edit/glob/grep 等）请使用相对 CCC 根的相对路径（如 AGENT_SESSIONS/2026-08-14--S134--x/SESSION.md）；Root / SESSION.md path 等绝对路径仅作标识，不作工具入参",
 		"",
 		"The DSH platform tools remain available too (read/write/edit/glob/grep/web_search/ask_user_question/subagent/workflow/goal and more) — the ACC tools above are the serenity-native layer, not the only tools.",
 		"",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.16.6",
+  "version": "1.16.8",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {