pi-extensions 0.1.11 → 0.1.13

package/README.md

@@ -6,7 +6,7 @@ Personal extensions for the [Pi coding agent](https://github.com/badlogic/pi-mon
 
 | Extension | Description |
 |-----------|-------------|
-| [/files](files-widget/) | In-terminal file browser and viewer. Navigate files, view diffs, select code, send comments to agent - all without leaving Pi |
+| [/files](files-widget/) | In-terminal file browser and viewer widget. Navigate files, view diffs, select code, send comments to agent - without leaving Pi, and without interrupting your agent |
 | [tab-status](tab-status/) | Manage as many parallel sessions as your mind can handle. Terminal tab indicators for <br>✅ done / 🚧 stuck / 🛑 timed out |
 | [ralph-wiggum](ralph-wiggum/) | Run arbitrarily-long tasks without diluting model attention. Flat version without subagents like [ralph-loop](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/ralph-loop) |
 | [agent-guidance](agent-guidance/) | Switch between Claude/Codex/Gemini with model-specific guidance (CLAUDE.md, CODEX.md, GEMINI.md) |

package/arcade/CHANGELOG.md

@@ -1,4 +1,7 @@
 # Changelog
 
+## 0.1.2 - 2026-01-26
+- Add demo video to README.
+
 ## 0.1.0 - 2026-01-13
 - Initial release.

package/arcade/README.md

@@ -1,5 +1,7 @@
 # arcade
 
+[**▶️ Watch demo**](assets/demo.mp4)
+
 [Snake](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/examples/extensions/snake.ts) is cool, but have you tried:
 
 - **sPIce-invaders** (`/spice-invaders`) - type `clawd` for a special challenge that gets harder every level

package/arcade/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-arcade",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Arcade minigames for the Pi coding agent.",
   "license": "MIT",
   "author": "Thomas Mustier",

package/files-widget/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this extension will be documented in this file.
 
+## [0.1.10] - 2026-01-26
+
+### Fixed
+- Treat git-reported directory entries as directories to avoid viewer errors
+- Guard the viewer against opening directories directly
+- Wrap delta diff output without breaking gutters and avoid truncation
+- Add a safe fallback when `bat` fails to render with wrapping
+
 ## [0.1.9] - 2026-01-26
 
 ### Changed

package/files-widget/README.md

@@ -1,6 +1,6 @@
 # files-widget
 
-In-terminal file browser and viewer for Pi. Navigate files, view diffs, select code, and send comments to the agent without leaving the terminal.
+In-terminal file browser and diff viewer widget for Pi. Navigate files, view diffs, select code, and send comments to the agent without leaving the terminal and without interrupting your agent.
 
 ![Demo](demo.svg)
 

package/files-widget/file-tree.ts

@@ -1,3 +1,4 @@
+import { statSync } from "node:fs";
 import { join } from "node:path";
 
 import { MAX_TREE_DEPTH } from "./constants";
@@ -5,6 +6,14 @@ import type { DiffStats, FileNode, FlatNode } from "./types";
 
 const collator = new Intl.Collator(undefined, { sensitivity: "base" });
 
+function isDirectoryPath(path: string): boolean {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
 function compareNodes(a: FileNode, b: FileNode): number {
   if (a.isDirectory !== b.isDirectory) {
     return a.isDirectory ? -1 : 1;
@@ -153,11 +162,41 @@ export function buildFileTreeFromPaths(
 
     const fileRelPath = parts.join("/");
     if (seenFiles.has(fileRelPath)) continue;
-    seenFiles.add(fileRelPath);
 
     const filePath = join(cwd, fileRelPath);
-    const fileGitStatus = gitStatus.get(fileRelPath);
+    const fileGitStatus = gitStatus.get(fileRelPath) ?? gitStatus.get(`${fileRelPath}/`);
     const fileDiffStats = diffStats.get(fileRelPath);
+    const existingDir = directoryMap.get(fileRelPath);
+
+    if (existingDir) {
+      if (fileGitStatus) {
+        existingDir.gitStatus = fileGitStatus;
+      }
+      if (fileDiffStats) {
+        existingDir.diffStats = fileDiffStats;
+      }
+      continue;
+    }
+
+    const isDirEntry = normalized.endsWith("/") || isDirectoryPath(filePath);
+    if (isDirEntry) {
+      const depth = parts.length;
+      const dirNode: FileNode = {
+        name: fileName,
+        path: filePath,
+        isDirectory: true,
+        children: [],
+        expanded: depth < 1,
+        hasChangedChildren: false,
+        gitStatus: fileGitStatus,
+        diffStats: fileDiffStats,
+      };
+      directoryMap.set(fileRelPath, dirNode);
+      current.children?.push(dirNode);
+      continue;
+    }
+
+    seenFiles.add(fileRelPath);
 
     current.children?.push({
       name: fileName,

package/files-widget/file-viewer.ts

@@ -1,9 +1,157 @@
+import { visibleWidth, wrapTextWithAnsi } from "@mariozechner/pi-tui";
 import { execSync } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { readFileSync, statSync } from "node:fs";
 
 import { isGitRepo } from "./git";
 import { hasCommand, stripLeadingEmptyLines } from "./utils";
 
+const DIFF_CONTENT_PREFIXES = new Set(["+", "-", " "]);
+
+function isDiffContentLine(line: string): boolean {
+  if (!line) return false;
+  if (!DIFF_CONTENT_PREFIXES.has(line[0])) return false;
+  if (line.startsWith("+++ ") || line.startsWith("--- ")) return false;
+  return true;
+}
+
+function wrapLine(line: string, width: number): string[] {
+  if (width <= 0 || line.length <= width) {
+    return [line];
+  }
+  const wrapped: string[] = [];
+  for (let i = 0; i < line.length; i += width) {
+    wrapped.push(line.slice(i, i + width));
+  }
+  return wrapped;
+}
+
+function wrapDiffLines(lines: string[], width: number): string[] {
+  if (width <= 0) return lines;
+  const wrapped: string[] = [];
+  for (const line of lines) {
+    if (line.length <= width) {
+      wrapped.push(line);
+      continue;
+    }
+    if (isDiffContentLine(line)) {
+      const prefix = line[0];
+      const content = line.slice(1);
+      const contentWidth = Math.max(width - 1, 1);
+      for (const chunk of wrapLine(content, contentWidth)) {
+        wrapped.push(prefix + chunk);
+      }
+    } else {
+      wrapped.push(...wrapLine(line, width));
+    }
+  }
+  return wrapped;
+}
+
+function extractAnsiCode(str: string, pos: number): { length: number } | null {
+  if (pos >= str.length || str[pos] !== "\x1b") return null;
+  const next = str[pos + 1];
+  if (next === "[") {
+    let j = pos + 2;
+    while (j < str.length && !/[mGKHJ]/.test(str[j])) j++;
+    if (j < str.length) return { length: j + 1 - pos };
+    return null;
+  }
+  if (next === "]") {
+    let j = pos + 2;
+    while (j < str.length) {
+      if (str[j] === "\x07") return { length: j + 1 - pos };
+      if (str[j] === "\x1b" && str[j + 1] === "\\") return { length: j + 2 - pos };
+      j++;
+    }
+    return null;
+  }
+  if (next === "_") {
+    let j = pos + 2;
+    while (j < str.length) {
+      if (str[j] === "\x07") return { length: j + 1 - pos };
+      if (str[j] === "\x1b" && str[j + 1] === "\\") return { length: j + 2 - pos };
+      j++;
+    }
+    return null;
+  }
+  return null;
+}
+
+function stripAnsiCodes(line: string): string {
+  let result = "";
+  for (let i = 0; i < line.length;) {
+    const ansi = extractAnsiCode(line, i);
+    if (ansi) {
+      i += ansi.length;
+      continue;
+    }
+    result += line[i];
+    i += 1;
+  }
+  return result;
+}
+
+function splitByVisibleWidth(line: string, width: number): { prefix: string; rest: string } {
+  if (width <= 0) return { prefix: "", rest: line };
+  let visible = 0;
+  let i = 0;
+  while (i < line.length) {
+    const ansi = extractAnsiCode(line, i);
+    if (ansi) {
+      i += ansi.length;
+      continue;
+    }
+    const charWidth = visibleWidth(line[i]);
+    if (visible + charWidth > width) break;
+    visible += charWidth;
+    i += 1;
+  }
+  return { prefix: line.slice(0, i), rest: line.slice(i) };
+}
+
+function maskDigits(line: string): string {
+  let result = "";
+  for (let i = 0; i < line.length;) {
+    const ansi = extractAnsiCode(line, i);
+    if (ansi) {
+      result += line.slice(i, i + ansi.length);
+      i += ansi.length;
+      continue;
+    }
+    const char = line[i];
+    result += char >= "0" && char <= "9" ? " " : char;
+    i += 1;
+  }
+  return result;
+}
+
+function wrapDeltaLine(line: string, width: number): string[] {
+  const clean = stripAnsiCodes(line);
+  let separatorIndex = clean.indexOf("│");
+  if (separatorIndex === -1) separatorIndex = clean.indexOf("|");
+  if (separatorIndex === -1) return wrapTextWithAnsi(line, width);
+
+  let prefixWidth = visibleWidth(clean.slice(0, separatorIndex + 1));
+  if (clean[separatorIndex + 1] === " ") prefixWidth += 1;
+  if (prefixWidth >= width) return wrapTextWithAnsi(line, width);
+
+  const { prefix, rest } = splitByVisibleWidth(line, prefixWidth);
+  const contentWidth = Math.max(width - visibleWidth(prefix), 1);
+  const continuationPrefix = maskDigits(prefix);
+  const wrappedContent = wrapTextWithAnsi(rest, contentWidth);
+
+  return wrappedContent.map((chunk, index) => (index === 0 ? prefix : continuationPrefix) + chunk);
+}
+
+function wrapDeltaLines(lines: string[], width: number): string[] {
+  if (width <= 0) return lines;
+  const wrapped: string[] = [];
+  for (const line of lines) {
+    wrapped.push(...wrapDeltaLine(line, width));
+  }
+  return wrapped;
+}
+
 export function loadFileContent(
   filePath: string,
   cwd: string,
@@ -15,23 +163,31 @@ export function loadFileContent(
   const termWidth = width || process.stdout.columns || 80;
 
   try {
+    try {
+      if (statSync(filePath).isDirectory()) {
+        return ["Directory selected - expand it in the file tree instead of opening it."];
+      }
+    } catch {
+      // Ignore stat errors and fall through to normal handling
+    }
+
     if (diffMode && hasChanges && isGitRepo(cwd)) {
       try {
         // Try different diff strategies
         let diffOutput = "";
 
         // First try: unstaged changes
-        const unstaged = execSync(`git diff -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
+        const unstaged = execSync(`git diff --no-color -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
         if (unstaged.trim()) {
           diffOutput = unstaged;
         } else {
           // Second try: staged changes
-          const staged = execSync(`git diff --cached -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
+          const staged = execSync(`git diff --no-color --cached -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
           if (staged.trim()) {
             diffOutput = staged;
           } else {
             // Third try: diff against HEAD (for new files that are staged)
-            const headDiff = execSync(`git diff HEAD -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
+            const headDiff = execSync(`git diff --no-color HEAD -- "${filePath}"`, { cwd, encoding: "utf-8", timeout: 10000, stdio: "pipe" });
             if (headDiff.trim()) {
               diffOutput = headDiff;
             }
@@ -46,7 +202,7 @@ export function loadFileContent(
           // Pipe through delta with line numbers for better readability
           try {
             const deltaOutput = execSync(
-              `delta --no-gitconfig --width=${termWidth} --line-numbers`,
+              `delta --no-gitconfig --width=${termWidth} --line-numbers --wrap-max-lines=unlimited --max-line-length=0`,
               {
                 cwd,
                 encoding: "utf-8",
@@ -55,13 +211,13 @@ export function loadFileContent(
                 stdio: ["pipe", "pipe", "pipe"],
               }
             );
-            return stripLeadingEmptyLines(deltaOutput.split("\n"));
+            return wrapDeltaLines(stripLeadingEmptyLines(deltaOutput.split("\n")), termWidth);
           } catch {
             // Fall back to raw diff
           }
         }
 
-        return diffOutput.split("\n");
+        return wrapDiffLines(stripLeadingEmptyLines(diffOutput.split("\n")), termWidth);
       } catch (e: any) {
         return [`Diff error: ${e.message}`];
       }
@@ -79,10 +235,21 @@ export function loadFileContent(
     }
 
     if (hasCommand("bat")) {
-      return execSync(
-        `bat --style=numbers --color=always --paging=never --wrap=auto --terminal-width=${termWidth} "${filePath}"`,
-        { encoding: "utf-8", timeout: 10000 }
-      ).split("\n");
+      try {
+        return execSync(
+          `bat --style=numbers --color=always --paging=never --wrap=auto --terminal-width=${termWidth} "${filePath}"`,
+          { encoding: "utf-8", timeout: 10000 }
+        ).split("\n");
+      } catch {
+        try {
+          return execSync(
+            `bat --style=numbers --color=always --paging=never --terminal-width=${termWidth} "${filePath}"`,
+            { encoding: "utf-8", timeout: 10000 }
+          ).split("\n");
+        } catch {
+          // Fall through to raw file read
+        }
+      }
     }
 
     const raw = readFileSync(filePath, "utf-8");

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -14,6 +14,10 @@
   },
   "bugs": "https://github.com/tmustier/pi-extensions/issues",
   "homepage": "https://github.com/tmustier/pi-extensions/tree/main/files-widget",
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "^0.50.0",
+    "@mariozechner/pi-tui": "^0.50.0"
+  },
   "pi": {
     "extensions": [
       "index.ts"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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"
-}