autonomous-flow-daemon 1.1.0 → 1.9.0

package/src/core/immune.ts

@@ -1,4 +1,6 @@
-import { existsSync, readFileSync } from "fs";
+import { diagnoseWithRules, loadAllRules, evaluateRules } from "./rule-engine";
+export type { DiagnosticRule } from "./rule-engine";
+export { loadAllRules, evaluateRules };
 
 // RFC 6902 JSON-Patch operation
 export interface PatchOp {
@@ -24,127 +26,10 @@ export interface DiagnosisResult {
   healthy: string[];
 }
 
-const CLAUDEIGNORE_DEFAULT = `# Autonomous Flow Daemon defaults
-node_modules/
-dist/
-.afd/
-*.log
-.env
-`;
-
-const HOOKS_DEFAULT = `{
-  "hooks": []
-}
-`;
-
-type Check = () => Symptom | null;
-
-const checks: Check[] = [
-  // Check 1: Missing .claudeignore
-  () => {
-    if (existsSync(".claudeignore")) return null;
-    return {
-      id: "IMM-001",
-      patternType: "missing-file",
-      fileTarget: ".claudeignore",
-      title: "Missing .claudeignore",
-      description:
-        "No .claudeignore found. Without it, AI agents ingest node_modules, build artifacts, and other noise — wasting tokens and degrading context quality.",
-      severity: "critical",
-      patches: [
-        { op: "add", path: "/.claudeignore", value: CLAUDEIGNORE_DEFAULT },
-      ],
-    };
-  },
-
-  // Check 2: Missing .claude/hooks.json fallback
-  () => {
-    const hooksPath = ".claude/hooks.json";
-    if (existsSync(hooksPath)) {
-      try {
-        const content = readFileSync(hooksPath, "utf-8");
-        JSON.parse(content);
-        return null;
-      } catch {
-        return {
-          id: "IMM-002",
-          patternType: "invalid-json",
-          fileTarget: hooksPath,
-          title: "Invalid hooks.json",
-          description:
-            "hooks.json exists but contains invalid JSON. Agents may fail silently when hooks cannot be parsed.",
-          severity: "critical",
-          patches: [
-            { op: "replace", path: "/.claude/hooks.json", value: HOOKS_DEFAULT },
-          ],
-        };
-      }
-    }
-    return {
-      id: "IMM-002",
-      patternType: "missing-file",
-      fileTarget: hooksPath,
-      title: "No fallback in hooks.json",
-      description:
-        "No .claude/hooks.json found. Without a hooks file, pre/post-command automation cannot be configured.",
-      severity: "warning",
-      patches: [
-        { op: "add", path: "/.claude/hooks.json", value: HOOKS_DEFAULT },
-      ],
-    };
-  },
-
-  // Check 3: CLAUDE.md missing or empty
-  () => {
-    if (!existsSync("CLAUDE.md")) {
-      return {
-        id: "IMM-003",
-        patternType: "missing-file",
-        fileTarget: "CLAUDE.md",
-        title: "Missing CLAUDE.md",
-        description:
-          "No CLAUDE.md found. AI agents have no project constitution to follow.",
-        severity: "critical",
-        patches: [
-          { op: "add", path: "/CLAUDE.md", value: "# Project Constitution\n\n<!-- Add project rules here -->\n" },
-        ],
-      };
-    }
-    const content = readFileSync("CLAUDE.md", "utf-8").trim();
-    if (content.length < 20) {
-      return {
-        id: "IMM-003",
-        patternType: "insufficient-content",
-        fileTarget: "CLAUDE.md",
-        title: "CLAUDE.md is nearly empty",
-        description:
-          `CLAUDE.md has only ${content.length} chars. Agents work better with clear project rules.`,
-        severity: "info",
-        patches: [],
-      };
-    }
-    return null;
-  },
-];
-
+/**
+ * Run diagnosis using the rule engine.
+ * Loads built-in rules + custom .afd/rules/*.yml rules.
+ */
 export function diagnose(knownAntibodies: string[], opts?: { raw?: boolean }): DiagnosisResult {
-  const symptoms: Symptom[] = [];
-  const healthy: string[] = [];
-
-  for (const check of checks) {
-    const symptom = check();
-    if (!symptom) {
-      healthy.push("OK");
-      continue;
-    }
-    // In raw mode, report all symptoms regardless of antibodies
-    // (used by auto-heal to detect regressions)
-    if (!opts?.raw && knownAntibodies.includes(symptom.id)) {
-      healthy.push(`${symptom.id} (immunized)`);
-      continue;
-    }
-    symptoms.push(symptom);
-  }
-
-  return { symptoms, healthy };
+  return diagnoseWithRules(knownAntibodies, opts);
 }

package/src/core/locale.ts

@@ -1,88 +1,88 @@
-/**
- * OS Locale Detection — cached per-process.
- *
- * Priority:
- *   0. ~/.afdrc config file (persistent user preference via `afd lang`)
- *   1. AFD_LANG env (explicit override per-session)
- *   2. LC_ALL / LANG / LANGUAGE env (user shell config, skip "C"/"POSIX")
- *   3. macOS AppleLocale (system preferences — solves LANG=C.UTF-8 on Korean macOS)
- *   4. Intl API (runtime default)
- *   5. Default: "ko"
- */
-
-import { execSync } from "child_process";
-import { readConfig } from "./config";
-
-export type SupportedLang = "en" | "ko";
-
-const SUPPORTED: SupportedLang[] = ["en", "ko"];
-
-let cached: SupportedLang | null = null;
-
-function isSupported(value: string): value is SupportedLang {
-  return SUPPORTED.includes(value as SupportedLang);
-}
-
-function matchKo(value: string): boolean {
-  return value.startsWith("ko");
-}
-
-/** Detect system language. Returns 'ko' or 'en'. */
-export function getSystemLanguage(): SupportedLang {
-  if (cached) return cached;
-
-  // 0. Persistent config (~/.afdrc)
-  const rc = readConfig();
-  if (rc.lang && isSupported(rc.lang)) {
-    cached = rc.lang as SupportedLang;
-    return cached;
-  }
-
-  // 1. Explicit env override
-  const afdLang = process.env.AFD_LANG ?? "";
-  if (isSupported(afdLang)) { cached = afdLang; return cached; }
-  if (matchKo(afdLang)) { cached = "ko"; return cached; }
-
-  // 2. Standard env — skip generic "C" / "POSIX"
-  const envLang = process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "";
-  if (envLang !== "" && !envLang.startsWith("C") && !envLang.startsWith("POSIX")) {
-    if (matchKo(envLang)) { cached = "ko"; return cached; }
-    cached = "en";
-    return cached;
-  }
-
-  // 3. macOS: AppleLocale
-  if (process.platform === "darwin") {
-    try {
-      const appleLocale = execSync("defaults read -g AppleLocale", {
-        encoding: "utf-8",
-        timeout: 500,
-      }).trim();
-      if (matchKo(appleLocale)) { cached = "ko"; return cached; }
-    } catch {
-      // Not macOS or defaults unavailable
-    }
-  }
-
-  // 4. Intl API fallback
-  try {
-    const intlLocale = Intl.DateTimeFormat().resolvedOptions().locale;
-    if (matchKo(intlLocale)) { cached = "ko"; return cached; }
-  } catch {
-    // Fallback to default
-  }
-
-  // 5. Default
-  cached = "ko";
-  return cached;
-}
-
-/** Get list of supported languages. */
-export function getSupportedLanguages(): SupportedLang[] {
-  return [...SUPPORTED];
-}
-
-/** Override locale (for testing or after `afd lang` write). */
-export function setLanguageOverride(lang: SupportedLang | null): void {
-  cached = lang;
-}
+/**
+ * OS Locale Detection — cached per-process.
+ *
+ * Priority:
+ *   0. ~/.afdrc config file (persistent user preference via `afd lang`)
+ *   1. AFD_LANG env (explicit override per-session)
+ *   2. LC_ALL / LANG / LANGUAGE env (user shell config, skip "C"/"POSIX")
+ *   3. macOS AppleLocale (system preferences — solves LANG=C.UTF-8 on Korean macOS)
+ *   4. Intl API (runtime default)
+ *   5. Default: "ko"
+ */
+
+import { execSync } from "child_process";
+import { readConfig } from "./config";
+
+export type SupportedLang = "en" | "ko";
+
+const SUPPORTED: SupportedLang[] = ["en", "ko"];
+
+let cached: SupportedLang | null = null;
+
+function isSupported(value: string): value is SupportedLang {
+  return SUPPORTED.includes(value as SupportedLang);
+}
+
+function matchKo(value: string): boolean {
+  return value.startsWith("ko");
+}
+
+/** Detect system language. Returns 'ko' or 'en'. */
+export function getSystemLanguage(): SupportedLang {
+  if (cached) return cached;
+
+  // 0. Persistent config (~/.afdrc)
+  const rc = readConfig();
+  if (rc.lang && isSupported(rc.lang)) {
+    cached = rc.lang as SupportedLang;
+    return cached;
+  }
+
+  // 1. Explicit env override
+  const afdLang = process.env.AFD_LANG ?? "";
+  if (isSupported(afdLang)) { cached = afdLang; return cached; }
+  if (matchKo(afdLang)) { cached = "ko"; return cached; }
+
+  // 2. Standard env — skip generic "C" / "POSIX"
+  const envLang = process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || "";
+  if (envLang !== "" && !envLang.startsWith("C") && !envLang.startsWith("POSIX")) {
+    if (matchKo(envLang)) { cached = "ko"; return cached; }
+    cached = "en";
+    return cached;
+  }
+
+  // 3. macOS: AppleLocale
+  if (process.platform === "darwin") {
+    try {
+      const appleLocale = execSync("defaults read -g AppleLocale", {
+        encoding: "utf-8",
+        timeout: 500,
+      }).trim();
+      if (matchKo(appleLocale)) { cached = "ko"; return cached; }
+    } catch {
+      // Not macOS or defaults unavailable
+    }
+  }
+
+  // 4. Intl API fallback
+  try {
+    const intlLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+    if (matchKo(intlLocale)) { cached = "ko"; return cached; }
+  } catch {
+    // Fallback to default
+  }
+
+  // 5. Default
+  cached = "ko";
+  return cached;
+}
+
+/** Get list of supported languages. */
+export function getSupportedLanguages(): SupportedLang[] {
+  return [...SUPPORTED];
+}
+
+/** Override locale (for testing or after `afd lang` write). */
+export function setLanguageOverride(lang: SupportedLang | null): void {
+  cached = lang;
+}

package/src/core/log-rotate.ts

@@ -0,0 +1,33 @@
+import { existsSync, statSync, renameSync, unlinkSync } from "fs";
+
+const MAX_LOG_SIZE = 5 * 1024 * 1024; // 5 MB
+const MAX_ROTATED_FILES = 3;           // daemon.log.1, .2, .3
+
+/**
+ * Rotate log file if it exceeds MAX_LOG_SIZE.
+ * Keeps up to MAX_ROTATED_FILES old logs.
+ *
+ * daemon.log → daemon.log.1 → daemon.log.2 → daemon.log.3 (deleted)
+ */
+export function rotateLogIfNeeded(logPath: string): void {
+  if (!existsSync(logPath)) return;
+
+  try {
+    const { size } = statSync(logPath);
+    if (size < MAX_LOG_SIZE) return;
+
+    // Shift existing rotated files: .3→delete, .2→.3, .1→.2
+    for (let i = MAX_ROTATED_FILES; i >= 1; i--) {
+      const src = i === 1 ? logPath : `${logPath}.${i - 1}`;
+      const dst = `${logPath}.${i}`;
+      if (!existsSync(src)) continue;
+      if (i === MAX_ROTATED_FILES && existsSync(dst)) {
+        unlinkSync(dst);
+      }
+      renameSync(src, dst);
+    }
+    // logPath has been renamed to logPath.1, fresh log will be created on open
+  } catch {
+    // Non-critical: if rotation fails, just keep appending
+  }
+}

package/src/core/log-utils.ts

@@ -0,0 +1,38 @@
+/**
+ * Logging utilities for the afd daemon.
+ * Extracted for testability and reuse.
+ */
+
+/** Format current time as HH:MM:SS.mmm */
+export function formatTimestamp(date: Date = new Date()): string {
+  const hh = String(date.getHours()).padStart(2, "0");
+  const mm = String(date.getMinutes()).padStart(2, "0");
+  const ss = String(date.getSeconds()).padStart(2, "0");
+  const ms = String(date.getMilliseconds()).padStart(3, "0");
+  return `${hh}:${mm}:${ss}.${ms}`;
+}
+
+/**
+ * Build a concise line-diff between old and new content.
+ * Returns at most `maxLines` diff entries (default 10).
+ */
+export function lineDiff(oldText: string, newText: string, maxLines = 10): string[] {
+  const oldLines = oldText.split("\n");
+  const newLines = newText.split("\n");
+  const diffs: string[] = [];
+  const maxLen = Math.max(oldLines.length, newLines.length);
+  for (let i = 0; i < maxLen; i++) {
+    if (oldLines[i] !== newLines[i]) {
+      const ln = i + 1;
+      if (i < oldLines.length && i < newLines.length) {
+        diffs.push(`  L${ln}: "${oldLines[i].trimEnd()}" → "${newLines[i].trimEnd()}"`);
+      } else if (i < oldLines.length) {
+        diffs.push(`  L${ln}: - "${oldLines[i].trimEnd()}"`);
+      } else {
+        diffs.push(`  L${ln}: + "${newLines[i]!.trimEnd()}"`);
+      }
+    }
+    if (diffs.length >= maxLines) { diffs.push("  ... (truncated)"); break; }
+  }
+  return diffs;
+}

package/src/core/lru-map.ts

@@ -0,0 +1,61 @@
+/**
+ * Size-bounded LRU Map that evicts by total byte size of values.
+ * Uses Map insertion order for LRU eviction (oldest first).
+ */
+export class LruStringMap {
+  private map = new Map<string, string>();
+  private currentBytes = 0;
+
+  constructor(private readonly maxBytes: number) {}
+
+  get(key: string): string | undefined {
+    const val = this.map.get(key);
+    if (val !== undefined) {
+      // Move to end (most recently used)
+      this.map.delete(key);
+      this.map.set(key, val);
+    }
+    return val;
+  }
+
+  /** Returns false if the value was too large to store (exceeds maxBytes). */
+  set(key: string, value: string): boolean {
+    const valueBytes = value.length * 2;
+
+    // Skip if single value exceeds budget (check BEFORE removing old entry)
+    if (valueBytes > this.maxBytes) return false;
+
+    // Remove old entry if exists
+    const old = this.map.get(key);
+    if (old !== undefined) {
+      this.currentBytes -= old.length * 2; // JS string ≈ 2 bytes per char
+      this.map.delete(key);
+    }
+
+    // Evict oldest entries until we have room
+    while (this.currentBytes + valueBytes > this.maxBytes && this.map.size > 0) {
+      const first = this.map.keys().next();
+      if (first.done) break;
+      const evicted = this.map.get(first.value)!;
+      this.currentBytes -= evicted.length * 2;
+      this.map.delete(first.value);
+    }
+
+    this.map.set(key, value);
+    this.currentBytes += valueBytes;
+    return true;
+  }
+
+  delete(key: string): boolean {
+    const val = this.map.get(key);
+    if (val !== undefined) {
+      this.currentBytes -= val.length * 2;
+      this.map.delete(key);
+      return true;
+    }
+    return false;
+  }
+
+  get size(): number { return this.map.size; }
+  get bytes(): number { return this.currentBytes; }
+}

package/src/core/notify.ts

@@ -1,66 +1,74 @@
-import { spawn } from "child_process";
-import { IS_WINDOWS, IS_MACOS } from "../platform";
-
-/**
- * Fire an OS-native toast notification.
- * Runs asynchronously, never blocks, silently ignores all errors.
- *
- * - Windows 10+: PowerShell BalloonTip
- * - macOS: osascript display notification
- * - Linux: notify-send (libnotify)
- */
-export function notifyAutoHeal(patternId: string): void {
-  const title = "\u{1F6E1}\uFE0F afd Auto-Healed";
-  const body = `Silently fixed: ${patternId}`;
-
-  try {
-    if (IS_WINDOWS) {
-      notifyWindows(title, body);
-    } else if (IS_MACOS) {
-      notifyMacOS(title, body);
-    } else {
-      notifyLinux(title, body);
-    }
-  } catch {
-    // Crash-only: silently ignore notification failures
-  }
-}
-
-function notifyWindows(title: string, body: string): void {
-  const ps = `
-    Add-Type -AssemblyName System.Windows.Forms
-    $n = New-Object System.Windows.Forms.NotifyIcon
-    $n.Icon = [System.Drawing.SystemIcons]::Shield
-    $n.BalloonTipTitle = '${title}'
-    $n.BalloonTipText = '${body}'
-    $n.BalloonTipIcon = 'Info'
-    $n.Visible = $true
-    $n.ShowBalloonTip(3000)
-    Start-Sleep -Milliseconds 3500
-    $n.Dispose()
-  `.replace(/\n\s*/g, " ");
-
-  const child = spawn("powershell", ["-NoProfile", "-NonInteractive", "-Command", ps], {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: true,
-  });
-  child.unref();
-}
-
-function notifyMacOS(title: string, body: string): void {
-  const script = `display notification "${body}" with title "${title}"`;
-  const child = spawn("osascript", ["-e", script], {
-    detached: true,
-    stdio: "ignore",
-  });
-  child.unref();
-}
-
-function notifyLinux(title: string, body: string): void {
-  const child = spawn("notify-send", [title, body, "--icon=dialog-information"], {
-    detached: true,
-    stdio: "ignore",
-  });
-  child.unref();
-}
+import { spawn } from "child_process";
+import { IS_WINDOWS, IS_MACOS } from "../platform";
+
+/**
+ * Fire an OS-native toast notification.
+ * Runs asynchronously, never blocks, silently ignores all errors.
+ *
+ * - Windows 10+: PowerShell BalloonTip
+ * - macOS: osascript display notification
+ * - Linux: notify-send (libnotify)
+ */
+export function notifyAutoHeal(patternId: string): void {
+  const title = "\u{1F6E1}\uFE0F afd Auto-Healed";
+  const body = `Silently fixed: ${patternId}`;
+
+  try {
+    if (IS_WINDOWS) {
+      notifyWindows(title, body);
+    } else if (IS_MACOS) {
+      notifyMacOS(title, body);
+    } else {
+      notifyLinux(title, body);
+    }
+  } catch {
+    // Crash-only: silently ignore notification failures
+  }
+}
+
+/** Escape single quotes for PowerShell string literals */
+function escapePS(s: string): string {
+  return s.replace(/'/g, "''");
+}
+
+/** Escape double quotes and backslashes for AppleScript string literals */
+function escapeAS(s: string): string {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+function safeSpawn(cmd: string, args: string[], opts: Record<string, unknown> = {}): void {
+  try {
+    const child = spawn(cmd, args, { detached: true, stdio: "ignore", ...opts });
+    child.on("error", () => {}); // Swallow async ENOENT when binary is missing
+    child.unref();
+  } catch {
+    // Binary not found or spawn failed — silently ignore
+  }
+}
+
+function notifyWindows(title: string, body: string): void {
+  const ps = `
+    Add-Type -AssemblyName System.Windows.Forms
+    $n = New-Object System.Windows.Forms.NotifyIcon
+    $n.Icon = [System.Drawing.SystemIcons]::Shield
+    $n.BalloonTipTitle = '${escapePS(title)}'
+    $n.BalloonTipText = '${escapePS(body)}'
+    $n.BalloonTipIcon = 'Info'
+    $n.Visible = $true
+    $n.ShowBalloonTip(3000)
+    Start-Sleep -Milliseconds 3500
+    $n.Dispose()
+  `.replace(/\n\s*/g, " ");
+
+  safeSpawn("powershell", ["-NoProfile", "-NonInteractive", "-Command", ps], { windowsHide: true });
+}
+
+function notifyMacOS(title: string, body: string): void {
+  const script = `display notification "${escapeAS(body)}" with title "${escapeAS(title)}"`;
+
+  safeSpawn("osascript", ["-e", script]);
+}
+
+function notifyLinux(title: string, body: string): void {
+  safeSpawn("notify-send", [title, body, "--icon=dialog-information"]);
+}