@shahmilsaari/memory-core 0.1.1 → 0.1.3

package/README.md

@@ -318,6 +318,46 @@ npx @shahmilsaari/memory-core hook uninstall   # remove the hook
 
 ---
 
+### `watch` — Real-time rule checking
+
+```bash
+npx @shahmilsaari/memory-core watch
+```
+
+Runs in your terminal and checks every source file as you save it. Violations print immediately — no commit needed.
+
+```
+  archmind watch — real-time rule enforcement
+
+  watching: /your/project
+  model:    llama3.2
+  rules:    24
+  ctrl+c to stop
+
+  [10:42:11] saved: src/controllers/user.ts
+
+  ✗ 1 violation in src/controllers/user.ts
+
+  [1] src/controllers/user.ts:34
+      Rule:   Thin controllers — business logic belongs in services
+      Why:    Logic in controllers cannot be reused from CLI, queues, or other
+              entry points — it gets siloed and duplicated across handlers
+      Issue:  Password hashing inside the route handler
+      Fix:    Move to UserService.hashPassword()
+
+  Fix violations or run: memory-core remember "<lesson>"
+```
+
+Options:
+```bash
+npx @shahmilsaari/memory-core watch --path src/      # watch a specific directory
+npx @shahmilsaari/memory-core watch --verbose        # show diff size and model details
+```
+
+Ignores: `node_modules`, `dist`, `build`, `.git`, config files — only checks source code.
+
+---
+
 ### `check` — Manual rule check
 
 ```bash
@@ -452,7 +492,7 @@ The hook only checks source files (`.ts .tsx .js .jsx .py .php .rb .go .java .cs
 | Feature | Description |
 |---|---|
 | CI/CD check | GitHub Actions workflow — fails PRs that violate rules |
-| Watch mode | `memory-core watch` — checks files on save in real-time |
+| ✓ Watch mode | `memory-core watch` — checks files on save in real-time |
 | Violation memory | Auto-save caught violations as "never do X, do Y" memories |
 | Rule analytics | Track which rules break most, which files are worst offenders |
 | Team sync | `memory-core push/pull` — shared memory pool across the whole team |

package/dist/cli.js

@@ -3,12 +3,12 @@
 // src/cli.ts
 import { Command } from "commander";
 import { input, select, confirm } from "@inquirer/prompts";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 import ora from "ora";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, existsSync as existsSync5, mkdirSync as mkdirSync2 } from "fs";
-import { join as join5, dirname as dirname2 } from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync2, appendFileSync } from "fs";
+import { join as join6, dirname as dirname2 } from "path";
 import { homedir } from "os";
-import { execSync as execSync2 } from "child_process";
+import { execSync as execSync3 } from "child_process";
 
 // src/generator.ts
 import { readFileSync, readdirSync, writeFileSync, mkdirSync, existsSync } from "fs";
@@ -626,10 +626,10 @@ function uninstallHook() {
   console.log(chalk.green("\n  \u2713 Pre-commit hook removed\n"));
 }
 async function checkStaged(options = {}) {
-  const SOURCE_EXTENSIONS = /\.(ts|tsx|js|jsx|py|php|rb|go|java|cs|swift|kt|rs|vue|svelte)$/;
+  const SOURCE_EXTENSIONS2 = /\.(ts|tsx|js|jsx|py|php|rb|go|java|cs|swift|kt|rs|vue|svelte)$/;
   let diff;
   try {
-    const stagedFiles = execSync("git diff --cached --name-only", { encoding: "utf-8" }).split("\n").filter((f) => f && SOURCE_EXTENSIONS.test(f));
+    const stagedFiles = execSync("git diff --cached --name-only", { encoding: "utf-8" }).split("\n").filter((f) => f && SOURCE_EXTENSIONS2.test(f));
     if (stagedFiles.length === 0) {
       if (options.verbose) console.log(chalk.gray("  No source files staged \u2014 skipping rule check."));
       return;
@@ -782,53 +782,317 @@ function printModelMissing(model) {
   console.log(chalk.gray("     Recommended: llama3.2  |  qwen2.5-coder:3b  |  mistral\n"));
 }
 
+// src/watcher.ts
+import { watch } from "chokidar";
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
+import { join as join5, relative } from "path";
+import chalk2 from "chalk";
+var SOURCE_EXTENSIONS = /\.(ts|tsx|js|jsx|py|php|rb|go|java|cs|swift|kt|rs|vue|svelte)$/;
+var IGNORE_PATTERNS = [
+  /node_modules/,
+  /\.git/,
+  /dist\//,
+  /build\//,
+  /coverage\//,
+  /\.memory-core/
+];
+var reasonMap2 = new Map(
+  seeds.filter((s) => s.reason).map((s) => [s.content, s.reason])
+);
+function loadConfig(cwd) {
+  const configPath = join5(cwd, ".memory-core.json");
+  if (!existsSync5(configPath)) return null;
+  try {
+    return JSON.parse(readFileSync4(configPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function getProfileRules(config2) {
+  const rules = [];
+  const avoids = [];
+  if (config2.backendArchitecture) {
+    const profile = listProfiles("backend").find((p) => p.name === config2.backendArchitecture);
+    if (profile) {
+      rules.push(...profile.rules);
+      avoids.push(...profile.avoid);
+    }
+  }
+  if (config2.frontendFramework) {
+    const profile = listProfiles("frontend").find((p) => p.name === config2.frontendFramework);
+    if (profile) {
+      rules.push(...profile.rules);
+      avoids.push(...profile.avoid);
+    }
+  }
+  return { rules, avoids };
+}
+async function checkFile(filePath, cwd, config2, verbose) {
+  const rel = relative(cwd, filePath);
+  let diff;
+  try {
+    diff = execSync2(`git diff HEAD -- "${rel}" 2>/dev/null || git diff --no-index /dev/null "${rel}" 2>/dev/null || true`, {
+      encoding: "utf-8",
+      cwd
+    });
+  } catch {
+    try {
+      diff = execSync2(`git diff --no-index /dev/null "${rel}"`, { encoding: "utf-8", cwd });
+    } catch (e) {
+      diff = e.stdout ?? "";
+    }
+  }
+  if (!diff.trim()) return;
+  const { rules, avoids } = getProfileRules(config2);
+  if (rules.length === 0) return;
+  const ollamaUrl = process.env.OLLAMA_URL ?? "http://localhost:11434";
+  const chatModel = process.env.OLLAMA_CHAT_MODEL ?? "llama3.2";
+  const MAX_DIFF = 6e3;
+  const truncated = diff.length > MAX_DIFF;
+  const diffToSend = truncated ? diff.slice(0, MAX_DIFF) + "\n\n[diff truncated]" : diff;
+  if (verbose) {
+    console.log(chalk2.dim(`
+  [watch] checking ${rel} (${diff.length} chars)\u2026`));
+  }
+  const rulesWithReasons = rules.map((r, i) => {
+    const why = reasonMap2.get(r);
+    return why ? `${i + 1}. ${r}
+   WHY: ${why}` : `${i + 1}. ${r}`;
+  }).join("\n");
+  const systemPrompt = `You are a strict code reviewer enforcing architecture rules.
+Analyze the file diff and identify ONLY clear, definite rule violations.
+Use the WHY for each rule to understand intent and judge edge cases.
+
+Rules to enforce:
+${rulesWithReasons}
+
+Things that must never appear:
+${avoids.map((a, i) => `${i + 1}. ${a}`).join("\n")}
+
+IMPORTANT: Respond with JSON: {"violations":[...]} or {"violations":[]}.
+Each violation: {"rule":"...","file":"...","line":N,"issue":"...","suggestion":"...","reason":"..."}.
+No text outside the JSON.`;
+  try {
+    const res = await fetch(`${ollamaUrl}/api/chat`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        model: chatModel,
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: `Review this diff for ${rel}:
+
+${diffToSend}` }
+        ],
+        stream: false,
+        format: "json"
+      })
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      if (body.includes("not found") || body.includes("model")) {
+        console.log(chalk2.yellow(`
+  \u26A0  Chat model "${chatModel}" not found. Pull it: ollama pull ${chatModel}
+`));
+      }
+      return;
+    }
+    const data = await res.json();
+    const raw = data.message.content.trim();
+    let violations = [];
+    try {
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        violations = parsed;
+      } else if (Array.isArray(parsed?.violations)) {
+        violations = parsed.violations;
+      } else if (parsed?.rule) {
+        violations = [parsed];
+      }
+    } catch {
+      violations = [];
+    }
+    if (violations.length === 0) {
+      console.log(chalk2.green(`  \u2713 ${rel}`) + chalk2.dim(" \u2014 no violations"));
+      return;
+    }
+    console.log(
+      chalk2.red.bold(`
+  \u2717 ${violations.length} violation${violations.length > 1 ? "s" : ""} in ${rel}
+`)
+    );
+    violations.forEach((v, i) => {
+      const loc = v.line ? `${v.file ?? rel}:${v.line}` : v.file ?? rel;
+      console.log(chalk2.bold(`  [${i + 1}] ${loc}`));
+      console.log(chalk2.yellow("      Rule:   ") + v.rule);
+      const why = v.reason ?? reasonMap2.get(v.rule);
+      if (why) console.log(chalk2.dim("      Why:    ") + chalk2.dim(why));
+      if (v.issue) console.log(chalk2.red("      Issue:  ") + v.issue);
+      if (v.suggestion) console.log(chalk2.green("      Fix:    ") + v.suggestion);
+      console.log();
+    });
+    console.log(chalk2.dim('  Fix violations or run: memory-core remember "<lesson>"'));
+    console.log();
+  } catch (err) {
+    if (err.cause?.code === "ECONNREFUSED" || err.message?.includes("ECONNREFUSED")) {
+      return;
+    }
+    if (verbose) {
+      console.log(chalk2.yellow(`  \u26A0  Check failed for ${rel}: ${err.message}`));
+    }
+  }
+}
+function startWatch(options = {}) {
+  const cwd = process.cwd();
+  const config2 = loadConfig(cwd);
+  if (!config2) {
+    console.error(chalk2.red("\n  No .memory-core.json found. Run: memory-core init\n"));
+    process.exit(1);
+  }
+  const { rules } = getProfileRules(config2);
+  if (rules.length === 0) {
+    console.log(chalk2.yellow("\n  No architecture rules configured in .memory-core.json \u2014 nothing to watch.\n"));
+    process.exit(0);
+  }
+  const watchPath = options.path ?? cwd;
+  const ollamaUrl = process.env.OLLAMA_URL ?? "http://localhost:11434";
+  const chatModel = process.env.OLLAMA_CHAT_MODEL ?? "llama3.2";
+  console.log(chalk2.cyan("\n  archmind watch \u2014 real-time rule enforcement\n"));
+  console.log(chalk2.dim(`  watching: ${watchPath}`));
+  console.log(chalk2.dim(`  model:    ${chatModel}`));
+  console.log(chalk2.dim(`  rules:    ${rules.length}`));
+  console.log(chalk2.dim("  ctrl+c to stop\n"));
+  const pending = /* @__PURE__ */ new Map();
+  let ollamaWarned = false;
+  const watcher = watch(watchPath, {
+    ignored: (filePath) => {
+      if (IGNORE_PATTERNS.some((p) => p.test(filePath))) return true;
+      const isFile = !filePath.endsWith("/");
+      if (isFile && !SOURCE_EXTENSIONS.test(filePath)) return true;
+      return false;
+    },
+    ignoreInitial: true,
+    persistent: true,
+    awaitWriteFinish: { stabilityThreshold: 150, pollInterval: 50 }
+  });
+  const handle = (filePath) => {
+    if (pending.has(filePath)) clearTimeout(pending.get(filePath));
+    const timer = setTimeout(async () => {
+      pending.delete(filePath);
+      console.log(chalk2.dim(`
+  [${(/* @__PURE__ */ new Date()).toLocaleTimeString()}] saved: ${relative(cwd, filePath)}`));
+      try {
+        const ping = await fetch(`${ollamaUrl}/api/tags`, { signal: AbortSignal.timeout(2e3) });
+        if (!ping.ok) throw new Error("not ok");
+        ollamaWarned = false;
+      } catch {
+        if (!ollamaWarned) {
+          console.log(chalk2.yellow(`  \u26A0  Ollama not running at ${ollamaUrl} \u2014 skipping check.`));
+          console.log(chalk2.gray("     Start it: ollama serve\n"));
+          ollamaWarned = true;
+        }
+        return;
+      }
+      await checkFile(filePath, cwd, config2, options.verbose ?? false);
+    }, 300);
+    pending.set(filePath, timer);
+  };
+  watcher.on("add", handle);
+  watcher.on("change", handle);
+  watcher.on("error", (err) => {
+    console.error(chalk2.red(`  watcher error: ${err.message}`));
+  });
+  process.on("SIGINT", () => {
+    console.log(chalk2.dim("\n\n  archmind watch stopped.\n"));
+    watcher.close();
+    process.exit(0);
+  });
+}
+
 // src/cli.ts
 function printBanner(projectName, agentCount) {
   const lines = [
     "",
-    chalk2.cyan("   \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 "),
-    chalk2.cyan("  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557"),
-    chalk2.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551"),
-    chalk2.cyan("  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551"),
-    chalk2.cyan("  \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D"),
-    chalk2.cyan("  \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D"),
+    chalk3.cyan("   \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 "),
+    chalk3.cyan("  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557"),
+    chalk3.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551"),
+    chalk3.cyan("  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551"),
+    chalk3.cyan("  \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D"),
+    chalk3.cyan("  \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D"),
     "",
-    chalk2.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 ") + chalk2.bold.white("C O R E") + chalk2.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"),
+    chalk3.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 ") + chalk3.bold.white("C O R E") + chalk3.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"),
     "",
-    chalk2.green(`  \u2713 Project   `) + chalk2.bold(projectName),
-    chalk2.green(`  \u2713 Agents    `) + chalk2.bold(`${agentCount} AI agents configured`),
-    chalk2.green(`  \u2713 Memory    `) + chalk2.bold("PostgreSQL + pgvector ready"),
+    chalk3.green(`  \u2713 Project   `) + chalk3.bold(projectName),
+    chalk3.green(`  \u2713 Agents    `) + chalk3.bold(`${agentCount} AI agents configured`),
+    chalk3.green(`  \u2713 Memory    `) + chalk3.bold("PostgreSQL + pgvector ready"),
     "",
-    chalk2.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\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"),
+    chalk3.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\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"),
     "",
-    chalk2.bold("  Every AI agent in this project now follows your rules."),
+    chalk3.bold("  Every AI agent in this project now follows your rules."),
     "",
-    chalk2.gray("  Next steps:"),
-    chalk2.gray('    memory-core remember "Your architectural decision"'),
-    chalk2.gray('    memory-core search "query"'),
-    chalk2.gray("    memory-core sync"),
+    chalk3.gray("  Next steps:"),
+    chalk3.gray('    memory-core remember "Your architectural decision"'),
+    chalk3.gray('    memory-core search "query"'),
+    chalk3.gray("    memory-core sync"),
     ""
   ];
   lines.forEach((l) => console.log(l));
 }
 var CONFIG_FILE = ".memory-core.json";
 function readProjectConfig() {
-  const path = join5(process.cwd(), CONFIG_FILE);
-  if (!existsSync5(path)) return null;
+  const path = join6(process.cwd(), CONFIG_FILE);
+  if (!existsSync6(path)) return null;
   try {
-    return JSON.parse(readFileSync4(path, "utf-8"));
+    return JSON.parse(readFileSync5(path, "utf-8"));
   } catch {
     return null;
   }
 }
 function writeProjectConfig(config2) {
-  writeFileSync3(join5(process.cwd(), CONFIG_FILE), JSON.stringify(config2, null, 2));
+  writeFileSync3(join6(process.cwd(), CONFIG_FILE), JSON.stringify(config2, null, 2));
 }
 var program = new Command();
 program.name("memory-core").description("Universal AI memory core \u2014 generate AI context files for all coding agents").version("0.1.0");
 program.command("init").description("Initialize memory-core in the current project").action(async () => {
-  console.log(chalk2.bold.cyan("\n  memory-core init\n"));
+  console.log(chalk3.bold.cyan("\n  memory-core init\n"));
   const detected = detectProject();
+  const envPath = join6(process.cwd(), ".memory-core.env");
+  const hasEnv = existsSync6(envPath) || existsSync6(join6(process.cwd(), ".env")) || !!process.env.DATABASE_URL;
+  if (!hasEnv) {
+    console.log(chalk3.dim("  No .memory-core.env found \u2014 let's set up your database connection.\n"));
+    const dbUser = process.env.USER ?? process.env.USERNAME ?? "postgres";
+    const dbUrl = await input({
+      message: "PostgreSQL connection URL?",
+      default: `postgresql://${dbUser}@localhost:5432/memory_core`
+    });
+    const ollamaUrl = await input({
+      message: "Ollama URL?",
+      default: "http://localhost:11434"
+    });
+    const envContent = [
+      `DATABASE_URL=${dbUrl}`,
+      `OLLAMA_URL=${ollamaUrl}`,
+      `OLLAMA_MODEL=nomic-embed-text`,
+      `OLLAMA_CHAT_MODEL=llama3.2`
+    ].join("\n") + "\n";
+    writeFileSync3(envPath, envContent);
+    process.env.DATABASE_URL = dbUrl;
+    process.env.OLLAMA_URL = ollamaUrl;
+    process.env.OLLAMA_MODEL = "nomic-embed-text";
+    process.env.OLLAMA_CHAT_MODEL = "llama3.2";
+    const gitignorePath = join6(process.cwd(), ".gitignore");
+    if (existsSync6(gitignorePath)) {
+      const gi = readFileSync5(gitignorePath, "utf-8");
+      if (!gi.includes(".memory-core.env")) {
+        appendFileSync(gitignorePath, "\n.memory-core.env\n");
+      }
+    } else {
+      writeFileSync3(gitignorePath, ".memory-core.env\n");
+    }
+    console.log(chalk3.green("\n  \u2713 .memory-core.env created"));
+    console.log(chalk3.gray("    Added to .gitignore \u2014 your DB credentials stay local.\n"));
+  }
   const projectName = await input({
     message: "Project name?",
     default: process.cwd().split("/").pop() ?? "my-project"
@@ -908,7 +1172,7 @@ program.command("init").description("Initialize memory-core in the current proje
   if (installCaveman) {
     const spinner2 = ora("Installing caveman token saver\u2026").start();
     try {
-      execSync2(
+      execSync3(
         "curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash",
         { stdio: "pipe", cwd: process.cwd() }
       );
@@ -930,7 +1194,7 @@ program.command("init").description("Initialize memory-core in the current proje
 program.command("sync").description("Re-pull memories and regenerate all AI agent files").action(async () => {
   const config2 = readProjectConfig();
   if (!config2) {
-    console.error(chalk2.red("No .memory-core.json found. Run: memory-core init"));
+    console.error(chalk3.red("No .memory-core.json found. Run: memory-core init"));
     process.exit(1);
   }
   const spinner = ora("Syncing memories\u2026").start();
@@ -962,7 +1226,7 @@ program.command("remember <text>").description("Save a new memory to the central
   let reason = opts.reason;
   if (!reason) {
     reason = await input({
-      message: chalk2.dim("Why does this rule exist? (optional \u2014 helps agents debug violations)"),
+      message: chalk3.dim("Why does this rule exist? (optional \u2014 helps agents debug violations)"),
       default: ""
     });
   }
@@ -979,9 +1243,9 @@ program.command("remember <text>").description("Save a new memory to the central
       tags: opts.tags ? opts.tags.split(",").map((t) => t.trim()) : [],
       embedding
     });
-    const reasonLine = reason ? chalk2.gray(`
+    const reasonLine = reason ? chalk3.gray(`
   Why: ${reason}`) : "";
-    spinner.succeed(chalk2.green(`Memory saved: "${text}"`) + reasonLine);
+    spinner.succeed(chalk3.green(`Memory saved: "${text}"`) + reasonLine);
   } catch (err) {
     spinner.fail(`Failed: ${err.message}`);
     process.exit(1);
@@ -999,16 +1263,16 @@ program.command("search <query>").description("Search memories using semantic si
     );
     spinner.stop();
     if (results.length === 0) {
-      console.log(chalk2.yellow("No memories found."));
+      console.log(chalk3.yellow("No memories found."));
     } else {
-      console.log(chalk2.bold(`
+      console.log(chalk3.bold(`
   ${results.length} results for "${query}"
 `));
       results.forEach((m, i) => {
-        const sim = m.similarity ? chalk2.gray(` (${(m.similarity * 100).toFixed(0)}% match)`) : "";
-        console.log(chalk2.cyan(`  ${i + 1}. [${m.type}] ${m.title ?? ""}`));
-        console.log(chalk2.white(`     ${m.content}`) + sim);
-        if (m.tags?.length) console.log(chalk2.gray(`     tags: ${m.tags.join(", ")}`));
+        const sim = m.similarity ? chalk3.gray(` (${(m.similarity * 100).toFixed(0)}% match)`) : "";
+        console.log(chalk3.cyan(`  ${i + 1}. [${m.type}] ${m.title ?? ""}`));
+        console.log(chalk3.white(`     ${m.content}`) + sim);
+        if (m.tags?.length) console.log(chalk3.gray(`     tags: ${m.tags.join(", ")}`));
         console.log();
       });
     }
@@ -1021,7 +1285,7 @@ program.command("search <query>").description("Search memories using semantic si
 program.command("seed").description("Load all predefined memories into the database").option("--arch <architecture>", "Only seed a specific architecture (e.g. clean-architecture)").option("--force", "Re-seed even if memories already exist", false).action(async (opts) => {
   await runMigrations();
   const filtered = opts.arch ? seeds.filter((s) => s.architecture === opts.arch || s.architecture === "global") : seeds;
-  console.log(chalk2.bold.cyan(`
+  console.log(chalk3.bold.cyan(`
   Seeding ${filtered.length} memories\u2026
 `));
   let saved = 0;
@@ -1040,14 +1304,14 @@ program.command("seed").description("Load all predefined memories into the datab
         tags: seed.tags,
         embedding
       });
-      spinner.succeed(chalk2.gray(`[${seed.architecture}] ${seed.title}`));
+      spinner.succeed(chalk3.gray(`[${seed.architecture}] ${seed.title}`));
       saved++;
     } catch (err) {
       spinner.warn(`Skipped \u2014 ${err.message}`);
       skipped++;
     }
   }
-  console.log(chalk2.bold.green(`
+  console.log(chalk3.bold.green(`
   Done. ${saved} memories seeded, ${skipped} skipped.
 `));
   await closePool();
@@ -1056,21 +1320,21 @@ program.command("global").description("Sync your memory into every AI agent glob
   const home = homedir();
   const GLOBAL_TARGETS = [
     // Claude Code
-    { label: "Claude Code", path: join5(home, ".claude/CLAUDE.md"), type: "md" },
+    { label: "Claude Code", path: join6(home, ".claude/CLAUDE.md"), type: "md" },
     // GitHub Copilot (VS Code)
-    { label: "Copilot", path: join5(home, "Library/Application Support/Code/User/settings.json"), type: "vscode-copilot" },
+    { label: "Copilot", path: join6(home, "Library/Application Support/Code/User/settings.json"), type: "vscode-copilot" },
     // Cursor global rules
-    { label: "Cursor", path: join5(home, ".cursor/rules/memory-core.mdc"), type: "md" },
+    { label: "Cursor", path: join6(home, ".cursor/rules/memory-core.mdc"), type: "md" },
     // Cline (VS Code)
-    { label: "Cline", path: join5(home, "Library/Application Support/Code/User/settings.json"), type: "vscode-cline" },
+    { label: "Cline", path: join6(home, "Library/Application Support/Code/User/settings.json"), type: "vscode-cline" },
     // Continue.dev global config
-    { label: "Continue.dev", path: join5(home, ".continue/config.json"), type: "continue" },
+    { label: "Continue.dev", path: join6(home, ".continue/config.json"), type: "continue" },
     // Aider global config
-    { label: "Aider", path: join5(home, ".aider.conf.yml"), type: "aider" },
+    { label: "Aider", path: join6(home, ".aider.conf.yml"), type: "aider" },
     // Zed global settings
-    { label: "Zed AI", path: join5(home, ".config/zed/settings.json"), type: "zed" },
+    { label: "Zed AI", path: join6(home, ".config/zed/settings.json"), type: "zed" },
     // Windsurf global rules
-    { label: "Windsurf", path: join5(home, ".windsurf/rules/memory-core.md"), type: "md" }
+    { label: "Windsurf", path: join6(home, ".windsurf/rules/memory-core.md"), type: "md" }
   ];
   const spinner = ora("Fetching global memories\u2026").start();
   let memories = [];
@@ -1098,9 +1362,9 @@ ${rulesText}
     writeFileSync3(filePath, content, "utf-8");
   };
   const readJson = (filePath) => {
-    if (!existsSync5(filePath)) return {};
+    if (!existsSync6(filePath)) return {};
     try {
-      return JSON.parse(readFileSync4(filePath, "utf-8"));
+      return JSON.parse(readFileSync5(filePath, "utf-8"));
     } catch {
       return {};
     }
@@ -1148,14 +1412,14 @@ read:
       skipped.push(target.label);
     }
   }
-  spinner.succeed(chalk2.green(`Synced ${memories.length} memories \u2192 ${written.length} agents`));
-  console.log(chalk2.green("\n  Updated:"));
-  written.forEach((l) => console.log(chalk2.gray(`    \u2713 ${l}`)));
+  spinner.succeed(chalk3.green(`Synced ${memories.length} memories \u2192 ${written.length} agents`));
+  console.log(chalk3.green("\n  Updated:"));
+  written.forEach((l) => console.log(chalk3.gray(`    \u2713 ${l}`)));
   if (skipped.length) {
-    console.log(chalk2.yellow("\n  Skipped (not installed):"));
-    skipped.forEach((l) => console.log(chalk2.gray(`    \u2717 ${l}`)));
+    console.log(chalk3.yellow("\n  Skipped (not installed):"));
+    skipped.forEach((l) => console.log(chalk3.gray(`    \u2717 ${l}`)));
   }
-  console.log(chalk2.bold("\n  Every AI agent now follows your memory globally.\n"));
+  console.log(chalk3.bold("\n  Every AI agent now follows your memory globally.\n"));
   await closePool();
 });
 var hook = program.command("hook").description("Manage the pre-commit rule enforcement hook");
@@ -1168,4 +1432,7 @@ hook.command("uninstall").description("Remove the pre-commit hook").action(() =>
 program.command("check").description("Check staged changes against architecture rules (used by pre-commit hook)").option("--staged", "Check git staged diff (default behaviour)").option("--verbose", "Show model and diff details").action(async (opts) => {
   await checkStaged({ verbose: opts.verbose ?? 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").action((opts) => {
+  startWatch({ path: opts.path, verbose: opts.verbose });
+});
 program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shahmilsaari/memory-core",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Universal AI memory core — generate AI context files from architecture profiles with RAG support",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
   "dependencies": {
     "@inquirer/prompts": "^5.0.0",
     "chalk": "^5.3.0",
+    "chokidar": "^5.0.0",
     "commander": "^12.0.0",
     "dotenv": "^16.4.0",
     "handlebars": "^4.7.8",