ultimate-pi 0.3.1 → 0.4.1

package/.pi/settings.example.json

@@ -3,11 +3,5 @@
 		"enabled": true,
 		"maxRetries": 3
 	},
-	"packages": [
-		"npm:ultimate-pi",
-		"npm:@posthog/pi",
-		"npm:context-mode",
-		"npm:@tintinweb/pi-subagents",
-		"npm:@sting8k/pi-vcc"
-	]
+	"packages": ["npm:ultimate-pi", "npm:@posthog/pi", "npm:context-mode"]
 }

package/.sentrux/rules.toml

@@ -35,7 +35,7 @@ order = 2
 
 [[layers]]
 name = "agents"
-paths = [".pi/agents/*", ".pi/prompts/*", ".agents/skills/*"]
+paths = [".pi/agents/*", ".pi/harness/agents.manifest.json", ".pi/prompts/*", ".agents/skills/*"]
 order = 3
 # Agent definitions, prompts, and skills
 

package/AGENTS.md

@@ -30,7 +30,7 @@ Created: 2026-05-14
 - Harness context: **context-mode only** — never lean-ctx on harness paths (see harness-context skill)
 - `graphify update .` after significant code changes
 - ast-grep (`sg`) is the default code search tool — use `sg -p 'pattern'` for structural search, never grep for code
-- Self-hosted Firecrawl at http://localhost:3002 (FIRECRAWL_API_URL)
+- Web fetch/search via `python3 "$UP_PKG/.pi/scripts/harness-web.py"` (Scrapling; see scrapling-web skill)
 
 ## graphify
 

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project are documented in this file.
 
+## [Unreleased]
+
+## [v0.4.1] — 2026-05-17
+
+### ✨ Features
+
+- **In-house VCC compaction:** vendored [pi-vcc](https://github.com/sting8k/pi-vcc) (inspired by [lllyasviel/VCC](https://github.com/lllyasviel/VCC)); removed `@sting8k/pi-vcc` npm dependency. Configuration is **env-only** (`HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG`) — no `PI_VCC_CONFIG_PATH` or JSON config files. VCC overrides `/compact` and auto-compaction by default; set `HARNESS_VCC_COMPACTION=false` for Pi LLM compaction. Refresh upstream: `npm run vendor:sync-vcc`.
+- **Harness subagents:** vendored harness-subagents extension with Sentrux bootstrap agent and related harness wiring.
+- **Harness web:** replace Firecrawl with Scrapling-based `harness-web` CLI for search and fetch.
+
+### 🔧 Chores
+
+- Format `.pi/settings.json` / `.pi/settings.example.json` and refresh `graphify-out` after VCC merge.
+
 ## [v0.3.1] — 2026-05-15
 
 ### 🐛 Fixes

package/THIRD_PARTY_NOTICES.md

@@ -6,3 +6,11 @@
 - **License:** MIT ([vendor/pi-model-router/LICENSE](vendor/pi-model-router/LICENSE))  
 - **Pinned revision:** See [vendor/pi-model-router/UPSTREAM_PIN.md](vendor/pi-model-router/UPSTREAM_PIN.md)  
 - ultimate-pi loads it from [`vendor/pi-model-router`](vendor/pi-model-router); import specifiers were adapted for `@mariozechner/pi-coding-agent` and related Pi packages.
+
+## pi-vcc (vendored)
+
+- **Project:** https://github.com/sting8k/pi-vcc  
+- **Conceptual basis:** https://github.com/lllyasviel/VCC (View-oriented Conversation Compiler)  
+- **License:** MIT (see upstream repository)  
+- **Pinned revision:** See [vendor/pi-vcc/UPSTREAM_PIN.md](vendor/pi-vcc/UPSTREAM_PIN.md)  
+- ultimate-pi loads it from [`vendor/pi-vcc`](vendor/pi-vcc) via [`.pi/extensions/ultimate-pi-vcc.ts`](.pi/extensions/ultimate-pi-vcc.ts). Harness configuration is env-only: `HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG` ([`.pi/extensions/lib/harness-vcc-settings.ts`](.pi/extensions/lib/harness-vcc-settings.ts)). Maintainer refresh: `npm run vendor:sync-vcc`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ultimate-pi",
-	"version": "0.3.1",
+	"version": "0.4.1",
 	"description": "Ultimate AI coding harness for pi.dev — extensible skills, Obsidian wiki knowledge layer, compressed context, deterministic output",
 	"keywords": [
 		"pi-package",
@@ -12,7 +12,8 @@
 		"knowledge-base",
 		"context-compression",
 		"agent-skills",
-		"firecrawl",
+		"scrapling",
+		"harness-web",
 		"context-mode",
 		"vcc"
 	],
@@ -44,12 +45,14 @@
 		".pi/scripts",
 		".pi/lib",
 		".pi/sounds",
+		".pi/harness/env.harness.template",
 		".pi/harness/specs",
 		".pi/harness/docs",
 		".pi/harness/sentrux",
 		".pi/harness/evals",
 		".pi/harness/evolution",
 		".pi/harness/corpus",
+		".pi/harness/agents.manifest.json",
 		".pi/harness/README.md",
 		".pi/npm/package.json",
 		".pi/npm/.gitignore",
@@ -57,32 +60,33 @@
 		".pi/settings.example.json",
 		".pi/auto-commit.json",
 		".pi/mcp.json",
-		".pi/pi-vcc-config.json",
 		".pi/SYSTEM.md",
 		".pi/PACKAGING.md",
-		"firecrawl/docker-compose.yaml",
-		"firecrawl/.env.template",
-		"firecrawl/README.md",
-		"firecrawl/searxng",
 		"AGENTS.md",
 		"biome.json",
 		"CHANGELOG.md",
 		"README.md",
 		"THIRD_PARTY_NOTICES.md",
-		"vendor/pi-model-router"
+		"vendor/pi-model-router",
+		"vendor/pi-vcc"
 	],
 	"peerDependencies": {
 		"@mariozechner/pi-coding-agent": "*"
 	},
 	"scripts": {
-		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts",
+		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/lib/harness-vcc-settings.ts .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/harness-ask-user.ts .pi/extensions/lib/ask-user/schema.ts .pi/extensions/lib/ask-user/types.ts .pi/extensions/lib/ask-user/validate.ts .pi/extensions/lib/ask-user/dialog.ts .pi/extensions/lib/ask-user/fallback.ts .pi/extensions/lib/ask-user/render.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts .pi/extensions/lib/harness-subagents/agent-loader.ts .pi/extensions/lib/harness-subagents/agent-parser.ts .pi/extensions/lib/harness-subagents/agent-manifest.ts .pi/extensions/lib/harness-subagents/blackboard.ts .pi/extensions/lib/harness-subagents/blackboard-tool.ts .pi/extensions/lib/harness-subagents/spawn-policy.ts .pi/extensions/lib/harness-subagents/types-blackboard.ts",
 		"vendor:sync-router": "bash .pi/scripts/vendor-sync-pi-model-router.sh",
+		"vendor:sync-vcc": "bash .pi/scripts/vendor-sync-pi-vcc.sh",
+		"release": "bash .pi/scripts/release.sh",
 		"lint": "biome check",
 		"lint:fix": "biome check --fix",
 		"format": "biome format --write",
 		"format:check": "biome format",
 		"prepare": "lefthook install",
-		"test": "node --test test/harness-verify.test.mjs",
+		"test": "node --test test/harness-verify.test.mjs test/harness-ask-user.test.mjs test/harness-subagents-loader.test.mjs test/sentrux-rules-sync.test.mjs && npx -y tsx --test test/harness-vcc-settings.test.ts",
+		"test:vcc": "npx -y tsx --test vendor/pi-vcc/tests/*.test.ts",
+		"harness:sentrux-bootstrap": "node .pi/scripts/harness-sentrux-bootstrap.mjs",
+		"harness:sentrux-sync": "node .pi/scripts/sentrux-rules-sync.mjs --force",
 		"test:integration": "npx -y tsx --test test/cursor-sdk-provider.integration.test.ts"
 	},
 	"devDependencies": {
@@ -97,10 +101,10 @@
 	},
 	"dependencies": {
 		"@posthog/pi": "latest",
-		"@sting8k/pi-vcc": "^0.3.12",
-		"@tintinweb/pi-subagents": "latest",
 		"asciify-image": "^0.1.10",
+		"croner": "^9.0.0",
 		"jimp": "^1.6.1",
+		"nanoid": "^5.1.5",
 		"posthog-node": "^5.30.6"
 	}
 }

package/vendor/pi-vcc/README.md

@@ -0,0 +1,215 @@
+# pi-vcc
+
+[![npm](https://img.shields.io/npm/v/@sting8k/pi-vcc)](https://www.npmjs.com/package/@sting8k/pi-vcc)
+
+Algorithmic conversation compactor for [Pi](https://github.com/badlogic/pi-mono). No LLM calls — produces a brief transcript via extraction and formatting.
+
+Inspired by [VCC](https://github.com/lllyasviel/VCC) **(View-oriented Conversation Compiler)**.
+
+## Demo
+
+![pi-vcc demo](./demo.gif)
+
+## Why pi-vcc
+
+|  | Pi default | pi-vcc |
+|---|---|---|
+| **Method** | LLM-generated summary | Algorithmic extraction, no LLM |
+| **Determinism** | Non-deterministic, can hallucinate | Same input = same output, always |
+| **Token reduction** | Varies | 35-99% on real sessions (higher on longer sessions) |
+| **Compaction latency** | Waits for LLM call | 30-470ms, no API calls |
+| **History after compaction** | Gone — agent only sees summary | Active lineage searchable via `vcc_recall` (`scope:"all"` available) |
+| **Repeated compactions** | Each rewrite risks losing more | Sections merge and accumulate |
+| **Cost** | Burns tokens on summarization call | Zero — no API calls |
+| **Structure** | Free-form prose | Brief transcript + 4 semantic sections |
+
+### Real session metrics
+
+Measured on real session JSONLs under `~/.pi/agent/sessions` (chars = rendered message text).
+
+| Session | Messages | Before | After | Reduction | Time |
+|---|---|---|---|---|---|
+| Session A | 2,943 | 997,162 | 7,959 | 99.2% | 64ms |
+| Session B | 1,703 | 428,334 | 7,762 | 98.2% | 29ms |
+| Session C | 1,657 | 424,183 | 9,577 | 97.7% | 54ms |
+| Session D | 1,004 | 2,258,477 | 4,439 | 99.8% | 30ms |
+| Session E | 486 | 295,006 | 11,163 | 96.2% | 30ms |
+| Session F | 46 | 5,234 | 3,364 | 35.7% | 5ms |
+| Session G | 27 | 8,595 | 2,489 | 71.0% | 2ms |
+
+## Features
+
+- **No LLM** — purely algorithmic, zero extra API cost
+- **Brief transcript** — chronological conversation flow, each tool call collapsed to a one-liner with `(#N)` refs, text truncated to keep it compact
+- **5 semantic sections** — session goal, files & changes, commits, outstanding context, user preferences
+- **Bounded merge** — rolling sections re-capped after merge instead of growing unbounded
+- **Lossless recall** — `vcc_recall` reads raw session JSONL, so active-lineage history stays searchable across compactions
+- **Scoped recall** — default search is active lineage; use `scope:"all"` / `scope:all` to intentionally search across all lineages
+- **Regex search** — `vcc_recall` supports regex patterns (`hook|inject`, `fail.*build`) and OR-ranked multi-word queries
+- **Result ranking** — search results ranked by term relevance, rare terms weighted higher than common ones
+- **`/pi-vcc-recall`** — slash command to search history directly, results shown as collapsible message and auto-fed to agent as context
+- **Fallback cut** — still works when Pi core returns nothing to summarize
+- **`/pi-vcc`** — manual compaction on demand
+
+## Install
+
+```bash
+pi install npm:@sting8k/pi-vcc
+```
+
+Or from GitHub:
+
+```bash
+pi install https://github.com/sting8k/pi-vcc
+```
+
+Or try without installing:
+
+```bash
+pi -e https://github.com/sting8k/pi-vcc
+```
+
+## Usage
+
+Once installed, pi-vcc registers a `session_before_compact` hook.
+
+- Run `/pi-vcc` to trigger pi-vcc compaction manually.
+- By default, `/compact` and auto-threshold compactions still go through pi core (LLM-based). Set `overrideDefaultCompaction: true` in the config to let pi-vcc handle all compaction paths.
+- To search older active-lineage history after compaction, use `vcc_recall`.
+- To intentionally search across all lineages, pass `scope:"all"` to `vcc_recall` or run `/pi-vcc-recall <query> scope:all`.
+- To search and feed results to agent yourself, run `/pi-vcc-recall <query> [page:N]`.
+  - Tip: type `/recall` and Pi will autocomplete to `/pi-vcc-recall`.
+
+### How compaction works
+
+Pi splits the conversation at the **last user message**. Everything after — the **kept tail** — stays intact and untouched. pi-vcc only summarizes the older portion before that cut point.
+
+### Compacted message structure
+
+```
+[Session Goal]
+- Fix the authentication bug in login flow
+- [Scope change]
+- Also update the session token refresh logic
+
+[Files And Changes]
+- Modified: src/auth/session.ts
+- Created: tests/auth-refresh.test.ts
+
+[Commits]
+- a1b2c3d: fix(auth): refresh token after password reset
+
+[Outstanding Context]
+- lint check still failing on line 42
+
+[User Preferences]
+- Prefer Vietnamese responses
+- Always run tests before committing
+
+[user]
+Fix the auth bug, users can't log in after password reset
+
+[assistant]
+Root cause is a missing token refresh after password reset...
+* bash "bun test tests/auth.test.ts" (#12)
+* edit "src/auth/session.ts" (#14)
+* bash "bun test tests/auth.test.ts" (#16)
+...(28 earlier lines omitted)
+```
+
+Sections appear only when relevant — a session with no git commits won't have `[Commits]`.
+
+**Sections:**
+
+| Section | Description |
+|---|---|
+| `[Session Goal]` | Initial goal + scope changes (regex-based extraction) |
+| `[Files And Changes]` | Modified/created files from tool calls (capped, paths trimmed to common root) |
+| `[Commits]` | Git commits made during the session (last 8, hash + first line) |
+| `[Outstanding Context]` | Unresolved items — errors, pending questions |
+| `[User Preferences]` | Regex-extracted from user messages (`always`, `never`, `prefer`...) |
+| Brief transcript | Chronological conversation flow — rolling window of ~120 recent lines, tool calls collapsed to one-liners with `(#N)` refs |
+
+**Merge policy:**
+- `Session Goal`, `User Preferences`: concise sticky sections
+- `Outstanding Context`: fresh-only (replaced each compaction)
+- `Files And Changes`, `Commits`: unique union across compactions
+- Brief transcript: rolling window, older lines drop off
+
+## Recall (Lossless History)
+
+Pi's default compaction discards old messages permanently. After compaction, the agent only sees the summary.
+
+`vcc_recall` bypasses this by reading the raw session JSONL file directly. By default it searches only the active conversation lineage, regardless of how many compactions have happened. Use `scope:"all"` only when you intentionally want to include off-lineage branches.
+
+### Search
+
+Queries support **regex** and **multi-word OR logic** ranked by relevance:
+
+```
+vcc_recall({ query: "auth token" })                         // active-lineage OR search, ranked
+vcc_recall({ query: "auth token", page: 2 })                // paginated (5 results/page)
+vcc_recall({ query: "hook|inject" })                         // regex pattern
+vcc_recall({ query: "fail.*build" })                         // regex pattern
+vcc_recall({ query: "auth token", scope: "all" })           // search all lineages
+```
+
+Manual slash command:
+
+```
+/pi-vcc-recall auth token scope:all
+```
+
+### Browse
+
+Without a query, returns the last 25 entries as brief summaries:
+
+```
+vcc_recall()
+vcc_recall({ scope: "all" })  // browse recent entries across all lineages
+```
+
+### Expand
+
+Returns full untruncated content for specific indices found via search:
+
+```
+vcc_recall({ expand: [41, 42] })                 // active-lineage expand
+vcc_recall({ expand: [41, 42], scope: "all" })   // expand across all lineages
+```
+
+Typical workflow: **search → find relevant entry indices → expand those indices for full content**.
+
+> Some tool results are truncated by Pi core at save time. `expand` returns everything in the JSONL but can't recover what Pi already cut.
+
+## Pipeline
+
+1. **Normalize** — raw Pi messages → uniform blocks (user, assistant, tool_call, tool_result, thinking)
+2. **Filter noise** — strip system messages, empty blocks
+3. **Build sections** — extract goal, file paths, blockers, preferences
+4. **Brief transcript** — chronological conversation flow, tool calls collapsed to one-liners, text truncated
+5. **Format** — render into bracketed sections + transcript
+6. **Merge** — if previous summary exists: sticky sections merge, volatile sections replace, transcript rolls
+
+## Config
+
+Config lives at `~/.pi/agent/pi-vcc-config.json` (auto-scaffolded on first load with safe defaults):
+
+```json
+{
+  "overrideDefaultCompaction": false,
+  "debug": false
+}
+```
+
+- **`overrideDefaultCompaction`** *(default `false`)*: when `false`, pi-vcc only runs for `/pi-vcc`; `/compact` and auto-threshold compactions fall through to pi core. Set `true` to make pi-vcc handle all compaction paths.
+- **`debug`** *(default `false`)*: when `true`, each compaction writes detailed info to `/tmp/pi-vcc-debug.json` — message counts, cut boundary, summary preview, sections.
+
+## Related Work
+
+- [VCC](https://github.com/lllyasviel/VCC) — the original transcript-preserving conversation compiler
+- [Pi](https://github.com/badlogic/pi-mono) — the AI coding agent this extension is built for
+
+## License
+
+MIT

package/vendor/pi-vcc/UPSTREAM_PIN.md

@@ -0,0 +1,12 @@
+# Vendored `pi-vcc`
+
+- **Repository:** https://github.com/sting8k/pi-vcc
+- **Conceptual basis:** [lllyasviel/VCC](https://github.com/lllyasviel/VCC) (View-oriented Conversation Compiler)
+- **License:** MIT (see upstream repository)
+- **Pinned upstream commit:** `3e0b49e4ef605370e3dd92889e6b70502262cc28`
+- **Local changes:**
+  - `src/core/settings.ts` re-exports env-only [`.pi/extensions/lib/harness-vcc-settings.ts`](../../.pi/extensions/lib/harness-vcc-settings.ts) (`HARNESS_VCC_COMPACTION`, `HARNESS_VCC_DEBUG`)
+  - No `scaffoldSettings` / no `PI_VCC_CONFIG_PATH`
+  - Compaction `details.compactor` is `ultimate-pi-vcc`
+
+**Refresh upstream:** run `npm run vendor:sync-vcc` from ultimate-pi root.

package/vendor/pi-vcc/index.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { registerBeforeCompactHook } from "./src/hooks/before-compact";
+import { registerPiVccCommand } from "./src/commands/pi-vcc";
+import { registerVccRecallCommand } from "./src/commands/vcc-recall";
+import { registerRecallTool } from "./src/tools/recall";
+
+export default (pi: ExtensionAPI) => {
+  registerBeforeCompactHook(pi);
+  registerPiVccCommand(pi);
+  registerVccRecallCommand(pi);
+  registerRecallTool(pi);
+};

package/vendor/pi-vcc/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@sting8k/pi-vcc",
+  "version": "0.3.13",
+  "description": "Algorithmic conversation compactor for pi - transcript-preserving structured summaries, no LLM calls",
+  "main": "index.ts",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "vcc",
+    "compact",
+    "compaction"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sting8k/pi-vcc.git"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/vendor/pi-vcc/scripts/audit-sessions.ts

@@ -0,0 +1,88 @@
+import { basename, dirname } from "node:path";
+import { compile } from "../src/core/summarize";
+import { normalize } from "../src/core/normalize";
+import { filterNoise } from "../src/core/filter-noise";
+import { renderMessage } from "../src/core/render-entries";
+import { prepareSessionSamples } from "../tests/support/real-sessions";
+import { loadSessionMessages } from "../tests/support/load-session";
+
+const SEP = "=".repeat(80);
+const samples = await prepareSessionSamples(10);
+
+for (const sample of samples) {
+  const loaded = loadSessionMessages(sample.copy);
+  const { messages } = loaded;
+
+  const rawBlocks = normalize(messages);
+  const filteredBlocks = filterNoise(rawBlocks);
+  const afterText = compile({ messages });
+
+  const rendered = messages.map((m, i) => renderMessage(m, i));
+  const beforeChars = rendered.reduce((s, e) => s + e.summary.length, 0);
+
+  const project = dirname(sample.source).split("--").filter(Boolean).pop() ?? "unknown";
+
+  const goalSection = afterText.match(/\[Session Goal\]\n([\s\S]*?)(?=\n\n\[|$)/)?.[1] ?? "(empty)";
+  const stateSection = afterText.match(/\[Current State\]\n([\s\S]*?)(?=\n\n\[|$)/)?.[1] ?? "(empty)";
+  const doneSection = afterText.match(/\[What Was Done\]\n([\s\S]*?)(?=\n\n\[|$)/)?.[1] ?? "(empty)";
+  const problemsSection = afterText.match(/\[Open Problems\]\n([\s\S]*?)(?=\n\n\[|$)/)?.[1] ?? "(empty)";
+  const nextSection = afterText.match(/\[Next Best Steps\]\n([\s\S]*?)(?=\n\n\[|$)/)?.[1] ?? "(empty)";
+
+  const doneLines = doneSection.split("\n").filter(l => l.trim());
+  const problemLines = problemsSection.split("\n").filter(l => l.trim());
+
+  // Detect issues
+  const issues: string[] = [];
+
+  // 1. Goal quality
+  const goalLines = goalSection.split("\n").map(l => l.replace(/^- /, "").trim()).filter(Boolean);
+  if (goalLines[0] && goalLines[0].length < 5) issues.push(`GOAL_TOO_SHORT: "${goalLines[0]}"`);
+  if (goalLines.length === 0) issues.push("GOAL_EMPTY");
+
+  // 2. Sensitive data in What Was Done
+  if (/sshpass|password|secret|token=|api[_-]?key/i.test(doneSection)) {
+    issues.push("SENSITIVE_DATA_IN_DONE");
+  }
+
+  // 3. Raw code/minified JS in summary
+  if (/\{[a-zA-Z$_]+:[a-zA-Z$_]+,[a-zA-Z$_]+:/.test(afterText) || /var [a-zA-Z]+=/.test(afterText)) {
+    issues.push("RAW_CODE_LEAK");
+  }
+
+  // 4. Open problems count
+  if (problemLines.length > 10) issues.push(`PROBLEMS_OVERCOUNT: ${problemLines.length}`);
+
+  // 5. Next steps empty
+  if (nextSection === "(empty)") issues.push("NEXT_STEPS_EMPTY");
+
+  // 6. What Was Done too verbose
+  if (doneLines.length > 15) issues.push(`DONE_TOO_VERBOSE: ${doneLines.length} lines`);
+
+  // 7. Summary too large (>10K chars)
+  if (afterText.length > 10000) issues.push(`SUMMARY_TOO_LARGE: ${afterText.length} chars`);
+
+  console.log(SEP);
+  console.log(`PROJECT: ${project}`);
+  console.log(`FILE: ${basename(sample.source)}`);
+  console.log(`Size: ${(sample.size / 1024).toFixed(0)}KB | Msgs: ${messages.length} | Blocks raw: ${rawBlocks.length} -> filtered: ${filteredBlocks.length}`);
+  console.log(`Before: ${beforeChars} chars | After: ${afterText.length} chars | Ratio: ${(beforeChars / afterText.length).toFixed(1)}x`);
+  console.log(`Issues: ${issues.length === 0 ? "NONE" : issues.join(", ")}`);
+  console.log("");
+  console.log("--- GOAL ---");
+  console.log(goalSection.slice(0, 300));
+  console.log("");
+  console.log("--- CURRENT STATE (first 300c) ---");
+  console.log(stateSection.slice(0, 300));
+  console.log("");
+  console.log("--- WHAT WAS DONE (first 5 lines) ---");
+  console.log(doneLines.slice(0, 5).join("\n"));
+  console.log(`... (${doneLines.length} total lines)`);
+  console.log("");
+  console.log("--- OPEN PROBLEMS (first 5 lines) ---");
+  console.log(problemLines.slice(0, 5).join("\n"));
+  console.log(`... (${problemLines.length} total lines)`);
+  console.log("");
+  console.log("--- NEXT STEPS ---");
+  console.log(nextSection.slice(0, 300));
+  console.log("");
+}

package/vendor/pi-vcc/scripts/benchmark-real-sessions.ts

@@ -0,0 +1,25 @@
+import { performance } from "node:perf_hooks";
+import { basename } from "node:path";
+import { buildCompactReport } from "../src/core/report";
+import { prepareSessionSamples } from "../tests/support/real-sessions";
+import { loadSessionMessages } from "../tests/support/load-session";
+
+const samples = await prepareSessionSamples(2);
+for (const sample of samples) {
+  const loaded = loadSessionMessages(sample.copy);
+  const start = performance.now();
+  const report = buildCompactReport({ messages: loaded.messages });
+  const elapsedMs = performance.now() - start;
+  console.log(JSON.stringify({
+    sourceFile: basename(sample.source),
+    sourceSizeBytes: sample.size,
+    copiedToTemp: true,
+    loadedMessages: loaded.messageCount,
+    skippedMessages: loaded.skippedCount,
+    compileMs: Number(elapsedMs.toFixed(2)),
+    before: report.before,
+    after: report.after,
+    compression: report.compression,
+    recall: report.recall,
+  }, null, 2));
+}

package/vendor/pi-vcc/scripts/compare-before-after.ts

@@ -0,0 +1,36 @@
+import { basename } from "node:path";
+import { compile } from "../src/core/summarize";
+import { renderMessage } from "../src/core/render-entries";
+import { clip } from "../src/core/content";
+import { prepareSessionSamples } from "../tests/support/real-sessions";
+import { loadSessionMessages } from "../tests/support/load-session";
+
+const SEP = "=".repeat(80);
+const samples = await prepareSessionSamples(2);
+
+for (const sample of samples) {
+  const loaded = loadSessionMessages(sample.copy);
+  const { messages } = loaded;
+
+  const rendered = messages.map((m, i) => renderMessage(m, i));
+  const beforeLines = rendered.map(
+    (e) => `#${e.index} [${e.role}] ${clip(e.summary, 300)}`,
+  );
+  const beforeText = beforeLines.join("\n");
+  const afterText = compile({ messages });
+
+  console.log(SEP);
+  console.log(`FILE: ${basename(sample.source)}`);
+  console.log(`Messages: ${messages.length} | Before chars: ${beforeText.length} | After chars: ${afterText.length}`);
+  console.log(`Compression: ${(beforeText.length / afterText.length).toFixed(1)}x`);
+  console.log(SEP);
+
+  console.log("\n--- BEFORE (raw context, first 40 + last 20 entries) ---\n");
+  for (const line of beforeLines.slice(0, 40)) console.log(line);
+  if (beforeLines.length > 60) console.log(`\n... (${beforeLines.length - 60} entries omitted) ...\n`);
+  for (const line of beforeLines.slice(-20)) console.log(line);
+
+  console.log("\n--- AFTER (pi-vcc compiled summary) ---\n");
+  console.log(afterText);
+  console.log("\n");
+}

package/vendor/pi-vcc/scripts/dump-branch-output.ts

@@ -0,0 +1,20 @@
+import { basename } from "node:path";
+import { compile } from "../src/core/summarize";
+import { prepareSessionSamples } from "../tests/support/real-sessions";
+import { loadSessionMessages } from "../tests/support/load-session";
+import { writeFileSync, mkdirSync } from "node:fs";
+
+const outDir = "/tmp/pi-vcc-compare";
+const branch = process.argv[2] || "unknown";
+mkdirSync(`${outDir}/${branch}`, { recursive: true });
+
+const samples = await prepareSessionSamples(5);
+for (const sample of samples) {
+  const name = basename(sample.source).slice(0, 30);
+  const loaded = loadSessionMessages(sample.copy);
+  const summary = compile({ messages: loaded.messages });
+  const outFile = `${outDir}/${branch}/${name}.txt`;
+  writeFileSync(outFile, summary);
+  console.log(`${name} (${loaded.messageCount} msgs) => ${summary.length} chars`);
+}
+console.log(`\nSaved to ${outDir}/${branch}/`);

package/vendor/pi-vcc/src/commands/pi-vcc.ts

@@ -0,0 +1,36 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { getLastCompactionStats, PI_VCC_COMPACT_INSTRUCTION } from "../hooks/before-compact";
+
+const formatTokens = (n: number): string => {
+  if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;
+  return String(n);
+};
+
+export const registerPiVccCommand = (pi: ExtensionAPI) => {
+  pi.registerCommand("pi-vcc", {
+    description: "Compact conversation with pi-vcc structured summary",
+    handler: async (_args, ctx) => {
+      ctx.compact({
+        customInstructions: PI_VCC_COMPACT_INSTRUCTION,
+        onComplete: () => {
+          const stats = getLastCompactionStats();
+          if (stats) {
+            ctx.ui.notify(
+              `pi-vcc: ${stats.summarized} source entries processed; tail kept ${stats.kept} (~${formatTokens(stats.keptTokensEst)} tok).`,
+              "info",
+            );
+          } else {
+            ctx.ui.notify("Compacted with pi-vcc", "info");
+          }
+        },
+        onError: (err) => {
+          if (err.message === "Compaction cancelled" || err.message === "Already compacted") {
+            ctx.ui.notify("Nothing to compact", "warning");
+          } else {
+            ctx.ui.notify(`Compaction failed: ${err.message}`, "error");
+          }
+        },
+      });
+    },
+  });
+};