@hheei/pi-debug0.2.0

Development diagnostics and TUI replay tools for Pi extensions.

GitHub Actions Published 16 days ago MIT ~458 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

@hheei/pi-debug

Development diagnostics, prompt cache analysis, and TUI replay tools for Pi extensions.

pi install npm:@hheei/pi-debug

Features

Prompt cache debugger

Hash-only provider payload diagnostics correlated with cacheRead and cacheWrite. The Pi extension exposes /cache-debug and records structured JSONL traces without storing sensitive prompt or response text.

Command: /cache-debug in Pi TUI mode.
See the Cache Debugging Guide for detailed trace interpretation.

Deterministic TUI Replay

Headless component replay with input, keystrokes, resize events, artificial wait timers, and optional real-model responses. Captures clean ANSI terminal frames and exports plain text, ANSI, SVG, or metadata artifacts for documentation and snapshot testing.

See the TUI Replay Guide for replay scripting and CLI parameters.

Package entry points

@hheei/pi-debug                 Pi extension and cache probe API
@hheei/pi-debug/tui-replay      Deterministic TUI replay library
pi-tui-replay                   Automatic replay and shell snapshot CLI
replay                          Incremental action-journal CLI

Development

pnpm test -- packages/pi-debug/test
pnpm run test:integration
pnpm run typecheck