@shahmilsaari/memory-core 1.0.2 → 1.0.4

package/README.md

@@ -356,11 +356,13 @@ Runs in the background and checks each file the moment you save it. You see viol
 Options:
 ```bash
 npx @shahmilsaari/memory-core watch --path src/   # watch a specific folder only
+npx @shahmilsaari/memory-core watch --scan-on-start  # snapshot-scan tracked files once, then keep watching
 npx @shahmilsaari/memory-core watch --verbose     # show extra details
 npx @shahmilsaari/memory-core watch --debug       # show prompt, diff, and raw model output
 ```
 
-Only checks source files — ignores `node_modules`, `dist`, config files, JSON, etc.
+Only checks source files — ignores `node_modules`, `dist`, config files, JSON, etc.  
+`--scan-on-start` is useful after a big refactor because it refreshes current live stats automatically before normal save-based watch mode begins.
 
 ---
 
@@ -369,7 +371,7 @@ Only checks source files — ignores `node_modules`, `dist`, config files, JSON,
 ```bash
 npx @shahmilsaari/memory-core dashboard
 npx @shahmilsaari/memory-core dashboard --port 5178
-npx @shahmilsaari/memory-core dashboard --path src/
+npx @shahmilsaari/memory-core dashboard --path /absolute/path/to/project
 npx @shahmilsaari/memory-core dashboard --no-watch
 ```
 
@@ -384,6 +386,7 @@ Starts a local Svelte dashboard at `http://localhost:5178` by default. The dashb
 - live reload for `.env`, `.memory-core.env`, `.memory-core.json`, and `.memory-core-stats.json`
 
 The WebSocket endpoint is local: `ws://localhost:5178/ws`. Runtime config changes are reloaded and pushed to the browser without restarting the dashboard after the dashboard process is running.
+When `--path` is provided, it must point to the project root (the directory containing `.memory-core.json`).
 
 ---
 
@@ -394,9 +397,13 @@ npx @shahmilsaari/memory-core check --staged           # check staged files
 npx @shahmilsaari/memory-core check --staged --verbose # with extra detail
 npx @shahmilsaari/memory-core check --staged --debug   # show prompt, diff, and raw model output
 npx @shahmilsaari/memory-core check --ci               # CI mode using memories.json
+npx @shahmilsaari/memory-core check --all              # scan all tracked source files (not just staged changes)
+npx @shahmilsaari/memory-core check --all --path src/  # scan only tracked files under src/
 ```
 
-`--staged` is the same path used by the pre-commit hook. `--ci` reads `memories.json` and uses a deterministic CI-friendly diff check, so pull requests can enforce rules without a local database or Ollama setup.
+`--staged` is the same path used by the pre-commit hook. `--ci` reads `memories.json` and uses a deterministic CI-friendly diff check, so pull requests can enforce rules without a local database or Ollama setup.  
+`--all` runs a full tracked-file snapshot check and exits non-zero if violations are found.
+`--all` and `--ci` are mutually exclusive in the same command.
 
 ---
 
@@ -585,9 +592,13 @@ Generates `.github/workflows/memory-core.yml`. Adds a PR check that runs `npx @s
 
 ```bash
 npx @shahmilsaari/memory-core stats
+npx @shahmilsaari/memory-core stats --reset
 ```
 
-Shows which rules fire most often and which files have the most violations. Useful for spotting systemic issues in the codebase.
+Shows which rules fire most often and which files have the most violations.
+- If live watch state exists, `stats` shows current live counters.
+- Otherwise it shows historical counters recorded over time.
+- Use `--reset` to clear counters and recent violation history.
 
 ---
 

package/dist/{chunk-PDQXIKL7.js → chunk-WJG77BPO.js}

@@ -966,8 +966,8 @@ var seeds = [
 // src/watcher.ts
 import { watch } from "chokidar";
 import { spawnSync } from "child_process";
-import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
-import { join as join7, relative as relative2 } from "path";
+import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7, relative as relative2, resolve as resolve4, sep } from "path";
 import chalk from "chalk";
 
 // src/generator.ts
@@ -1195,6 +1195,14 @@ var ResilientGraphRepository = class {
 var ChokidarWatchService = class {
   async start(options = {}) {
     await startWatch({
+      path: options.path,
+      verbose: options.verbose,
+      debug: options.debug,
+      scanOnStart: options.scanOnStart
+    });
+  }
+  async scan(options = {}) {
+    return scanFiles({
       path: options.path,
       verbose: options.verbose,
       debug: options.debug
@@ -1896,7 +1904,7 @@ var OUTPUT_FILES = [
 var AGENT_NAMES = [...new Set(OUTPUT_FILES.map((f) => f.agent))];
 Handlebars.registerHelper(
   "join",
-  (arr, sep) => Array.isArray(arr) ? arr.join(sep) : ""
+  (arr, sep2) => Array.isArray(arr) ? arr.join(sep2) : ""
 );
 Handlebars.registerHelper(
   "bullet",
@@ -2284,25 +2292,62 @@ var SOURCE_EXTENSIONS3 = /\.(ts|tsx|js|jsx|py|php|rb|go|java|cs|swift|kt|rs|vue|
 var reasonMap = new Map(
   seeds.filter((s) => s.reason).map((s) => [s.content, s.reason])
 );
-function recordViolations(violations) {
-  const statsPath = join7(process.cwd(), ".memory-core-stats.json");
-  let stats = { rules: {}, files: {} };
-  if (existsSync6(statsPath)) {
-    try {
-      stats = JSON.parse(readFileSync5(statsPath, "utf-8"));
-    } catch {
-      stats = { rules: {}, files: {} };
+function readStatsFile(statsPath) {
+  if (!existsSync6(statsPath)) return { rules: {}, files: {} };
+  try {
+    return JSON.parse(readFileSync5(statsPath, "utf-8"));
+  } catch {
+    return { rules: {}, files: {} };
+  }
+}
+function rebuildLiveCounters(byFile) {
+  const rules = {};
+  const files = {};
+  for (const [file, violations] of Object.entries(byFile)) {
+    if (!Array.isArray(violations) || violations.length === 0) continue;
+    files[file] = violations.length;
+    for (const violation of violations) {
+      rules[violation.rule] = (rules[violation.rule] ?? 0) + 1;
     }
   }
+  return { rules, files };
+}
+function resetLiveStats(cwd) {
+  const statsPath = join7(cwd, ".memory-core-stats.json");
+  const stats = readStatsFile(statsPath);
+  stats.rules ??= {};
+  stats.files ??= {};
+  stats.live = {
+    rules: {},
+    files: {},
+    byFile: {}
+  };
+  writeFileSync3(statsPath, JSON.stringify(stats, null, 2) + "\n", "utf-8");
+}
+function recordWatchResult(cwd, file, violations) {
+  const statsPath = join7(cwd, ".memory-core-stats.json");
+  const stats = readStatsFile(statsPath);
   stats.rules ??= {};
   stats.files ??= {};
+  stats.live ??= { rules: {}, files: {}, byFile: {} };
+  stats.live.byFile ??= {};
+  if (violations.length === 0) {
+    delete stats.live.byFile[file];
+  } else {
+    stats.live.byFile[file] = violations;
+  }
+  const live = rebuildLiveCounters(stats.live.byFile);
+  stats.live.rules = live.rules;
+  stats.live.files = live.files;
   for (const violation of violations) {
     stats.rules[violation.rule] = (stats.rules[violation.rule] ?? 0) + 1;
     if (violation.file) stats.files[violation.file] = (stats.files[violation.file] ?? 0) + 1;
   }
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  const recent = violations.map((violation) => ({ ...violation, timestamp, source: "watch" }));
-  stats.recentViolations = [...recent, ...stats.recentViolations ?? []].slice(0, 50);
+  if (violations.length > 0) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const recent = violations.map((violation) => ({ ...violation, timestamp, source: "watch" }));
+    stats.recentViolations = [...recent, ...stats.recentViolations ?? []].slice(0, 50);
+  }
   writeFileSync3(statsPath, JSON.stringify(stats, null, 2) + "\n", "utf-8");
 }
 function loadConfig(cwd) {
@@ -2333,7 +2378,7 @@ function getProfileRules(config2) {
   }
   return { rules, avoids };
 }
-async function loadRelevantRules(config2, rel, diff, fallbackRules) {
+async function loadRelevantRules(cwd, config2, rel, diff, fallbackRules) {
   try {
     const query = buildContextQuery([
       rel,
@@ -2344,7 +2389,7 @@ async function loadRelevantRules(config2, rel, diff, fallbackRules) {
     ]);
     const memories = await retrieveContextualMemories({
       query,
-      cwd: process.cwd(),
+      cwd,
       config: config2,
       limit: 15
     });
@@ -2363,10 +2408,11 @@ ${violation.file}`.toLowerCase();
     return !allowPatterns.some((pattern) => haystack.includes(pattern.toLowerCase()));
   });
 }
-async function verifyViolations(diff, violations, allowPatterns, debug) {
+async function verifyViolations(inputText, violations, allowPatterns, debug, mode = "diff") {
   if (violations.length === 0) return violations;
+  const sourceLabel = mode === "snapshot" ? "file content" : "diff";
   const systemPrompt = `You are verifying candidate architecture violations.
-Only keep violations that are directly supported by the diff.
+Only keep violations that are directly supported by the ${sourceLabel}.
 Reject speculative or weak matches.
 Treat these allowlisted patterns as intentional and valid:
 ${allowPatterns.length ? allowPatterns.map((pattern, index) => `${index + 1}. ${pattern}`).join("\n") : "(none)"}
@@ -2374,8 +2420,8 @@ ${allowPatterns.length ? allowPatterns.map((pattern, index) => `${index + 1}. ${
 Return strict JSON:
 {"violations":[{"rule":"...","file":"...","line":1,"issue":"...","suggestion":"...","reason":"..."}]}
 Do not include any text outside the JSON.`;
-  const userPrompt = `Diff:
-${diff.slice(0, 6e3)}
+  const userPrompt = `${mode === "snapshot" ? "File content" : "Diff"}:
+${inputText.slice(0, 6e3)}
 
 Candidate violations:
 ${JSON.stringify(violations, null, 2)}`;
@@ -2407,26 +2453,128 @@ async function loadIgnorePatterns() {
     return [];
   }
 }
-async function checkFile(filePath, cwd, config2, verbose, debug) {
-  const rel = relative2(cwd, filePath);
-  let diff;
-  const headResult = spawnSync("git", ["diff", "HEAD", "--", rel], { encoding: "utf-8", cwd });
-  if (headResult.stdout?.trim()) {
-    diff = headResult.stdout;
+function normalizeForGit(pathLike) {
+  return pathLike.split(sep).join("/");
+}
+function listSourceFilesFromFilesystem(dir) {
+  if (!existsSync6(dir)) return [];
+  const files = [];
+  const stack = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    let entries = [];
+    try {
+      entries = readdirSync3(current);
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const absolute = join7(current, entry);
+      let isDirectory = false;
+      let isFile = false;
+      try {
+        const stats = statSync2(absolute);
+        isDirectory = stats.isDirectory();
+        isFile = stats.isFile();
+      } catch {
+        continue;
+      }
+      if (isDirectory) {
+        if (entry === "node_modules" || entry === ".git" || entry === "dist" || entry === "build" || entry === "coverage") {
+          continue;
+        }
+        stack.push(absolute);
+        continue;
+      }
+      if (isFile && SOURCE_EXTENSIONS3.test(absolute)) files.push(absolute);
+    }
+  }
+  return files;
+}
+function listTrackedSourceFiles(projectRoot, watchPath) {
+  const relPrefix = normalizeForGit(relative2(projectRoot, watchPath));
+  const inRoot = relPrefix === "" || relPrefix === ".";
+  const prefixWithSlash = inRoot ? "" : `${relPrefix}/`;
+  const listed = spawnSync("git", ["ls-files"], { encoding: "utf-8", cwd: projectRoot });
+  if (listed.status !== 0) {
+    return listSourceFilesFromFilesystem(watchPath).sort();
+  }
+  const files = (listed.stdout ?? "").split("\n").filter((file) => file.length > 0).filter((file) => SOURCE_EXTENSIONS3.test(file)).filter((file) => inRoot || file.startsWith(prefixWithSlash)).map((file) => join7(projectRoot, file)).filter((file) => existsSync6(file));
+  return [...new Set(files)].sort();
+}
+async function runSnapshotScan(projectRoot, watchPath, config2, verbose, debug, onEvent) {
+  const files = listTrackedSourceFiles(projectRoot, watchPath);
+  if (files.length === 0) {
+    console.log(chalk.yellow("\n  No tracked source files found for scan.\n"));
+    return {
+      filesChecked: 0,
+      filesWithViolations: 0,
+      violations: 0
+    };
+  }
+  console.log(chalk.dim(`
+  scanning ${files.length} tracked source files...
+`));
+  const summary = {
+    filesChecked: 0,
+    filesWithViolations: 0,
+    violations: 0
+  };
+  for (const filePath of files) {
+    const rel = normalizeForGit(relative2(projectRoot, filePath));
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    onEvent?.({ type: "saved", timestamp, file: rel });
+    const result = await checkFile(filePath, projectRoot, config2, verbose, debug, "snapshot");
+    if (result.type !== "checked") {
+      if (result.type === "skipped") {
+        onEvent?.({ type: "skipped", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel, reason: result.reason });
+      } else {
+        onEvent?.({ type: "error", timestamp: (/* @__PURE__ */ new Date()).toISOString(), message: result.message });
+      }
+      continue;
+    }
+    summary.filesChecked += 1;
+    if (result.violations.length === 0) {
+      onEvent?.({ type: "clean", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel });
+      continue;
+    }
+    summary.filesWithViolations += 1;
+    summary.violations += result.violations.length;
+    onEvent?.({ type: "violations", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel, violations: result.violations });
+  }
+  return summary;
+}
+async function checkFile(filePath, projectRoot, config2, verbose, debug, mode = "diff") {
+  const rel = relative2(projectRoot, filePath).split(sep).join("/");
+  if (rel.startsWith("..")) return { type: "skipped", reason: "File is outside project root" };
+  let inputText;
+  if (mode === "snapshot") {
+    if (!existsSync6(filePath)) return { type: "skipped", reason: "File no longer exists" };
+    inputText = readFileSync5(filePath, "utf-8");
+    if (!inputText.trim()) return { type: "skipped", reason: "File is empty" };
   } else {
-    const noIndexResult = spawnSync("git", ["diff", "--no-index", "/dev/null", rel], { encoding: "utf-8", cwd });
-    diff = noIndexResult.stdout ?? "";
+    const headResult = spawnSync("git", ["diff", "HEAD", "--", rel], { encoding: "utf-8", cwd: projectRoot });
+    if (headResult.stdout?.trim()) {
+      inputText = headResult.stdout;
+    } else {
+      const noIndexResult = spawnSync("git", ["diff", "--no-index", "/dev/null", rel], {
+        encoding: "utf-8",
+        cwd: projectRoot
+      });
+      inputText = noIndexResult.stdout ?? "";
+    }
+    if (!inputText.trim()) return { type: "skipped", reason: "No changes compared with HEAD" };
   }
-  if (!diff.trim()) return { type: "skipped", reason: "No changes compared with HEAD" };
   const { rules: fallbackRules, avoids } = getProfileRules(config2);
-  const rules = await loadRelevantRules(config2, rel, diff, fallbackRules);
+  const rules = await loadRelevantRules(projectRoot, config2, rel, inputText, fallbackRules);
   if (rules.length === 0) return { type: "skipped", reason: "No applicable architecture rules" };
-  const MAX_DIFF = 6e3;
-  const truncated = diff.length > MAX_DIFF;
-  const diffToSend = truncated ? diff.slice(0, MAX_DIFF) + "\n\n[diff truncated]" : diff;
+  const MAX_INPUT = 6e3;
+  const truncated = inputText.length > MAX_INPUT;
+  const inputToSend = truncated ? inputText.slice(0, MAX_INPUT) + "\n\n[input truncated]" : inputText;
   if (verbose || debug) {
+    const label = mode === "snapshot" ? "snapshot" : `${inputText.length} chars`;
     console.log(chalk.dim(`
-  [watch] checking ${rel} (${diff.length} chars)\u2026`));
+  [watch] checking ${rel} (${label})\u2026`));
   }
   const rulesWithReasons = rules.map((r, i) => {
     const why = reasonMap.get(r);
@@ -2435,7 +2583,7 @@ async function checkFile(filePath, cwd, config2, verbose, debug) {
   }).join("\n");
   const allowPatterns = [.../* @__PURE__ */ new Set([...getAllowPatterns(config2), ...await loadIgnorePatterns()])];
   const astViolations = findAstDeterministicViolationsForFile(rel, {
-    cwd,
+    cwd: projectRoot,
     config: config2,
     rules,
     reasonLookup: reasonMap
@@ -2443,8 +2591,9 @@ async function checkFile(filePath, cwd, config2, verbose, debug) {
     ...violation,
     severity: "error"
   }));
+  const analysisTarget = mode === "snapshot" ? "file content" : "file diff";
   const systemPrompt = `You are a strict code reviewer enforcing architecture rules.
-Analyze the file diff and identify ONLY clear, definite rule violations.
+Analyze the ${analysisTarget} and identify ONLY clear, definite rule violations.
 Use the WHY for each rule to understand intent and judge edge cases.
 
 Rules to enforce:
@@ -2464,16 +2613,19 @@ No text outside the JSON.`;
     console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     console.log(systemPrompt);
     console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-    console.log(chalk.gray(`  [debug] diff length: ${diff.length} chars`));
-    console.log(chalk.dim(diffToSend));
+    console.log(chalk.gray(`  [debug] input length: ${inputText.length} chars`));
+    console.log(chalk.dim(inputToSend));
     console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   }
   try {
+    const reviewPrompt = mode === "snapshot" ? `Review this file ${rel}:
+
+${inputToSend}` : `Review this diff for ${rel}:
+
+${inputToSend}`;
     const raw = await callChatModel([
       { role: "system", content: systemPrompt },
-      { role: "user", content: `Review this diff for ${rel}:
-
-${diffToSend}` }
+      { role: "user", content: reviewPrompt }
     ]);
     if (debug) {
       console.log(chalk.gray("  [debug] raw response:"));
@@ -2493,7 +2645,7 @@ ${diffToSend}` }
     } catch {
       violations = [];
     }
-    violations = await verifyViolations(diff, violations, allowPatterns, debug);
+    violations = await verifyViolations(inputText, violations, allowPatterns, debug, mode);
     violations = [...astViolations, ...violations];
     violations = applyAllowPatterns(violations, allowPatterns);
     violations = violations.map((violation) => ({
@@ -2501,6 +2653,7 @@ ${diffToSend}` }
       code: violation.code ?? (violation.line ? formatCodeContext(filePath, violation.line, 1) : void 0)
     }));
     if (violations.length === 0) {
+      recordWatchResult(projectRoot, rel, []);
       console.log(chalk.green(`  \u2713 ${rel}`) + chalk.dim(" \u2014 no violations"));
       return { type: "checked", violations: [] };
     }
@@ -2522,7 +2675,7 @@ ${diffToSend}` }
       if (v.suggestion) console.log(chalk.green("      Fix:    ") + v.suggestion);
       console.log();
     });
-    recordViolations(violations);
+    recordWatchResult(projectRoot, rel, violations);
     console.log(chalk.dim('  Fix violations or run: memory-core remember "<lesson>"'));
     console.log();
     return { type: "checked", violations };
@@ -2536,6 +2689,7 @@ ${diffToSend}` }
       code: violation.code ?? (violation.line ? formatCodeContext(filePath, violation.line, 1) : void 0)
     }));
     if (violations.length === 0) {
+      recordWatchResult(projectRoot, rel, []);
       console.log(chalk.green(`  \u2713 ${rel}`) + chalk.dim(" \u2014 no deterministic violations"));
       return { type: "checked", violations: [] };
     }
@@ -2557,15 +2711,56 @@ ${diffToSend}` }
       if (v.suggestion) console.log(chalk.green("      Fix:    ") + v.suggestion);
       console.log();
     });
-    recordViolations(violations);
+    recordWatchResult(projectRoot, rel, violations);
     console.log(chalk.dim('  Fix violations or run: memory-core remember "<lesson>"'));
     console.log();
     return { type: "checked", violations };
   }
 }
+async function scanFiles(options = {}) {
+  const projectRoot = resolve4(process.cwd());
+  const watchPath = resolve4(projectRoot, options.path ?? ".");
+  const config2 = loadConfig(projectRoot);
+  if (!config2) {
+    throw new Error("No .memory-core.json found. Run: memory-core init");
+  }
+  const { rules } = getProfileRules(config2);
+  if (rules.length === 0) {
+    console.log(chalk.yellow("\n  No architecture rules configured in .memory-core.json \u2014 nothing to scan.\n"));
+    return {
+      filesChecked: 0,
+      filesWithViolations: 0,
+      violations: 0
+    };
+  }
+  resetLiveStats(projectRoot);
+  console.log(chalk.cyan("\n  archmind scan \u2014 checking tracked source files\n"));
+  console.log(chalk.dim(`  project: ${projectRoot}`));
+  console.log(chalk.dim(`  path:    ${watchPath}`));
+  console.log(chalk.dim(`  model:   ${getChatProviderLabel()}`));
+  console.log(chalk.dim(`  rules:   ${rules.length}
+`));
+  const summary = await runSnapshotScan(
+    projectRoot,
+    watchPath,
+    config2,
+    options.verbose ?? false,
+    options.debug ?? false,
+    options.onEvent
+  );
+  const cleanFiles = summary.filesChecked - summary.filesWithViolations;
+  console.log(chalk.bold("\n  scan summary\n"));
+  console.log(chalk.dim(`  files checked:         ${summary.filesChecked}`));
+  console.log(chalk.dim(`  files clean:           ${cleanFiles}`));
+  console.log(chalk.dim(`  files with violations: ${summary.filesWithViolations}`));
+  console.log(chalk.dim(`  total violations:      ${summary.violations}
+`));
+  return summary;
+}
 async function startWatch(options = {}) {
-  const cwd = process.cwd();
-  const config2 = loadConfig(cwd);
+  const projectRoot = resolve4(process.cwd());
+  const watchPath = resolve4(projectRoot, options.path ?? ".");
+  const config2 = loadConfig(projectRoot);
   const exitOnSetupFailure = options.exitOnSetupFailure ?? true;
   if (!config2) {
     const message = "No .memory-core.json found. Run: memory-core init";
@@ -2586,8 +2781,9 @@ async function startWatch(options = {}) {
     if (exitOnSetupFailure) process.exit(0);
     return;
   }
-  const watchPath = options.path ?? cwd;
+  resetLiveStats(projectRoot);
   console.log(chalk.cyan("\n  archmind watch \u2014 real-time rule enforcement\n"));
+  console.log(chalk.dim(`  project:  ${projectRoot}`));
   console.log(chalk.dim(`  watching: ${watchPath}`));
   console.log(chalk.dim(`  model:    ${getChatProviderLabel()}`));
   console.log(chalk.dim(`  rules:    ${rules.length}`));
@@ -2599,6 +2795,18 @@ async function startWatch(options = {}) {
     model: getChatProviderLabel(),
     rules: rules.length
   });
+  if (options.scanOnStart) {
+    console.log(chalk.dim("  running initial snapshot scan before watch events..."));
+    await runSnapshotScan(
+      projectRoot,
+      watchPath,
+      config2,
+      options.verbose ?? false,
+      options.debug ?? false,
+      options.onEvent
+    );
+    console.log(chalk.dim("  initial scan complete.\n"));
+  }
   const pending = /* @__PURE__ */ new Map();
   const watcher = watch(watchPath, {
     ignored: [
@@ -2620,13 +2828,26 @@ async function startWatch(options = {}) {
     if (pending.has(filePath)) clearTimeout(pending.get(filePath));
     const timer = setTimeout(async () => {
       pending.delete(filePath);
-      const rel = relative2(cwd, filePath);
+      const rel = normalizeForGit(relative2(projectRoot, filePath));
+      if (rel.startsWith("..")) return;
       const timestamp = /* @__PURE__ */ new Date();
       console.log(chalk.dim(`
   [${timestamp.toLocaleTimeString()}] saved: ${rel}`));
       options.onEvent?.({ type: "saved", timestamp: timestamp.toISOString(), file: rel });
-      const result = await checkFile(filePath, cwd, config2, options.verbose ?? false, options.debug ?? false);
+      const result = await checkFile(
+        filePath,
+        projectRoot,
+        config2,
+        options.verbose ?? false,
+        options.debug ?? false,
+        "diff"
+      );
       if (result.type === "skipped") {
+        if (result.reason === "No changes compared with HEAD") {
+          recordWatchResult(projectRoot, rel, []);
+          options.onEvent?.({ type: "clean", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel });
+          return;
+        }
         options.onEvent?.({ type: "skipped", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel, reason: result.reason });
         return;
       }
@@ -2645,6 +2866,12 @@ async function startWatch(options = {}) {
   };
   watcher.on("add", handle);
   watcher.on("change", handle);
+  watcher.on("unlink", (filePath) => {
+    const rel = normalizeForGit(relative2(projectRoot, filePath));
+    if (rel.startsWith("..")) return;
+    recordWatchResult(projectRoot, rel, []);
+    options.onEvent?.({ type: "clean", timestamp: (/* @__PURE__ */ new Date()).toISOString(), file: rel });
+  });
   watcher.on("error", (err) => {
     const message = err instanceof Error ? err.message : String(err);
     console.error(chalk.red(`  watcher error: ${message}`));

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   retrieveMemorySelection,
   runMigrations,
   seeds
-} from "./chunk-PDQXIKL7.js";
+} from "./chunk-WJG77BPO.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -122,10 +122,18 @@ var reasonMap = new Map(
 );
 var HOOK_PATH = join2(".git", "hooks", "pre-commit");
 var HOOK_MARKER = "# archmind-memory-core";
-function buildHookScript(advisory) {
+function buildHookBody(advisory) {
   const suffix = advisory ? " || true" : "";
-  return `#!/bin/sh
-${HOOK_MARKER}${advisory ? " advisory" : ""}
+  return `${HOOK_MARKER}${advisory ? " advisory" : ""}
+if [ "\${MEMORY_CORE_SKIP_HOOK:-}" = "1" ] || [ "\${ARCHMIND_SKIP_HOOK:-}" = "1" ] || [ "\${HUSKY:-}" = "0" ] || [ "\${HUSKY_SKIP_HOOKS:-}" = "1" ]; then
+  exit 0
+fi
+if [ -n "\${SKIP:-}" ] && echo ",$SKIP," | grep -qiE ',(memory-core|archmind),'; then
+  exit 0
+fi
+if [ -n "\${SKIP_HOOKS:-}" ]; then
+  exit 0
+fi
 if command -v memory-core >/dev/null 2>&1; then
   memory-core check --staged${suffix}
 elif [ -f "./node_modules/.bin/memory-core" ]; then
@@ -137,6 +145,26 @@ else
 fi
 `;
 }
+function buildHookScript(advisory) {
+  return `#!/bin/sh
+
+${buildHookBody(advisory)}`;
+}
+function normalizeHookPreamble(content) {
+  const lines = content.split("\n");
+  const normalized = [];
+  let shebangSeen = false;
+  for (const line of lines) {
+    if (/^\s*#!\/bin\/sh\s*$/.test(line)) {
+      if (shebangSeen) continue;
+      shebangSeen = true;
+      normalized.push("#!/bin/sh");
+      continue;
+    }
+    normalized.push(line);
+  }
+  return normalized.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
 function recordViolations(violations, source = "hook") {
   const statsPath = join2(process.cwd(), ".memory-core-stats.json");
   let stats = { rules: {}, files: {} };
@@ -403,18 +431,26 @@ function installHook(advisory = true) {
     process.exit(1);
   }
   const script = buildHookScript(advisory);
+  const body = buildHookBody(advisory).trimEnd();
   if (existsSync2(HOOK_PATH)) {
     const existing = readFileSync2(HOOK_PATH, "utf-8");
     if (existing.includes(HOOK_MARKER)) {
       const markerIndex = existing.indexOf(HOOK_MARKER);
-      const before = markerIndex > 1 ? existing.slice(0, markerIndex).trimEnd() + "\n\n" : "";
-      writeFileSync2(HOOK_PATH, before + script);
+      const beforeRaw = markerIndex > 0 ? existing.slice(0, markerIndex) : "";
+      const normalizedBefore = normalizeHookPreamble(beforeRaw);
+      const preamble = normalizedBefore.length > 0 ? normalizedBefore : "#!/bin/sh";
+      const preambleWithShebang = preamble.startsWith("#!/bin/sh") ? preamble : `#!/bin/sh
+${preamble}`;
+      writeFileSync2(HOOK_PATH, `${preambleWithShebang}
+
+${body}
+`);
       chmodSync(HOOK_PATH, 493);
       const modeLabel2 = advisory ? chalk.cyan("advisory") : chalk.yellow("strict");
       console.log(chalk.green("\n  \u2713 Pre-commit hook updated") + chalk.dim(` (${modeLabel2} mode)`));
       return;
     }
-    writeFileSync2(HOOK_PATH, existing.trimEnd() + "\n\n" + script);
+    writeFileSync2(HOOK_PATH, existing.trimEnd() + "\n\n" + body + "\n");
   } else {
     writeFileSync2(HOOK_PATH, script);
   }
@@ -435,7 +471,7 @@ function uninstallHook() {
     return;
   }
   const markerIndex = content.indexOf(HOOK_MARKER);
-  const before = markerIndex > 1 ? content.slice(0, markerIndex).trimEnd() : "";
+  const before = markerIndex > 1 ? normalizeHookPreamble(content.slice(0, markerIndex)) : "";
   if (before && before !== "#!/bin/sh") {
     writeFileSync2(HOOK_PATH, `${before}
 `);
@@ -575,6 +611,7 @@ ${diffToSend}` }
   });
   console.log(chalk.dim("  Fix the violations above, then commit again."));
   console.log(chalk.dim("  To bypass (not recommended): git commit --no-verify"));
+  console.log(chalk.dim("  Env bypass: MEMORY_CORE_SKIP_HOOK=1 git commit"));
   console.log(chalk.dim('  To save as memory: memory-core remember "<lesson>"'));
   console.log();
   recordViolations(violations);
@@ -2036,8 +2073,23 @@ program.command("uninstall").description("Remove memory-core from the current pr
     console.log(chalk2.gray("    \u2713 cleaned .gitignore memory-core block"));
   }
 });
-program.command("stats").description("Show violation counters recorded by check and watch").action(() => {
+program.command("stats").description("Show violation counters recorded by check and watch").option("--reset", "Reset violation counters and recent history").action((opts) => {
   const statsPath = join3(process.cwd(), ".memory-core-stats.json");
+  if (opts.reset) {
+    const emptyStats = {
+      rules: {},
+      files: {},
+      live: {
+        rules: {},
+        files: {},
+        byFile: {}
+      },
+      recentViolations: []
+    };
+    writeFileSync3(statsPath, JSON.stringify(emptyStats, null, 2) + "\n", "utf-8");
+    console.log(chalk2.green("\n  Violation stats reset.\n"));
+    return;
+  }
   if (!existsSync3(statsPath)) {
     console.log(chalk2.yellow("\n  No violation stats recorded yet.\n"));
     return;
@@ -2051,12 +2103,31 @@ program.command("stats").description("Show violation counters recorded by check
       console.log(`  ${index + 1}. ${truncate(name, 44).padEnd(46)} ${count}`);
     });
   };
-  printTop("Top rules", stats.rules);
-  printTop("Top files", stats.files);
-  console.log();
+  const liveRules = stats.live?.rules ?? {};
+  const liveFiles = stats.live?.files ?? {};
+  const hasLiveState = !!stats.live;
+  const hasLiveViolations = Object.keys(liveRules).length > 0 || Object.keys(liveFiles).length > 0;
+  printTop(
+    hasLiveState ? "Top rules (current watch state)" : "Top rules",
+    hasLiveState ? liveRules : stats.rules
+  );
+  printTop(
+    hasLiveState ? "Top files (current watch state)" : "Top files",
+    hasLiveState ? liveFiles : stats.files
+  );
+  if (!hasLiveState) {
+    console.log(chalk2.dim("\n  Note: these counters are historical events, not live current code state."));
+    console.log(chalk2.dim("  Start watch for live counters, or reset with: memory-core stats --reset\n"));
+  } else {
+    if (hasLiveViolations) {
+      console.log(chalk2.dim("\n  Live counters auto-refresh while watch is running.\n"));
+    } else {
+      console.log(chalk2.dim("\n  Current live state has no violations.\n"));
+    }
+  }
 });
 program.command("dashboard").description("Start the live Svelte dashboard with WebSocket watch events").option("-p, --port <port>", "Dashboard port", "5178").option("--path <dir>", "Directory to watch (default: current directory)").option("--no-watch", "Serve the dashboard without starting file watch").action(async (opts) => {
-  const { startDashboard } = await import("./dashboard-server-AUX4BQP6.js");
+  const { startDashboard } = await import("./dashboard-server-OEDFMSFB.js");
   await startDashboard({
     port: parseInt(opts.port, 10),
     path: opts.path,
@@ -2460,16 +2531,30 @@ hook.command("install").description("Install pre-commit hook (advisory mode by d
 hook.command("uninstall").description("Remove the pre-commit hook").action(() => {
   uninstallHook();
 });
-program.command("check").description("Check staged changes against architecture rules (used by pre-commit hook)").option("--staged", "Check git staged diff (default behaviour)").option("--ci", `Check CI diff using ${MEMORY_FILE}`).option("--verbose", "Show model and diff details").option("--debug", "Show prompt, diff, and raw model response").action(async (opts) => {
+program.command("check").description("Check staged changes against architecture rules (used by pre-commit hook)").option("--staged", "Check git staged diff (default behaviour)").option("--ci", `Check CI diff using ${MEMORY_FILE}`).option("--all", "Check all tracked source files, including already-committed files").option("--path <dir>", "Directory to check for --all mode (default: current directory)").option("--verbose", "Show model and diff details").option("--debug", "Show prompt, diff, and raw model response").action(async (opts) => {
+  if (opts.ci && opts.all) {
+    console.error(chalk2.red("\n  Choose one mode: --ci or --all.\n"));
+    process.exit(1);
+  }
   if (opts.ci) {
     await checkCi({ verbose: opts.verbose ?? false, debug: opts.debug ?? false });
     return;
   }
+  if (opts.all) {
+    const summary = await phase1.providers.watchService.scan({
+      path: opts.path,
+      verbose: opts.verbose,
+      debug: opts.debug
+    });
+    if (summary.violations > 0) process.exit(1);
+    return;
+  }
   await checkStaged({ verbose: opts.verbose ?? false, debug: opts.debug ?? false });
 });
-program.command("watch").description("Watch source files and check violations in real-time on every save").option("--path <dir>", "Directory to watch (default: current directory)").option("--verbose", "Show diff size and model details per file").option("--debug", "Show prompt, diff, and raw model response").action(async (opts) => {
+program.command("watch").description("Watch source files and check violations in real-time on every save").option("--path <dir>", "Directory to watch (default: current directory)").option("--scan-on-start", "Run an initial full snapshot scan before watching file changes").option("--verbose", "Show diff size and model details per file").option("--debug", "Show prompt, diff, and raw model response").action(async (opts) => {
   await phase1.providers.watchService.start({
     path: opts.path,
+    scanOnStart: opts.scanOnStart,
     verbose: opts.verbose,
     debug: opts.debug
   });

package/dist/{dashboard-server-AUX4BQP6.js → dashboard-server-OEDFMSFB.js}

@@ -12,13 +12,13 @@ import {
   saveMemory,
   startWatch,
   updateMemory
-} from "./chunk-PDQXIKL7.js";
+} from "./chunk-WJG77BPO.js";
 
 // src/dashboard-server.ts
 import { createHash } from "crypto";
 import { createReadStream, existsSync, readFileSync, watch } from "fs";
 import { createServer } from "http";
-import { extname, join, normalize, relative } from "path";
+import { extname, join, normalize, relative, resolve } from "path";
 import { fileURLToPath } from "url";
 import chalk from "chalk";
 var clients = /* @__PURE__ */ new Set();
@@ -46,6 +46,7 @@ var snapshotBroadcastTimer;
 var snapshotBroadcastInFlight = false;
 var snapshotBroadcastQueued = false;
 var snapshotBroadcastForceRefresh = false;
+var projectRoot = process.cwd();
 function readJsonFile(path, fallback) {
   if (!existsSync(path)) return fallback;
   try {
@@ -55,7 +56,7 @@ function readJsonFile(path, fallback) {
   }
 }
 function readProjectConfig() {
-  return readJsonFile(join(process.cwd(), ".memory-core.json"), null);
+  return readJsonFile(join(projectRoot, ".memory-core.json"), null);
 }
 function parseEnvFile(raw) {
   const values = {};
@@ -71,8 +72,8 @@ function parseEnvFile(raw) {
   return values;
 }
 function getRuntimeEnvPath() {
-  const memoryEnv = join(process.cwd(), ".memory-core.env");
-  return existsSync(memoryEnv) ? memoryEnv : join(process.cwd(), ".env");
+  const memoryEnv = join(projectRoot, ".memory-core.env");
+  return existsSync(memoryEnv) ? memoryEnv : join(projectRoot, ".env");
 }
 function reloadRuntimeEnv() {
   const envPath = getRuntimeEnvPath();
@@ -91,18 +92,20 @@ function invalidateSnapshotBase() {
   snapshotBaseCache = void 0;
 }
 function readStats() {
-  return readJsonFile(join(process.cwd(), ".memory-core-stats.json"), { rules: {}, files: {} });
+  return readJsonFile(join(projectRoot, ".memory-core-stats.json"), { rules: {}, files: {} });
 }
 function topEntries(values = {}, limit = 8) {
   return Object.entries(values).sort((a, b) => b[1] - a[1]).slice(0, limit).map(([name, count]) => ({ name, count }));
 }
 function buildStatsPayload() {
   const stats = readStats();
+  const rules = stats.live?.rules ?? stats.rules ?? {};
+  const files = stats.live?.files ?? stats.files ?? {};
   return {
-    rules: stats.rules ?? {},
-    files: stats.files ?? {},
-    topRules: topEntries(stats.rules),
-    topFiles: topEntries(stats.files),
+    rules,
+    files,
+    topRules: topEntries(rules),
+    topFiles: topEntries(files),
     recentViolations: stats.recentViolations ?? []
   };
 }
@@ -206,12 +209,12 @@ async function getModelStatus(forceRefresh = false) {
   return status;
 }
 async function getRuntimeStatus(config) {
-  const detected = detectProject(process.cwd());
+  const detected = detectProject(projectRoot);
   const declaredArchitectures = [
     config?.backendArchitecture,
     config?.frontendFramework
   ].filter((value) => typeof value === "string" && value.length > 0);
-  const activeArchitectures = inferProjectArchitectures(process.cwd(), config);
+  const activeArchitectures = inferProjectArchitectures(projectRoot, config);
   const database = parseDatabaseUrl(Config.databaseUrl);
   let postgres = {
     ...database,
@@ -242,7 +245,7 @@ async function getRuntimeStatus(config) {
   const model = await modelPromise;
   return {
     project: {
-      name: config?.projectName ?? process.cwd().split("/").pop() ?? "project",
+      name: config?.projectName ?? projectRoot.split("/").pop() ?? "project",
       type: config?.projectType ?? "unknown",
       language: config?.language ?? detected.language,
       initialized: config !== null,
@@ -376,7 +379,7 @@ async function handleApi(req, res, url) {
         return;
       }
       const config = readProjectConfig();
-      const activeArchitectures = inferProjectArchitectures(process.cwd(), config);
+      const activeArchitectures = inferProjectArchitectures(projectRoot, config);
       await saveMemory({
         type: typeof body.type === "string" ? body.type : "rule",
         scope: typeof body.scope === "string" ? body.scope : "project",
@@ -635,14 +638,14 @@ function startConfigWatch() {
     }, 150);
   };
   for (const file of watchedFiles) {
-    const filePath = join(process.cwd(), file);
+    const filePath = join(projectRoot, file);
     if (!existsSync(filePath)) continue;
     watchedPaths.add(filePath);
     watchers.push(watch(filePath, () => reload(filePath)));
   }
-  watchers.push(watch(process.cwd(), (_eventType, filename) => {
+  watchers.push(watch(projectRoot, (_eventType, filename) => {
     if (typeof filename !== "string" || !watchedFiles.includes(filename)) return;
-    const filePath = join(process.cwd(), filename);
+    const filePath = join(projectRoot, filename);
     if (!existsSync(filePath)) return;
     if (!watchedPaths.has(filePath)) {
       watchedPaths.add(filePath);
@@ -656,6 +659,7 @@ function startConfigWatch() {
   };
 }
 async function startDashboard(options = {}) {
+  projectRoot = resolve(options.path ?? process.cwd());
   reloadRuntimeEnv();
   const port = options.port ?? 5178;
   const stopConfigWatch = startConfigWatch();
@@ -683,8 +687,8 @@ async function startDashboard(options = {}) {
     }
     void closePool();
   });
-  await new Promise((resolve) => {
-    server.listen(port, resolve);
+  await new Promise((resolve2) => {
+    server.listen(port, resolve2);
   });
   console.log(chalk.green(`
   Dashboard: http://localhost:${port}
@@ -692,7 +696,7 @@ async function startDashboard(options = {}) {
   if (options.watch ?? true) {
     watcherStatus.enabled = true;
     void startWatch({
-      path: options.path,
+      path: projectRoot,
       onEvent: handleWatchEvent,
       exitOnSetupFailure: false
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shahmilsaari/memory-core",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Universal AI memory core — generate AI context files from architecture profiles with RAG support",
   "homepage": "https://memory-core.shahmilsaari.my/",
   "type": "module",