@caupulican/pi-adaptative 0.80.23 → 0.80.26

package/docs/extensions.md

@@ -133,11 +133,28 @@ Additional paths and filters via `settings.json`:
   ],
   "disabledResources": {
     "extensions": ["old-extension", "project-only-extension"]
+  },
+  "activeResourceProfile": "lean",
+  "resourceProfiles": {
+    "lean": {
+      "extensions": { "block": ["old-extension"], "allow": [] },
+      "tools": { "allow": ["read", "rg", "python"] }
+    }
   }
 }
 ```
 
-Resource arrays support include/exclude patterns: plain entries include local paths, `!pattern` excludes matching auto-discovered resources, `+path` force-includes an exact path, and `-path` force-excludes an exact path. `disabledResources.extensions` is the explicit reversible unload form and is equivalent to exclude patterns. Put it in user settings for global unloads or project `.pi/settings.json` for project-specific unloads.
+Resource arrays support include/exclude patterns: plain entries include local paths, `!pattern` excludes matching auto-discovered resources, `+path` force-includes an exact path, and `-path` force-excludes an exact path. `disabledResources.extensions` remains as the legacy explicit reversible unload form and is merged as a `resourceProfiles` block filter. Prefer `resourceProfiles` when you need focused per-session, per-repo, or subagent-specific loading.
+
+Extensions may carry profile blocks inside comments. Pi reads only matching `<resource-profile>` blocks as JSON config before filtering, and ignores the rest of the extension file for profile parsing:
+
+```ts
+/*
+<resource-profile name="reviewer">
+{ "tools": { "allow": ["read", "rg"] }, "extensions": { "block": ["heavy-devtools"] } }
+</resource-profile>
+*/
+```
 
 To share extensions via npm or git as pi packages, see [packages.md](packages.md).
 

package/docs/prompt-templates.md

@@ -31,6 +31,7 @@ Review the staged changes (`git diff --cached`). Focus on:
 - The filename becomes the command name. `review.md` becomes `/review`.
 - `description` is optional. If missing, the first non-empty line is used.
 - `argument-hint` is optional. When set, the hint is displayed before the description in the autocomplete dropdown.
+- Optional `<resource-profile name="...">{...}</resource-profile>` blocks define profile filters as JSON. Pi reads only matching profile blocks as config and strips them from expanded prompt content.
 
 ### Argument Hints
 

package/docs/settings.md

@@ -1,11 +1,12 @@
 # Settings
 
-Pi uses JSON settings files with project settings overriding global settings.
+Pi uses JSON settings files with project settings overriding global settings. Pi also supports zero-footprint directory resource profiles stored under the user-level agent directory.
 
 | Location | Scope |
 |----------|-------|
 | `~/.pi/agent/settings.json` | Global (all projects) |
 | `.pi/settings.json` | Project (current directory) |
+| `~/.pi/agent/resource-profiles/<hash>/settings.json` | User-level per repo/directory overlay; no repo files written |
 
 Edit directly or use `/settings` for common options.
 
@@ -281,6 +282,10 @@ Paths in `~/.pi/agent/settings.json` resolve relative to `~/.pi/agent`. Paths in
 | `prompts` | string[] | `[]` | Local prompt template paths or directories |
 | `themes` | string[] | `[]` | Local theme file paths or directories |
 | `enableSkillCommands` | boolean | `true` | Register skills as `/skill:name` commands |
+| `resourceProfiles` | object | `{}` | Named resource allow/block filters for `extensions`, `skills`, `prompts`, `themes`, `agents`, and `tools` |
+| `activeResourceProfile` | string/string[] | - | Active profile name(s) |
+| `activeResourceProfiles` | string[] | - | Active profile names; equivalent to array form of `activeResourceProfile` |
+| `disabledResources` | object | `{}` | Legacy block filters; still supported and merged into resource profiles |
 
 Arrays support glob patterns and exclusions. Use `!pattern` to exclude. Use `+path` to force-include an exact path and `-path` to force-exclude an exact path.
 
@@ -310,6 +315,43 @@ Object form filters which resources to load:
 
 See [packages.md](packages.md) for package management details.
 
+#### resourceProfiles
+
+Resource profiles dynamically filter resources after discovery. Each resource kind supports `allow` and `block` arrays. If `allow` is non-empty, only matching resources load; `block` is applied after allow. Patterns match relative paths, absolute paths, file names, and containing directory names.
+
+```json
+{
+  "activeResourceProfile": "lean",
+  "resourceProfiles": {
+    "lean": {
+      "extensions": { "block": ["cmux-agent-manager", "heavy-devtools"] },
+      "skills": { "allow": ["engineering-principles", "graph-first-code-navigation"] },
+      "agents": { "block": ["GEMINI.md"] },
+      "tools": { "allow": ["read", "rg", "python"] }
+    }
+  }
+}
+```
+
+Use `--resource-profile lean` to select a profile for one session or subagent launch. Use `--resource-profile-json` for one-shot definitions that never touch disk:
+
+```bash
+pi --resource-profile oneoff \
+  --resource-profile-json '{"oneoff":{"tools":{"allow":["read","rg"]}}}'
+```
+
+Resource files may also carry profile blocks. Pi parses only the matching `<resource-profile>` block as JSON config and strips the block from prompt/agent/skill expansion content:
+
+```markdown
+<resource-profile name="lean">
+{ "tools": { "allow": ["read", "rg"] }, "agents": { "block": ["GEMINI.md"] } }
+</resource-profile>
+```
+
+Supported carriers: extension files (`.ts`/`.js`, usually inside comments), prompt templates, skill files, and context agent files (`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`). Resource-profile block contents are data, not instructions.
+
+Zero-footprint repo/directory overlays live under `~/.pi/agent/resource-profiles/<hash>/settings.json`, where `<hash>` is derived from the nearest VCS root (or current directory when no VCS root exists). These files are user-level settings; Pi does not write `.pi/settings.json` just to remember directory profiles.
+
 ## Example
 
 ```json

package/docs/skills.md

@@ -82,6 +82,18 @@ For project-level Claude Code skills, add to `.pi/settings.json`:
 
 This is progressive disclosure: names and descriptions are always in context, while full instructions load on-demand.
 
+When multiple skills are loaded, descriptions are the routing contract. Write narrow descriptions and prefer the most task-specific skill. Combine skills only when they cover distinct parts of the request. Do not rely on the agent to apply every loaded skill.
+
+Skills may carry optional resource profile blocks:
+
+```markdown
+<resource-profile name="reviewer">
+{ "tools": { "allow": ["read", "rg"] } }
+</resource-profile>
+```
+
+These blocks are JSON config, not instructions. Pi parses only matching profile blocks and strips them from `/skill:name` expansion.
+
 ## Skill Commands
 
 Skills register as `/skill:name` commands:

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.80.20",
+  "version": "0.80.23",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.80.20",
+      "version": "0.80.23",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-anthropic",
   "private": true,
-  "version": "0.80.20",
+  "version": "0.80.23",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-gitlab-duo",
   "private": true,
-  "version": "0.80.20",
+  "version": "0.80.23",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-sandbox",
-	"version": "0.80.20",
+	"version": "0.80.23",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "0.80.20",
+			"version": "0.80.23",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "^0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-sandbox",
 	"private": true,
-	"version": "0.80.20",
+	"version": "0.80.23",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.80.20",
+  "version": "0.80.23",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.80.20",
+      "version": "0.80.23",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "0.80.20",
+  "version": "0.80.23",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.80.23",
+	"version": "0.80.26",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@caupulican/pi-adaptative",
-			"version": "0.80.23",
+			"version": "0.80.26",
 			"license": "MIT",
 			"dependencies": {
-				"@caupulican/pi-agent-core": "^0.80.23",
-				"@caupulican/pi-ai": "^0.80.23",
-				"@caupulican/pi-tui": "^0.80.23",
+				"@caupulican/pi-agent-core": "^0.80.26",
+				"@caupulican/pi-ai": "^0.80.26",
+				"@caupulican/pi-tui": "^0.80.26",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"chalk": "5.6.2",
 				"cross-spawn": "7.0.6",
@@ -474,11 +474,11 @@
 			}
 		},
 		"node_modules/@caupulican/pi-agent-core": {
-			"version": "0.80.23",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.80.23.tgz",
+			"version": "0.80.26",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.80.26.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"@caupulican/pi-ai": "^0.80.23",
+				"@caupulican/pi-ai": "^0.80.26",
 				"ignore": "7.0.5",
 				"typebox": "1.1.38",
 				"yaml": "2.9.0"
@@ -488,8 +488,8 @@
 			}
 		},
 		"node_modules/@caupulican/pi-ai": {
-			"version": "0.80.23",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.80.23.tgz",
+			"version": "0.80.26",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.80.26.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",
@@ -511,8 +511,8 @@
 			}
 		},
 		"node_modules/@caupulican/pi-tui": {
-			"version": "0.80.23",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.80.23.tgz",
+			"version": "0.80.26",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.80.26.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.80.23",
+	"version": "0.80.26",
 	"description": "Adaptive fork of Pi coding agent for self-evolving agent harness experiments",
 	"type": "module",
 	"piConfig": {
@@ -41,9 +41,9 @@
 		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap"
 	},
 	"dependencies": {
-		"@caupulican/pi-agent-core": "^0.80.23",
-		"@caupulican/pi-ai": "^0.80.23",
-		"@caupulican/pi-tui": "^0.80.23",
+		"@caupulican/pi-agent-core": "^0.80.26",
+		"@caupulican/pi-ai": "^0.80.26",
+		"@caupulican/pi-tui": "^0.80.26",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",