@oh-my-pi/pi-coding-agent 15.2.2 → 15.2.4

package/CHANGELOG.md

@@ -2,6 +2,54 @@
 
 ## [Unreleased]
 
+## [15.2.4] - 2026-05-22
+### Breaking Changes
+
+- Replaced the legacy `@@` header and `+`/`<`/`=`/`-` hashline syntax with the new `§PATH` header and `«`/`»`/`≔` operation format, so existing hashline scripts and prompts using old symbols must be updated
+
+### Added
+
+- Added one-anchor `≔ANCHOR` shorthand equivalent to `≔ANCHOR..ANCHOR` for single-line replace/delete
+
+### Changed
+
+- Changed `≔A..B` so an omitted payload now deletes the range, and added an explicit empty payload line to keep a literal blank replacement line
+
+### Removed
+
+- Removed the `hsep` prompt helper and `PI_HL_SEP` payload-prefix configuration because hashline payloads are no longer line-prefixed
+
+### Fixed
+
+- Fixed hashline payload handling in parser and streaming preview to preserve blank lines as actual payload text until the next op, file header, or envelope marker
+
+## [15.2.3] - 2026-05-22
+### Breaking Changes
+
+- Changed PR and task-isolation worktree directory layout to hash-based `~/.omp/wt/<identifier>-<path-hash>` style paths, replacing the previous nested encoded-repo layout
+
+### Added
+
+- Added `omp worktree` command (alias `wt`) to list and manage agent-managed worktrees under `~/.omp/wt`
+- Added `omp worktree clear` to remove orphaned worktree directories, with `--all` to include live PR-checkouts, `--dry-run` for preview, and `--json` reporting
+- Added machine-readable JSON output to `omp worktree list` for scripted inspection
+- Added `display.shimmer` appearance setting with `classic`, `kitt` (Knight Rider K.I.T.T. scanner), and `disabled` modes
+
+### Changed
+
+- Changed the welcome intro animation to a 3-second eased gradient sweep with a diagonal shine highlight across the logo
+- Changed background job completion follow-ups to batch multiple finished jobs into a single `async-result` message, showing each completed job and its result in one place
+- Changed MCP notification follow-ups to combine multiple resource updates into a single consolidated message and suppress duplicate server/uri entries
+- Updated PR checkout to reuse `hashPath`-based worktree roots when creating and scanning worktrees for cleanup
+- Updated `worktree` cleanup logic to gracefully prune parent git metadata after removing worktree directories
+- Reworked working-message shimmer animation for 60fps rendering: ANSI sequences are coalesced per same-tier run instead of emitted per code point, palettes compile once and cache per active theme, and the band position is now fractional so motion is smooth at any frame rate
+- Switched MCP health-check and "Connecting to…" spinners from hard-coded ASCII (`|/-\`) to `theme.spinnerFrames` so they pick up the active symbol preset (braille on unicode/nerd, ASCII when explicitly themed)
+
+### Fixed
+
+- Fixed PR checkout failures when the default worktree path was already registered or occupied by stale leftovers by automatically selecting suffixed alternatives (`-2`, `-3`, etc.)
+- Fixed Memory tab in the settings UI not revealing or hiding the Hindsight-only rows (`Hindsight API URL`, `Hindsight Bank ID`, `Hindsight Scoping`, etc.) when `Memory Backend` was switched via the inline submenu. The selector now rebuilds its item list after every change so condition-gated rows appear/disappear immediately instead of requiring a tab switch
+
 ## [15.2.2] - 2026-05-22
 
 ### Fixed
@@ -8511,4 +8559,4 @@ Initial public release.
 - Git branch display in footer
 - Message queueing during streaming responses
 - OAuth integration for Gmail and Google Calendar access
-- HTML export with syntax highlighting and collapsible sections
+- HTML export with syntax highlighting and collapsible sections

package/dist/types/cli/worktree-cli.d.ts

@@ -0,0 +1,26 @@
+type WorktreeKind = "pr-checkout" | "task-isolation" | "empty" | "stray";
+export interface WorktreeEntry {
+    /** Absolute path to the worktree dir (or stray container) under `~/.omp/wt/`. */
+    path: string;
+    /** Classification of what we found on disk. */
+    kind: WorktreeKind;
+    /** Parent repo root, when this is a registered git worktree. */
+    parentRepo?: string;
+    /** Branch name extracted from the parent's tracking file, when available. */
+    branch?: string;
+    /** When set, the entry is unhealthy and `omp worktree clear` will remove it. */
+    orphanReason?: string;
+}
+export interface ListWorktreesOptions {
+    json: boolean;
+}
+export interface ClearWorktreesOptions {
+    /** Remove every entry, including live PR-checkout worktrees. */
+    all: boolean;
+    /** Print what would be removed without touching the filesystem. */
+    dryRun: boolean;
+    json: boolean;
+}
+export declare function listWorktrees(options: ListWorktreesOptions): Promise<void>;
+export declare function clearWorktrees(options: ClearWorktreesOptions): Promise<void>;
+export {};

package/dist/types/commands/worktree.d.ts

@@ -0,0 +1,34 @@
+/**
+ * List and clean up agent-managed git worktrees under `~/.omp/wt`.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Worktree extends Command {
+    static description: string;
+    static aliases: string[];
+    static args: {
+        action: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: string[];
+            default: string;
+        };
+    };
+    static flags: {
+        all: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        "dry-run": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/config/settings-schema.d.ts

@@ -648,6 +648,29 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 3;
     };
+    readonly "display.shimmer": {
+        readonly type: "enum";
+        readonly values: readonly ["classic", "kitt", "disabled"];
+        readonly default: "classic";
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly label: "Shimmer";
+            readonly description: "Animation style for working/loading messages";
+            readonly options: readonly [{
+                readonly value: "classic";
+                readonly label: "Classic";
+                readonly description: "Soft cosine wave sweeping across the text";
+            }, {
+                readonly value: "kitt";
+                readonly label: "KITT Scanner";
+                readonly description: "Knight Rider 1982 red light bouncing left-right";
+            }, {
+                readonly value: "disabled";
+                readonly label: "Disabled";
+                readonly description: "No animation; static muted text";
+            }];
+        };
+    };
     readonly "display.showTokenUsage": {
         readonly type: "boolean";
         readonly default: false;

package/dist/types/hashline/constants.d.ts

@@ -2,8 +2,6 @@
 export declare const MISMATCH_CONTEXT = 2;
 /** Filler hash used for the interior of a multi-line range; not validated. */
 export declare const RANGE_INTERIOR_HASH = "**";
-/** Header marker introducing a new file section in multi-section input. */
-export declare const FILE_HEADER_PREFIX = "@";
 /** Optional patch envelope start marker; silently consumed when present. */
 export declare const BEGIN_PATCH_MARKER = "*** Begin Patch";
 /** Optional patch envelope end marker; terminates parsing when encountered. */

package/dist/types/hashline/hash.d.ts

@@ -64,47 +64,21 @@ export declare function resolveHashlineGrammarPlaceholders(grammar: string): str
 /** @deprecated Use {@link resolveHashlineGrammarPlaceholders}. */
 export declare const resolveLarkLidPlaceholders: typeof resolveHashlineGrammarPlaceholders;
 /**
- * Single source of truth for the hashline edit payload separator. This is the
- * configured separator that starts inserted/replacement payload lines in
- * hashline edit input (`<separator>TEXT`) and separates inline modify ops from
- * their appended/prepended text.
+ * Hashline edit input markers. File section headers start with {@link HL_FILE_PREFIX};
+ * op lines start with a direction/action sigil: {@link HL_OP_INSERT_BEFORE},
+ * {@link HL_OP_INSERT_AFTER}, or {@link HL_OP_REPLACE}. Payload lines are
+ * verbatim file content and have no per-line marker.
  *
- * Override at runtime with the `PI_HL_SEP` env var (e.g.
- * `PI_HL_SEP=">"`, `PI_HL_SEP="\\"`). The value is read once at module load;
- * the edit grammar, prompt helper, and edit parser derive from it.
- *
- * Default is `~`, chosen empirically. Benchmark across 8 candidate separators
- * x 3 models (glm-4.7:nitro, gpt-5.4-nano, claude-sonnet-4-6), 24-48 runs per
- * cell, hashline variant, 12 sampled tasks per run:
- *
- *   sep | task ✓ | edit ✓ | patch fail      | tok/run
- *   ----|--------|--------|-----------------|--------
- *    +  | 70.8%  | 78.0%  | 27/125 (21.6%)  | 32,127
- *    ÷  | 70.7%  | 90.6%  | 22/211 (10.4%)  | 31,666
- *    ~  | 69.4%  | 94.9%  |  6/107 ( 5.6%)  | 30,529   <-- default
- *    >  | 69.2%  | 91.5%  | 21/219 ( 9.6%)  | 30,777
- *    :  | 66.7%  | 86.4%  | 20/126 (15.9%)  | 33,900
- *    |  | 65.9%  | 86.9%  | 20/127 (15.7%)  | 34,589
- *    \  | 65.5%  | 89.8%  | 16/124 (12.9%)  | 36,010
- *    %  | 63.9%  | 92.8%  | 11/125 ( 8.8%)  | 36,530
- *
- * `~` wins because:
- *   - highest edit-tool success rate (94.9%) of any tested separator
- *   - lowest patch-failure rate (5.6%) — model rarely emits a malformed payload
- *   - cheapest in tokens alongside `>` (no retry overhead from format collisions)
- *   - no line-leading role in any mainstream language, markdown, diff, regex,
- *     or shell, so payload lines are unambiguous to both the parser and models
- *   - task-success is statistically tied with `>` and `÷` (within run-to-run
- *     noise), so the edit-reliability win is free
- *
- * `+` and `÷` lead on raw task-success but at the cost of ~2-4x more patch
- * failures (the model retries until it lands a valid edit). `:`, `|`, `\`
- * collide with line-leading syntax (label/object-key, body separator, escape)
- * and degrade both edit reliability and intent-match.
+ * These constants are the single source of truth for the edit parser, grammar,
+ * renderer, and prompt.
  */
-export declare const HL_EDIT_SEP: string;
-/** Regex-escaped form of {@link HL_EDIT_SEP}, safe for regexes. */
-export declare const HL_EDIT_SEP_RE_RAW: string;
+export declare const HL_OP_INSERT_BEFORE = "\u00AB";
+export declare const HL_OP_INSERT_AFTER = "\u00BB";
+export declare const HL_OP_REPLACE = "\u2254";
+/** All hashline edit op sigils, concatenated for fast membership tests. */
+export declare const HL_OP_CHARS = "\u00AB\u00BB\u2254";
+/** Hashline edit file section header marker. */
+export declare const HL_FILE_PREFIX = "\u00A7";
 /** Stable separator for read/search/hashline display output. Intentionally not configurable. */
 export declare const HL_BODY_SEP = "|";
 /** Regex-escaped form of {@link HL_BODY_SEP}, safe for embedding inside a regex. */

package/dist/types/hashline/parser.d.ts

@@ -1,11 +1,7 @@
 import type { HashlineCursor, HashlineEdit } from "./types";
 export declare function cloneCursor(cursor: HashlineCursor): HashlineCursor;
-export declare function parseHashline(diff: string, opts?: ParseHashlineOptions): HashlineEdit[];
-export interface ParseHashlineOptions {
-    /** File path the diff targets. Used to suppress indent-sensitive false-positive warnings. */
-    path?: string;
-}
-export declare function parseHashlineWithWarnings(diff: string, opts?: ParseHashlineOptions): {
+export declare function parseHashline(diff: string): HashlineEdit[];
+export declare function parseHashlineWithWarnings(diff: string): {
     edits: HashlineEdit[];
     warnings: string[];
 };

package/dist/types/modes/shared.d.ts

@@ -3,4 +3,13 @@ import type { TabBarTheme } from "@oh-my-pi/pi-tui";
 export declare function sanitizeStatusText(text: string): string;
 /** Shared tab bar theme used by model-selector and settings-selector. */
 export declare function getTabBarTheme(): TabBarTheme;
+/**
+ * Suffix appended to the loader's working message to remind users they can
+ * abort with Esc. Rendered with the active theme's bracket glyphs so it stays
+ * visually consistent with badges and other bracketed UI affordances.
+ *
+ * The leading space separates the hint from the message body and is consumed
+ * by `endsWith`/`slice` matching in the loader renderer.
+ */
+export declare function interruptHint(): string;
 export { parseCommandArgs } from "../utils/command-args";

package/dist/types/modes/theme/shimmer.d.ts

@@ -1,13 +1,16 @@
 import type { Theme, ThemeColor } from "./theme";
-type ShimmerTheme = Pick<Theme, "bold" | "fg">;
+type ShimmerTheme = Pick<Theme, "bold" | "fg" | "getFgAnsi">;
+type ShimmerPaletteTier = ThemeColor | {
+    ansi: string;
+};
 /** Three-tier color stack a shimmer character cycles through as the band sweeps. */
 export interface ShimmerPalette {
-    /** Color for chars outside / at the edge of the band (intensity < 0.2). */
-    low: ThemeColor;
-    /** Color for chars approaching the crest (0.2 <= intensity < 0.6). */
-    mid: ThemeColor;
-    /** Color at the band's crest (intensity >= 0.6). */
-    high: ThemeColor;
+    /** Color for chars outside / at the edge of the band (intensity < ~0.22). */
+    low: ShimmerPaletteTier;
+    /** Color for chars approaching the crest (~0.22 ≤ intensity < ~0.65). */
+    mid: ShimmerPaletteTier;
+    /** Color at the band's crest (intensity ≥ ~0.65). */
+    high: ShimmerPaletteTier;
     /** Whether to bold the crest tier. Default `false`. */
     bold?: boolean;
 }
@@ -18,9 +21,17 @@ export interface ShimmerSegment {
 }
 export declare const DEFAULT_SHIMMER_PALETTE: ShimmerPalette;
 /**
- * Apply a shimmer sweep across one or more segments, treating them as a single
- * continuous string for band positioning. Each segment can supply its own
- * palette so the gradient stays in lockstep while the colors differ.
+ * Apply a shimmer sweep across one or more segments, treating them as a
+ * single continuous string for band positioning. Each segment can supply
+ * its own palette so the gradient stays in lockstep while the colors
+ * differ.
+ *
+ * Performance shape (per call, dominant cost):
+ *   - One `Date.now()` read.
+ *   - One `compile()` lookup per segment (Symbol-keyed cache slot, hot path
+ *     skipped after first frame).
+ *   - One ANSI open/close pair per **run of same-tier chars**, not per char.
+ *   - No per-char allocations beyond the run buffer.
  */
 export declare function shimmerSegments(segments: readonly ShimmerSegment[], theme: ShimmerTheme): string;
 export declare function shimmerText(text: string, theme: ShimmerTheme, palette?: ShimmerPalette): string;

package/dist/types/session/agent-session.d.ts

@@ -45,6 +45,7 @@ import type { ClientBridge } from "./client-bridge";
 import { type CustomMessage } from "./messages";
 import type { BranchSummaryEntry, NewSessionOptions, SessionContext, SessionManager } from "./session-manager";
 import { ToolChoiceQueue } from "./tool-choice-queue";
+import { YieldQueue } from "./yield-queue";
 /** Session-specific events that extend the core AgentEvent */
 export type AgentSessionEvent = AgentEvent | {
     type: "auto_compaction_start";
@@ -264,6 +265,7 @@ export declare class AgentSession {
     readonly agent: Agent;
     readonly sessionManager: SessionManager;
     readonly settings: Settings;
+    readonly yieldQueue: YieldQueue;
     readonly configWarnings: string[];
     readonly rawSseDebugBuffer: RawSseDebugBuffer;
     constructor(config: AgentSessionConfig);

package/dist/types/session/yield-queue.d.ts

@@ -0,0 +1,24 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+export interface YieldDispatcher<P> {
+    /** Drop entries already delivered through another path. Called per-entry at flush time. */
+    isStale?(entry: P): boolean;
+    /** Produce one batched AgentMessage from non-stale entries. Return null to skip. */
+    build(survivors: P[]): AgentMessage | null;
+}
+export interface YieldQueueOptions {
+    isStreaming: () => boolean;
+    injectStreaming(msg: AgentMessage): void;
+    injectIdle(messages: AgentMessage[]): Promise<void>;
+    scheduleIdleFlush(run: () => Promise<void>): void;
+}
+type YieldFlushMode = "streaming" | "idle";
+export declare class YieldQueue {
+    #private;
+    constructor(options: YieldQueueOptions);
+    register<P>(kind: string, dispatcher: YieldDispatcher<P>): () => void;
+    enqueue<P>(kind: string, entry: P): void;
+    has(kind?: string): boolean;
+    flush(mode: YieldFlushMode): Promise<void>;
+    clear(): void;
+}
+export {};

package/dist/types/slash-commands/helpers/format.d.ts

@@ -1,7 +1,7 @@
 import { type Theme } from "../../modes/theme/theme";
 /** Format a millisecond duration as a coarse-grained human label. */
 export declare function formatDuration(ms: number): string;
-type ProgressBarTheme = Pick<Theme, "bold" | "fg">;
+type ProgressBarTheme = Pick<Theme, "bold" | "fg" | "getFgAnsi">;
 /**
  * Render an ASCII progress bar with a trailing percent label.
  * `fraction` is clamped to `[0, 1]`. `undefined` renders a dotted placeholder.

package/dist/types/task/worktree.d.ts

@@ -19,7 +19,6 @@ export interface WorktreeBaseline {
         baseline: RepoBaseline;
     }>;
 }
-export declare function getEncodedProjectName(cwd: string): string;
 export declare function getRepoRoot(cwd: string): Promise<string>;
 export declare function getGitNoIndexNullPath(): string;
 export declare function captureBaseline(repoRoot: string): Promise<WorktreeBaseline>;

package/dist/types/utils/git.d.ts

@@ -263,6 +263,7 @@ export declare const worktree: {
         signal?: AbortSignal;
     }): Promise<boolean>;
     list(cwd: string, signal?: AbortSignal): Promise<GitWorktreeEntry[]>;
+    prune(cwd: string, signal?: AbortSignal): Promise<void>;
 };
 export declare const patch: {
     /** Apply a patch file. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.2.2",
+	"version": "15.2.4",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,12 +47,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/omp-stats": "15.2.2",
-		"@oh-my-pi/pi-agent-core": "15.2.2",
-		"@oh-my-pi/pi-ai": "15.2.2",
-		"@oh-my-pi/pi-natives": "15.2.2",
-		"@oh-my-pi/pi-tui": "15.2.2",
-		"@oh-my-pi/pi-utils": "15.2.2",
+		"@oh-my-pi/omp-stats": "15.2.4",
+		"@oh-my-pi/pi-agent-core": "15.2.4",
+		"@oh-my-pi/pi-ai": "15.2.4",
+		"@oh-my-pi/pi-natives": "15.2.4",
+		"@oh-my-pi/pi-tui": "15.2.4",
+		"@oh-my-pi/pi-utils": "15.2.4",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/autoresearch/storage.ts

@@ -2,10 +2,22 @@ import { Database, type SQLQueryBindings } from "bun:sqlite";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { getAutoresearchDbPath, getAutoresearchProjectDir, logger } from "@oh-my-pi/pi-utils";
-import { getEncodedProjectName } from "../task/worktree";
 import * as git from "../utils/git";
 import type { ASIData, ExperimentStatus, MetricDirection, NumericMetricMap } from "./types";
 
+/**
+ * Encode an absolute project path into a single filesystem-safe segment.
+ *
+ * Used to key per-project autoresearch state under `~/.omp/autoresearch/`.
+ * The `--…--` wrapper is historical — existing on-disk state depends on it,
+ * so changing the format here would orphan every prior autoresearch DB.
+ * Not collision-free for pathological inputs (`/a/b` vs `/a-b`) but matches
+ * the rest of the codebase and stays human-readable for `ls`.
+ */
+function encodeProjectKey(repoRoot: string): string {
+	return `--${repoRoot.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
+}
+
 export interface SessionRow {
 	id: number;
 	name: string;
@@ -561,7 +573,7 @@ export async function openAutoresearchStorageIfExists(cwd: string): Promise<Auto
 async function resolveAutoresearchPaths(cwd: string): Promise<{ dbPath: string; projectDir: string }> {
 	const override = process.env.OMP_AUTORESEARCH_DB_DIR;
 	const repoRoot = (await git.repo.root(cwd)) ?? cwd;
-	const encoded = getEncodedProjectName(repoRoot);
+	const encoded = encodeProjectKey(repoRoot);
 	if (override) {
 		return {
 			dbPath: path.join(override, `${encoded}.db`),