psyclaw 0.27.19 → 0.27.20

package/README.md

@@ -2,7 +2,7 @@
 
 PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、证据来源、Claim-Evidence 账本、完整性门禁、可恢复工作流和本地面板接到内置运行时上；只有无法由证据和通行方法消解、且会实质改变研究设计或解释的分歧才交由研究者取舍。它不替代统计软件，也不会把未经核验的引用、结果或审稿意见写成事实。
 
-当前版本：`0.27.19`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.27.20`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
 
 ## 发布流程
 
@@ -19,19 +19,19 @@ RELEASE_MESSAGE="release: describe the change" pnpm release:push
 需要 Node.js `>=22.19.0`。官方 npm 源：
 
 ```powershell
-npm install -g psyclaw@0.27.19
+npm install -g psyclaw@0.27.20
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.27.19 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.27.20 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.27.19 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.27.20 --registry=https://registry.npmmirror.com
 ```
 
 确认命令入口：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyclaw",
-  "version": "0.27.19",
+  "version": "0.27.20",
   "description": "A standalone, evidence-grounded social-science research agent with research contracts, evidence gates, and recoverable workflows",
   "type": "module",
   "license": "MIT",

package/scripts/rebrand-pi.mjs

@@ -435,6 +435,35 @@ async function applySettingsPatches(settingsManagerPath) {
   return applied;
 }
 
+const MANAGED_TOOL_DOWNLOAD_GUARD = `    // PsyClaw supplies Node-based find/grep fallbacks. Keep PATH tools when
+    // present, but never fetch optional binaries from GitHub during startup.
+    return undefined;`;
+
+/** Disable Pi's optional binary downloads without enabling global offline mode. */
+export function disableManagedToolDownloads(content) {
+  if (content.includes(MANAGED_TOOL_DOWNLOAD_GUARD)) {
+    return { content, applied: false };
+  }
+  const existingToolCheck = `    if (existingPath) {
+        return existingPath;
+    }`;
+  const occurrences = content.split(existingToolCheck).length - 1;
+  if (occurrences !== 1 || !content.includes("export async function ensureTool(tool, onStatus)")) {
+    throw new Error(`Expected exactly one Pi managed-tool availability check, found ${occurrences}`);
+  }
+  return {
+    content: content.replace(existingToolCheck, `${existingToolCheck}\n${MANAGED_TOOL_DOWNLOAD_GUARD}`),
+    applied: true,
+  };
+}
+
+async function applyManagedToolPatches(toolsManagerPath) {
+  const current = await readFile(toolsManagerPath, "utf8");
+  const result = disableManagedToolDownloads(current);
+  if (result.applied) await atomicReplace(toolsManagerPath, result.content, true);
+  return result.applied;
+}
+
 export async function rebrandPiRuntime(options = {}) {
   const entry = import.meta.resolve("@earendil-works/pi-coding-agent");
   const pkgDir = dirname(dirname(fileURLToPath(entry)));
@@ -442,15 +471,17 @@ export async function rebrandPiRuntime(options = {}) {
   const modePath = join(pkgDir, "dist", "modes", "interactive", "interactive-mode.js");
   const settingsManagerPath = join(pkgDir, "dist", "core", "settings-manager.js");
   const slashCommandsPath = join(pkgDir, "dist", "core", "slash-commands.js");
+  const toolsManagerPath = join(pkgDir, "dist", "utils", "tools-manager.js");
 
   const pkgResult = await patchPackageJson(pkgPath);
   const applied = await applyModePatches(modePath);
   const settingsApplied = await applySettingsPatches(settingsManagerPath);
   const commandApplied = await applySlashCommandPatches(slashCommandsPath);
+  const managedToolsApplied = await applyManagedToolPatches(toolsManagerPath);
 
   if (!options.quiet) {
     process.stdout.write(
-      `psyclaw rebrand: piConfig ${pkgResult.applied ? "applied" : "already set"} · ${applied.length > 0 ? `patched ${applied.length} display string(s)` : "display strings already patched"} · ${settingsApplied.length > 0 ? `patched ${settingsApplied.length} setting default(s)` : "settings already patched"} · ${commandApplied.length > 0 ? `hidden ${commandApplied.length} Pi command(s)` : "Pi commands already filtered"} (${pkgDir})\n`,
+      `psyclaw rebrand: piConfig ${pkgResult.applied ? "applied" : "already set"} · ${applied.length > 0 ? `patched ${applied.length} display string(s)` : "display strings already patched"} · ${settingsApplied.length > 0 ? `patched ${settingsApplied.length} setting default(s)` : "settings already patched"} · ${commandApplied.length > 0 ? `hidden ${commandApplied.length} Pi command(s)` : "Pi commands already filtered"} · ${managedToolsApplied ? "disabled managed-tool downloads" : "managed-tool downloads already disabled"} (${pkgDir})\n`,
     );
     if (applied.length > 0) {
       for (const label of applied) {