@oh-my-pi/pi-coding-agent 13.19.0 → 14.0.2

package/CHANGELOG.md

@@ -2,7 +2,264 @@
 
 ## [Unreleased]
 
+## [14.0.2] - 2026-04-09
+### Added
+
+- Added `/force` slash command to force the next agent turn to use a specific tool
+- Added `ToolChoiceQueue` for managing tool-choice directives with lifecycle callbacks and requeue semantics
+- Added `setForcedToolChoice()` method to AgentSession to programmatically force tool invocations
+- Added `toolChoiceQueue` property to AgentSession for direct queue access
+- Added `peekQueueInvoker()` method to AgentSession to retrieve in-flight tool invocation handlers
+- Added `queueResolveHandler()` function as the canonical entry point for preview/apply workflows
+- Added `buildToolChoice()` and `steer()` methods to ToolSession for tool-choice queue integration
+- Added `getToolChoiceQueue()` method to ToolSession for accessing the tool-choice queue
+- Added support for embedded URL selectors (`:raw` and `:L#-L#` line ranges) in read command paths
+- Added `parseReadUrlTarget` function to parse and validate URL read targets with line range support
+- Added `decl` region to chunk selector for targeting declarations without leading trivia
+- Exported `hooks` subpath for extensibility API access
+- Added `build` script for compiling binary artifacts
+
+### Changed
+
+- Refactored pending action handling from `PendingActionStore` to `ToolChoiceQueue` with generator-based directives
+- Changed tool-choice override mechanism from simple override to a queue-based system with callbacks
+- Updated `ResolveTool` to dispatch to in-flight queue invokers instead of popping from a pending action store
+- Updated custom tool loader to accept `pushPendingAction` callback instead of `PendingActionStore` instance
+- Updated `AstEditTool` to use `queueResolveHandler()` for preview/apply semantics
+- Changed eager-todo prelude to use the tool-choice queue instead of simple override
+- Updated todo reminder suppression to check for user-forced directives via `consumeLastServedLabel()`
+- Made model-specific edit mode defaults conditional on `PI_STRICT_EDIT_MODE` environment variable for greater flexibility in edit mode selection
+- Updated slash command handlers to support returning remaining text as prompt input instead of consuming input entirely
+- Enhanced slash command parser to recognize both whitespace and colon (`:`) as command argument separators
+- Updated indentation guidance for chunk edit content to use single leading spaces per indent level instead of tabs
+- Updated read CLI to delegate URL inputs through the read tool pipeline instead of treating them as local file paths
+- Updated chunk edit documentation to clarify region semantics and emphasize using the narrowest region for edits
+- Improved chunk selector guidance with visual diagram showing region boundaries
+- Renamed `build:binary` script to `build`
+- Refactored `check` script to include linting via Biome and type checking
+- Added `check:types`, `lint`, `fmt`, and `fix` scripts for improved developer workflow
+- Simplified TypeScript configuration by extending workspace-level config
+
+### Removed
+
+- Removed `PendingActionStore` class and related pending-action module
+- Removed `pendingActionStore` parameter from AgentSession config
+- Removed `pendingActionStore` from ToolSession interface
+- Removed `consumeNextToolChoiceOverride()` method from AgentSession (replaced by `nextToolChoice()`)
+
+### Fixed
+
+- Fixed tool-choice queue cleanup on agent loop abort to prevent orphaned in-flight directives
+- Fixed requeue semantics to preserve `onInvoked` and `onRejected` callbacks across multiple abort cycles
+
+## [14.0.1] - 2026-04-08
+
+### Changed
+
+- Improved auto-generated file detection to gracefully handle ENOENT errors when peeking file content, preventing unnecessary abort failures
+- Optimized context emission by skipping message cloning when no extensions have context handlers
+- Improved message cloning resilience by falling back to shallow array clone when structured cloning fails due to non-cloneable objects
+- Made `assertEditableFileContent` synchronous instead of async for improved performance in streaming edit checks
+- Enhanced streaming edit abort detection to check for auto-generated files as soon as the file path is available, rather than waiting for the full diff
+- Improved file prefix reading in session storage to use `peekFile` utility from @oh-my-pi/pi-utils for better efficiency
+- Moved image metadata detection to @oh-my-pi/pi-utils package for shared use across projects
+- Simplified image loading API by removing redundant metadata parameters and consolidating image utilities
+- Updated imports to use readImageMetadata and parseImageMetadata from @oh-my-pi/pi-utils instead of local implementations
+
+### Removed
+
+- Removed image-input.ts utility module; functionality consolidated into image-loading.ts
+- Removed mime.ts utility module; MIME detection moved to @oh-my-pi/pi-utils
+- Removed ImageMetadata interface and ReadImageMetadataOptions from local codebase
+
+### Fixed
+
+- Fixed streaming edit abort for auto-generated files by adding LRU caching and early path-based detection to prevent unnecessary edits
+
+## [14.0.0] - 2026-04-08
+
+### Breaking Changes
+
+- Simplified chunk edit operations: removed `append_child`, `prepend_child`, `append_sibling`, `prepend_sibling`, and `replace_body` ops in favor of unified `replace`, `before`, `after`, `prepend`, and `append` with region targeting (`@head`, `@body`, `@tail`)
+- Chunk edit `target` format changed: now accepts `selector#CRC@region` for mutations and `selector@region` for insertions; removed separate `crc` and `anchor` fields from edit operations
+- Removed checksum requirement from insert operations (`before`, `after`, `prepend`, `append`); only `replace` requires `#CRC` suffix
+
+### Added
+
+- Auto QA tool (`report_tool_issue`) for automated tracking of unexpected tool behavior; enabled via `PI_AUTO_QA=1` environment variable or `dev.autoqa` setting
+- `dev.autoqa` setting to enable automated tool issue reporting for all agents
+- System prompt guidance when `report_tool_issue` tool is available, encouraging agents to report tool behavior discrepancies
+- LSP server discovery at startup via `discoverStartupLspServers()` to detect configured language servers without blocking initialization
+- LSP startup event channel (`lsp:startup`) for asynchronous server warmup notifications with completion or failure status
+- `LspStartupServerInfo` type for tracking LSP server status including connecting, ready, and error states
+- LSP server status display in `/info` command showing connecting, ready, and error states with color-coded indicators
+- Multi-session support in ACP mode: agents can now manage multiple concurrent sessions with independent state, models, and configurations
+- Session forking in ACP mode: `unstable_forkSession` creates a new session from an existing one's history
+- Session resumption in ACP mode: `unstable_resumeSession` reloads a previously saved session
+- Session closure in ACP mode: `unstable_closeSession` cleanly shuts down a session and releases resources
+- Model state reporting in ACP mode: `SessionModelState` with available models and current selection in session responses
+- Direct model setting in ACP mode: `unstable_setSessionModel` RPC command for changing the active model
+- Turn-level usage tracking in ACP mode: prompt responses now include `usage` with input/output/cached token counts
+- Message ID tracking in ACP mode: stable message IDs for assistant chunks enabling client-side message correlation
+- Settings cloning: `Settings.cloneForCwd()` method to create isolated settings instances for different working directories
+- Extension flag value retrieval: `ExtensionRunner.getFlagValues()` to inspect current flag state
+- Exported autoresearch module and submodules via `./autoresearch` and `./autoresearch/*` package paths
+- Exported autoresearch tools via `./autoresearch/tools/*` package path
+- Exported CLI commands via `./cli/commands/*` package path
+- Exported DAP module and submodules via `./dap` and `./dap/*` package paths
+- Exported edit module and submodules via `./edit`, `./edit/*`, and `./edit/modes/*` package paths
+- Exported bundled ci-green custom command via `./extensibility/custom-commands/bundled/ci-green` package path
+- Exported extensibility plugins marketplace via `./extensibility/plugins/marketplace` and `./extensibility/plugins/marketplace/*` package paths
+- Exported ACP mode via `./modes/acp` and `./modes/acp/*` package paths
+- Exported web utilities via `./web/*` package path
+- Exported line-hash utilities from edit module via `./edit/line-hash`
+- Host-owned custom tools support: RPC clients can now register custom tools via `setCustomTools()` and the RPC server will invoke them over the transport with `host_tool_call` requests
+- RPC host tool framework: `RpcHostToolBridge` for managing host tool execution, `RpcHostToolDefinition` for tool metadata, and bidirectional `host_tool_call`, `host_tool_cancel`, `host_tool_update`, and `host_tool_result` frames
+- RPC client tool API: `defineRpcClientTool()` helper, `RpcClientCustomTool` interface, and `RpcClientToolContext` for implementing host-side tool execution with update streaming and abort support
+- `set_host_tools` RPC command to replace the active set of host-owned tools before the next model call
+- `refreshRpcHostTools()` method on `AgentSession` to integrate host tools into the active tool registry with conflict detection and auto-activation of non-hidden tools
+- Instruction breakpoints support: `set_instruction_breakpoint` and `remove_instruction_breakpoint` debug actions for setting breakpoints at specific instruction addresses
+- Data breakpoints support: `data_breakpoint_info`, `set_data_breakpoint`, and `remove_data_breakpoint` debug actions for monitoring variable/memory access
+- Memory introspection: `read_memory` and `write_memory` debug actions for inspecting and modifying debugger memory
+- Disassembly support: `disassemble` debug action for viewing assembly instructions with symbol resolution
+- Module and source introspection: `modules` and `loaded_sources` debug actions for querying loaded modules and source files
+- Custom DAP requests: `custom_request` debug action for sending arbitrary Debug Adapter Protocol commands
+- Reverse request handling in DAP client: `onReverseRequest()` method for responding to adapter-initiated requests like `runInTerminal` and `startDebugging`
+- DAP reverse request support: adapters can now request terminal spawning and child debug sessions via `runInTerminal` and `startDebugging` reverse requests
+- Instruction pointer reference in debug snapshots: `instructionPointerReference` field in session summaries for low-level debugging
+- Hit condition support for instruction and data breakpoints: `hit_condition` parameter for conditional breakpoint triggering
+- RPC `set_todos` command and `todoPhases` in `get_state`, allowing hosts to pre-seed and inspect session todo state over the protocol
+- Deferred diagnostics support in LSP writethrough: `onDeferredDiagnostics` callback and `deferredSignal` in `WritethroughOptions` allow callers to receive diagnostics that arrive after the main 5-second timeout
+- Language detection for `.pm` (Perl modules), `.astro` (Astro framework), and special filenames `containerfile` and `justfile`
+- Workspace-scoped diagnostics and reload actions via `*` file parameter; `diagnostics` action now supports `*` for workspace-wide diagnostics across all configured servers
+- Socket-mode DAP adapter support for debuggers like dlv that communicate via network sockets instead of stdio; Linux uses unix domain sockets, macOS/other platforms use TCP with client-addr dialing
+- Improved extensionless binary debugging: native debuggers (gdb, lldb-dap) and adapters with root markers are now preferred over unrelated adapters like debugpy
+- Debug tool with DAP (Debug Adapter Protocol) support for launching and attaching debuggers, setting breakpoints, stepping through execution, inspecting threads/stack/variables, and evaluating expressions
+- Debug adapter configuration for gdb, lldb-dap, debugpy, and dlv with language/file-type matching and root marker detection
+- Debug session management with support for source and function breakpoints, conditional breakpoints, stack trace inspection, scope/variable exploration, and program output capture
+- `debug.enabled` setting to control debug tool availability
+- Chunk read formatting: `anchorStyle` (full / kind / bare), `read.anchorstyle` setting, and `chunked` flag on file display mode
+- `read.prosechunks` and `read.explorechunks` settings for prose chunk trees and checksum-free explore trees
+- Handlebars helpers `anchor` and `sel` (with template `anchorStyle` context) for chunk examples in prompts
+- Chunk-mode grep lines as `path:selector>LINE|content`; unified grep tool template behind `IS_CHUNK_MODE`
+- `lru-cache` for chunk tree caching
+- Chunk-mode `read` output: recursive rendering with `$XXXX` checksum suffixes, inline large-chunk previews, and normalized `#path$XXXX` selectors between read and edit
+- Autoresearch: `init_experiment` options `new_segment`, `from_autoresearch_md`, `abandon_unlogged_runs`; `log_experiment` options `skip_restore` and broader `force`; `run_experiment` `force` (with warnings); pre-run dirty-path tracking; `abandonUnloggedAutoresearchRuns` and `abandonedAt` on runs
+- LSP: diagnostic versioning (`versionSupport`, stored document version per diagnostic set), and `waitForDiagnostics` / `getDiagnosticsForFile` options (`expectedDocumentVersion`, `allowUnversioned`)
+
+### Changed
+
+- Extracted working directory formatting logic into `formatToolWorkingDirectory()` utility for consistent path display across tools
+- Bash command rendering now sanitizes tabs and shortens home directory paths in command previews
+- Chunk edit tool schema: renamed `target` parameter to `sel` for consistency with read tool terminology
+- Chunk edit tool: `op` parameter is now required (previously optional with `replace` default)
+- Chunk edit documentation: updated all region references from `@inner` to `@body` for clearer semantics
+- Chunk edit documentation: expanded with comprehensive real-world examples showing full read output, operation effects, and indentation rules
+- Chunk edit documentation: simplified indentation guidance to write content at indent-level 0 with automatic re-indentation by the tool
+- Chunk edit documentation: clarified that `@region` only works on container chunks, not leaf chunks
+- Chunk edit documentation: emphasized that CRCs change after every edit and must be refreshed from latest responses
+- Read chunk tool documentation: updated selector examples to use `@body` instead of `@inner`
+- Chunk edit region terminology updated: `@inner` renamed to `@body` for clearer semantics in container chunks
+- Chunk edit documentation restructured with comprehensive examples showing full read output, operation effects, and indentation rules
+- Chunk edit indentation guidance simplified: content should be written at indent-level 0 and the tool automatically applies correct base indentation
+- Chunk edit examples expanded with realistic TypeScript code samples demonstrating replace, insert, prepend, append, and delete operations
+- Python tool description now dynamically reflects prelude documentation availability instead of static text
+- Python tool now automatically warms the environment on first execution if prelude helpers are unavailable, ensuring documentation is loaded before use
+- Tool creation now auto-injects `report_tool_issue` when auto QA is enabled, regardless of requested tool list
+- Chunk edit region names standardized to `@head`, `@body`, and `@tail` for clearer semantics
+- Chunk edit documentation clarified: region defaults to full chunk when omitted; leaf chunks no longer support region targeting
+- Chunk read documentation updated: selector examples now use region-specific selectors based on `@head`, `@body`, and `@tail`
+- LSP server connecting status in welcome banner now uses muted pending symbol instead of warning symbol for clearer visual distinction
+- Codex websocket prewarm now runs asynchronously in the background instead of blocking session creation, allowing faster startup
+- Codex websocket status updates now display in interactive mode when prewarm completes or fails
+- LSP server warmup now runs asynchronously in the background instead of blocking session creation, allowing faster startup
+- LSP servers returned from `createAgentSession()` now include `connecting` status during initial warmup phase
+- Interactive mode now subscribes to LSP startup events and displays status updates and error messages to the user
+- LSP server status in `/info` command now distinguishes between connecting (yellow), ready (green), and error (red) states
+- ACP agent now manages multiple sessions instead of a single session; session lifecycle and configuration are now per-session
+- ACP session creation now uses a factory function to support creating new sessions for different working directories
+- ACP event mapping now accepts optional `getMessageId` callback for stable message ID assignment to assistant chunks
+
+### Removed
+
+- Deleted `src/utils/prompt-format.ts` module; prompt formatting logic moved to `pi-utils`
+- Deleted `src/utils/frontmatter.ts` module; frontmatter parsing logic moved to `pi-utils`
+- Removed `waitForChildProcess` utility (child process termination now handled by native `killTree` from pi-natives)
+- `grep-chunk.md` (folded into unified grep template)
+- `startMacAppearanceObserver` export (use `MacAppearanceObserver.start()`)
+- `copyToClipboard` export from pi-natives
+- `PI_CHUNK_SPLICES` env and `chunkSplicesEnabled()`
+- Autoresearch `segmentFingerprint` and related config hashing
+
+### Fixed
+
+- Chunk edit parameter validation: corrected detection of chunk edit operations to check for `sel` field instead of `target`
+- Chunk edit streaming previews: updated to reference `sel` parameter instead of `target`
+- Python prelude introspection now respects execution timeout and signal options, preventing hangs during environment warmup
+- Welcome banner LSP server status now updates in real-time when background startup warmup completes, eliminating stale connecting status displays
+- Welcome banner LSP startup rows now re-render when background warmup finishes, use the pending status symbol while servers are still connecting, and no longer add a redundant `LSP ready` status line on successful startup
+- ACP session initialization now registers connection cleanup handlers to dispose all sessions on disconnect
+- Reorganized package.json exports: moved `./edit` exports before `./plan-mode` for better logical grouping
+- Notebook conversion logic now checks for raw read mode or non-chunk mode before converting via markit, allowing chunk-mode reads of `.ipynb` files to use chunk parsing instead of conversion
+- Go receiver methods now render as top-level siblings instead of nested under their receiver type in chunk read output
+- Moved prompt formatting and rendering utilities from `coding-agent` to `pi-utils` package; `renderPromptTemplate()` and `formatPromptContent()` now accessed via `prompt.render()` and `prompt.format()` from `@oh-my-pi/pi-utils`
+- Moved `parseFrontmatter()` utility from `coding-agent` to `pi-utils` package; now imported from `@oh-my-pi/pi-utils` instead of local utils
+- Consolidated prompt template handling: `TemplateContext` type now available as `prompt.TemplateContext` from `@oh-my-pi/pi-utils`
+- DAP initialization now advertises support for `runInTerminal` and `startDebugging` reverse requests, and memory references
+- Debug tool schema expanded with new parameters for instruction/data breakpoints, memory operations, and custom requests
+- DAP session state now tracks instruction and data breakpoints separately from source breakpoints
+- Replaced `Bun.which()` with `$which()` from pi-utils for command resolution
+- Chunk edit tool documentation restructured: replaced operation-specific examples with region-based guidance and canonical indentation rules
+- Chunk read documentation updated: selectors now support region syntax (e.g., `class_Foo.fn_bar#ABCD@body`) and canonical target listings show supported regions per chunk
+- Chunk edit schema simplified: `target` description now documents region format; `op` and `content` descriptions clarified for region-aware operations
+- Chunk edit streaming previews updated: labels now reflect region-aware operations (e.g., `append` instead of `append child`, `insert after` without anchor reference)
+- Removed CRC parsing from `parseChunkSelector()` and `parseChunkReadPath()`: selectors no longer extract embedded checksums
+- Chunk edit normalization simplified: no longer requires async checksum resolution or context-dependent operation mapping
+- RPC mode now automatically disables session title generation by default; hosts can opt in with `PI_RPC_EMIT_TITLE=1` environment variable to receive title updates
+- RPC mode now resets workflow-altering `todo.*`, `task.*`, and `async.*` settings to built-in defaults instead of inheriting user overrides
+- RPC mode now disables automatic session title generation by default and suppresses `setTitle` extension UI requests unless hosts opt in with `PI_RPC_EMIT_TITLE=1`
+- Reorganized edit tool implementation from `patch/` to `edit/` directory structure with dedicated mode subdirectories (`edit/modes/chunk.ts`, `edit/modes/hashline.ts`, `edit/modes/patch.ts`, `edit/modes/replace.ts`)
+- Updated package.json exports to use `./edit` path instead of `./patch` for edit tool and related utilities
+- Chunk edit tool documentation simplified: removed line-based edit examples, clarified `target` format with full path and CRC suffix, added guidance for `replace_body` operation to preserve declarations
+- LSP diagnostics timeout reduced from 10 seconds to 5 seconds for faster feedback; slow diagnostics now fetch in background via deferred mechanism
+- Diagnostics action error messaging clarified: requires `file` parameter or `*` for workspace scope; improved guidance in error responses
+- Workspace symbols and reload actions now accept `*` to operate across all configured servers instead of requiring a file path
+- DAP session initialization now subscribes to stop events before launching/attaching to avoid missing stopOnEntry events
+- Stack frame fetching moved outside the event dispatch loop to prevent deadlocks and improve responsiveness
+- Evaluate requests now default to the top stopped frame when frameId is not explicitly provided
+- Eager todo enforcement now skips prompts ending with question marks or exclamation marks, treating them as queries or commands rather than statements requiring task planning
+- Chunk read output now displays fully-qualified anchor paths (e.g., `[class_Worker.fn_run#CRC]`) instead of bare names, making targets unambiguous for edits
+- Chunk edit tool documentation clarified: `target` must be the fully-qualified path with `#CRC` suffix; added guidance to run `read(path="file", sel="?")` for canonical target listings when anchor style is unclear
+- Chunk read tool documentation updated: `sel` parameter now documents the `?` selector for canonical target listings, and clarifies that default output shows full paths
+- Chunk edit schema and tool contract: explicit `op` (`replace`, `append`, `prepend`, `after`, `before`); use `replace` with empty `content` to remove a chunk (no separate `delete` op); sibling inserts use `anchor` instead of separate after/before target fields; insert ops omit CRC where appropriate, mutations require checksum on target
+- Chunk path handling: parse selector and CRC separately, sanitize selectors (strip filename prefixes, uppercase checksums), accept embedded `#CRC` on targets, auto-accept stale CRC for later ops in the same batch on the same chunk
+- Chunk UX: streaming and final edit previews show chunk edits next to hashline edits with op-specific labels; prompt docs shortened with rules table, `…` in examples, and helper-based path/anchor samples
+- `log_experiment` only reverts files modified by the run; prompts and errors document that pre-existing dirty files are preserved; richer pending-run error context; `init_experiment` no-ops when the contract matches unless `new_segment`; secondary metrics informational only (no `force` for drift)
+- Autoresearch: `log_experiment` reloads benchmark/scope/constraints from `autoresearch.md` after resolving a pending run; `/autoresearch` without `autoresearch.md` follows `/plan`-style toggle and message flow; setup moved into autoresearch system prompt (removed `command-initialize.md`)
+- Native/shell alignment: `GrepOutputMode` from pi-natives; shell and `getDiagnosticsForFile` callbacks use error-first `(err, chunk)`; `getDiagnosticsForFile` takes an options object
+- Clipboard: `copyToClipboard` / `readImageFromClipboard` live in `utils/clipboard.ts` (OSC 52 and Termux)
+- macOS: session-wide power assertion while the agent runs; `MacAppearanceObserver.start()` with error-first callback; `detectMacOSAppearance()` returns enum values
+- ACP session cleanup now properly cancels in-flight prompts and disposes resources when sessions are closed or connection aborts
+- Removed unused `_createErrorToolResult` helper function from RPC host-tools module
+- Fixed Go receiver method indentation in append operations to preserve relative indentation from the anchor chunk
+- Fixed Go type chunk line counts to report only the type body lines instead of including grouped receiver methods
+- Fixed enum variant insertion to avoid adding extra blank lines between variants
+- Chunk read output now correctly preserves embedded CRC in selectors (e.g., `class_Foo.fn_bar#ZZPM`) instead of stripping them during path parsing
+- Chunk edit error messages now consistently report checksum mismatches with format `Checksum mismatch` instead of variable phrasing
+- Chunk-mode read output now correctly displays scoped response trees showing only touched chunks and adjacent siblings, preventing unrelated distant chunks from appearing in responses
+- DAP stopped event handling no longer blocks the message reader, preventing potential deadlocks during rapid event sequences
+- Chunk-mode whole-chunk replaces now preserve attached leading comments and docblocks when replacement content starts at the declaration, preventing accidental comment loss during agent edits
+- Chunk edit error messages now consistently report checksum mismatches with the format `did not match checksum "XXXX"` instead of variable phrasing
+- Chunk selector validation for edits now rejects non-canonical selectors (suffix-only like `fn_run` or prefix-stripped like `run`), requiring fully-qualified paths to prevent ambiguity
+- Plan review previews now re-append at the chat tail on refresh, keeping them adjacent to the active selector instead of updating off-screen
+- `log_experiment` validates and reverts run-scoped file changes without clobbering unrelated dirty worktree state
+- Chunk edit targets that embed CRC in the selector (e.g. `fn_foo#ABCD`) parse correctly
+- Shell paths check errors before consuming chunk output (bash executor, config resolution)
+- `/autoresearch` toggles like `/plan` when empty; slash completion no longer suggests `off`/`clear` on an empty prefix after the command
+- Chunk-mode read/edit edge cases (zero-width gap replaces, stale batch diagnostics, grouped Go receivers, line-count headers, parse error locations)
+
 ## [13.19.0] - 2026-04-05
+
 ### Added
 
 - Added idle auto-compaction settings and scheduling so sessions can compact after inactive turns without auto-continuing.
@@ -50,6 +307,7 @@
 - Fixed the plan review selector to support the external editor shortcut for opening and updating the current plan from the approval screen
 
 ## [13.18.0] - 2026-04-02
+
 ### Breaking Changes
 
 - Removed standalone `fetch` tool; URL fetching is now integrated into the `read` tool
@@ -72,6 +330,7 @@
 - Fixed `read` tool to properly handle `file://` URL scheme by converting to filesystem paths
 
 ## [13.17.5] - 2026-04-01
+
 ### Added
 
 - Added support for writing to ZIP archives using fflate library for cross-platform compatibility
@@ -85,6 +344,7 @@
 - Removed GhPrPushTool test case
 
 ## [13.17.4] - 2026-04-01
+
 ### Added
 
 - Support for writing to archive entries in `.tar`, `.tar.gz`, `.tgz`, and `.zip` files using `archive.ext:path/inside/archive` syntax
@@ -109,6 +369,7 @@
 - Updated `read` tool documentation to reflect archive support and usage patterns
 
 ## [13.17.2] - 2026-04-01
+
 ### Added
 
 - Added `/marketplace help` command to display usage guide for all marketplace operations
@@ -164,6 +425,7 @@
 - Fixed inline image rendering to cap image height and preserve multiplexer scrollback during terminal resizes ([#587](https://github.com/can1357/oh-my-pi/pull/587) by [@smileynet](https://github.com/smileynet))
 
 ## [13.17.1] - 2026-04-01
+
 ### Removed
 
 - Removed `code_search` tool for code snippet and documentation search
@@ -173,6 +435,7 @@
 - Fixed edit tool diff rendering to wrap long diff lines with continuation gutters instead of truncating them at terminal width ([#578](https://github.com/can1357/oh-my-pi/issues/578))
 - Fixed `--list-models` and `/model` provider filtering to hide models from disabled providers ([#588](https://github.com/can1357/oh-my-pi/issues/588))
 - Fixed edit tool diffstats to use diff-specific add/remove theme colors instead of success/error status colors ([#589](https://github.com/can1357/oh-my-pi/issues/589))
+
 ## [13.17.0] - 2026-03-30
 
 ### Added
@@ -225,6 +488,7 @@
 - Fixed `--model provider/id` resolving to wrong provider when model ID exists in multiple catalogs ([#560](https://github.com/can1357/oh-my-pi/issues/560))
 
 ## [13.16.4] - 2026-03-28
+
 ### Changed
 
 - Renamed hashline helper functions from `hlineref`/`hlinefull` to `href`/`hline` for brevity
@@ -404,6 +668,7 @@
 ### Added
 
 - Session observer overlay (`Ctrl+S`): view running subagent sessions with a picker and read-only transcript showing thinking, text, tool calls, and results
+
 ## [13.14.0] - 2026-03-20
 
 ### Added
@@ -1680,7 +1945,7 @@
 
 - Changed custom UI hook cleanup to conditionally restore editor state only when not using overlay mode
 - Extracted environment variable configuration for non-interactive bash execution into reusable `NO_PAGER_ENV` constant
-- Replaced custom timing instrumentation with logger.timeAsync() and logger.time() from pi-utils for consistent startup profiling
+- Replaced custom timing instrumentation with logger.time() and logger.time() from pi-utils for consistent startup profiling
 - Removed PI_DEBUG_STARTUP environment variable in favor of logger.debug() for conditional debug output
 - Consolidated timing calls throughout initialization pipeline to use unified logger-based timing system
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "13.19.0",
+	"version": "14.0.2",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -31,23 +31,27 @@
 		"omp": "src/cli.ts"
 	},
 	"scripts": {
-		"check": "tsgo -p tsconfig.json",
+		"build": "bun --cwd=../stats scripts/generate-client-bundle.ts --generate && bun --cwd=../natives run embed:native && bun build --compile --define PI_COMPILED=true --external mupdf --root ../.. ./src/cli.ts --outfile dist/omp && bun --cwd=../natives run embed:native --reset && bun --cwd=../stats scripts/generate-client-bundle.ts --reset",
+		"check": "biome check . && bun run check:types",
+		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"lint": "biome lint .",
+		"test": "bun test",
+		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index",
+		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
 		"prepack": "bun scripts/generate-docs-index.ts",
-		"build:binary": "cd ../.. && bun --cwd=packages/stats scripts/generate-client-bundle.ts && bun --cwd=packages/natives run embed:native && bun build --compile --define PI_COMPILED=true --external mupdf --root . ./packages/coding-agent/src/cli.ts --outfile packages/coding-agent/dist/omp && bun --cwd=packages/natives run embed:native --reset && bun --cwd=packages/stats scripts/generate-client-bundle.ts --reset",
-		"generate-template": "bun scripts/generate-template.ts",
-		"test": "bun test"
+		"generate-template": "bun scripts/generate-template.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@oh-my-pi/omp-stats": "13.19.0",
-		"@oh-my-pi/pi-agent-core": "13.19.0",
-		"@oh-my-pi/pi-ai": "13.19.0",
-		"@oh-my-pi/pi-natives": "13.19.0",
-		"@oh-my-pi/pi-tui": "13.19.0",
-		"@oh-my-pi/pi-utils": "13.19.0",
+		"@oh-my-pi/omp-stats": "14.0.2",
+		"@oh-my-pi/pi-agent-core": "14.0.2",
+		"@oh-my-pi/pi-ai": "14.0.2",
+		"@oh-my-pi/pi-natives": "14.0.2",
+		"@oh-my-pi/pi-tui": "14.0.2",
+		"@oh-my-pi/pi-utils": "14.0.2",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",
@@ -56,6 +60,7 @@
 		"fflate": "0.8.2",
 		"handlebars": "^4.7",
 		"linkedom": "^0.18",
+		"lru-cache": "11.3.1",
 		"markit-ai": "0.5.0",
 		"puppeteer": "^24.37",
 		"zod": "4.3.6"
@@ -90,6 +95,18 @@
 			"types": "./src/async/*.ts",
 			"import": "./src/async/*.ts"
 		},
+		"./autoresearch": {
+			"types": "./src/autoresearch/index.ts",
+			"import": "./src/autoresearch/index.ts"
+		},
+		"./autoresearch/*": {
+			"types": "./src/autoresearch/*.ts",
+			"import": "./src/autoresearch/*.ts"
+		},
+		"./autoresearch/tools/*": {
+			"types": "./src/autoresearch/tools/*.ts",
+			"import": "./src/autoresearch/tools/*.ts"
+		},
 		"./capability": {
 			"types": "./src/capability/index.ts",
 			"import": "./src/capability/index.ts"
@@ -102,6 +119,10 @@
 			"types": "./src/cli/*.ts",
 			"import": "./src/cli/*.ts"
 		},
+		"./cli/commands/*": {
+			"types": "./src/cli/commands/*.ts",
+			"import": "./src/cli/commands/*.ts"
+		},
 		"./commands/*": {
 			"types": "./src/commands/*.ts",
 			"import": "./src/commands/*.ts"
@@ -166,6 +187,14 @@
 			"types": "./src/config/*.ts",
 			"import": "./src/config/*.ts"
 		},
+		"./dap": {
+			"types": "./src/dap/index.ts",
+			"import": "./src/dap/index.ts"
+		},
+		"./dap/*": {
+			"types": "./src/dap/*.ts",
+			"import": "./src/dap/*.ts"
+		},
 		"./debug": {
 			"types": "./src/debug/index.ts",
 			"import": "./src/debug/index.ts"
@@ -182,6 +211,18 @@
 			"types": "./src/discovery/*.ts",
 			"import": "./src/discovery/*.ts"
 		},
+		"./edit": {
+			"types": "./src/edit/index.ts",
+			"import": "./src/edit/index.ts"
+		},
+		"./edit/*": {
+			"types": "./src/edit/*.ts",
+			"import": "./src/edit/*.ts"
+		},
+		"./edit/modes/*": {
+			"types": "./src/edit/modes/*.ts",
+			"import": "./src/edit/modes/*.ts"
+		},
 		"./exa": {
 			"types": "./src/exa/index.ts",
 			"import": "./src/exa/index.ts"
@@ -218,6 +259,10 @@
 			"types": "./src/extensibility/custom-commands/*.ts",
 			"import": "./src/extensibility/custom-commands/*.ts"
 		},
+		"./extensibility/custom-commands/bundled/ci-green": {
+			"types": "./src/extensibility/custom-commands/bundled/ci-green/index.ts",
+			"import": "./src/extensibility/custom-commands/bundled/ci-green/index.ts"
+		},
 		"./extensibility/custom-commands/bundled/review": {
 			"types": "./src/extensibility/custom-commands/bundled/review/index.ts",
 			"import": "./src/extensibility/custom-commands/bundled/review/index.ts"
@@ -254,6 +299,14 @@
 			"types": "./src/extensibility/plugins/*.ts",
 			"import": "./src/extensibility/plugins/*.ts"
 		},
+		"./extensibility/plugins/marketplace": {
+			"types": "./src/extensibility/plugins/marketplace/index.ts",
+			"import": "./src/extensibility/plugins/marketplace/index.ts"
+		},
+		"./extensibility/plugins/marketplace/*": {
+			"types": "./src/extensibility/plugins/marketplace/*.ts",
+			"import": "./src/extensibility/plugins/marketplace/*.ts"
+		},
 		"./internal-urls": {
 			"types": "./src/internal-urls/index.ts",
 			"import": "./src/internal-urls/index.ts"
@@ -314,6 +367,14 @@
 			"types": "./src/modes/*.ts",
 			"import": "./src/modes/*.ts"
 		},
+		"./modes/acp": {
+			"types": "./src/modes/acp/index.ts",
+			"import": "./src/modes/acp/index.ts"
+		},
+		"./modes/acp/*": {
+			"types": "./src/modes/acp/*.ts",
+			"import": "./src/modes/acp/*.ts"
+		},
 		"./modes/components": {
 			"types": "./src/modes/components/index.ts",
 			"import": "./src/modes/components/index.ts"
@@ -358,14 +419,6 @@
 			"types": "./src/modes/utils/*.ts",
 			"import": "./src/modes/utils/*.ts"
 		},
-		"./patch": {
-			"types": "./src/patch/index.ts",
-			"import": "./src/patch/index.ts"
-		},
-		"./patch/*": {
-			"types": "./src/patch/*.ts",
-			"import": "./src/patch/*.ts"
-		},
 		"./plan-mode/*": {
 			"types": "./src/plan-mode/*.ts",
 			"import": "./src/plan-mode/*.ts"
@@ -435,6 +488,10 @@
 			"types": "./src/utils/*.ts",
 			"import": "./src/utils/*.ts"
 		},
+		"./web/*": {
+			"types": "./src/web/*.ts",
+			"import": "./src/web/*.ts"
+		},
 		"./web/scrapers": {
 			"types": "./src/web/scrapers/index.ts",
 			"import": "./src/web/scrapers/index.ts"
@@ -454,6 +511,15 @@
 		"./web/search/providers/*": {
 			"types": "./src/web/search/providers/*.ts",
 			"import": "./src/web/search/providers/*.ts"
-		}
+		},
+		"./hooks": {
+			"types": "./src/extensibility/hooks/index.ts",
+			"import": "./src/extensibility/hooks/index.ts"
+		},
+		"./hooks/*": {
+			"types": "./src/extensibility/hooks/*.ts",
+			"import": "./src/extensibility/hooks/*.ts"
+		},
+		"./*.js": "./src/*.ts"
 	}
 }

package/scripts/format-prompts.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env bun
+import { prompt } from "@oh-my-pi/pi-utils";
 /**
  * Format prompt files (mixed XML + Markdown + Handlebars).
  *
@@ -14,7 +15,6 @@
  * 9. Bold RFC 2119 keywords (MUST, SHOULD, MAY, etc.) in prompt content
  */
 import { Glob } from "bun";
-import { formatPromptContent } from "../src/utils/prompt-format";
 
 const PROMPTS_DIR = new URL("../src/prompts/", import.meta.url).pathname;
 const COMMIT_PROMPTS_DIR = new URL("../src/commit/prompts/", import.meta.url).pathname;
@@ -42,7 +42,7 @@ async function main() {
 
 	for (const fullPath of files) {
 		const original = await Bun.file(fullPath).text();
-		const formatted = formatPromptContent(original, PROMPT_FORMAT_OPTIONS);
+		const formatted = prompt.format(original, PROMPT_FORMAT_OPTIONS);
 
 		if (original !== `${formatted}\n`) {
 			if (check) {

package/src/autoresearch/apply-contract-to-state.ts

@@ -0,0 +1,24 @@
+import { inferMetricUnitFromName } from "./helpers";
+import type { AutoresearchContract, ExperimentState } from "./types";
+
+/**
+ * Updates session fields from a validated `autoresearch.md` parse (same fields as `init_experiment`).
+ * Does not touch `name`, `currentSegment`, `results`, `bestMetric`, `confidence`, or `maxExperiments`.
+ */
+export function applyAutoresearchContractToExperimentState(
+	contract: AutoresearchContract,
+	state: ExperimentState,
+): void {
+	const benchmarkContract = contract.benchmark;
+	state.metricName = benchmarkContract.primaryMetric ?? state.metricName;
+	state.metricUnit = benchmarkContract.metricUnit;
+	state.bestDirection = benchmarkContract.direction ?? "lower";
+	state.secondaryMetrics = benchmarkContract.secondaryMetrics.map(name => ({
+		name,
+		unit: inferMetricUnitFromName(name),
+	}));
+	state.benchmarkCommand = benchmarkContract.command?.trim() ?? state.benchmarkCommand;
+	state.scopePaths = [...contract.scopePaths];
+	state.offLimits = [...contract.offLimits];
+	state.constraints = [...contract.constraints];
+}

package/src/autoresearch/contract.ts

@@ -1,4 +1,3 @@
-import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import type { AutoresearchBenchmarkContract, AutoresearchContract, MetricDirection } from "./types";
@@ -76,49 +75,6 @@ export function validateAutoresearchContract(contract: AutoresearchContract): st
 	return errors;
 }
 
-export function buildAutoresearchSegmentFingerprint(
-	contract: AutoresearchContract,
-	scripts: {
-		benchmarkScript: string;
-		checksScript: string | null;
-	},
-): string {
-	const payload = {
-		benchmark: contract.benchmark,
-		scopePaths: contract.scopePaths,
-		offLimits: contract.offLimits,
-		constraints: contract.constraints,
-		scripts,
-	};
-	return crypto.createHash("sha256").update(JSON.stringify(payload)).digest("hex");
-}
-
-export function getAutoresearchFingerprintMismatchError(
-	stateFingerprint: string | null,
-	workDir: string,
-): string | null {
-	if (!stateFingerprint) {
-		return "The current segment has no fingerprint metadata. Re-run init_experiment before continuing.";
-	}
-
-	const contractResult = readAutoresearchContract(workDir);
-	const scriptSnapshot = loadAutoresearchScriptSnapshot(workDir);
-	const errors = [...contractResult.errors, ...scriptSnapshot.errors];
-	if (errors.length > 0) {
-		return `${errors.join(" ")} Re-run init_experiment after fixing the workspace contract.`;
-	}
-
-	const currentFingerprint = buildAutoresearchSegmentFingerprint(contractResult.contract, {
-		benchmarkScript: scriptSnapshot.benchmarkScript,
-		checksScript: scriptSnapshot.checksScript,
-	});
-	if (currentFingerprint === stateFingerprint) {
-		return null;
-	}
-
-	return "autoresearch.md, autoresearch.sh, or autoresearch.checks.sh changed since the current segment was initialized. Re-run init_experiment before continuing.";
-}
-
 export function loadAutoresearchScriptSnapshot(workDir: string): AutoresearchScriptSnapshot {
 	const benchmarkScriptPath = path.join(workDir, "autoresearch.sh");
 	const checksScriptPath = path.join(workDir, "autoresearch.checks.sh");