@aeondave/pi-skill-optimizer 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes are documented here.
 
 ## Unreleased
 
+## 3.1.2 - 2026-10-13
+
+### Fixed
+
+- Handle Pi 1.2 custom-triggered runs as no-intent starts: fail open for permitted tools, ignore custom message text even if a stray prompt field is present, and preserve the previous human request for output extraction.
+
 ## 3.1.1 - 2026-10-08
 
 ### Fixed

package/README.md

@@ -37,7 +37,7 @@ That's enough to start. Optionally run `/skill-optimizer init` to generate routi
 | Need | Command |
 | --- | --- |
 | Install only in this project | `pi install -l npm:@aeondave/pi-skill-optimizer` |
-| Pin the current release | `pi install npm:@aeondave/pi-skill-optimizer@3.1.1` |
+| Pin the current release | `pi install npm:@aeondave/pi-skill-optimizer@3.1.2` |
 | Update an unpinned install | `pi update npm:@aeondave/pi-skill-optimizer` |
 
 Restart after updating. Pinned installs stay pinned until you explicitly install another version.

package/docs/ARCHITECTURE.md

@@ -26,6 +26,14 @@ before provider conversion erases custom-message provenance. Native `custom`, `b
 the query or overlay target. Structured system sections and tool declarations are preserved;
 request-local clones do not modify persisted conversation entries.
 
+Pi 1.2's `before_agent_start` event distinguishes user starts (`messageType: "user"` with `prompt`)
+from custom-triggered starts (`messageType: "custom"` with `message`). Only a user prompt updates the
+last human request and drives tool activation. A custom start has no routing signal, so optimizer
+activation fails open across permitted named tools while retaining protected, used, and searched
+tools; custom message text is ignored even if the event also carries a `prompt` property. The
+previous human request remains available to output extraction. On Pi 1.0, the supported event has no
+`messageType` discriminator, so its string `prompt` continues to identify user intent.
+
 Ranking uses exact matching, BM25F, bounded name and alias typo recovery, reciprocal-rank fusion, diversity, profile evidence, and decayed usage evidence. It scores full source descriptions, then appends a bounded set of verbatim skill names and descriptions (not the full `SKILL.md` instructions) to the latest human block. The overlay is separate from the stable prefix, fingerprinted, idempotent, and omitted when there is no valid target.
 
 The resolver labels prefetch as discovery metadata, not loaded instructions or usage evidence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeondave/pi-skill-optimizer",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "private": false,
   "type": "module",
   "description": "Less repeated context for Pi: local skill routing, on-demand tools, and recoverable output reduction.",
@@ -81,6 +81,6 @@
     "extensions": [
       "./src/index.ts"
     ],
-    "image": "https://raw.githubusercontent.com/AeonDave/pi-skill-optimizer/v3.1.1/assets/banner.png"
+    "image": "https://raw.githubusercontent.com/AeonDave/pi-skill-optimizer/v3.1.2/assets/banner.png"
   }
 }

package/src/index.ts

@@ -1059,7 +1059,13 @@ export default function skillOptimizer(pi: ExtensionAPI) {
 	});
 
 	pi.on("before_agent_start", (event, ctx) => {
-		latestPrompt = event.prompt;
+		// Pi 1.2 also starts runs from custom messages, which have no human prompt.
+		// Keep their content out of routing and preserve the last real request for extraction.
+		const customStart = "messageType" in event && event.messageType === "custom";
+		const prompt = !customStart && "prompt" in event && typeof event.prompt === "string"
+			? event.prompt
+			: undefined;
+		if (prompt !== undefined) latestPrompt = prompt;
 		if (isDisabled(ctx.cwd)) {
 			restorePermittedTools();
 			return;
@@ -1074,7 +1080,7 @@ export default function skillOptimizer(pi: ExtensionAPI) {
 		try {
 			const skills = skillInputs(event.systemPromptOptions.skills ?? []);
 			registry = makeSkillRegistry(skills);
-			initializeToolSelection(state, event.prompt);
+			initializeToolSelection(state, prompt ?? "");
 			maybeShowInitNotice(ctx, state, skills);
 			updateStatus(ctx);
 			return;