omp-vcc 0.1.7 → 0.1.8

package/README.md

@@ -26,6 +26,7 @@ New here → [`docs/setup.md`](docs/setup.md).
 | `/vcc-recall [query] [scope:all] [page:N] [mode:touched]` | Search compacted history |
 | `/pi-vcc-recall` | Legacy alias for `/vcc-recall` |
 | `/vcc-stats [history\|all]` | Last savings + history table (single, no alias) |
+| `/vcc-config` | Effective config with per-key source (`file` / `host overlay` / `default`) plus resolved file path. Args ignored. |
 
 Tools: `vcc_recall`, `vcc_stats` (approval `read`). Extension-only — no `commands/*.md` file slash commands (avoids duplicate `/omp-vcc`).
 
@@ -53,7 +54,7 @@ File `~/.omp/omp-vcc/config.json` — XDG: `$OMP_VCC_CONFIG_PATH` > `$PI_VCC_CON
 | `debug` | `false` | Write `/tmp/omp-vcc-debug.json` per compaction. |
 | `chainShakeHint` | `false` | Eager post-VCC `shake` chain. Host rescue already auto-shakes on dead-end; this forces it. |
 
-Toggle live: `omp config set plugins."@zhulinchng/omp-vcc".debug true` or `/settings` → `@zhulinchng/omp-vcc`. File is source of truth; `ctx.settings` overlays at runtime.
+Toggle live: `omp config set plugins."@zhulinchng/omp-vcc".debug true` or `/settings` → `@zhulinchng/omp-vcc`. File is source of truth; `ctx.settings` overlays at runtime. `/vcc-config` shows the merged result — use it to confirm a toggle took effect.
 
 ## How it works
 
@@ -82,9 +83,9 @@ Additive VCC+shake is automatic. Eager chain: `chainShakeHint:true`. Explicit mo
 
 ```sh
 bunx tsc --noEmit
-bun test                  # 515 tests, 48 files, 1443 expects, 0 fail
+bun test                  # 619 tests, 55 files, 1876 expects, 0 fail
 bun test tests/e2e --timeout 120000  # 111 E2E
-bun run smoke             # 9 checks: 3 hooks + 4 cmds + 2 tools + pipeline
+bun run smoke             # 13 checks: 3 hooks + 6 cmds + 2 tools + dedup (+ pipeline)
 omp plugin link . && omp plugin doctor
 ```
 
@@ -97,6 +98,7 @@ bunx tsc --noEmit && bun test && bun run smoke
 omp -e @zhulinchng/omp-vcc
 /omp-vcc keep:1   # expect [Session Goal] + toast omp-vcc: kept 1/2 turns
 /vcc-stats        # table + history
+/vcc-config      # effective config card with per-key source
 cat /tmp/omp-vcc-debug.json  # when debug:true
 ```
 

package/extensions/main.ts

@@ -19,6 +19,7 @@ import {
   scheduleCompactionStatsNotify,
   registerVccStatsTool as registerVccStatsToolHook,
   registerVccStatsCommand as registerVccStatsCommandHook,
+  registerVccConfigCommand as registerVccConfigCommandHook,
 } from "./vcc-core/hook";
 import { searchEntriesDetailed, getTouchedFiles } from "./vcc-core/core/search-entries";
 import { formatRecallOutput, formatTouchedOutput } from "./vcc-core/core/format-recall";
@@ -342,9 +343,10 @@ export default function (pi: ExtensionAPI): void {
   });
   // ── /vcc-stats commands — show savings table (PR3) ──
   registerVccStatsCommandHook(pi);
+  registerVccConfigCommandHook(pi);
 
 }
 // ── Re-exports for pi-vcc test compatibility (not dead: tests import via hook directly,
 // but external consumers and the `vcc-recall` shim may import via main) ──
-export { registerBeforeCompactHook, PI_VCC_COMPACT_INSTRUCTION, OMP_VCC_COMPACT_INSTRUCTION, getLastCompactionStats, getCompactionHistory, formatCompactionStats, formatStatsTable, formatLastStatsDetail, scheduleCompactionStatsNotify, AUTO_CONTINUE_CUSTOM_TYPE, LEGACY_AUTO_CONTINUE_CUSTOM_TYPE, invalidExpandIndices, registerRecallTool, registerVccRecallCommand, registerPiVccCommand, registerVccStatsTool, registerVccStatsCommand, clearCompactionHistoryForTests } from "./vcc-core/hook";
+export { registerBeforeCompactHook, PI_VCC_COMPACT_INSTRUCTION, OMP_VCC_COMPACT_INSTRUCTION, getLastCompactionStats, getCompactionHistory, formatCompactionStats, formatStatsTable, formatLastStatsDetail, scheduleCompactionStatsNotify, AUTO_CONTINUE_CUSTOM_TYPE, LEGACY_AUTO_CONTINUE_CUSTOM_TYPE, invalidExpandIndices, registerRecallTool, registerVccRecallCommand, registerPiVccCommand, registerVccStatsTool, registerVccStatsCommand, registerVccConfigCommand, clearCompactionHistoryForTests } from "./vcc-core/hook";
 export { buildPiVccCustomInstructions, parseKeepAndPrompt } from "./vcc-core/core/compact-args";

package/extensions/vcc-core/core/settings.ts

@@ -166,3 +166,80 @@ export function scaffoldSettings(): void {
     // best-effort; never crash extension load
   }
 }
+/** Live-resolved config path. Unlike the `SETTINGS_PATH` const (frozen at import
+ * time), this reflects the current `OMP_VCC_CONFIG_PATH` / `PI_VCC_CONFIG_PATH` env. */
+export function getSettingsPath(): string {
+  return settingsPath();
+}
+
+export type VccSettingSource = "file" | "overlay" | "default";
+
+export interface VccConfigView {
+  /** Live primary path — where a config file WOULD live. */
+  path: string;
+  /** Actual file parsed (primary, XDG/legacy fallback, or null when none). */
+  readPath: string | null;
+  /** True when a candidate file exists (even if unparseable). */
+  filePresent: boolean;
+  /** True when a candidate file parsed as a JSON object. */
+  fileValid: boolean;
+  /** Effective values — same merge as `loadSettings` (defaults ← file ← ctx overlay). */
+  values: PiVccSettings;
+  /** Per-key provenance. Presence check is `key in parsed`, so a file key that
+   * happens to equal the default still counts as `file`. */
+  sources: Record<keyof PiVccSettings, VccSettingSource>;
+}
+
+/**
+ * `loadSettings` plus provenance for `/vcc-config`. Read-only: never creates or
+ * repairs files (`scaffoldSettings` owns that). Merge order mirrors `loadSettings`
+ * exactly — defaults, then the first readable candidate (primary, else the same
+ * `fallbackReadPath()` order), then the identical ctx overlay chain.
+ */
+export function loadSettingsWithSources(ctx?: unknown): VccConfigView {
+  const path = settingsPath();
+  const primaryParsed = readJson(path);
+  let parsed: Record<string, unknown> | null = primaryParsed;
+  let readPath: string | null = primaryParsed ? path : null;
+  if (!parsed) {
+    const fb = fallbackReadPath();
+    if (fb && fb !== path) {
+      const fbParsed = readJson(fb);
+      if (fbParsed) {
+        parsed = fbParsed;
+        readPath = fb;
+      }
+    }
+  }
+  const candidateExists = fallbackReadPath() !== null;
+  const valid = !!parsed && typeof parsed === "object";
+  const values: PiVccSettings =
+    valid && parsed
+      ? { ...DEFAULT_SETTINGS, ...(parsed as Partial<PiVccSettings>) }
+      : { ...DEFAULT_SETTINGS };
+  const sources = {} as Record<keyof PiVccSettings, VccSettingSource>;
+  for (const k of Object.keys(DEFAULT_SETTINGS) as (keyof PiVccSettings)[]) {
+    sources[k] = valid && parsed && k in parsed ? "file" : "default";
+  }
+  if (ctx) {
+    const tryGet = (key: string): unknown => {
+      try {
+        const c = ctx as any;
+        if (!c) return undefined;
+        if (c.settings?.get) return c.settings.get(key);
+        if (c.config?.get) return c.config.get(key);
+        if (c.settings && typeof c.settings === "object" && key in c.settings) return c.settings[key];
+        if (c.config && typeof c.config === "object" && key in c.config) return c.config[key];
+      } catch {}
+      return undefined;
+    };
+    for (const k of Object.keys(DEFAULT_SETTINGS) as (keyof PiVccSettings)[]) {
+      const v = tryGet(`plugins.@zhulinchng/omp-vcc.${k}`) ?? tryGet(`plugins.omp-vcc.${k}`) ?? tryGet(`omp-vcc.${k}`) ?? tryGet(k);
+      if (v !== undefined) {
+        (values as any)[k] = v;
+        sources[k] = "overlay";
+      }
+    }
+  }
+  return { path, readPath, filePresent: candidateExists, fileValid: valid, values, sources };
+}

package/extensions/vcc-core/hook.ts

@@ -4,7 +4,7 @@ import { createRequire } from "node:module";
 import { writeFileSync } from "fs";
 import { compileRanked } from "./core/summarize";
 import { buildPiVccCustomInstructions, parseKeepAndPrompt, PI_VCC_COMPACT_INSTRUCTION } from "./core/compact-args";
-import { loadSettings, type PiVccSettings } from "./core/settings";
+import { loadSettings, loadSettingsWithSources, DEFAULT_SETTINGS, type PiVccSettings, type VccConfigView } from "./core/settings";
 import { calibrateCharsPerToken, estimateMessageContentChars, estimateMessageContentTokens, estimateTokensFromChars, collectUsageStats } from "./core/token-estimate";
 import type { PiVccCompactionDetails } from "./details";
 import type { CompactionReason } from "./types";
@@ -1332,4 +1332,31 @@ export const registerVccStatsCommand = (pi: any) => {
     try { ctx?.ui?.notify?.(`vcc_stats: ${history.length} compaction(s)`, "info"); } catch {}
   };
   pi.registerCommand("vcc-stats", { description: "Show omp-vcc compaction savings (last + history)", handler });
+};
+// ── /vcc-config command — show effective configuration with per-key source ──
+export const formatVccConfigCard = (view: VccConfigView): string => {
+  const header = `**omp-vcc config** (\`${view.path}\`)`;
+  const status = !view.filePresent
+    ? "No config file found — showing defaults."
+    : !view.fileValid
+      ? "Config file unparseable — showing defaults."
+      : view.readPath === view.path
+        ? `Source: file ${view.readPath}`
+        : `Source: fallback file ${view.readPath}`;
+  const lines = (Object.keys(DEFAULT_SETTINGS) as (keyof PiVccSettings)[]).map(
+    (k) => `- ${k}: ${view.values[k] ? "on" : "off"} (${view.sources[k] === "overlay" ? "host overlay" : view.sources[k]})`,
+  );
+  return [header, status, ...lines].join("\n");
+};
+
+export const registerVccConfigCommand = (pi: any) => {
+  const handler = async (_args: string, ctx: any) => {
+    // args deliberately ignored — always show the effective config
+    const view = loadSettingsWithSources(ctx);
+    const output = formatVccConfigCard(view);
+    const piAny = pi as unknown as { sendMessage?: (msg: unknown, opts?: unknown) => void };
+    try { piAny.sendMessage?.({ customType: "vcc-config", content: output, display: true }, { triggerTurn: false }); } catch {}
+    try { ctx?.ui?.notify?.(`vcc_config: ${Object.keys(view.values).length} keys from ${view.readPath ?? "defaults"}`, "info"); } catch {}
+  };
+  pi.registerCommand("vcc-config", { description: "Show omp-vcc effective configuration with per-key source", handler });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omp-vcc",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "description": "Algorithmic VCC compaction for omp - fast lossless no-LLM",
   "author": "Zhu Lin <zhulin@czl.my>",

package/scripts/smoke.ts

@@ -75,6 +75,10 @@ try {
     "vcc-stats command registered",
     commands.some((c) => c.name === "vcc-stats"),
   );
+  check(
+    "vcc-config command registered",
+    commands.some((c) => c.name === "vcc-config"),
+  );
   check(
     "no omp-vcc-stats duplicate",
     !commands.some((c) => c.name === "omp-vcc-stats"),

package/skills/omp-vcc/SKILL.md

@@ -49,6 +49,7 @@ Use `vcc_recall` to search for prior work … Do not redo work already completed
 | Task | How | Notes |
 |---|---|---|
 | **Check savings** | `/vcc-stats` · `vcc_stats({history:true})` | Last + history table (50-capped, no `omp-vcc-stats` alias). `/omp-vcc` toast is single line only; detailed savings via `/vcc-stats`. Use to confirm headroom before long edits. |
+| **View config** | `/vcc-config` | Effective config with per-key source (`file` / `host overlay` / `default`) plus resolved file path. Args ignored. Use to confirm a `/settings` toggle took effect. |
 | **Recall search** | `/vcc-recall <query> [scope:all] [page:2]` · alias `/pi-vcc-recall` · tool `vcc_recall({query, scope, mode, page, expand})` | 5 hits/page, up to 50 total. See cookbook below. |
 | **Stats tool** | `vcc_stats({history?: boolean})` | Same as `/vcc-stats`. `history:true` = full 50-row table. |