@pi-unipi/unipi 2.10.2 → 2.11.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.11.0] — 2026-08-26
+
+### Added
+
+- `trajectory`: full UniPi-owned package attribution for lifecycle hooks, command handlers, tool execution, mutating `ExtensionAPI` calls, context/session actions, and custom EventBus delivery, including duration, result fingerprints, errors, and bounded mutation evidence.
+- `trajectory`: per-request prefix-integrity verdicts (`first_request`, `identical_retry`, `prefix_extended`, `boundary`, `violation`) over final serialized provider payloads. Violations identify the first changed message index/path and separately report system prompt, tool schema/order, provider route, thinking level, and envelope drift.
+- `trajectory`: explicit cache epochs for compaction, tree navigation, model changes, and thinking-level changes; append-only enforcement resumes immediately after each boundary.
+- `trajectory`: **UniPi** and **Violations** filters plus Trace, Integrity, and Attribution inspector tabs.
+
+### Changed
+
+- Umbrella `@pi-unipi/unipi` now loads every owned module through a package-scoped tracing API and keeps trajectory as the final unwrapped sink. Unrelated third-party extensions are intentionally excluded from attribution.
+- Trajectory is now context-focused: the ledger includes provider-visible messages, system prompts, serialized requests, prefix verdicts, and only UniPi operations that mutate context or establish a cache epoch. Inert lifecycle hooks, registrations, notifications, response headers, and stream deltas are excluded.
+- Trajectory live updates now cache the telemetry tail and projected snapshot, read only the last 5 MB of existing sidecars, use conditional 1.5-second polling, and avoid rerendering unchanged pages.
+
 ## [2.10.2] — 2026-08-25
 
 Follow-up to 2.10.1: the 2.10.1 tarballs shipped with `@pi-unipi/*` cross-dependency pins still pointing at `2.10.0`, so installing `@pi-unipi/unipi@2.10.1` resolved the old `@pi-unipi/trajectory@2.10.0` (without the auto-completion fix) instead of `2.10.1`. This release re-synchronizes every cross-pin to `2.10.2` and republishes the full synchronized set.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,28 +82,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.10.2",
-    "@pi-unipi/background-tasks": "2.10.2",
-    "@pi-unipi/btw": "2.10.2",
-    "@pi-unipi/command-enchantment": "2.10.2",
-    "@pi-unipi/compactor": "2.10.2",
-    "@pi-unipi/core": "2.10.2",
-    "@pi-unipi/footer": "2.10.2",
-    "@pi-unipi/image": "2.10.2",
-    "@pi-unipi/info-screen": "2.10.2",
-    "@pi-unipi/input-shortcuts": "2.10.2",
-    "@pi-unipi/kanboard": "2.10.2",
-    "@pi-unipi/mcp": "2.10.2",
-    "@pi-unipi/memory": "2.10.2",
-    "@pi-unipi/milestone": "2.10.2",
-    "@pi-unipi/notify": "2.10.2",
-    "@pi-unipi/ralph": "2.10.2",
-    "@pi-unipi/subagents": "2.10.2",
-    "@pi-unipi/trajectory": "2.10.2",
-    "@pi-unipi/updater": "2.10.2",
-    "@pi-unipi/utility": "2.10.2",
-    "@pi-unipi/web-api": "2.10.2",
-    "@pi-unipi/workflow": "2.10.2"
+    "@pi-unipi/ask-user": "2.11.0",
+    "@pi-unipi/background-tasks": "2.11.0",
+    "@pi-unipi/btw": "2.11.0",
+    "@pi-unipi/command-enchantment": "2.11.0",
+    "@pi-unipi/compactor": "2.11.0",
+    "@pi-unipi/core": "2.11.0",
+    "@pi-unipi/footer": "2.11.0",
+    "@pi-unipi/image": "2.11.0",
+    "@pi-unipi/info-screen": "2.11.0",
+    "@pi-unipi/input-shortcuts": "2.11.0",
+    "@pi-unipi/kanboard": "2.11.0",
+    "@pi-unipi/mcp": "2.11.0",
+    "@pi-unipi/memory": "2.11.0",
+    "@pi-unipi/milestone": "2.11.0",
+    "@pi-unipi/notify": "2.11.0",
+    "@pi-unipi/ralph": "2.11.0",
+    "@pi-unipi/subagents": "2.11.0",
+    "@pi-unipi/trajectory": "2.11.0",
+    "@pi-unipi/updater": "2.11.0",
+    "@pi-unipi/utility": "2.11.0",
+    "@pi-unipi/web-api": "2.11.0",
+    "@pi-unipi/workflow": "2.11.0"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.10.2",
+    "@pi-unipi/core": "2.11.0",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.84.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2",
-    "@pi-unipi/info-screen": "2.10.2",
+    "@pi-unipi/core": "2.11.0",
+    "@pi-unipi/info-screen": "2.11.0",
     "@earendil-works/pi-agent-core": "^0.84.0"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Image generation and image recognition tools for the Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -39,8 +39,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.10.2",
-    "@pi-unipi/info-screen": "2.10.2",
+    "@pi-unipi/core": "2.11.0",
+    "@pi-unipi/info-screen": "2.11.0",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Lifecycle layer for project-level goals — MILESTONES.md tracking, session hooks, auto-sync",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2"
+    "@pi-unipi/core": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2",
+    "@pi-unipi/core": "2.11.0",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -31,8 +31,8 @@
     "test": "npx tsx --test reminder.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2",
-    "@pi-unipi/info-screen": "2.10.2"
+    "@pi-unipi/core": "2.11.0",
+    "@pi-unipi/info-screen": "2.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "src/index.ts",
@@ -9,7 +9,7 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.10.2",
+    "@pi-unipi/core": "2.11.0",
     "@earendil-works/pi-agent-core": "^0.84.0",
     "acorn": "8.18.0"
   },

package/packages/trajectory/README.md

@@ -15,15 +15,23 @@ Typing `/unipi:trajectory` followed by a space auto-completes the available
 actions (`stop`, `off`, `toggle`), so the options are discoverable without
 reading the docs. Running it with no argument opens or reuses the server.
 
-The command starts or reuses an in-process server on `127.0.0.1:8176-8186` and opens it in the default browser. The page follows the active session every 500 ms. The server is owned by the current Pi process and is stopped on any Pi session shutdown/reload/resume/new/fork event.
+The command starts or reuses an in-process server on `127.0.0.1:8176-8186` and opens it in the default browser. The page follows the active session every 1.5 seconds, skips unchanged snapshots, and reuses an in-memory telemetry tail instead of rereading the JSONL file. The server is owned by the current Pi process and is stopped on any Pi session shutdown/reload/resume/new/fork event.
 
 ## What it shows
 
+- The exact provider-context path: user/assistant/tool messages, effective system prompt, serialized provider request, and prefix-integrity verdict
+- UniPi package operations only when they mutate context or cross an explicit context epoch boundary; UI-only hooks, registrations, notifications, command bookkeeping, and unrelated EventBus traffic are intentionally excluded from the ledger
+- A per-request prefix-integrity verdict: first request, identical retry, append-only extension, explicit lifecycle boundary, or violation
+- Exact prefix-break evidence: first changed message index/path plus independent system-prompt, tool-schema/order, route, thinking-level, and provider-envelope drift
+- Contributing UniPi package operations between the previous request and a violation
+- One-click **UniPi** and **Violations** filters, plus Trace, Integrity, and Attribution detail tabs
+- The fully assembled effective system prompt for each agent run
 - Turn-aware User, Assistant, Tool, Compaction, and Branch ledger
-- Assistant reasoning and final output
-- Tool payloads, results, errors, and measured call duration
+- Effective context messages before each model request and the final provider payload after serialization/extension rewrites
+- Assistant reasoning and final output, including streamed assistant events
+- Tool payloads, final results, errors, and measured call duration
 - Provider, model, stop reason, token usage, cache reads/writes, and cost
-- Provider, model, thinking level, request payload/options, tool schemas, response status/headers
+- Provider, model, thinking level, serialized request payload, and tool schemas
 - Exact TTFT, decoding/total request timing, and tool execution timing
 - Input/Model/Tools overview timeline with drag-to-focus
 - Search, turn folding, call folding, and a local record inspector
@@ -34,7 +42,15 @@ The server binds only to `127.0.0.1`. It reads `SessionManager.getBranch()` and
 
 Detailed telemetry is appended to `~/.unipi/trajectory/<session-id>.jsonl` with a private directory/file mode. Authorization, API-key, token, cookie, secret, password, and credential fields and credential-shaped values are recursively redacted before persistence.
 
-Detailed request fields appear when captured by the trajectory telemetry sidecar.
+Context-relevant prompt, request, package mutation, and prefix-integrity fields appear when captured by the trajectory telemetry sidecar. Stream deltas, response headers, inert hooks, and other activity that cannot affect model context are not persisted. Secret-shaped headers and values are redacted before persistence, and pathological events/read volume are bounded so debug capture cannot exhaust the Pi process.
+
+## Prefix integrity
+
+Inside one cache epoch, the previous serialized message sequence must be an exact prefix of the next request. An identical retry is also safe. Any earlier edit, removal, reorder, or middle insertion is a violation. System instructions, tool definitions/order, provider route, thinking level, and request envelope are checked independently because changes there also invalidate provider prefix caches.
+
+Compaction, tree navigation, model changes, and thinking-level changes create explicit epoch boundaries. The first request after a boundary is labeled as such; append-only enforcement resumes on the following request.
+
+Package attribution is intentionally limited to UniPi modules loaded through the all-in-one `@pi-unipi/unipi` umbrella. Standalone trajectory still captures Pi's observable hooks and requests, but cannot attribute calls made by independently loaded packages.
 
 ## Lifecycle
 
@@ -42,6 +58,6 @@ Each Pi process owns its own trajectory server. A second Pi process running `/un
 
 ## Limitations
 
-- Live transport uses 500 ms polling rather than a push stream.
-- Very large branches are rendered in one table; browser virtualization can be added if measured sessions require it.
+- Live transport uses conditional 1.5-second polling rather than a push stream.
+- Very large active branches are rendered in one table; unchanged snapshots are not rebuilt or rerendered.
 - Tool duration uses exact executor telemetry when captured and session timestamps otherwise.

package/packages/trajectory/index.ts

@@ -2,19 +2,33 @@ import type { ExtensionAPI, ExtensionContext, SessionEntry } from "@earendil-wor
 import { registerTelemetryCapture } from "./src/capture.js";
 import { projectTrajectory } from "./src/project.js";
 import { openBrowser, TrajectoryServer } from "./src/server.js";
+import { createUnipiTracer, type UnipiTraceRecorder } from "./src/tracer.js";
+
+export { createUnipiTracer, type UnipiTraceRecorder, type UnipiTracer } from "./src/tracer.js";
 
 let server: TrajectoryServer | null = null;
 let currentContext: ExtensionContext | null = null;
+let cachedLeafId: string | null | undefined;
+let cachedTelemetryRevision = -1;
+let cachedSnapshot: ReturnType<typeof projectTrajectory> | null = null;
 
 function stopServer(): boolean {
   if (!server?.url) return false;
   server.stop();
   server = null;
+  cachedLeafId = undefined;
+  cachedTelemetryRevision = -1;
+  cachedSnapshot = null;
   return true;
 }
 
-export default function trajectory(pi: ExtensionAPI): void {
-  const readTelemetry = registerTelemetryCapture(pi);
+export interface TrajectoryOptions {
+  traceRecorder?: UnipiTraceRecorder;
+}
+
+export default function trajectory(pi: ExtensionAPI, options: TrajectoryOptions = {}): void {
+  const recorder = options.traceRecorder ?? createUnipiTracer(pi).recorder;
+  const readTelemetry = registerTelemetryCapture(pi, undefined, recorder);
 
   pi.registerCommand("unipi:trajectory", {
     description: "Open or manage UniPi's live trajectory for the current session",
@@ -54,11 +68,17 @@ export default function trajectory(pi: ExtensionAPI): void {
         server = new TrajectoryServer({
           snapshot: () => {
             const active = currentContext ?? ctx;
-            return projectTrajectory(active.sessionManager.getBranch() as SessionEntry[], {
+            const leafId = active.sessionManager.getLeafId();
+            const telemetryRevision = recorder.revision();
+            if (cachedSnapshot && cachedLeafId === leafId && cachedTelemetryRevision === telemetryRevision) return cachedSnapshot;
+            cachedLeafId = leafId;
+            cachedTelemetryRevision = telemetryRevision;
+            cachedSnapshot = projectTrajectory(active.sessionManager.getBranch() as SessionEntry[], {
               sessionId: active.sessionManager.getSessionId(),
               name: active.sessionManager.getSessionName(),
               cwd: active.cwd,
             }, readTelemetry());
+            return cachedSnapshot;
           },
         });
       }

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/trajectory",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",