autonomous-flow-daemon 1.6.0 → 1.9.0

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

@@ -1,33 +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
-  }
-}
+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

@@ -1,38 +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;
-}
+/**
+ * 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

@@ -1,61 +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; }
-}
+/**
+ * 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,74 +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
-  }
-}
-
-/** 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"]);
-}
+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"]);
+}