pi-extensions 0.1.38 → 0.1.40

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [0.1.40] - 2026-05-07
+
+### Changed
+- Declare `@earendil-works` Pi peer and development dependencies for the bundled extensions.

package/agent-guidance/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.5] - 2026-05-07
+
+### Changed
+- Declare the `@earendil-works/pi-coding-agent` peer and development dependency used by runtime imports.
+- Update Pi extension imports to the new `@earendil-works` namespace.
+
+## 0.1.4 - 2026-04-28
+
+### Changed
+- Templates simplified to focus on durable behavioural overrides:
+  - `CODEX.md`: replaces the previous agent-protocol prose with two blocks for OpenAI models — `<solution_persistence>` (autonomy + bias for action + persist till done + no quality-for-tokens trade) and `<validation>` (run validators before summarizing or committing; fix failures before finalizing).
+  - `GEMINI.md`: replaces the empty placeholder with a `<tool_usage_rules>` block that steers Gemini to pi's `read`/`write`/`edit` tools instead of `cat`/heredoc/`sed -i`/etc.
+
 ## 0.1.3 - 2026-02-03
 
 ### Changed

package/agent-guidance/README.md

@@ -78,8 +78,8 @@ Links the extension to `~/.pi/agent/extensions/` and helps you set up `AGENTS.md
 
 Starter templates in `templates/`:
 - `CLAUDE.md` - Claude-specific guidelines
-- `CODEX.md` - OpenAI guidelines (from [steipete/agent-scripts](https://github.com/steipete/agent-scripts))
-- `GEMINI.md` - Gemini guidelines
+- `CODEX.md` - OpenAI guidelines: `<solution_persistence>` (bias for action, persist till the task is done) and `<validation>` (run tests/lint/typecheck/build before summarizing or committing)
+- `GEMINI.md` - Gemini guidelines: `<tool_usage_rules>` steering the model to pi's `read`/`write`/`edit` tools instead of `cat`/`heredoc`/`sed -i`/etc.
 
 Install with:
 ```bash

package/agent-guidance/agent-guidance.ts

@@ -11,7 +11,7 @@
 
 import * as fs from "node:fs";
 import * as path from "node:path";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 const PROVIDER_FILES: Record<string, string[]> = {
 	anthropic: ["CLAUDE.md"],

package/agent-guidance/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-agent-guidance",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Loads provider-specific context files (CLAUDE.md, CODEX.md, GEMINI.md) based on current model.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -18,5 +18,11 @@
     "extensions": [
       "agent-guidance.ts"
     ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0"
   }
 }

package/agent-guidance/templates/CODEX.md

@@ -1,92 +1,14 @@
-# CODEX.md
-
-Adapted from [steipete/agent-scripts](https://github.com/steipete/agent-scripts/blob/main/AGENTS.MD).
-
-Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
-
-## Agent Protocol
-- PRs: use `gh pr view/diff` (no URLs).
-- Guardrails: use `trash` for deletes when available.
-- Need upstream file: stage in `/tmp/`, then cherry-pick; never overwrite tracked.
-- Bugs: add regression test when it fits.
-- Keep files <~500 LOC; split/refactor as needed.
-- Commits: Conventional Commits (`feat|fix|refactor|build|ci|chore|docs|style|perf|test`).
-- CI: `gh run list/view` (rerun/fix til green).
-- Prefer end-to-end verify; if blocked, say what's missing.
-- New deps: quick health check (recent releases/commits, adoption).
-- Web: search early; quote exact errors; prefer 2024–2025 sources.
-- Style: telegraph. Drop filler/grammar. Min tokens.
-
-## Screenshots
-- Size: `sips -g pixelWidth -g pixelHeight <file>` (prefer 2×).
-- Optimize: `imageoptim <file>` (install: `brew install imageoptim-cli`).
-- Replace asset; keep dimensions; commit; run gate; verify CI.
-
-## Docs
-- Start: check for docs list script; open docs before coding.
-- Follow links until domain makes sense.
-- Keep notes short; update docs when behavior/API changes (no ship w/o docs).
-
-## PR Feedback
-- Active PR: `gh pr view --json number,title,url --jq '"PR #\\(.number): \\(.title)\\n\\(.url)"'`.
-- PR comments: `gh pr view …` + `gh api …/comments --paginate`.
-- Replies: cite fix + file/line; resolve threads only after fix lands.
-- When merging a PR: thank the contributor in `CHANGELOG.md`.
-
-## Flow & Runtime
-- Use repo's package manager/runtime; no swaps w/o approval.
-- Use background tasks for long jobs; tmux only for interactive/persistent (debugger/server).
-
-## Build / Test
-- Before handoff: run full gate (lint/typecheck/tests/docs).
-- CI red: `gh run list/view`, rerun, fix, push, repeat til green.
-- Keep it observable (logs, panes, tails).
-
-## Git
-- Safe by default: `git status/diff/log`. Push only when user asks.
-- `git checkout` ok for PR review / explicit request.
-- Branch changes require user consent.
-- Destructive ops forbidden unless explicit (`reset --hard`, `clean`, `restore`, `rm`, …).
-- Don't delete/rename unexpected stuff; stop + ask.
-- No repo-wide S/R scripts; keep edits small/reviewable.
-- Avoid manual `git stash`; if Git auto-stashes during pull/rebase, that's fine.
-- If user types a command ("pull and push"), that's consent for that command.
-- No amend unless asked.
-- Big review: `git --no-pager diff --color=never`.
-- Multi-agent: check `git status/diff` before edits; ship small commits.
-
-## Language/Stack Notes
-- Swift: validate `swift build` + tests; keep concurrency attrs right.
-- TypeScript: use repo PM; keep files small; follow existing patterns.
-
-## Critical Thinking
-- Fix root cause (not band-aid).
-- Unsure: read more code; if still stuck, ask w/ short options.
-- Conflicts: call out; pick safer path.
-- Unrecognized changes: assume other agent; keep going; focus your changes. If it causes issues, stop + ask user.
-- Leave breadcrumb notes in thread.
-
-## Tools
-
-### trash
-- Move files to Trash: `trash …` (safer than rm).
-
-### gh
-- GitHub CLI for PRs/CI/releases. Given issue/PR URL: use `gh`, not web search.
-- Examples: `gh issue view <url> --comments -R owner/repo`, `gh pr view <url> --comments --files -R owner/repo`.
-
-### tmux
-- Use only when you need persistence/interaction (debugger/server).
-- Quick refs: `tmux new -d -s shell`, `tmux attach -t shell`, `tmux list-sessions`, `tmux kill-session -t shell`.
-
-<frontend_aesthetics>
-Avoid "AI slop" UI. Be opinionated + distinctive.
-
-Do:
-- Typography: pick a real font; avoid Inter/Roboto/Arial/system defaults.
-- Theme: commit to a palette; use CSS vars; bold accents > timid gradients.
-- Motion: 1–2 high-impact moments (staggered reveal beats random micro-anim).
-- Background: add depth (gradients/patterns), not flat default.
-
-Avoid: purple-on-white clichés, generic component grids, predictable layouts.
-</frontend_aesthetics>
+<solution_persistence>
+  - Treat yourself as an autonomous senior pair-programmer: once the user gives a direction, proactively gather context, plan, implement, test, and refine without waiting for additional prompts at each step.
+  - Persist until the task is fully and comprehensively handled end-to-end within the current turn whenever feasible: do not stop at analysis or partial searches or fixes; carry changes through search, implementation, verification, and a clear explanation of outcomes unless the user explicitly pauses or redirects you.
+  - Be extremely biased for action. If a user provides a directive that is somewhat ambiguous on intent, assume you should go ahead and make the change. If the user asks a question like "should we do x?" and your answer is "yes", you should also go ahead and perform the action. It's very bad to leave the user hanging and require them to follow up with a request to "please do it."
+  - Never preserve tokens at the cost of comprehensiveness, correctness, or quality of the solution. Always prioritize delivering a complete, well-researched, correct, high-quality solution over minimizing token usage.
+</solution_persistence>
+
+<validation>
+Testing Gate (MANDATORY)
+  - After any file edit or code generation that changes files, run the project's validators before summarizing work or executing any commit/push. These typically include tests, type checks, linters, and build commands. Do not run build unnecessarily.
+  - Determine the validation commands; if unclear, search the repo.
+  - Favor fast checks scoped to changes during iteration; reserve full-suite runs for milestone points (e.g. pre-commit, before summarizing work, or when requested).
+  - If final validators fail, stop and fix failures, then rerun validators; never finalize or commit with failing validators unless the user explicitly approves skipping.
+</validation>

package/agent-guidance/templates/GEMINI.md

@@ -1,5 +1,18 @@
-# GEMINI.md
+<tool_usage_rules>
+CRITICAL: You have dedicated tools for file I/O. Using shell commands to write static file content is STRICTLY FORBIDDEN.
 
-Gemini-specific guidelines. Loaded when using Google models.
+## MANDATORY Tool Mappings
 
-<!-- Add your Gemini-specific preferences here -->
+| Operation | CORRECT (use this) | FORBIDDEN via bash (never do this) |
+|-----------|-------------------|-------------------------------------|
+| Read a file | `read` tool | `cat file`, `head file`, `tail file`, `less`, `more` |
+| Create/write a file | `write` tool | `cat << EOF > file`, `echo "..." > file`, `printf > file`, `tee` |
+| Edit/modify a file | `edit` tool | `sed -i`, `awk -i inplace`, `perl -pi -e` |
+
+## Rules
+1. The `bash` tool is ONLY for running programs, builds, tests, installing packages, and other genuine shell operations.
+2. NEVER use `bash` to read file contents. Always use the `read` tool.
+3. NEVER use `bash` with heredocs (`cat << EOF`) or shell redirects to write static content to files. Always use `write` or `edit`. Running a program that produces output files (e.g. `python3 train.py > log.txt`, `gcc -o binary main.c`) is fine.
+4. If you catch yourself writing a shell command that dumps known text into a file, STOP and use `write` or `edit` instead.
+5. Prefer the `grep`, `find`, and `ls` built-in tools over running them via bash when possible.
+</tool_usage_rules>

package/arcade/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.1.6] - 2026-05-07
+
+### Changed
+- Declare the `@earendil-works` Pi peer and development dependencies used by runtime imports.
+- Update Pi extension imports to the new `@earendil-works` namespace.
+
 ## 0.1.5 - 2026-02-03
 - Add preview video metadata for the extension listing.
 

package/arcade/mario-not/mario-not.ts

@@ -2,8 +2,8 @@
  * Mario-Not - a Mario-style TUI platformer. Play with /mario-not
  */
 
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 const {
 	createGame,

package/arcade/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-arcade",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Arcade minigames for the Pi coding agent.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -23,5 +23,13 @@
       "mario-not/mario-not.ts"
     ],
     "video": "https://raw.githubusercontent.com/tmustier/pi-extensions/main/arcade/assets/demo.mp4"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-tui": "^0.74.0"
   }
 }

package/arcade/picman.ts

@@ -2,8 +2,8 @@
  * Picman - Pi eats tokens, avoids bugs! Play with /picman
  */
 
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 const TICK_MS = 100;
 const POWER_DURATION = 50;

package/arcade/ping.ts

@@ -2,8 +2,8 @@
  * Ping game extension - play with /ping
  */
 
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 const GAME_WIDTH = 24;
 const GAME_HEIGHT = 14;

package/arcade/spice-invaders.ts

@@ -2,8 +2,8 @@
  * sPIce Invaders game extension - play with /spice-invaders
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 const GAME_WIDTH = 24;
 const GAME_HEIGHT = 16;

package/arcade/tetris.ts

@@ -2,8 +2,8 @@
  * Tetris game extension - play with /tetris
  */
 
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 const BOARD_WIDTH = 10;
 const BOARD_HEIGHT = 20;

package/code-actions/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.1.5] - 2026-05-07
+
+### Changed
+- Declare the `@earendil-works` Pi peer and development dependencies used by runtime imports.
+- Update Pi extension imports to the new `@earendil-works` namespace.
+
 ## 0.1.4 - 2026-02-03
 - Add preview image metadata for the extension listing.
 

package/code-actions/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { extractSnippets, extractText } from "./src/snippets";
 import type { Snippet } from "./src/snippets";
 import { pickAction, pickSnippet } from "./src/ui";

package/code-actions/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-code-actions",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Pick code blocks or inline snippets from recent assistant messages to copy or insert.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -19,5 +19,13 @@
       "index.ts"
     ],
     "image": "https://github.com/user-attachments/assets/0dc10a64-d61f-4b56-9684-5e448c759385"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-tui": "^0.74.0"
   }
 }

package/code-actions/src/actions.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { Container, Text, matchesKey, truncateToWidth } from "@mariozechner/pi-tui";
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { Container, Text, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";

package/code-actions/src/search.ts

@@ -1,4 +1,4 @@
-import type { SelectItem } from "@mariozechner/pi-tui";
+import type { SelectItem } from "@earendil-works/pi-tui";
 import type { Snippet } from "./snippets";
 import { getSnippetPreview } from "./snippets";
 

package/code-actions/src/ui.ts

@@ -1,6 +1,6 @@
-import type { ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
-import { Container, type SelectItem, SelectList, Text, matchesKey } from "@mariozechner/pi-tui";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import { Container, type SelectItem, SelectList, Text, matchesKey } from "@earendil-works/pi-tui";
 import type { Snippet } from "./snippets";
 import { getSnippetPreview, truncatePreview } from "./snippets";
 import { buildSearchIndex, rankedFilterItems } from "./search";

package/files-widget/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this extension will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.21] - 2026-05-07
+
+### Changed
+- Declare `@earendil-works` Pi development dependencies used by runtime imports.
+- Update Pi extension imports and peer dependencies to the new `@earendil-works` namespace.
+
+
 ## [0.1.20] - 2026-04-24
 
 ### Removed

package/files-widget/browser.ts

@@ -1,5 +1,5 @@
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { Key, matchesKey, truncateToWidth } from "@mariozechner/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { Key, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import { lstatSync, realpathSync, statSync } from "node:fs";
 import { readdir, readFile, realpath, stat } from "node:fs/promises";
 import { homedir } from "node:os";