@leing2021/super-pi 0.25.2 → 0.25.3

package/README.md

@@ -18,7 +18,7 @@ Install, describe what you want to build, then keep saying "continue." Super Pi
 pi install npm:@leing2021/super-pi
 ```
 
----
+> **Project trust (pi ≥ 0.79):** Pi asks before loading project-local settings, resources, and packages. On first use, approve the project trust prompt so Super Pi can read `.pi/settings.json` and load its skills/extensions. Use `pi --approve` for non-interactive runs.
 
 ## Highlights
 

package/extensions/ce-core/index.ts

@@ -1,6 +1,7 @@
 import { readFile } from "node:fs/promises"
 import path from "node:path"
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"
+import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent"
 import { Type } from "typebox"
 import { createArtifactHelperTool, type ArtifactType } from "./tools/artifact-helper"
 import { createAskUserQuestionTool, CUSTOM_SENTINEL } from "./tools/ask-user-question"
@@ -97,15 +98,17 @@ interface StrategySettings {
 }
 
 /**
- * Read settings from two locations:
- * 1. Project-level: {cwd}/.pi/settings.json (highest priority)
- * 2. Global-level: ~/.pi/agent/settings.json (fallback)
+ * Read settings from two locations (config dir honors pi's `CONFIG_DIR_NAME`,
+ * which defaults to `.pi` but is user-configurable since pi 0.79.7):
+ * 1. Project-level: {cwd}/{CONFIG_DIR_NAME}/settings.json (highest priority)
+ * 2. Global-level: ~/{CONFIG_DIR_NAME}/agent/settings.json (fallback)
  *
  * Project-level takes precedence; global-level is used as fallback.
  */
 async function readSettings(cwd: string): Promise<StrategySettings | null> {
+  const agentHome = process.env.HOME || "~"
   // Try project-level first
-  const projectPath = path.join(cwd, ".pi", "settings.json")
+  const projectPath = path.join(cwd, CONFIG_DIR_NAME, "settings.json")
   try {
     const content = await readFile(projectPath, "utf8")
     const projectSettings = JSON.parse(content) as StrategySettings
@@ -118,7 +121,7 @@ async function readSettings(cwd: string): Promise<StrategySettings | null> {
   }
 
   // Fallback to global-level
-  const globalPath = path.join(process.env.HOME || "~", ".pi", "agent", "settings.json")
+  const globalPath = path.join(agentHome, CONFIG_DIR_NAME, "agent", "settings.json")
   try {
     const content = await readFile(globalPath, "utf8")
     return JSON.parse(content) as StrategySettings
@@ -126,8 +129,8 @@ async function readSettings(cwd: string): Promise<StrategySettings | null> {
     // Global settings not found either
   }
 
-  // Try ~/.pi/settings.json as another fallback
-  const altGlobalPath = path.join(process.env.HOME || "~", ".pi", "settings.json")
+  // Try ~/{CONFIG_DIR_NAME}/settings.json as another fallback
+  const altGlobalPath = path.join(agentHome, CONFIG_DIR_NAME, "settings.json")
   try {
     const content = await readFile(altGlobalPath, "utf8")
     return JSON.parse(content) as StrategySettings
@@ -805,7 +808,19 @@ export default function ceCoreExtension(pi: ExtensionAPI) {
     }
   })
 
-  // Tree summary prompt optimizer — keeps branch summaries focused
+  // Branch summary prompt optimizer — appends focus instructions to `/tree`
+  // navigation summaries. `SessionBeforeTreeResult.customInstructions` is
+  // consumed by pi (agent-session.js navigateTree), so this return shape is
+  // effective for branch summaries.
+  //
+  // NOTE on regular context compaction (manual `/compact`, threshold,
+  // overflow): pi's `session_before_compact` result only accepts `cancel` or
+  // a full `compaction` replacement — there is NO prompt-only injection
+  // field (`customInstructions` is an event *input*, not a return value).
+  // So we cannot append focus instructions to regular compaction summaries
+  // without replacing pi's entire summarizer. We deliberately do not hook
+  // `session_before_compact` to avoid dead handlers and needless emit()
+  // overhead on every compaction.
   pi.on("session_before_tree", async (_event, _ctx) => {
     return {
       customInstructions: COMPACTION_FOCUS_INSTRUCTIONS,

package/extensions/ce-core/tools/compaction-optimizer.ts

@@ -2,11 +2,23 @@
 // Compaction Prompt Optimizer
 // ============================================================================
 //
-// Hooks into `session_before_compact` to inject custom instructions that make
-// compaction summaries more focused and useful for coding agent context.
+// Focus instructions injected into pi's branch-summary prompts so summaries
+// stay useful for coding-agent continuation.
 //
-// This is a "prompt-only" optimization — it doesn't replace pi's compaction
-// flow, just adds focus instructions to the summarization prompt.
+// Consumed by the `session_before_tree` hook in `index.ts`, which returns
+// `{ customInstructions, replaceInstructions }`. This return shape IS
+// supported by pi (consumed in `agent-session.js` navigateTree →
+// SessionBeforeTreeResult) and appends focus instructions to summaries
+// generated on `/tree` navigation.
+//
+// Regular context compaction (manual `/compact`, threshold, overflow) is
+// NOT covered: pi's `SessionBeforeCompactResult` only accepts `cancel` or a
+// full `compaction` replacement — there is no prompt-only injection field
+// (`customInstructions` is an event *input*, not a return value). Appending
+// focus instructions there would require replacing pi's entire summarizer,
+// so we deliberately do not hook it.
+//
+// This is a "prompt-only" optimization; it does not replace pi's flows.
 
 /**
  * Custom instructions appended to compaction summarization prompts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leing2021/super-pi",
-  "version": "0.25.2",
+  "version": "0.25.3",
   "private": false,
   "type": "module",
   "description": "Pi-native Compound Engineering package for iterative development workflows",
@@ -35,13 +35,13 @@
     "test": "bun test"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=0.74.0",
-    "@earendil-works/pi-tui": ">=0.74.0",
+    "@earendil-works/pi-coding-agent": ">=0.79.10",
+    "@earendil-works/pi-tui": ">=0.79.10",
     "typebox": ">=1.0.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.76.0",
-    "@earendil-works/pi-tui": "^0.76.0",
+    "@earendil-works/pi-coding-agent": "^0.80.0",
+    "@earendil-works/pi-tui": "^0.80.0",
     "bun-types": "^1.3.12"
   },
   "pi": {