pi-vcc 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 buihongduc132
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# pi-vcc
+
+[![npm](https://img.shields.io/npm/v/@sting8k/pi-vcc)](https://www.npmjs.com/package/@sting8k/pi-vcc)
+[![license](https://img.shields.io/npm/l/@sting8k/pi-vcc)](https://spdx.org/licenses/MIT)
+
+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)**.
+
+## Features
+
+- **Zero LLM calls** — deterministic, same input always produces same output
+- **35–99% token reduction** on real sessions (higher on longer sessions)
+- **30–470ms latency** — no API calls, pure algorithmic extraction
+- **4 semantic sections** — Session Goal, Outstanding Context, References, Key Signals
+- **Brief transcript** with tool-call rollup and noise filtering
+- **History search** via `vcc_recall` tool (lineage-scoped, expand, pagination)
+- **Section merging** across repeated compactions with deduplication
+- **Configurable extraction** — additive patterns for URLs, GitHub refs, versions, constraints, decisions, statuses
+
+## Installation
+
+### For humans (npm)
+
+```bash
+npm install @sting8k/pi-vcc
+```
+
+### For AI agents (pi settings.json)
+
+Add to your pi `settings.json` packages array:
+
+```json
+{
+  "packages": ["@sting8k/pi-vcc"]
+}
+```
+
+### Git-sourced
+
+In `settings.json`, reference the repo directly:
+
+```json
+{
+  "packages": ["github:buihongduc132/pi-vcc"]
+}
+```
+
+Or clone into `profile/git/github.com/buihongduc132/`:
+
+```bash
+git clone https://github.com/buihongduc132/pi-vcc.git profile/git/github.com/buihongduc132/pi-vcc
+```
+
+## Usage
+
+Once installed, pi-vcc registers two hooks and one tool automatically:
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `/pi-vcc` | Trigger pi-vcc compaction explicitly |
+| `/compact` | Handled by pi-vcc when `overrideDefaultCompaction: true` |
+
+### Tool: `vcc_recall`
+
+Search session history after compaction:
+
+```
+vcc_recall({ query: "auth bug", scope: "all", page: 1 })
+vcc_recall({ expand: [0, 3], scope: "all" })
+```
+
+- **Default scope**: active lineage only; use `scope: "all"` for off-lineage branches
+- Supports regex queries, pagination, and expand indices
+
+## Configuration
+
+Config file: `~/.pi/agent/pi-vcc-config.json` (auto-scaffolded with defaults).
+
+```json
+{
+  "overrideDefaultCompaction": false,
+  "debug": false,
+  "extraction": {
+    "references": {
+      "enabled": true,
+      "extraUrlPatterns": [],
+      "extraGithubRefPatterns": [],
+      "extraVersionPatterns": [],
+      "extraBranchPatterns": []
+    },
+    "keySignals": {
+      "enabled": true,
+      "extraConstraintPatterns": [],
+      "extraDecisionPatterns": [],
+      "extraStatusPatterns": []
+    },
+    "goals": {
+      "enabled": true,
+      "extraTaskVerbs": [],
+      "extraScopeChangeWords": []
+    }
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `overrideDefaultCompaction` | `false` | When `true`, pi-vcc handles all compaction triggers |
+| `debug` | `false` | Write debug snapshot to `/tmp/pi-vcc-debug.json` |
+| `extraction.*.enabled` | `true` | Enable/disable individual extraction categories |
+| `extraction.*.extra*` | `[]` | Additive patterns (built-ins never removed) |
+
+## License
+
+MIT © [buihongduc132](https://github.com/buihongduc132)
+
+Repository: [buihongduc132/pi-vcc](https://github.com/buihongduc132/pi-vcc)

package/flow/plans/20260515-1300/plan.md

@@ -0,0 +1,206 @@
+# Plan: Enhance pi-vcc Extractors + Configurable Rules
+
+## User Context (verbatim)
+
+> "Do it be able to capture: url like ? ALSO what are others important mark / anchor that it should capture but currently it is not? Also what are NLP keywords that it can capture for better information as well?"
+> "make it to be able to configured as a config file as well (JUST adding, not removing the rules)"
+> "TDD approach; must have verifier loop; LOTS of test cases"
+
+## Problem
+
+pi-vcc compaction loses critical information:
+1. **URLs** — explicitly filtered OUT by `NON_GOAL_RE` in `goals.ts`
+2. **GitHub refs** — `#42`, `PR #7`, `@user`, `owner/repo` not captured
+3. **Version/context anchors** — semver, branch names, commit refs, error codes
+4. **NLP signals** — constraints, decisions, status changes not extracted
+5. **No configurability** — all regexes are hardcoded, users can't tune them
+
+## Declarative Target State
+
+### 1. New Section: `[References]` in output
+
+```
+[References]
+- URL: https://docs.example.com/api/v2
+- URL: http://100.114.135.99:4747
+- GitHub: #42, PR #7, buihongduc132/pi-plugins
+- Version: v2.3.1, @1.0.0
+- Branch: feat/new-auth
+- CommitRef: abc1234
+```
+
+### 2. New Section: `[Key Signals]` in output
+
+```
+[Key Signals]
+- Constraint: must not push to main directly
+- Decision: use Redis for caching instead of in-process LRU
+- Status: DONE — auth module migrated
+- Blocker: CI fails on Node 18
+```
+
+### 3. Configurable extraction rules via `pi-vcc-config.json`
+
+```jsonc
+{
+  // Existing settings preserved
+  "overrideDefaultCompaction": false,
+  "debug": false,
+  
+  // NEW: extraction config (additive only — defaults match current behavior)
+  "extraction": {
+    "references": {
+      "enabled": true,
+      "urlPatterns": ["https?://\\S+"],           // additive to built-in
+      "githubRefPatterns": ["#\\d+", "PR\\s*#\\d+"], // additive
+      "versionPatterns": ["v?\\d+\\.\\d+\\.\\d+"],
+      "branchPatterns": ["\\b(?:feat|fix|main|develop)/[\\w-]+"]
+    },
+    "keySignals": {
+      "enabled": true,
+      "constraintPatterns": ["\\b(must not|don'?t|cannot|forbidden|never)\\b"],
+      "decisionPatterns": ["\\b(decided|let'?s use|going with|chose)\\b"],
+      "statusPatterns": ["\\b(DONE|TODO|WIP|blocked|resolved)\\b"]
+    },
+    "goals": {
+      // Can ADD patterns to existing extractors, never remove
+      "extraTaskVerbs": [],
+      "extraScopeChangeWords": []
+    }
+  }
+}
+```
+
+### 4. No breaking changes
+
+- All existing extractors unchanged
+- Existing tests must continue to pass
+- New sections appear AFTER existing sections in output
+- Config defaults = current behavior + new extractors enabled
+
+## Implementation Tasks (TDD)
+
+### Phase 1: New Extractor — References
+
+| # | Task | Files | Test First |
+|---|------|-------|------------|
+| 1.1 | Create `src/extract/references.ts` — extract URLs, GitHub refs, versions, branches, commit refs | `extract/references.ts` | `tests/extract-references.test.ts` |
+| 1.2 | Wire into `buildSections` — add `references` field to `SectionData` | `sections.ts`, `build-sections.ts` | `tests/build-sections.test.ts` |
+| 1.3 | Wire into `formatSummary` — render `[References]` section | `format.ts` | `tests/format.test.ts` |
+| 1.4 | Wire into `mergePrevious` — merge references across compactions | `summarize.ts` | `tests/compile.test.ts` |
+
+### Phase 2: New Extractor — Key Signals
+
+| # | Task | Files | Test First |
+|---|------|-------|------------|
+| 2.1 | Create `src/extract/signals.ts` — extract constraints, decisions, status markers | `extract/signals.ts` | `tests/extract-signals.test.ts` |
+| 2.2 | Wire into `buildSections` + `formatSummary` + `mergePrevious` | `sections.ts`, `build-sections.ts`, `format.ts`, `summarize.ts` | extend existing tests |
+
+### Phase 3: Configurable Rules
+
+| # | Task | Files | Test First |
+|---|------|-------|------------|
+| 3.1 | Extend `PiVccSettings` with `extraction` config schema | `settings.ts` | `tests/settings.test.ts` |
+| 3.2 | Pass config to extractors — patterns become configurable (defaults = current) | all extractors | extend all extractor tests |
+| 3.3 | Fix `goals.ts` `NON_GOAL_RE` — URLs no longer filtered from goals (moved to dedicated extractor) | `extract/goals.ts` | `tests/extract-goals.test.ts` |
+
+### Phase 4: Comprehensive Test Coverage
+
+| # | Task |
+|---|------|
+| 4.1 | Edge cases: multi-line URLs, malformed refs, duplicate dedup |
+| 4.2 | Config override: custom patterns replace defaults |
+| 4.3 | Merge across compactions: references persist correctly |
+| 4.4 | Backwards compat: output format identical when new sections empty |
+
+## Test Cases (Detailed)
+
+### extract-references.test.ts
+
+```
+URLs:
+- http://example.com
+- https://docs.site.com/api/v2#section
+- http://100.114.135.99:4747
+- file:///path/to/file
+- URL inside markdown [text](url)
+- Multiple URLs in one message
+- URL at line boundary
+- Dedup same URL across blocks
+- Skip URLs that are only tool_result noise (large JSON dumps)
+
+GitHub refs:
+- #42, #1234
+- PR #7, pr#12
+- Issue #5
+- @username mentions
+- owner/repo paths (e.g., buihongduc132/pi-plugins)
+- Full GitHub URLs (https://github.com/owner/repo/issues/42)
+
+Versions:
+- v1.2.3, v0.3.12
+- @1.0.0, @^2.0.0
+- semver ranges: >=1.0.0 <2.0.0
+
+Branches:
+- feat/new-auth, fix/login-bug
+- main, develop, master (only if context suggests branch ref)
+
+Commit refs:
+- abc1234, abc1234567 (7-12 hex chars, standalone)
+- NOT inside git commit output (already handled by commits extractor)
+```
+
+### extract-signals.test.ts
+
+```
+Constraints:
+- "must not push to main directly"
+- "don't use any external deps"
+- "cannot modify the public API"
+- "forbidden to write to /etc"
+- CONSTRAINT_RE from summary: /\b(don'?t|must not|cannot|forbidden|disallowed|off[- ]limits|out of scope|excluded|do not)\b/i
+
+Decisions:
+- "decided to use Redis"
+- "let's go with approach B"
+- "going with the microservice pattern"
+- "chose SQLite for simplicity"
+
+Status markers:
+- "DONE — auth migrated"
+- "WIP: still debugging"
+- "TODO: add tests"
+- "blocked on upstream fix"
+- "resolved: was a typo"
+
+Negatives (should NOT match):
+- Questions ("should we use X?")
+- Hypotheticals ("what if we can't?")
+- Code comments in tool results
+```
+
+### Config tests
+
+```
+- Default config = all extractors enabled with built-in patterns
+- Custom patterns additive (append to defaults)
+- Disable specific extractor via enabled: false
+- Invalid config gracefully ignored (fallback to defaults)
+- Config hot-reload (re-read on each compaction)
+```
+
+## Risk Assessment
+
+| Risk | Level | Mitigation |
+|------|-------|------------|
+| Breaking existing output format | LOW | New sections only; existing untouched |
+| Performance (regex on every block) | LOW | Patterns pre-compiled; only user/assistant blocks scanned |
+| False positives (refs in code dumps) | MEDIUM | Filter tool_result blocks; only scan user + assistant |
+| Config migration | LOW | scaffoldSettings fills missing keys |
+
+## PR Target
+
+`buihongduc132/pi-vcc` (fork) → `sting8k/pi-vcc` (upstream)
+
+Branch: `feat/enhance-extractors-configurable`

package/index.ts

@@ -0,0 +1,14 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { scaffoldSettings } from "./src/core/settings";
+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) => {
+  scaffoldSettings();
+  registerBeforeCompactHook(pi);
+  registerPiVccCommand(pi);
+  registerVccRecallCommand(pi);
+  registerRecallTool(pi);
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "pi-vcc",
+  "version": "0.4.0",
+  "description": "Algorithmic conversation compactor for pi - transcript-preserving structured summaries, no LLM calls",
+  "main": "index.ts",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "pi-coding-agent",
+    "vcc",
+    "version-control",
+    "compaction"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/buihongduc132/pi-vcc.git"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}

package/pi-vcc-config.schema.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/buihongduc132/pi-vcc/pi-vcc-config.schema.json",
+  "title": "pi-vcc Configuration",
+  "description": "Configuration for pi-vcc algorithmic conversation compactor",
+  "type": "object",
+  "properties": {
+    "overrideDefaultCompaction": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, pi-vcc handles ALL compactions (/compact, auto-threshold, /pi-vcc). When false, only /pi-vcc triggers pi-vcc; everything else falls back to pi core's LLM-based compaction."
+    },
+    "debug": {
+      "type": "boolean",
+      "default": false,
+      "description": "Write debug snapshot to /tmp/pi-vcc-debug.json on each compaction."
+    },
+    "extraction": {
+      "$ref": "#/$defs/extraction"
+    }
+  },
+  "$defs": {
+    "extraction": {
+      "type": "object",
+      "description": "Fine-grained extraction configuration. All extra* patterns are ADDITIVE — built-in patterns are never removed.",
+      "properties": {
+        "references": {
+          "$ref": "#/$defs/references"
+        },
+        "keySignals": {
+          "$ref": "#/$defs/keySignals"
+        },
+        "goals": {
+          "$ref": "#/$defs/goals"
+        }
+      },
+      "additionalProperties": false
+    },
+    "references": {
+      "type": "object",
+      "description": "References extractor: URLs, GitHub refs, versions, branches, commit refs. Output appears as [References] section.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "When false, skip this extraction entirely."
+        },
+        "extraUrlPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional URL regex patterns (appended to built-in https?://\\S+). Each pattern is compiled with global flag. Capture group 1 or full match is used."
+        },
+        "extraGithubRefPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional GitHub ref patterns (appended to built-in #\\d+, PR\\s*#\\d+, owner/repo). Full match is used."
+        },
+        "extraVersionPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional version patterns (appended to built-in v?\\d+\\.\\d+\\.\\d+). Capture group 1 or full match is used."
+        },
+        "extraBranchPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional branch patterns (appended to built-in feat|fix|hotfix|release|.../xxx). Full match is used."
+        }
+      },
+      "additionalProperties": false
+    },
+    "keySignals": {
+      "type": "object",
+      "description": "Key Signals extractor: constraints, decisions, status markers. Output appears as [Key Signals] section.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "When false, skip this extraction entirely."
+        },
+        "extraConstraintPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional constraint patterns (appended to built-in don't|must not|cannot|forbidden|disallowed|off-limits|out of scope|excluded|do not). Applied to user messages only."
+        },
+        "extraDecisionPatterns": {
+          "type": "array",
+          "items": { "type": "string", "format": "regex" },
+          "default": [],
+          "description": "Additional decision patterns (appended to built-in decided|let's use|going with|chose|we'll use). Applied to user messages only."
+        },
+        "extraStatusPatterns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Additional status keywords (appended to built-in DONE|TODO|WIP|blocked|resolved). Keywords are matched at sentence start or after punctuation. Applied to user + assistant messages."
+        }
+      },
+      "additionalProperties": false
+    },
+    "goals": {
+      "type": "object",
+      "description": "Goals extractor tweaks. Controls session goal and scope-change detection.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "When false, skip goals extraction entirely (only affects [Session Goal] section)."
+        },
+        "extraTaskVerbs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Additional task verbs (appended to built-in fix|implement|add|create|build|refactor|...). Used to detect new task statements in user messages."
+        },
+        "extraScopeChangeWords": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Additional scope-change keywords (appended to built-in instead|actually|change of plan|...). Used to detect when user pivots to a new goal."
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/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/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));
+}