pi-repl-py 0.2.5 → 0.2.6

package/README.md

@@ -1,4 +1,4 @@
-# pi-repl
+# pi-repl-py
 
 A [pi](https://pi.dev) extension that gives the agent a single `execute` tool backed by a
 **persistent Python evaluator**: a real `ipython` kernel that keeps variables, functions, imports,
@@ -32,7 +32,15 @@ A plain `pi` session is untouched; the extension is dormant until `--repl` is pa
 
 ## Installing as a pi package
 
-`npm install` runs a `postinstall` that creates the Python venv the evaluator needs, at a stable
+Install the package from npm or directly from GitHub:
+
+```bash
+pi install npm:pi-repl-py
+# or
+pi install github:k3-2o/pi-repl-py
+```
+
+The install runs a `postinstall` that creates the Python venv the evaluator needs, at a stable
 per-user path (`~/.pi/agent/pi-repl/venv`). If `python3` or the network is missing, it prints a
 clear notice. How the interpreter is resolved is in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-repl-py",
-	"version": "0.2.5",
+	"version": "0.2.6",
 	"type": "module",
 	"description": "A pi extension with a single tool: execute, running a TypeScript host with a persistent Python (ipykernel) evaluator and a user-configurable toolbox of functions.",
 	"keywords": [

package/src/extension/prompt.ts

@@ -9,8 +9,7 @@ export const executeToolDescription =
 	"You have one tool: a persistent Python workspace backed by a real `ipython` kernel. " +
 	"Variables, imports, and definitions survive across cells and turns — it is your working memory and action " +
 	"language. " +
-	"Helpers in `~/.pi/agent/pi-repl/helpers/` load at boot; list them with " +
-	"`[k for k in globals() if not k.startswith('_')]`. A cell returns its final expression; printed output is " +
+	"Helpers in `~/.pi/agent/pi-repl/helpers/` load at boot. A cell returns its final expression; printed output is " +
 	"captured separately.";
 
 export const executePromptSnippet =
@@ -40,6 +39,17 @@ export function buildPromptGuidelines(preloaded: string[]): string[] {
 		"Inspect what is present — count, print a few lines, list what is loaded — before committing. Build one " +
 			"step, run it, and use its output to choose the next.",
 		"",
+		"## Precise file and search work",
+		"Search narrowly and inspect only the lines needed. Do not dump whole files or repeat unchanged context. " +
+			"For existing files, prefer a surgical old-text/new-text replacement over rewriting the file. Read the " +
+			"target region first, make the smallest unique replacement, then verify the changed region and file validity. " +
+			"Use complete writes only for new files or intentional full rewrites. Never leave a bare final expression: " +
+			"IPython displays it automatically; assign results and explicitly print only what you need.",
+		"",
+		"## Repository discipline",
+		"Inspect before changing. Preserve project conventions and unrelated content. Make the smallest valid change, " +
+			"verify it afterward, and never invent files, APIs, conventions, or test results.",
+		"",
 		"## Batch and print sparingly",
 		"Batch as much independent work as reasonably possible into one call. Keep large values in variables; " +
 			"print slices, counts, and summaries.",
@@ -48,7 +58,7 @@ export function buildPromptGuidelines(preloaded: string[]): string[] {
 			? [
 					"## Helpers",
 					"User helpers load from `~/.pi/agent/pi-repl/helpers/` as workspace definitions. Their descriptions " +
-						"appear below. List what is loaded with `[k for k in globals() if not k.startswith('_')]`.",
+						"appear below.",
 					"",
 					...preloaded,
 					"",