@monotykamary/pi-vcc 0.6.1 → 0.6.3

package/README.md

@@ -199,6 +199,7 @@ pi-vcc is one of four compaction approaches in the AI coding-agent ecosystem. He
 - **Scoped recall** — default search is active lineage; use `scope:"all"` for all lineages, or `scope:"compaction:N"` / `scope:"compaction:latest"` to search within a specific compaction segment's original messages
 - **Priority error tags** — outstanding context items tagged `[ERROR]`, `[WARN]`, `[INFO]`, `[RESOLVED]` for urgency at a glance
 - **Metadata footer** — each compaction summary ends with timestamp, compression ratio, and message range
+- **Compaction counter** — the post-compaction notification reports the ordinal of the just-completed compaction (e.g. `"3rd compaction"`), counted from pi-vcc compaction entries in the session file so it lines up with `scope:"compaction:N"`
 - **Cache-friendly ordering** — stable sections (goal, preferences, files, commits, anchors) come first; volatile sections (outstanding context, earlier turns, current status) come last, maximizing prompt-cacheable prefix across compactions
 - **Adaptive recall view** — search results grouped by conversation segments (turns) with match indicators (`>`) and context preservation, so the agent sees the conversational structure around each match
 - **Regex search** — `vcc_recall` supports regex patterns (`hook|inject`, `fail.*build`) and OR-ranked multi-word queries

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@monotykamary/pi-vcc",
-  "version": "0.6.0",
+  "version": "0.6.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@monotykamary/pi-vcc",
-      "version": "0.6.0",
+      "version": "0.6.3",
       "devDependencies": {
         "knip": "6.14.1",
         "typescript": "6.0.3"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monotykamary/pi-vcc",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Algorithmic conversation compactor for pi - transcript-preserving structured summaries, no LLM calls",
   "main": "index.ts",
   "keywords": [
@@ -15,22 +15,23 @@
     "url": "git+https://github.com/monotykamary/pi-vcc.git"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "^0.79.8",
     "@earendil-works/pi-agent-core": "^0.79.8",
+    "@earendil-works/pi-ai": "^0.79.8",
     "@earendil-works/pi-coding-agent": "^0.79.8",
     "typebox": ">=1.1.24 <2.0.0"
   },
   "devDependencies": {
-    "typescript": "6.0.3",
-    "knip": "6.14.1"
-  },
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "lint:dead": "knip"
+    "@types/node": "^26.0.0",
+    "knip": "6.14.1",
+    "typescript": "6.0.3"
   },
   "pi": {
     "extensions": [
       "./index.ts"
     ]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint:dead": "knip"
   }
-}
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+allowBuilds:
+  '@google/genai': false
+  protobufjs: false

package/src/commands/pi-vcc.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { getLastCompactionStats, PI_VCC_COMPACT_INSTRUCTION } from "../hooks/before-compact";
+import { countPiVccCompactionsFromSession, ordinalSuffix } from "../core/compaction-count";
 
 const formatTokens = (n: number): string => {
   if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;
@@ -14,13 +15,17 @@ export const registerPiVccCommand = (pi: ExtensionAPI) => {
         customInstructions: PI_VCC_COMPACT_INSTRUCTION,
         onComplete: () => {
           const stats = getLastCompactionStats();
+          const count = countPiVccCompactionsFromSession(ctx.sessionManager);
+          const compactionLabel = count > 0
+            ? ` (${count}${ordinalSuffix(count)} compaction)`
+            : "";
           if (stats) {
             ctx.ui.notify(
-              `pi-vcc: ${stats.summarized} source entries processed; tail kept ${stats.kept} (~${formatTokens(stats.keptTokensEst)} tok).`,
+              `pi-vcc: ${stats.summarized} source entries processed; tail kept ${stats.kept} (~${formatTokens(stats.keptTokensEst)} tok).${compactionLabel}`,
               "info",
             );
           } else {
-            ctx.ui.notify("Compacted with pi-vcc", "info");
+            ctx.ui.notify(`Compacted with pi-vcc${compactionLabel}`, "info");
           }
         },
         onError: (err) => {

package/src/core/compaction-count.ts

@@ -0,0 +1,47 @@
+/**
+ * Count pi-vcc compactions in the session.
+ *
+ * Compaction entries are persisted to the session file as
+ * `{ type: "compaction", details: { compactor: "pi-vcc", ... } }`.
+ * `session_compact` fires after the new compaction entry has been appended,
+ * so counting entries at that point includes the just-completed compaction —
+ * meaning the count doubles as the 1-based ordinal of the latest one.
+ *
+ * `getEntries()` returns the full append-only session (all lineages), which
+ * matches the `compaction:N` indexing scheme used by vcc_recall — so the
+ * ordinal shown in the notification lines up with `scope:"compaction:N"`.
+ */
+
+export const ordinalSuffix = (n: number): string => {
+  const last = n % 10;
+  const lastTwo = n % 100;
+  if (lastTwo >= 11 && lastTwo <= 13) return "th";
+  if (last === 1) return "st";
+  if (last === 2) return "nd";
+  if (last === 3) return "rd";
+  return "th";
+};
+
+interface SessionManagerLike {
+  getEntries?: () => any[];
+}
+
+/** Total pi-vcc compactions in the session (includes the just-completed one). */
+export const countPiVccCompactions = (entries: any[]): number => {
+  let total = 0;
+  for (const e of entries) {
+    if (e?.type === "compaction" && e?.details?.compactor === "pi-vcc") total++;
+  }
+  return total;
+};
+
+export const countPiVccCompactionsFromSession = (
+  sessionManager: SessionManagerLike | undefined,
+): number => {
+  try {
+    const entries = sessionManager?.getEntries?.() ?? [];
+    return countPiVccCompactions(entries);
+  } catch {
+    return 0;
+  }
+};

package/src/hooks/before-compact.ts

@@ -3,6 +3,7 @@ import { writeFileSync } from "fs";
 import { compile, type CompileInput } from "../core/summarize";
 import { loadSettings, type PiVccSettings } from "../core/settings";
 import { triggerInvisibleContinue } from "../core/invisible-continue";
+import { countPiVccCompactionsFromSession, ordinalSuffix } from "../core/compaction-count";
 import type { PiVccCompactionDetails } from "../details";
 
 export const PI_VCC_COMPACT_INSTRUCTION = "__pi_vcc__";
@@ -489,11 +490,15 @@ export const registerBeforeCompactHook = (pi: ExtensionAPI) => {
     // /pi-vcc path uses its own onComplete callback in the command handler.
     if (!lastCompactWasPiVcc) {
       const stats = lastStats;
+      const count = countPiVccCompactionsFromSession(ctx?.sessionManager as any);
+      const compactionLabel = count > 0
+        ? ` (${count}${ordinalSuffix(count)} compaction)`
+        : "";
       if (stats) {
         setTimeout(() => {
           try {
             ctx?.ui?.notify?.(
-              `pi-vcc: ${stats.summarized} source entries processed; tail kept ${stats.kept} (~${formatTokens(stats.keptTokensEst)} tok).`,
+              `pi-vcc: ${stats.summarized} source entries processed; tail kept ${stats.kept} (~${formatTokens(stats.keptTokensEst)} tok).${compactionLabel}`,
               "info",
             );
           } catch {}