pi-file-permissions 0.1.0 → 0.1.2

package/README.md

@@ -29,6 +29,10 @@ By default, all enabled tools have unrestricted access to the filesystem. This e
 
 This extension is designed to do one simple thing: **restrict which paths the LLM's tools can access**. If you don't provide a `file-permissions.yaml` in your project root, nothing happens — pi runs completely normally.
 
+### Why This Matters
+
+Pi's LLM often aggressively searches for files — sometimes scanning from `$HOME` or traversing large directory trees — which can be slow and wasteful. More importantly, when building **focused agents** or **multi-agent systems**, setting clear boundaries on which files each agent can access is critical. You want to define exactly which paths are read-only, which are editable, and which are completely off-limits. This prevents agents from stepping on each other's work and keeps each agent scoped to its responsibility.
+
 Permission control is enforced at three levels:
 
 ### 1. System Prompt

package/extensions/pi-file-permissions.ts

@@ -265,6 +265,7 @@ function buildSystemPromptNotice(rules: PermissionRules): string {
     "",
     "Everything in the current project folder and ~/.pi is always accessible.",
     "Everything else is denied.",
+    "When searching for a file, you MUST search ALL domains that have find permission, not just some of them. Do not skip a domain just because it lacks read or write permission.",
     "If a tool reports a permission restriction, NEVER try a workaround via bash, alternate tools, broader parent directories, globbing, or search/discovery commands.",
     "Stop immediately and report the limitation instead.",
   ].join("\n");

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "pi-file-permissions",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Pi extension that enforces file-level permissions via a YAML config. Controls which paths each tool (read, write, edit, find, grep, ls) can access.",
   "keywords": ["pi-package"],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ross-jill-ws/pi-file-permissions"
+  },
   "pi": {
     "extensions": ["./extensions"]
   },