pi-extensions 0.1.12 → 0.1.14

package/files-widget/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this extension will be documented in this file.
 
+## [0.1.11] - 2026-01-26
+
+### Changed
+- Require `bat`, `delta`, and `glow` before opening `/files`
+- Add a postinstall reminder for required system tools
+- Document install commands next to the Pi install steps
+
 ## [0.1.10] - 2026-01-26
 
 ### Fixed

package/files-widget/README.md

@@ -12,6 +12,16 @@ In-terminal file browser and diff viewer widget for Pi. Navigate files, view dif
 pi install npm:@tmustier/pi-files-widget
 ```
 
+Required deps (needed for /files):
+
+```bash
+# macOS (Homebrew)
+brew install bat git-delta glow
+
+# Ubuntu/Debian
+sudo apt-get install -y bat git-delta glow
+```
+
 ```bash
 pi install git:github.com/tmustier/pi-extensions
 ```
@@ -57,17 +67,13 @@ Then reference it in your settings:
 }
 ```
 
-## Dependencies (recommended)
-
-```bash
-brew install bat git-delta glow
-```
+## Dependencies (required)
 
 - `bat`: syntax highlighting
 - `delta`: formatted diffs
 - `glow`: markdown rendering
 
-If any are missing, the extension will notify you at session start and gracefully fall back to plain rendering.
+The `/files` browser requires these tools and will refuse to open until they are installed.
 
 ## Commands
 

package/files-widget/index.ts

@@ -17,10 +17,18 @@ import { hasCommand } from "./utils";
 export default function editorExtension(pi: ExtensionAPI): void {
   const cwd = process.cwd();
   const agentModifiedFiles = new Set<string>();
+  const requiredDeps = ["bat", "delta", "glow"] as const;
+  const getMissingDeps = () => requiredDeps.filter((dep) => !hasCommand(dep));
 
   pi.registerCommand("files", {
     description: "Open file browser",
     handler: async (_args, ctx) => {
+      const missing = getMissingDeps();
+      if (missing.length > 0) {
+        ctx.ui.notify(`files-widget requires ${missing.join(", ")}. Install: brew install bat git-delta glow`, "error");
+        return;
+      }
+
       await ctx.ui.custom<void>((tui, theme, _kb, done) => {
         let pollInterval: ReturnType<typeof setInterval> | null = null;
 
@@ -122,13 +130,9 @@ export default function editorExtension(pi: ExtensionAPI): void {
   });
 
   pi.on("session_start", async (_event, ctx) => {
-    const missing: string[] = [];
-    if (!hasCommand("bat")) missing.push("bat");
-    if (!hasCommand("delta")) missing.push("delta");
-    if (!hasCommand("glow")) missing.push("glow");
-
+    const missing = getMissingDeps();
     if (missing.length > 0) {
-      ctx.ui.notify(`Editor: install ${missing.join(", ")} for better experience`, "info");
+      ctx.ui.notify(`files-widget requires ${missing.join(", ")}. Install: brew install bat git-delta glow`, "error");
     }
 
     agentModifiedFiles.clear();

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -18,6 +18,9 @@
     "@mariozechner/pi-coding-agent": "^0.50.0",
     "@mariozechner/pi-tui": "^0.50.0"
   },
+  "scripts": {
+    "postinstall": "node -e \"console.log('pi-files-widget: required deps: bat, delta, glow. Install with: brew install bat git-delta glow')\""
+  },
   "pi": {
     "extensions": [
       "index.ts"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "private": false,
   "keywords": [
     "pi-package"

package/.ralph/import-cc-codex.md

@@ -1,31 +0,0 @@
-# import-cc-codex implementation loop
-
-## Goals
-- Implement Phase 1 `pi --import <path>` CLI flow.
-- Build Claude Code + Codex transcript parsing + mapping.
-- Add usage exclusion + context estimate for imported ranges.
-- Preserve metadata, ordering, and labels per spec.
-- Prepare for Phase 2 `/import` selector (no UI changes yet unless required).
-
-## Checklist (interleaved)
-1. Wire CLI flags + import entrypoint (imp-001)
-2. Implement parsers + mapping utilities (imp-002)
-3. Add import metadata + labeling (imp-004)
-4. Implement usage exclusion + context estimate (imp-003)
-5. Add tool-output redaction (imp-005)
-6. **Reflection**: summarize what works/doesn’t, adjust plan
-7. **Cleanup**: refactor/simplify, remove redundancy, improve clarity
-8. **Testing**: targeted tests for parsers/mapping
-9. Repeat (1–5) as needed
-10. **Reflection** (periodic)
-11. **Cleanup** (periodic)
-12. **Testing**: broaden scope; move toward E2E once CLI flow is stable
-
-## Acceptance
-- `pi --import <path>` creates a valid Pi session JSONL and opens it.
-- Imported sessions are labeled, metadata preserved, and usage excluded.
-- Deterministic context % works before first new assistant response.
-- Tests cover key parsing and mapping behavior.
-
-## Progress Log
-- 2026-01-13: Wired `--import`/`--source` CLI flags, added core import module for CC/Codex parsing + mapping, updated README CLI docs, and added startup status banner plumbing. Pending: tests, usage exclusion/context estimate, redaction opt-out.

package/.ralph/import-cc-codex.state.json

@@ -1,14 +0,0 @@
-{
-  "name": "import-cc-codex",
-  "taskFile": ".ralph/import-cc-codex.md",
-  "iteration": 1,
-  "maxIterations": 50,
-  "itemsPerIteration": 3,
-  "reflectEvery": 3,
-  "reflectInstructions": "REFLECTION CHECKPOINT\n\nPause and reflect on your progress:\n1. What has been accomplished so far?\n2. What's working well?\n3. What's not working or blocking progress?\n4. Should the approach be adjusted?\n5. What are the next priorities?\n\nUpdate the task file with your reflection, then continue working.",
-  "active": false,
-  "status": "completed",
-  "startedAt": "2026-01-13T13:32:49.696Z",
-  "lastReflectionAt": 0,
-  "completedAt": "2026-01-13T13:33:21.479Z"
-}

package/.ralph/mario-not-impl.md

@@ -1,69 +0,0 @@
-# Badlogic Game Implementation
-
-## Goal
-Implement `/badlogic-game` per `badlogic-game/spec.md` with deterministic core logic, reliable tests (unit + integration + E2E), and incremental milestones.
-
-## Loop Protocol
-- Work on 1 feature per iteration (small, shippable, testable).
-- Each iteration MUST:
-  - Add or extend at least 1 regression test (unit or integration).
-  - Add or extend at least 1 E2E scripted scenario (headless run with golden frame or state snapshot).
-  - Record verification evidence (commands + results) in Reflection.
-- After each story, do a quick refactor pass to keep code concise and modular.
-- Keep diffs small; commit once the feature passes verification.
-- Self-reflect every iteration and adjust plan if needed.
-
-## Refactor Principles
-- Keep files under ~400 LOC; split by responsibility (engine, render, entities, input, levels).
-- Prefer pure functions and deterministic state updates; avoid hidden globals.
-- Consolidate constants (tiles, glyphs, physics) in one place.
-- Eliminate duplication by extracting helpers and data tables.
-
-## Typing Strategy
-- Use `// @ts-check` + JSDoc types for strict checks without a build step.
-- Add `badlogic-game/tsconfig.json` with `checkJs`, `strict`, `noEmit`.
-- Typecheck command: `npx tsc --noEmit -p badlogic-game/tsconfig.json` (record results).
-
-## Verifiability Standard
-- Unit tests: physics tick, jump apex, collision resolution, serialization.
-- Integration tests: deterministic input sequences -> expected positions/collisions/state transitions.
-- E2E tests: scripted input -> render frames or HUD/state snapshots; compare to golden fixtures.
-- Manual checks: milestone smoke test in a live TUI session (M1..M4).
-
-## Feature Checklist
-- [x] Story 0: Test harness + engine/core separation
-  - Decide runner (node:test vs custom) and structure
-  - Deterministic RNG + headless renderer
-- [x] Quality: strict typing setup (tsconfig + @ts-check)
-- [x] Story 1: Core loop (map, movement, gravity, collision, camera clamp, Level 1)
-- [x] Story 2: Enemies + stomp + hazards
-- [x] Story 3: Blocks + coins + scoring + HUD
-- [x] Story 4: Power-ups (mushroom) + big state
-- [x] Story 5: Save/resume + pause/quit
-- [x] Story 6: Polish (particles, text cues, camera dead-zone)
-- [x] Docs + wiring: `/badlogic-game` command registration and README update
-- [ ] Final: full test run + manual E2E checks; update harness logs
-
-## Milestone Gates
-- [x] M1: Story 1 + test harness + E2E scenario
-- [x] M2: Story 2 + tests + E2E scenario
-- [x] M3: Story 3/4 + tests + E2E scenario
-- [ ] M4: Story 5/6 + tests + manual run
-
-## References
-- Spec: `badlogic-game/spec.md`
-- Existing WIP: `arcade/wip/badlogic-game.ts`
-
-## Reflection (Iteration 35)
-1. What has been accomplished so far?
-   - Added invuln save regression test and paused cue frame E2E fixture.
-   - Verification: `node --test badlogic-game/tests/*.test.js` -> 77 pass; `npx tsc --noEmit -p badlogic-game/tsconfig.json` -> ok.
-2. What's working well?
-   - Invuln persistence and paused cue overlay are covered deterministically.
-3. What's not working or blocking progress?
-   - Manual M4 run still pending (interactive UI required).
-4. Should the approach be adjusted?
-   - No; keep manual run as final gate.
-5. What are the next priorities?
-   - M4 manual run.
-   - Final: update harness logs.

package/.ralph/mario-not-impl.state.json

@@ -1,14 +0,0 @@
-{
-  "name": "badlogic-game-impl",
-  "taskFile": ".ralph/badlogic-game-impl.md",
-  "iteration": 35,
-  "maxIterations": 80,
-  "itemsPerIteration": 1,
-  "reflectEvery": 1,
-  "reflectInstructions": "REFLECTION CHECKPOINT\n\nPause and reflect on your progress:\n1. What has been accomplished so far?\n2. What's working well?\n3. What's not working or blocking progress?\n4. Should the approach be adjusted?\n5. What are the next priorities?\n\nUpdate the task file with your reflection, then continue working.",
-  "active": false,
-  "status": "completed",
-  "startedAt": "2026-01-09T03:55:16.633Z",
-  "lastReflectionAt": 35,
-  "completedAt": "2026-01-09T09:09:36.947Z"
-}

package/.ralph/mario-not-spec.md

@@ -1,163 +0,0 @@
-# Badlogic Game Spec
-
-## Goal
-Create a comprehensive Mario-style TUI extension spec in `badlogic-game/spec.md` with list-based outline and detailed, verifiable content. Each sub-subsection must include design intent + implementation guidance so it is directly actionable for engineering.
-
-## Requirements
-- Use list items + subitems for the outline and content.
-- Draft section-by-section via ralph loop iterations.
-- Iterate at the level of every sub-subsection (e.g., target size, scroll rules).
-- After completing each sub-section (e.g., Player Experience & Feel), reflect on coherence and adjust if needed.
-- Final coherence reflection at end of doc; adjust as needed.
-- Commit after each major section: Core Gameplay, Presentation, Tech + Delivery.
-
-## Planned Sections
-1) Core Gameplay
-  - Player Experience & Feel
-    - Time-to-fun / quick boot
-    - Pace / difficulty ramp
-    - Failure/respawn cadence
-    - Feel targets vs SMB1
-  - Controls & Input
-    - Key mapping
-    - Input buffering
-    - Pausing/quitting/restart
-  - Game Loop & States
-    - State machine
-    - Transitions
-  - Level Design
-    - Tile palette
-    - Layout rules
-    - Level 1 (short)
-  - Entities & Interactions
-    - Player
-    - Blocks
-    - Items
-    - Enemies
-    - Hazards
-  - Physics & Movement
-    - Gravity / accel / friction
-    - Jump (variable)
-    - Collision resolution
-
-2) Presentation
-  - Camera & Viewport
-    - Target size
-    - Scroll rules
-    - Bounds/edges
-  - Rendering & Palette
-    - 256-color plan
-    - Glyphs / tiles
-  - HUD & Scoring
-    - HUD layout
-    - Score/lives/time/coins
-  - FX & Feedback (optional)
-    - Particles
-    - Text cues
-
-3) Tech + Delivery
-  - Save/Resume
-    - Autosave cadence
-    - Persisted fields
-    - Resume behavior
-  - Technical Architecture
-    - Data model
-    - Update order
-    - Collision handling
-    - Input handling
-    - Serialization
-  - Feature Stories & Sequencing
-  - Test Plan
-  - Milestones
-  - Open Questions
-
-## Checklist
-- [x] Create `badlogic-game/spec.md` with list-based scaffold
-- [x] Draft Core Gameplay subsections (reflect + adjust after each)
-  - [x] Player Experience & Feel > Time-to-fun / quick boot
-  - [x] Player Experience & Feel > Pace / difficulty ramp
-  - [x] Player Experience & Feel > Failure/respawn cadence
-  - [x] Player Experience & Feel > Feel targets vs SMB1
-  - [x] Controls & Input > Key mapping
-  - [x] Controls & Input > Input buffering
-  - [x] Controls & Input > Pausing/quitting/restart
-  - [x] Game Loop & States > State machine
-  - [x] Game Loop & States > Transitions
-  - [x] Level Design > Tile palette
-  - [x] Level Design > Layout rules
-  - [x] Level Design > Level 1 (short)
-  - [x] Entities & Interactions > Player
-  - [x] Entities & Interactions > Blocks
-  - [x] Entities & Interactions > Items
-  - [x] Entities & Interactions > Enemies
-  - [x] Entities & Interactions > Hazards
-  - [x] Physics & Movement > Gravity / accel / friction
-  - [x] Physics & Movement > Jump (variable)
-  - [x] Physics & Movement > Collision resolution
-- [x] Commit Core Gameplay section
-- [x] Draft Presentation subsections (reflect + adjust after each)
-  - [x] Camera & Viewport > Target size
-  - [x] Camera & Viewport > Scroll rules
-  - [x] Camera & Viewport > Bounds/edges
-  - [x] Rendering & Palette > 256-color plan
-  - [x] Rendering & Palette > Glyphs / tiles
-  - [x] HUD & Scoring > HUD layout
-  - [x] HUD & Scoring > Score/lives/time/coins
-  - [x] FX & Feedback > Particles
-  - [x] FX & Feedback > Text cues
-- [x] Commit Presentation section
-- [x] Draft Tech + Delivery subsections (reflect + adjust after each)
-  - [x] Save/Resume > Autosave cadence
-  - [x] Save/Resume > Persisted fields
-  - [x] Save/Resume > Resume behavior
-  - [x] Technical Architecture > Data model
-  - [x] Technical Architecture > Update order
-  - [x] Technical Architecture > Collision handling
-  - [x] Technical Architecture > Input handling
-  - [x] Technical Architecture > Serialization
-  - [x] Feature Stories & Sequencing
-  - [x] Test Plan
-  - [x] Milestones
-  - [x] Open Questions
-- [x] Commit Tech + Delivery section
-- [x] Final coherence reflection; adjust doc as needed
-
-## Reflection (Iteration 46)
-1. What has been accomplished so far?
-   - Completed final coherence pass; clarified player glyph sizing.
-2. What's working well?
-   - All sections align on sizes, timings, and rendering constraints.
-3. What's not working or blocking progress?
-   - Nothing blocked.
-4. Should the approach be adjusted?
-   - No; spec is complete.
-5. What are the next priorities?
-   - None; ready to stop loop.
-
-## Coherence Checks
-- Physics & Movement: collision ordering aligns with stomp and head-bump rules.
-
-## Tech + Delivery Coherence Check (Iteration 45)
-- Save cadence aligns with resume behavior and pause/quit rules.
-- Data model fields cover persisted fields list.
-- Serialization versioning aligns with SaveState schema.
-- Stories/milestones reflect the same delivery order.
-
-## Final Coherence Check (Iteration 46)
-- Glyph sizing clarified for player big state (1x3 tiles).
-- Run modifier, jump buffer, and physics values are consistent.
-- Save/resume flow matches input and state machine rules.
-
-## Presentation Coherence Check (Iteration 32)
-- Viewport size supports HUD lines and 2-char tile grid without wrap.
-- Camera rules align with bounds clamp and no vertical scroll assumption.
-- Glyphs/tiles use ASCII and 2-char width consistent with rendering plan.
-- HUD fields (score/coins/lives/time) match scoring spec values.
-- FX cues are lightweight and don't conflict with HUD overlays.
-
-## Core Gameplay Coherence Check (Iteration 22)
-- Consistency: run modifier defined in Controls; referenced in Physics and feel targets.
-- Timing: coyote/jump buffer values consistent between Input and Jump sections.
-- Level 1: pacing, layout rules, and hazards align with speed/jump targets.
-- Death loop: hazards, enemies, and respawn cadence agree on invuln timing and lives.
-- Tile palette: blocks/items/hazards align with symbols; ensure rendering uses same glyphs.

package/.ralph/mario-not-spec.state.json

@@ -1,14 +0,0 @@
-{
-  "name": "badlogic-game-spec",
-  "taskFile": ".ralph/badlogic-game-spec.md",
-  "iteration": 46,
-  "maxIterations": 60,
-  "itemsPerIteration": 1,
-  "reflectEvery": 1,
-  "reflectInstructions": "REFLECTION CHECKPOINT\n\nPause and reflect on your progress:\n1. What has been accomplished so far?\n2. What's working well?\n3. What's not working or blocking progress?\n4. Should the approach be adjusted?\n5. What are the next priorities?\n\nUpdate the task file with your reflection, then continue working.",
-  "active": false,
-  "status": "completed",
-  "startedAt": "2026-01-08T22:35:44.127Z",
-  "lastReflectionAt": 46,
-  "completedAt": "2026-01-08T23:04:52.947Z"
-}

package/.ralph/todo-app-plan.state.json

@@ -1,14 +0,0 @@
-{
-  "name": "todo-app-plan",
-  "taskFile": ".ralph/todo-app-plan.md",
-  "iteration": 1,
-  "maxIterations": 50,
-  "itemsPerIteration": 3,
-  "reflectEvery": 10,
-  "reflectInstructions": "REFLECTION CHECKPOINT\n\nPause and reflect on your progress:\n1. What has been accomplished so far?\n2. What's working well?\n3. What's not working or blocking progress?\n4. Should the approach be adjusted?\n5. What are the next priorities?\n\nUpdate the task file with your reflection, then continue working.",
-  "active": false,
-  "status": "completed",
-  "startedAt": "2026-01-26T17:22:57.476Z",
-  "lastReflectionAt": 0,
-  "completedAt": "2026-01-26T17:23:25.779Z"
-}