@pi-unipi/utility 2.6.2 → 2.9.0

package/README.md

@@ -1,8 +1,6 @@
 # @pi-unipi/utility
 
-Environment info, diagnostics, cleanup, name badge, and diff rendering. The grab-bag package for maintaining your development environment and making tool output readable.
-
-The diff rendering is the standout feature — Shiki-powered syntax-highlighted diffs for `write` and `edit` tool output. Side-by-side view for edits, unified view for writes, with color presets and auto-fallback on narrow terminals.
+Environment info, diagnostics, cleanup, and the session name badge. The grab-bag package for maintaining your development environment and keeping an eye on provider cache behavior.
 
 ## Commands
 
@@ -15,7 +13,9 @@ The diff rendering is the standout feature — Shiki-powered syntax-highlighted
 | `/unipi:reload` | Explain how to reload extensions |
 | `/unipi:name-badge` | Toggle name badge overlay |
 | `/unipi:badge-gen` | Generate session name via LLM and enable badge |
-| `/unipi:util-settings` | Unified settings for badge and diff rendering |
+| `/unipi:badge-name` | Set the session name shown in the badge |
+| `/unipi:badge-settings` | Configure badge behavior |
+| `/unipi:util-settings` | Unified settings TUI (badge) |
 | `/unipi:prefix-cache` | Show privacy-safe request-prefix transitions and provider cache token counters |
 
 ### Examples
@@ -31,7 +31,7 @@ The diff rendering is the standout feature — Shiki-powered syntax-highlighted
 
 ## Special Triggers
 
-Utility registers with the info-screen dashboard, showing module status and diagnostic results. The footer subscribes to utility events for its extension status segment.
+Utility registers with the info-screen dashboard, showing module status and diagnostic results. The footer subscribes to utility events for its extension status segment. When Herdr is present, the badge module syncs the session name to the pane title.
 
 ## Provider prefix-cache diagnostics
 
@@ -41,71 +41,31 @@ The fingerprints are keyed HMAC-SHA-256 values using a random in-memory key that
 
 `/unipi:cleanup` includes private `~/.unipi/tool-results/` artifacts in the normal temporary-file retention policy (7 days by default). Use dry-run mode to review candidates before deletion.
 
-The diff rendering feature wraps Pi's built-in `write` and `edit` tools. When enabled, these tools show syntax-highlighted diffs instead of plain output. This is a transparent replacement — the agent doesn't need to know about it.
-
 ## Agent Tools
 
 | Tool | Description |
 |------|-------------|
-| `ctx_batch` | Atomic batch execution with rollback support |
 | `ctx_env` | Environment inspection for debugging |
-| `write` | Write file with syntax-highlighted diff (when diff enabled) |
-| `edit` | Edit file with split/unified diff view (when diff enabled) |
-
-### Batch Execution
-
-```typescript
-import { BatchBuilder } from "@pi-unipi/utility/tools/batch";
-
-const report = await new BatchBuilder()
-  .addCommand("search", { query: "refactor" })
-  .addTool("memory_search", { query: "patterns" })
-  .withOptions({ failFast: true, commandTimeoutMs: 30000 })
-  .execute(myExecutor);
-
-if (!report.success) {
-  console.log("Failed:", report.results.find(r => !r.success)?.error);
-}
-```
+| `set_session_name` | Set the session name for badge display (when badge agent-tool is enabled) |
 
 ## Configurables
 
-### Diff Rendering
+### Name Badge
 
 ```
 /unipi:util-settings        # Open unified settings TUI
 ```
 
-Or edit `.unipi/config/util-settings.json` directly:
+Or edit `.unipi/config/util-settings.json` directly (migrated automatically from the legacy `.unipi/config/badge.json` on first read):
 
 ```json
 {
-  "diff": {
-    "enabled": true,
-    "theme": "default",
-    "shikiTheme": "github-dark",
-    "splitMinWidth": 150
+  "badge": {
+    "badgeEnabled": true
   }
 }
 ```
 
-| Setting | Default | Options |
-|---------|---------|---------|
-| `enabled` | true | true/false |
-| `theme` | "default" | default, midnight, subtle, neon |
-| `shikiTheme` | "github-dark" | github-dark, dracula, one-dark-pro, catppuccin-mocha, nord, tokyo-night |
-| `splitMinWidth` | 150 | Minimum terminal width for split view |
-
-Environment variable overrides: `DIFF_ADD_BG`, `DIFF_REM_BG`, etc.
-
-Features:
-- Split view (side-by-side) for `edit`, auto-falls back to unified on narrow terminals
-- Unified view (stacked) for `write` overwrites
-- LRU cache (192 entries) for Shiki highlights
-- Large diff fallback (skip highlighting above 80k chars)
-
-### Name Badge
-
 The badge is a persistent HUD overlay in the top-right corner showing the current session name. It auto-restores visibility on session restart.
 
 ## Programmatic API
@@ -113,35 +73,9 @@ The badge is a persistent HUD overlay in the top-right corner showing the curren
 | Module | Path | Description |
 |--------|------|-------------|
 | ProcessLifecycle | `lifecycle/process` | Parent PID polling, orphan detection, signal handlers |
-| cleanupStale | `lifecycle/cleanup` | Stale DB/temp/session/cache cleanup with dry-run |
-| TTLCache | `cache/ttl-cache` | Memory or SQLite-backed TTL cache |
+| cleanupStale | `lifecycle/cleanup` | Stale DB/temp/session cleanup with dry-run |
 | AnalyticsCollector | `analytics/collector` | Privacy-respecting event collection with daily rollup |
 | runDiagnostics | `diagnostics/engine` | Cross-module health checks with plugin architecture |
-| detectCapabilities | `display/capabilities` | Terminal feature detection (color, Nerd Font, unicode) |
-| Width Utilities | `display/width` | ANSI-aware clamp, wrap, collapse, pad, center |
-
-### TTL Cache
-
-```typescript
-import { TTLCache } from "@pi-unipi/utility/cache/ttl-cache";
-
-const cache = new TTLCache({ defaultTtlMs: 60000 });
-await cache.set("key", { data: "value" });
-const value = await cache.get("key");
-```
-
-### Terminal Capabilities
-
-```typescript
-import { detectCapabilities, getIcon } from "@pi-unipi/utility/display/capabilities";
-
-const caps = detectCapabilities();
-console.log("Nerd Font:", caps.nerdFont);
-console.log("Truecolor:", caps.truecolor);
-console.log(getIcon("󰘳", "[OK]")); // Uses Nerd Font if available
-```
-
-Capability detection distinguishes basic color, xterm-256-compatible terminals, and truecolor-capable terminals. Apple Terminal is treated as color-capable but not truecolor-capable so renderers can fall back safely.
 
 ## Privacy
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/utility",
-  "version": "2.6.2",
-  "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
+  "version": "2.9.0",
+  "description": "Utility commands and tools for Pi coding agent \u2014 lifecycle, diagnostics, cache, analytics, display, batch execution",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -36,14 +36,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.1"
-  },
-  "devDependencies": {
-    "@types/diff": "^7.0.2"
+    "@pi-unipi/core": "2.9.0"
   },
+  "devDependencies": {},
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.80.0",
-    "@earendil-works/pi-tui": "^0.80.0",
+    "@earendil-works/pi-coding-agent": "^0.84.0",
+    "@earendil-works/pi-tui": "^0.84.0",
     "typebox": "^1.1.38"
   },
   "scripts": {

package/src/index.ts

@@ -3,13 +3,12 @@
  *
  * Comprehensive utilities suite for Pi coding agent:
  * - Commands: continue, reload, status, cleanup, env, doctor, badge
- * - Tools: ctx_batch, ctx_env, set_session_name
+ * - Tools: ctx_env, set_session_name
  * - Lifecycle: process management, stale cleanup
- * - Cache: TTL cache with optional persistence
  * - Analytics: lightweight event collection
  * - Diagnostics: cross-module health checks
- * - Display: terminal capabilities, width utilities
- * - TUI: settings inspector pattern, name badge
+ * - Prefix-cache observability: privacy-safe provider cache stats
+ * - TUI: util settings, name badge (incl. Herdr pane title sync)
  */
 
 import { dirname } from "node:path";