v0.2.0

v0.2.0 - 2026-05-21

Added

• Microtask event batching — rapid child session events are coalesced into a single parent invalidate per microtask boundary, preventing UI jank during bursty tool execution.
• Epoch-based invalidation — the spawn renderer uses epoch counters rather than pointer comparison to detect stale sessions, making ownership checks reliable across session resets.

v0.1.0

v0.1.0 - 2026-05-21

Initial release of pi-agenticoding — context management primitives for the pi coding agent: spawn, ledger, and handoff.

Added

Context Management System Prompt

• Automatic system-prompt injection — the LLM receives a context management primer at session start.
• Live ledger listing in system prompt — each session start injects the current ledger entries.

Spawn — Isolate Subtasks in Clean Child Contexts

• spawn tool — delegate isolated work to an in-memory child agent with its own clean context.
• Parallel execution — siblings run concurrently; the parent orchestrates and merges results.
• Child tool inheritance — children receive ledger tools but never spawn or handoff tools.
• Ledger-aware child prompts — child sessions know what ledger entries exist without pre-loading.
• Child output truncation — results limited to 2000 lines / 50KB.
• Explicit model-required error — fails immediately when no model is configured.
• No grandchildren — prevents explosive branching.
• Session lifecycle management — proper cleanup on completion, error, or parent session reset.
• Signal-based cancellation — respects AbortSignal for mid-flight cancellation.

Ledger — Sparse Continuity Cache

• ledger_add tool — save named, compact continuity entries.
• ledger_get tool — retrieve full entry bodies by name.
• ledger_list tool — list all entries with name and first-line preview.
• Persistence across sessions — ledger entries survive context resets, handoffs, and restarts.
• Epoch-based staleness — child ledger tools reject access when parent session was reset.

Handoff — Deliberate Context Compaction

• handoff tool — deliberate compaction replacing noisy context with a clean restart.
• /handoff command — user-facing shortcut for the same.
• Rich compaction summary — inlines referenced ledger entries.
• Clean slot handoff — full history preserved in session file.
• Post-handoff auto-resume — momentum without manual re-prompt.
• Enforcement tracking — prevents the /handoff command from being silently ignored.

Primacy-Zone Watchdog

• Advisory context-usage reminders — injected before each LLM call at 30%/50%/70% thresholds.
• Hidden from user — uses custom role with display: false.

TUI and Status Indicators

• Context usage in status bar — live ctx 65% indicator, color-coded.
• Ledger count indicator — 📒 N badge, hidden when empty.
• /ledger command — shows entries in a TUI notification overlay.
• Live spawn rendering — collapsible child agent sessions with real-time action summaries.
• Render caching — cached by width/expanded/showImages.
• Graceful degradation — recovers from errors without crashing the parent TUI.

Extension Wiring and Lifecycle

• Single state object — shared across hooks, tools, and TUI renderer.
• Session lifecycle hooks — before_agent_start, context, session_start, turn_end, agent_end, session_before_compact.
• Comprehensive test suite — 50+ tests across all primitives.