@caupulican/pi-adaptative 0.78.3 → 0.79.0

package/docs/extensions.md

@@ -480,7 +480,7 @@ pi.on("before_agent_start", async (event, ctx) => {
   //   .promptGuidelines - custom guideline bullets
   //   .appendSystemPrompt - text from --append-system-prompt flags
   //   .cwd - working directory
-  //   .contextFiles - lazy-loadable AGENTS.md/CLAUDE.md file locations
+  //   .contextFiles - eagerly loaded AGENTS.md/CLAUDE.md/GEMINI.md context files
   //   .skills - discovered skills; startup prompt includes locations only, not frontmatter
 
   return {
@@ -496,7 +496,7 @@ pi.on("before_agent_start", async (event, ctx) => {
 });
 ```
 
-The `systemPromptOptions` field gives extensions access to the same structured data Pi uses to build the system prompt. This lets you inspect what Pi has discovered — custom prompts, guidelines, tool snippets, context file locations, skills — without re-discovering resources or re-parsing flags. Use it when your extension needs to make deep, informed changes to the system prompt while respecting user-provided configuration.
+The `systemPromptOptions` field gives extensions access to the same structured data Pi uses to build the system prompt. This lets you inspect what Pi has discovered — custom prompts, guidelines, tool snippets, context file contents, skills — without re-discovering resources or re-parsing flags. Use it when your extension needs to make deep, informed changes to the system prompt while respecting user-provided configuration.
 
 Inside `before_agent_start`, `event.systemPrompt` and `ctx.getSystemPrompt()` both reflect the chained system prompt as of the current handler. Later `before_agent_start` handlers can still modify it again.
 

package/docs/quickstart.md

@@ -85,7 +85,7 @@ Additional built-in read-only tools (`grep`, `find`, `ls`) are available through
 
 ## Give pi project instructions
 
-Pi discovers context file locations at startup and lazy-loads their contents only when needed. Add an `AGENTS.md` file to tell it how to work in a project:
+Pi discovers and injects context file contents at startup. Add an `AGENTS.md` file to tell it how to work in a project:
 
 ```markdown
 # Project Instructions
@@ -97,10 +97,10 @@ Pi discovers context file locations at startup and lazy-loads their contents onl
 
 Pi discovers:
 
-- `~/.pi/agent/AGENTS.md` for global instructions
-- `AGENTS.md` or `CLAUDE.md` from parent directories and the current directory
+- `AGENTS.md`, `CLAUDE.md`, or `GEMINI.md` in `~/.pi/agent/` for global instructions
+- `AGENTS.md`, `CLAUDE.md`, or `GEMINI.md` from parent directories and the current directory
 
-Restart pi, or run `/reload`, after changing context file locations. If only contents changed, the agent can read the file again on demand.
+Restart pi, or run `/reload`, after changing context file contents or locations so the next prompt rebuild includes the latest instructions.
 
 ## Common things to try
 

package/docs/sdk.md

@@ -348,7 +348,7 @@ const { session } = await createAgentSession({
   - `.pi/skills/`
   - `.agents/skills/` in `cwd` and ancestor directories (up to git repo root, or filesystem root when not in a repo)
 - Project prompts (`.pi/prompts/`)
-- Context files (`AGENTS.md` walking up from cwd)
+- Context files (`AGENTS.md`, `CLAUDE.md`, or `GEMINI.md` walking up from cwd)
 - Session directory naming
 
 `agentDir` is used by `DefaultResourceLoader` for:
@@ -357,7 +357,7 @@ const { session } = await createAgentSession({
   - `skills/` under `agentDir` (for example `~/.pi/agent/skills/`)
   - `~/.agents/skills/`
 - Global prompts (`prompts/`)
-- Global context file (`AGENTS.md`)
+- Global context file (`AGENTS.md`, `CLAUDE.md`, or `GEMINI.md`)
 - Settings (`settings.json`)
 - Custom models (`models.json`)
 - Credentials (`auth.json`)
@@ -633,7 +633,7 @@ const loader = new DefaultResourceLoader({
   agentsFilesOverride: (current) => ({
     agentsFiles: [
       ...current.agentsFiles,
-      { path: "/virtual/AGENTS.md" },
+      { path: "/virtual/AGENTS.md", content: "Virtual project instructions" },
     ],
   }),
 });

package/docs/settings.md

@@ -75,6 +75,8 @@ Set `PI_SKIP_VERSION_CHECK=1` to disable the Pi version update check. Use `--off
 | `selfModification.enabled` | boolean | `false` | Allow the agent to modify Pi's own source/harness when explicitly tasked |
 | `selfModification.sourcePath` | string | - | Path to the `pi-adaptative` source checkout the agent must use for self-modification |
 
+Use `/settings` → **Self modification** to configure this interactively. The submenu lets you choose whether to save globally or to the current project's `.pi/settings.json`. Pi warns when the path does not look like a `pi-adaptative` checkout, and a new session or `/reload` is recommended after changing guardrail settings.
+
 When disabled, the system prompt tells the agent not to edit Pi core, the installed runtime, or harness source for self-evolution. To permit self-modification, enable the setting and provide the source checkout path:
 
 ```json
@@ -101,6 +103,8 @@ The agent is instructed to edit only that source checkout, preserve unrelated ch
 | `autoLearn.maxConcurrentLearners` | number | `2` | Maximum running Auto Learn background learners across all session tenants |
 | `autoLearn.applyHighConfidence` | boolean | `false` | Allow the learner to apply high-confidence memory candidates; tooling/core changes remain proposal/approval-gated |
 
+Use `/settings` → **Auto Learn** to configure this interactively, including the scavenger model. The submenu lets you choose whether to save globally or to the current project's `.pi/settings.json`. The model picker prioritizes models from currently configured subscription/API accounts and still offers a manual custom-pattern entry. Use `/auto-learn status` to inspect trigger state, cooldown, and running leases; use `/auto-learn run` to start one learner immediately.
+
 When enabled, Auto Learn uses a shared state file under the learning extension data directory to coordinate non-colliding background learners across sessions. Each long session gets its own tenant lease, and all learners read/renew the same state before scavenging stored histories for tooling capability and agent-behavior improvements. Learners also query available user/project memory first, using existing rules, preferences, corrections, and project facts to polish candidates, avoid duplicates, and improve accuracy.
 
 ```json

package/docs/usage.md

@@ -93,13 +93,13 @@ See [Sessions](sessions.md) and [Compaction](compaction.md) for details.
 
 ## Context Files
 
-Pi discovers `AGENTS.md` or `CLAUDE.md` locations at startup from:
+Pi discovers `AGENTS.md`, `CLAUDE.md`, or `GEMINI.md` context files at startup from:
 
-- `~/.pi/agent/AGENTS.md` for global instructions
+- `AGENTS.md`, `CLAUDE.md`, or `GEMINI.md` in `~/.pi/agent/` for global instructions
 - parent directories, walking up from the current working directory
 - the current directory
 
-Use context files for project conventions, commands, safety rules, and preferences. Their contents are lazy-loaded by path with the `read` tool instead of being injected into every startup prompt. Disable discovery with `--no-context-files` or `-nc`.
+Use context files for project conventions, commands, safety rules, and preferences. Their contents are injected into the startup system prompt so every session begins with the active project context. Disable discovery with `--no-context-files` or `-nc`.
 
 ### System Prompt Files
 
@@ -204,7 +204,7 @@ Built-in tools: `read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`.
 | `--no-prompt-templates` | Disable prompt template discovery |
 | `--theme <path>` | Load a theme; repeatable |
 | `--no-themes` | Disable theme discovery |
-| `--no-context-files`, `-nc` | Disable `AGENTS.md` and `CLAUDE.md` discovery |
+| `--no-context-files`, `-nc` | Disable `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` discovery |
 
 Combine `--no-*` with explicit flags to load exactly what you need, ignoring settings. Example:
 
@@ -216,7 +216,7 @@ pi --no-extensions -e ./my-extension.ts
 
 | Option | Description |
 |--------|-------------|
-| `--system-prompt <text>` | Replace default prompt; context file and skill locations are still appended for lazy loading |
+| `--system-prompt <text>` | Replace default prompt; context file contents and lazy-loadable skill locations are still appended |
 | `--append-system-prompt <text>` | Append to system prompt |
 | `--verbose` | Force verbose startup |
 | `-h`, `--help` | Show help |

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

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.78.3",
+  "version": "0.79.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.78.3",
+      "version": "0.79.0",
       "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.78.3",
+  "version": "0.79.0",
   "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.78.3",
+  "version": "0.79.0",
   "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.78.3",
+	"version": "0.79.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "0.78.3",
+			"version": "0.79.0",
 			"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.78.3",
+	"version": "0.79.0",
 	"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.78.3",
+  "version": "0.79.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.78.3",
+      "version": "0.79.0",
       "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.78.3",
+  "version": "0.79.0",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/sdk/07-context-files.ts

@@ -1,7 +1,7 @@
 /**
  * Context Files (AGENTS.md)
  *
- * Context files provide project-specific instructions that can be lazy-loaded by path.
+ * Context files provide project-specific instructions injected into the startup prompt.
  */
 
 import {
@@ -16,7 +16,7 @@ const loader = new DefaultResourceLoader({
 	cwd: process.cwd(),
 	agentDir: getAgentDir(),
 	agentsFilesOverride: (current) => ({
-		agentsFiles: [...current.agentsFiles, { path: "/virtual/AGENTS.md" }],
+		agentsFiles: [...current.agentsFiles, { path: "/virtual/AGENTS.md", content: "Virtual project instructions" }],
 	}),
 });
 await loader.reload();

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.78.3",
+	"version": "0.79.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@caupulican/pi-adaptative",
-			"version": "0.78.3",
+			"version": "0.79.0",
 			"license": "MIT",
 			"dependencies": {
-				"@earendil-works/pi-agent-core": "npm:@caupulican/pi-agent-core@0.78.3",
-				"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.78.3",
-				"@earendil-works/pi-tui": "npm:@caupulican/pi-tui@0.78.3",
+				"@earendil-works/pi-agent-core": "npm:@caupulican/pi-agent-core@0.79.0",
+				"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.79.0",
+				"@earendil-works/pi-tui": "npm:@caupulican/pi-tui@0.79.0",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"chalk": "5.6.2",
 				"cross-spawn": "7.0.6",
@@ -474,23 +474,22 @@
 			}
 		},
 		"node_modules/@earendil-works/pi-agent-core": {
-			"version": "0.78.3",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.78.3.tgz",
+			"version": "0.79.0",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.79.0.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.78.3",
+				"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.79.0",
 				"ignore": "7.0.5",
 				"typebox": "1.1.38",
 				"yaml": "2.9.0"
 			},
 			"engines": {
 				"node": ">=22.19.0"
-			},
-			"name": "@caupulican/pi-agent-core"
+			}
 		},
 		"node_modules/@earendil-works/pi-ai": {
-			"version": "0.78.3",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.78.3.tgz",
+			"version": "0.79.0",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.79.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",
@@ -509,12 +508,11 @@
 			},
 			"engines": {
 				"node": ">=22.19.0"
-			},
-			"name": "@caupulican/pi-ai"
+			}
 		},
 		"node_modules/@earendil-works/pi-tui": {
-			"version": "0.78.3",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.78.3.tgz",
+			"version": "0.79.0",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.79.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",
@@ -522,8 +520,7 @@
 			},
 			"engines": {
 				"node": ">=22.19.0"
-			},
-			"name": "@caupulican/pi-tui"
+			}
 		},
 		"node_modules/@google/genai": {
 			"version": "1.52.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.78.3",
+	"version": "0.79.0",
 	"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": {
-		"@earendil-works/pi-agent-core": "npm:@caupulican/pi-agent-core@0.78.3",
-		"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.78.3",
-		"@earendil-works/pi-tui": "npm:@caupulican/pi-tui@0.78.3",
+		"@earendil-works/pi-agent-core": "npm:@caupulican/pi-agent-core@0.79.0",
+		"@earendil-works/pi-ai": "npm:@caupulican/pi-ai@0.79.0",
+		"@earendil-works/pi-tui": "npm:@caupulican/pi-tui@0.79.0",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",