@trim21/personal-pi-extensions 0.0.400 → 0.0.401

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.400",
+  "version": "0.0.401",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [

package/src/claude-code/bash.md

@@ -6,6 +6,8 @@ The working directory persists between commands, but shell state does not. The s
 
 Commands run in a sandbox: no write access outside the workspace and no network access. Use the `dangerouslyDisableSandbox` parameter to request unsandboxed execution; the user must approve this request.
 
+Long command output is automatically truncated and the full output is saved to a file. Avoid piping commands through `tail` to limit output unless you have a specific reason.
+
 IMPORTANT: Avoid using this tool to run `find`, `grep`, `cat`, `head`, `tail`, `sed`, `awk`, or `echo` commands, unless explicitly instructed or after you have verified that a dedicated tool cannot accomplish your task. Instead, use the appropriate dedicated tool as this will provide a much better experience for the user:
 
 - File search: Use Glob (NOT find or ls)

package/src/opencode/bash.md

@@ -0,0 +1,7 @@
+### Bash tool
+
+Executes a given bash command synchronously and returns its output.
+
+Commands run in a sandbox: no write access outside the workspace and no network access. Use the `dangerouslyDisableSandbox` parameter to request unsandboxed execution; the user must approve this request.
+
+Long command output is automatically truncated and the full output is saved to a file. Avoid piping commands through `tail` to limit output unless you have a specific reason.

package/src/opencode/bash.ts

@@ -1,3 +1,6 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
@@ -10,6 +13,9 @@ const MAX_TIMEOUT_MS = 600_000;
 /** 对齐上游 opencode 的截断提示文案（tools/BashTool/bash.ts）。 */
 const CAPTURE_TRUNCATED_NOTICE = "[output capture truncated at the in-memory safety limit]";
 
+/** Bash tool guidance, kept in markdown so it reads like documentation. */
+const BASH_PROMPT = readFileSync(fileURLToPath(new URL("bash.md", import.meta.url)), "utf8").trim();
+
 /**
  * 对齐上游 opencode（packages/core/src/tool/bash.ts）：
  * 命令失败（非 0 退出码）与超时都不抛错，输出与状态文本一起返回，
@@ -32,6 +38,7 @@ export default function opencodeBash(
       "Every command runs in the foreground. Background command execution is not supported; shell jobs are waited for before the tool returns.",
     ].join("\n"),
     promptSnippet: "execute bash command",
+    promptGuidelines: [BASH_PROMPT],
     parameters: Type.Object(
       {
         command: Type.String({ description: "The command to execute" }),