pi-soly 1.7.0 → 1.8.0

package/commands.ts

@@ -21,9 +21,11 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
 	analyzeRules,
 	buildProgressBar,
+	buildRulesContextStats,
 	CONTEXT_WINDOW_TOKENS,
 	extractFilePathsFromPrompt,
 	formatAnalyticsFull,
+	formatRulesContextStats,
 	formatTok,
 	readIfExists,
 	solyDirFor,
@@ -70,7 +72,7 @@ export function registerCommands(pi: ExtensionAPI, deps: CommandsDeps): void {
 
 	pi.registerCommand("rules", {
 		description:
-			"manage soly rules (list, show, analytics, reload, enable, disable)",
+			"manage soly rules (list, show, stats, analytics, reload, enable, disable)",
 		handler: async (args, ctx) => {
 			const ui: CommandUI = {
 				notify: (t, k) => ctx.ui.notify(t, k ?? "info"),
@@ -129,6 +131,16 @@ export function registerCommands(pi: ExtensionAPI, deps: CommandsDeps): void {
 				return;
 			}
 
+			if (sub === "stats") {
+				// Claude-memory-style breakdown: shows which rules are always-on
+				// (every turn) vs glob-matched (only when prompt has file paths).
+				// Surfaces context bloat and verifies rules will actually fire.
+				const rules = getRules();
+				const stats = buildRulesContextStats(rules, CONTEXT_WINDOW_TOKENS);
+				ui.notify(formatRulesContextStats(stats), "info");
+				return;
+			}
+
 			if (sub === "show") {
 				if (!target) {
 					ui.notify("Usage: /rules show <path>", "error");

package/core.ts

@@ -993,6 +993,127 @@ export function formatAnalyticsFull(analytics: RuleAnalytics): string {
   return lines.join("\n");
 }
 
+// =============================================================================
+// Rules context stats — Claude-memory-style breakdown
+// =============================================================================
+//
+// Shows which rules are "always-on" (loaded every turn) vs "glob-matched"
+// (loaded only when file paths in prompt match). Useful for spotting
+// context bloat and verifying rules will actually fire.
+
+export interface RuleStat {
+  relPath: string;
+  tokens: number;
+  sourceLabel: string;
+  description?: string;
+  always: boolean;
+  globs: string[];
+  loadedLastTurn: boolean;
+}
+
+export interface RulesContextStats {
+  totalLoaded: number;
+  totalTokens: number;
+  contextBudgetPct: number;
+  alwaysOn: RuleStat[];
+  globMatched: RuleStat[];
+  disabled: RuleStat[];
+  lastTurn: {
+    promptFiles: string[];
+    matchedRulePaths: string[];
+  };
+}
+
+export function buildRulesContextStats(
+  rules: RuleFile[],
+  contextWindowTokens: number,
+  lastTurn?: { promptFiles: string[]; matchedRelPaths: string[] },
+): RulesContextStats {
+  const enabled = rules.filter((r) => r.enabled);
+  const disabled = rules.filter((r) => !r.enabled);
+  const lastTurnMatched = new Set(lastTurn?.matchedRelPaths ?? []);
+  const stat = (r: RuleFile, loadedLastTurn: boolean): RuleStat => ({
+    relPath: r.relPath,
+    tokens: estimateTokens(r.body),
+    sourceLabel: r.sourceLabel,
+    description: r.meta.description,
+    always: r.meta.always === true,
+    globs: r.meta.globs ?? [],
+    loadedLastTurn,
+  });
+  const alwaysOn: RuleStat[] = [];
+  const globMatched: RuleStat[] = [];
+  for (const r of enabled) {
+    const isAlways = r.meta.always === true;
+    const isLoadedLastTurn = lastTurnMatched.has(r.relPath) || isAlways;
+    const s = stat(r, isLoadedLastTurn);
+    if (isAlways) alwaysOn.push(s);
+    else globMatched.push(s);
+  }
+  const totalTokens = [...alwaysOn, ...globMatched].reduce((a, b) => a + b.tokens, 0);
+  return {
+    totalLoaded: enabled.length,
+    totalTokens,
+    contextBudgetPct:
+      contextWindowTokens > 0 ? (totalTokens / contextWindowTokens) * 100 : 0,
+    alwaysOn,
+    globMatched,
+    disabled: disabled.map((r) => stat(r, false)),
+    lastTurn: {
+      promptFiles: lastTurn?.promptFiles ?? [],
+      matchedRulePaths: lastTurn?.matchedRelPaths ?? [],
+    },
+  };
+}
+
+export function formatRulesContextStats(stats: RulesContextStats): string {
+  const lines: string[] = [];
+  lines.push(`📊 Rules context stats`);
+  lines.push(``);
+  const ctxWindow = stats.contextBudgetPct > 0
+    ? Math.round(stats.totalTokens / (stats.contextBudgetPct / 100))
+    : 0;
+  lines.push(
+    `Loaded: ${stats.totalLoaded} rule(s) · ${formatTok(stats.totalTokens)} · ${stats.contextBudgetPct.toFixed(1)}% of ${formatTok(ctxWindow)} context`,
+  );
+  lines.push(``);
+  if (stats.alwaysOn.length > 0) {
+    lines.push(`ALWAYS-ON (loaded every turn):`);
+    for (const r of stats.alwaysOn) {
+      const last = r.loadedLastTurn ? " ✓" : "";
+      const desc = r.description ? ` — "${r.description}"` : "";
+      lines.push(`  ● ${r.relPath}  ${formatTok(r.tokens)}${desc}${last}`);
+    }
+    lines.push(``);
+  }
+  if (stats.globMatched.length > 0) {
+    lines.push(`GLOB-MATCHED (loaded when prompt file matches):`);
+    for (const r of stats.globMatched) {
+      const last = r.loadedLastTurn ? " ✓" : "";
+      const desc = r.description ? ` — "${r.description}"` : "";
+      const globs = r.globs.length > 0 ? `  [globs: ${r.globs.join(", ")}]` : "";
+      lines.push(`  ◐ ${r.relPath}  ${formatTok(r.tokens)}${desc}${globs}${last}`);
+    }
+    lines.push(``);
+  }
+  if (stats.disabled.length > 0) {
+    lines.push(`DISABLED:`);
+    for (const r of stats.disabled) {
+      lines.push(`  ○ ${r.relPath}  ${formatTok(r.tokens)} — disabled`);
+    }
+    lines.push(``);
+  }
+  if (stats.lastTurn.promptFiles.length > 0) {
+    lines.push(`Last turn: ${stats.lastTurn.promptFiles.length} file path(s) in prompt`);
+    for (const f of stats.lastTurn.promptFiles) {
+      lines.push(`  → ${f}`);
+    }
+  } else {
+    lines.push(`Last turn: no file paths in prompt (only always-on rules loaded)`);
+  }
+  return lines.join("\n");
+}
+
 // ============================================================================
 // @import resolver (markdown only)
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-soly",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Project management framework for pi-coding-agent. Workflows, planning, multi-question picker, agent switcher, live task list — one npm install, zero config.",
   "type": "module",
   "main": "index.ts",