@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/utils/chat-logger.js

@@ -0,0 +1,292 @@
+import { mkdir, writeFile, appendFile, readdir, readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+async function appendWithRetry(filePath, content, onRetry) {
+  try {
+    await appendFile(filePath, content, "utf-8");
+  } catch (appendError) {
+    if (appendError.code === "ENOENT") {
+      onRetry && await onRetry();
+      try {
+        await appendFile(filePath, content, "utf-8");
+      } catch (retryError) {
+        console.warn("[ChatLogger] WARNING: Could not append entry to chat log (non-fatal)"), console.warn("[ChatLogger]   Log path:", filePath), console.warn("[ChatLogger]   Error:", retryError), console.warn("[ChatLogger]   The chat session will continue, but this entry was not logged.");
+      }
+    } else
+      throw appendError;
+  }
+}
+class ChatLogger {
+  sessionId;
+  sessionStartTime;
+  sessionLogPath;
+  logDir;
+  projectRoot;
+  headerWritten = !1;
+  headerWritePromise = null;
+  /**
+   * Creates a new ChatLogger instance
+   * @param projectRoot Optional project root for relative path resolution
+   */
+  constructor(projectRoot) {
+    this.sessionId = randomUUID(), this.sessionStartTime = this.getTimestamp(), this.projectRoot = projectRoot, this.logDir = this.getLogDirectory();
+    const filenameSafeTimestamp = this.sessionStartTime.replace(/:/g, "_");
+    this.sessionLogPath = join(this.logDir, `${filenameSafeTimestamp}_${this.sessionId}.log`);
+  }
+  /**
+   * Get the log directory path
+   * Prefers .dr/chat/sessions/ in project root, falls back to ~/.dr/chat/sessions/
+   */
+  getLogDirectory() {
+    return this.projectRoot && existsSync(this.projectRoot) ? join(this.projectRoot, ".dr", "chat", "sessions") : join(homedir(), ".dr", "chat", "sessions");
+  }
+  /**
+   * Get current ISO timestamp with milliseconds
+   */
+  getTimestamp() {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  /**
+   * Get session ID
+   */
+  getSessionId() {
+    return this.sessionId;
+  }
+  /**
+   * Get session log file path
+   */
+  getSessionLogPath() {
+    return this.sessionLogPath;
+  }
+  /**
+   * Ensure log directory exists
+   */
+  async ensureLogDirectory() {
+    try {
+      await mkdir(this.logDir, { recursive: !0 });
+    } catch (error) {
+      if (error instanceof Error && !error.message.includes("EEXIST"))
+        throw error;
+    }
+  }
+  /**
+   * Format a log entry as JSON
+   */
+  formatEntry(entry) {
+    return JSON.stringify(entry) + `
+`;
+  }
+  /**
+   * Log a user message
+   * @param message The user message content
+   * @param metadata Optional metadata
+   */
+  async logUserMessage(message, metadata) {
+    const entry = {
+      timestamp: this.getTimestamp(),
+      type: "message",
+      role: "user",
+      content: message,
+      metadata
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log an assistant/AI response
+   * @param content The response content
+   * @param metadata Optional metadata
+   */
+  async logAssistantMessage(content, metadata) {
+    const entry = {
+      timestamp: this.getTimestamp(),
+      type: "message",
+      role: "assistant",
+      content,
+      metadata
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log a command being sent to the CLI
+   * @param command Command name (e.g., "gh copilot explain")
+   * @param args Command arguments
+   * @param metadata Optional metadata
+   */
+  async logCommand(command, args = [], metadata) {
+    const content = [command, ...args].join(" "), entry = {
+      timestamp: this.getTimestamp(),
+      type: "command",
+      role: "cli",
+      content,
+      metadata: {
+        ...metadata,
+        command,
+        args
+      }
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log an error
+   * @param errorMessage The error message
+   * @param metadata Optional metadata including error details
+   */
+  async logError(errorMessage, metadata) {
+    const entry = {
+      timestamp: this.getTimestamp(),
+      type: "error",
+      role: "system",
+      content: errorMessage,
+      metadata
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Log an event (initialization, session start, etc.)
+   * @param eventName Event name
+   * @param metadata Optional metadata
+   */
+  async logEvent(eventName, metadata) {
+    const entry = {
+      timestamp: this.getTimestamp(),
+      type: "event",
+      role: "system",
+      content: eventName,
+      metadata
+    };
+    await this.writeEntry(entry);
+  }
+  /**
+   * Ensure header is written exactly once, even with concurrent calls
+   */
+  async ensureHeaderWritten() {
+    if (!this.headerWritten) {
+      if (this.headerWritePromise) {
+        await this.headerWritePromise;
+        return;
+      }
+      this.headerWritePromise = this.writeHeader(), await this.headerWritePromise, this.headerWritePromise = null;
+    }
+  }
+  /**
+   * Write the session header to the log file
+   */
+  async writeHeader() {
+    const header = {
+      timestamp: this.sessionStartTime,
+      type: "event",
+      role: "system",
+      content: "Session started",
+      metadata: {
+        sessionId: this.sessionId,
+        logVersion: "1.0"
+      }
+    };
+    try {
+      await writeFile(this.sessionLogPath, this.formatEntry(header), "utf-8"), this.headerWritten = !0;
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        await this.ensureLogDirectory();
+        try {
+          await writeFile(this.sessionLogPath, this.formatEntry(header), "utf-8"), this.headerWritten = !0;
+        } catch (retryError) {
+          throw retryError;
+        }
+      } else
+        throw error;
+    }
+  }
+  /**
+   * Write an entry to the log file
+   */
+  async writeEntry(entry) {
+    try {
+      await this.ensureLogDirectory(), await this.ensureHeaderWritten(), await appendWithRetry(this.sessionLogPath, this.formatEntry(entry), async () => {
+        await this.ensureLogDirectory(), this.headerWritten = !1, await this.ensureHeaderWritten();
+      });
+    } catch (error) {
+      const errno = error.code;
+      errno === "EACCES" ? (console.error("[ChatLogger] ERROR: Permission denied writing to log file:", this.sessionLogPath), console.error("[ChatLogger]   Session logging disabled for this session.")) : errno === "ENOSPC" ? console.error("[ChatLogger] ERROR: Disk full, cannot write to log file:", this.sessionLogPath) : (console.error("[ChatLogger] CRITICAL: Unexpected error writing to log file:", error), console.error("[ChatLogger]   Session ID:", this.sessionId), console.error("[ChatLogger]   Log path:", this.sessionLogPath), console.error("[ChatLogger]   This is a bug - please report with error details above."));
+    }
+  }
+  /**
+   * Read all entries from the session log.
+   * Parses lines individually to preserve valid entries when one line is corrupt.
+   */
+  async readEntries() {
+    try {
+      const content = await readFile(this.sessionLogPath, "utf-8"), entries = [];
+      for (const line of content.split(`
+`)) {
+        const trimmed = line.trim();
+        if (trimmed)
+          try {
+            entries.push(JSON.parse(trimmed));
+          } catch (parseError) {
+            console.warn("[ChatLogger] Skipping corrupt JSON line in session log:", parseError instanceof Error ? parseError.message : String(parseError));
+          }
+      }
+      return entries;
+    } catch (fileError) {
+      return fileError.code !== "ENOENT" && console.warn("[ChatLogger] Warning: Could not read log file:", fileError), [];
+    }
+  }
+  /**
+   * Get summary of the session
+   */
+  async getSummary() {
+    const entries = await this.readEntries(), messageCount = entries.filter((e) => e.type === "message" && e.role === "user").length, commandCount = entries.filter((e) => e.type === "command").length, errorCount = entries.filter((e) => e.type === "error").length;
+    let duration = "N/A";
+    if (entries.length > 1) {
+      const first = new Date(entries[0].timestamp), ms = new Date(entries[entries.length - 1].timestamp).getTime() - first.getTime(), seconds = Math.floor(ms / 1e3), minutes = Math.floor(seconds / 60), secs = seconds % 60;
+      minutes > 0 ? duration = `${minutes}m ${secs}s` : duration = `${secs}s`;
+    }
+    return {
+      sessionId: this.sessionId,
+      messageCount,
+      commandCount,
+      errorCount,
+      duration
+    };
+  }
+}
+let globalChatLogger;
+function initializeChatLogger(projectRoot) {
+  return globalChatLogger = new ChatLogger(projectRoot), globalChatLogger;
+}
+function getChatLogger() {
+  return globalChatLogger;
+}
+function resetGlobalChatLogger() {
+  globalChatLogger = void 0;
+}
+async function listChatSessions(projectRoot) {
+  const logDir = new ChatLogger(projectRoot).getLogDirectory();
+  try {
+    return (await readdir(logDir)).filter((f) => f.endsWith(".log")).sort().reverse();
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return [];
+    throw error;
+  }
+}
+async function readChatSession(logFile, projectRoot) {
+  const logDir = new ChatLogger(projectRoot).getLogDirectory(), logPath = join(logDir, logFile);
+  try {
+    return (await readFile(logPath, "utf-8")).split(`
+`).filter((line) => line.trim()).map((line) => JSON.parse(line));
+  } catch (error) {
+    throw console.error("Error reading chat session:", error), error;
+  }
+}
+export {
+  ChatLogger,
+  getChatLogger,
+  initializeChatLogger,
+  listChatSessions,
+  readChatSession,
+  resetGlobalChatLogger
+};
+//# sourceMappingURL=chat-logger.js.map

package/dist/utils/chat-logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/chat-logger.ts"],
+  "sourcesContent": ["/**\n * Chat Logger Utility\n *\n * Provides universal logging for all chat messages and commands.\n * Stores logs in .dr/chat/sessions/ with one file per session.\n * Filenames include both timestamp and session ID for chronological ordering.\n *\n * Log format:\n * - Session file: .dr/chat/sessions/{timestamp}_{sessionId}.log\n * - Timestamp comes first for natural sorting (most recent first)\n * - Timestamp format: ISO 8601 with colons replaced by underscores for filesystem compatibility\n * - Each entry contains: timestamp, type (message/command/error), role, content\n */\n\nimport { mkdir, writeFile, appendFile, readdir, readFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\n\n/**\n * Helper to append content to file with automatic retry on ENOENT\n *\n * When appending to a file, a race condition can occur where the file\n * or directory is deleted between the initial write and the append.\n * This helper handles ENOENT by recreating the directory and file with header.\n *\n * @param filePath Path to file to append to\n * @param content Content to append\n * @param onRetry Callback to prepare file (e.g., write header) before retry\n * @throws Error if append fails for non-ENOENT reasons\n */\nasync function appendWithRetry(\n  filePath: string,\n  content: string,\n  onRetry?: () => Promise<void>\n): Promise<void> {\n  try {\n    await appendFile(filePath, content, \"utf-8\");\n  } catch (appendError) {\n    const errno = (appendError as NodeJS.ErrnoException).code;\n    if (errno === \"ENOENT\") {\n      // File doesn't exist - race condition where directory/file was deleted\n      // Call retry callback (e.g., to recreate directory and file with header)\n      if (onRetry) {\n        await onRetry();\n      }\n      // Retry the append\n      try {\n        await appendFile(filePath, content, \"utf-8\");\n      } catch (retryError) {\n        // Retry failed - this is a real problem\n        console.warn(\"[ChatLogger] WARNING: Could not append entry to chat log (non-fatal)\");\n        console.warn(\"[ChatLogger]   Log path:\", filePath);\n        console.warn(\"[ChatLogger]   Error:\", retryError);\n        console.warn(\n          \"[ChatLogger]   The chat session will continue, but this entry was not logged.\"\n        );\n        // Intentional: Continue without logging rather than crash the entire session.\n        // The chat log is best-effort; we don't want logging failures to break the user's work.\n      }\n    } else {\n      // Rethrow non-ENOENT errors to outer handler\n      throw appendError;\n    }\n  }\n}\n\n/**\n * Chat log entry types\n */\nexport type ChatLogEntryType = \"message\" | \"command\" | \"error\" | \"event\";\n\n/**\n * A single chat log entry\n */\nexport interface ChatLogEntry {\n  timestamp: string;\n  type: ChatLogEntryType;\n  role?: \"user\" | \"assistant\" | \"system\" | \"cli\";\n  content: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Chat Logger class\n *\n * Manages logging of chat sessions and messages\n */\nexport class ChatLogger {\n  private sessionId: string;\n  private sessionStartTime: string;\n  private sessionLogPath: string;\n  private logDir: string;\n  private projectRoot?: string;\n  private headerWritten = false;\n  private headerWritePromise: Promise<void> | null = null;\n\n  /**\n   * Creates a new ChatLogger instance\n   * @param projectRoot Optional project root for relative path resolution\n   */\n  constructor(projectRoot?: string) {\n    this.sessionId = randomUUID();\n    this.sessionStartTime = this.getTimestamp();\n    this.projectRoot = projectRoot;\n    this.logDir = this.getLogDirectory();\n    // Timestamp first for natural sorting, replace colons with underscores for filesystem compatibility\n    const filenameSafeTimestamp = this.sessionStartTime.replace(/:/g, \"_\");\n    this.sessionLogPath = join(this.logDir, `${filenameSafeTimestamp}_${this.sessionId}.log`);\n  }\n\n  /**\n   * Get the log directory path\n   * Prefers .dr/chat/sessions/ in project root, falls back to ~/.dr/chat/sessions/\n   */\n  getLogDirectory(): string {\n    if (this.projectRoot && existsSync(this.projectRoot)) {\n      const projectLogDir = join(this.projectRoot, \".dr\", \"chat\", \"sessions\");\n      return projectLogDir;\n    }\n\n    // Fall back to home directory\n    return join(homedir(), \".dr\", \"chat\", \"sessions\");\n  }\n\n  /**\n   * Get current ISO timestamp with milliseconds\n   */\n  private getTimestamp(): string {\n    return new Date().toISOString();\n  }\n\n  /**\n   * Get session ID\n   */\n  getSessionId(): string {\n    return this.sessionId;\n  }\n\n  /**\n   * Get session log file path\n   */\n  getSessionLogPath(): string {\n    return this.sessionLogPath;\n  }\n\n  /**\n   * Ensure log directory exists\n   */\n  async ensureLogDirectory(): Promise<void> {\n    try {\n      await mkdir(this.logDir, { recursive: true });\n    } catch (error) {\n      if (error instanceof Error && !error.message.includes(\"EEXIST\")) {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Format a log entry as JSON\n   */\n  private formatEntry(entry: ChatLogEntry): string {\n    return JSON.stringify(entry) + \"\\n\";\n  }\n\n  /**\n   * Log a user message\n   * @param message The user message content\n   * @param metadata Optional metadata\n   */\n  async logUserMessage(message: string, metadata?: Record<string, unknown>): Promise<void> {\n    const entry: ChatLogEntry = {\n      timestamp: this.getTimestamp(),\n      type: \"message\",\n      role: \"user\",\n      content: message,\n      metadata,\n    };\n\n    await this.writeEntry(entry);\n  }\n\n  /**\n   * Log an assistant/AI response\n   * @param content The response content\n   * @param metadata Optional metadata\n   */\n  async logAssistantMessage(content: string, metadata?: Record<string, unknown>): Promise<void> {\n    const entry: ChatLogEntry = {\n      timestamp: this.getTimestamp(),\n      type: \"message\",\n      role: \"assistant\",\n      content,\n      metadata,\n    };\n\n    await this.writeEntry(entry);\n  }\n\n  /**\n   * Log a command being sent to the CLI\n   * @param command Command name (e.g., \"gh copilot explain\")\n   * @param args Command arguments\n   * @param metadata Optional metadata\n   */\n  async logCommand(\n    command: string,\n    args: string[] = [],\n    metadata?: Record<string, unknown>\n  ): Promise<void> {\n    const content = [command, ...args].join(\" \");\n\n    const entry: ChatLogEntry = {\n      timestamp: this.getTimestamp(),\n      type: \"command\",\n      role: \"cli\",\n      content,\n      metadata: {\n        ...metadata,\n        command,\n        args,\n      },\n    };\n\n    await this.writeEntry(entry);\n  }\n\n  /**\n   * Log an error\n   * @param errorMessage The error message\n   * @param metadata Optional metadata including error details\n   */\n  async logError(errorMessage: string, metadata?: Record<string, unknown>): Promise<void> {\n    const entry: ChatLogEntry = {\n      timestamp: this.getTimestamp(),\n      type: \"error\",\n      role: \"system\",\n      content: errorMessage,\n      metadata,\n    };\n\n    await this.writeEntry(entry);\n  }\n\n  /**\n   * Log an event (initialization, session start, etc.)\n   * @param eventName Event name\n   * @param metadata Optional metadata\n   */\n  async logEvent(eventName: string, metadata?: Record<string, unknown>): Promise<void> {\n    const entry: ChatLogEntry = {\n      timestamp: this.getTimestamp(),\n      type: \"event\",\n      role: \"system\",\n      content: eventName,\n      metadata,\n    };\n\n    await this.writeEntry(entry);\n  }\n\n  /**\n   * Ensure header is written exactly once, even with concurrent calls\n   */\n  private async ensureHeaderWritten(): Promise<void> {\n    // If header is already written, return immediately\n    if (this.headerWritten) {\n      return;\n    }\n\n    // If a write is in progress, wait for it\n    if (this.headerWritePromise) {\n      await this.headerWritePromise;\n      return;\n    }\n\n    // Start the write and store the promise\n    this.headerWritePromise = this.writeHeader();\n    await this.headerWritePromise;\n    this.headerWritePromise = null;\n  }\n\n  /**\n   * Write the session header to the log file\n   */\n  private async writeHeader(): Promise<void> {\n    const header: ChatLogEntry = {\n      timestamp: this.sessionStartTime,\n      type: \"event\",\n      role: \"system\",\n      content: \"Session started\",\n      metadata: {\n        sessionId: this.sessionId,\n        logVersion: \"1.0\",\n      },\n    };\n\n    try {\n      await writeFile(this.sessionLogPath, this.formatEntry(header), \"utf-8\");\n      this.headerWritten = true;\n    } catch (error) {\n      const errno = (error as NodeJS.ErrnoException).code;\n      if (errno === \"ENOENT\") {\n        // Directory doesn't exist - create it and retry\n        await this.ensureLogDirectory();\n        try {\n          await writeFile(this.sessionLogPath, this.formatEntry(header), \"utf-8\");\n          this.headerWritten = true;\n        } catch (retryError) {\n          throw retryError;\n        }\n      } else {\n        // Permissions, disk full, or other error\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Write an entry to the log file\n   */\n  private async writeEntry(entry: ChatLogEntry): Promise<void> {\n    try {\n      await this.ensureLogDirectory();\n      await this.ensureHeaderWritten();\n\n      // Append the entry with automatic retry on ENOENT race condition\n      await appendWithRetry(this.sessionLogPath, this.formatEntry(entry), async () => {\n        // On ENOENT, recreate directory and header before retrying append\n        await this.ensureLogDirectory();\n        this.headerWritten = false;\n        await this.ensureHeaderWritten();\n      });\n    } catch (error) {\n      const errno = (error as NodeJS.ErrnoException).code;\n\n      // Distinguish between expected issues (permissions, disk full) and unexpected bugs\n      if (errno === \"EACCES\") {\n        // Permissions issue - warn but continue (can't fix at runtime)\n        console.error(\n          \"[ChatLogger] ERROR: Permission denied writing to log file:\",\n          this.sessionLogPath\n        );\n        console.error(\"[ChatLogger]   Session logging disabled for this session.\");\n      } else if (errno === \"ENOSPC\") {\n        // Disk full - warn but continue\n        console.error(\n          \"[ChatLogger] ERROR: Disk full, cannot write to log file:\",\n          this.sessionLogPath\n        );\n      } else {\n        // Unexpected error - this is a bug that should be reported\n        console.error(\"[ChatLogger] CRITICAL: Unexpected error writing to log file:\", error);\n        console.error(\"[ChatLogger]   Session ID:\", this.sessionId);\n        console.error(\"[ChatLogger]   Log path:\", this.sessionLogPath);\n        console.error(\"[ChatLogger]   This is a bug - please report with error details above.\");\n      }\n    }\n  }\n\n  /**\n   * Read all entries from the session log.\n   * Parses lines individually to preserve valid entries when one line is corrupt.\n   */\n  async readEntries(): Promise<ChatLogEntry[]> {\n    try {\n      const content = await readFile(this.sessionLogPath, \"utf-8\");\n      const entries: ChatLogEntry[] = [];\n\n      for (const line of content.split(\"\\n\")) {\n        const trimmed = line.trim();\n        if (!trimmed) continue;\n\n        try {\n          entries.push(JSON.parse(trimmed) as ChatLogEntry);\n        } catch (parseError) {\n          // Skip corrupt lines but continue parsing remaining entries\n          console.warn(\n            \"[ChatLogger] Skipping corrupt JSON line in session log:\",\n            parseError instanceof Error ? parseError.message : String(parseError)\n          );\n          // Continue to next line instead of failing entire read\n        }\n      }\n\n      return entries;\n    } catch (fileError) {\n      // ENOENT is expected when session log hasn't been created yet - don't warn\n      if ((fileError as NodeJS.ErrnoException).code !== \"ENOENT\") {\n        console.warn(\"[ChatLogger] Warning: Could not read log file:\", fileError);\n      }\n      // Return empty array on file read errors but preserve any entries that were successfully parsed\n      return [];\n    }\n  }\n\n  /**\n   * Get summary of the session\n   */\n  async getSummary(): Promise<{\n    sessionId: string;\n    messageCount: number;\n    commandCount: number;\n    errorCount: number;\n    duration: string;\n  }> {\n    const entries = await this.readEntries();\n\n    const messageCount = entries.filter((e) => e.type === \"message\" && e.role === \"user\").length;\n    const commandCount = entries.filter((e) => e.type === \"command\").length;\n    const errorCount = entries.filter((e) => e.type === \"error\").length;\n\n    // Calculate duration from first to last entry\n    let duration = \"N/A\";\n    if (entries.length > 1) {\n      const first = new Date(entries[0].timestamp);\n      const last = new Date(entries[entries.length - 1].timestamp);\n      const ms = last.getTime() - first.getTime();\n      const seconds = Math.floor(ms / 1000);\n      const minutes = Math.floor(seconds / 60);\n      const secs = seconds % 60;\n\n      if (minutes > 0) {\n        duration = `${minutes}m ${secs}s`;\n      } else {\n        duration = `${secs}s`;\n      }\n    }\n\n    return {\n      sessionId: this.sessionId,\n      messageCount,\n      commandCount,\n      errorCount,\n      duration,\n    };\n  }\n}\n\n/**\n * Global chat logger instance or undefined\n */\nlet globalChatLogger: ChatLogger | undefined;\n\n/**\n * Initialize global chat logger\n * @param projectRoot Optional project root\n * @returns The initialized ChatLogger instance\n */\nexport function initializeChatLogger(projectRoot?: string): ChatLogger {\n  globalChatLogger = new ChatLogger(projectRoot);\n  return globalChatLogger;\n}\n\n/**\n * Get the global chat logger instance\n * @returns The global ChatLogger instance or undefined if not initialized\n */\nexport function getChatLogger(): ChatLogger | undefined {\n  return globalChatLogger;\n}\n\n/**\n * Reset the global chat logger (for testing purposes)\n */\nexport function resetGlobalChatLogger(): void {\n  globalChatLogger = undefined;\n}\n\n/**\n * List all chat session logs\n * @param projectRoot Optional project root for relative path resolution\n */\nexport async function listChatSessions(projectRoot?: string): Promise<string[]> {\n  const logger = new ChatLogger(projectRoot);\n  const logDir = logger.getLogDirectory();\n\n  try {\n    const files = await readdir(logDir);\n    return files\n      .filter((f) => f.endsWith(\".log\"))\n      .sort()\n      .reverse();\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return [];\n    }\n    throw error;\n  }\n}\n\n/**\n * Read a specific chat session\n * @param logFile The log filename\n * @param projectRoot Optional project root\n */\nexport async function readChatSession(\n  logFile: string,\n  projectRoot?: string\n): Promise<ChatLogEntry[]> {\n  const logger = new ChatLogger(projectRoot);\n  const logDir = logger.getLogDirectory();\n  const logPath = join(logDir, logFile);\n\n  try {\n    const content = await readFile(logPath, \"utf-8\");\n    return content\n      .split(\"\\n\")\n      .filter((line) => line.trim())\n      .map((line) => JSON.parse(line) as ChatLogEntry);\n  } catch (error) {\n    console.error(\"Error reading chat session:\", error);\n    throw error;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/claude-stream.js

@@ -0,0 +1,8 @@
+import { ClaudeCodeClient } from "../coding-agents/claude-code-client.js";
+async function invokeClaudeStreaming(prompt) {
+  return await new ClaudeCodeClient().sendMessage(prompt, { withDanger: !1 });
+}
+export {
+  invokeClaudeStreaming
+};
+//# sourceMappingURL=claude-stream.js.map

package/dist/utils/claude-stream.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/claude-stream.ts"],
+  "sourcesContent": ["import { ClaudeCodeClient } from \"../coding-agents/claude-code-client.js\"\n\n/**\n * Invoke Claude Code CLI in non-interactive print mode, relaying text and\n * tool-use events to stdout in real-time, and returning the complete response\n * text for parsing.\n *\n * Delegates entirely to ClaudeCodeClient.sendMessage(), which handles:\n * - Prompt delivery via stdin (handles long prompts)\n * - stream-json event parsing\n * - Real-time tool-use and text output to process.stdout\n * - Complete response capture for the caller to parse\n *\n * @param prompt - The prompt to send to Claude via stdin\n * @returns The complete response text, ready for parsing\n */\nexport async function invokeClaudeStreaming(\n  prompt: string,\n): Promise<string> {\n  const client = new ClaudeCodeClient()\n\n  return await client.sendMessage(prompt, { withDanger: false })\n}\n"],
+  "mappings": "AAAA,SAAS,wBAAwB;AAgBjC,eAAsB,sBACpB,QAAc;AAId,SAAO,MAFQ,IAAI,iBAAgB,EAEf,YAAY,QAAQ,EAAE,YAAY,GAAK,CAAE;AAC/D;",
+  "names": []
+}

package/dist/utils/date-utils.js

@@ -0,0 +1,7 @@
+function formatDate(timestamp) {
+  return new Date(timestamp).toISOString().replace("T", " ").slice(0, 19);
+}
+export {
+  formatDate
+};
+//# sourceMappingURL=date-utils.js.map

package/dist/utils/date-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/date-utils.ts"],
+  "sourcesContent": ["/**\n * Date utility functions\n */\n\n/**\n * Formats a timestamp as a human-readable date string\n * @param timestamp ISO 8601 timestamp string\n * @returns Formatted date string in format \"YYYY-MM-DD HH:MM:SS\"\n */\nexport function formatDate(timestamp: string): string {\n    return new Date(timestamp).toISOString().replace(\"T\", \" \").slice(0, 19);\n}\n"],
+  "mappings": "AASM,SAAU,WAAW,WAAiB;AACxC,SAAO,IAAI,KAAK,SAAS,EAAE,YAAW,EAAG,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC1E;",
+  "names": []
+}

package/dist/utils/element-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/element-utils.ts"],
-  "sourcesContent": ["/**\n * Element utility functions shared across commands\n */\n\nimport { Model } from '../core/model.js';\n\n/**\n * Find which layer contains an element by ID\n */\nexport async function findElementLayer(\n  model: Model,\n  elementId: string\n): Promise<string | undefined> {\n  for (const layerName of model.getLayerNames()) {\n    const layer = await model.getLayer(layerName);\n    if (layer && layer.getElement(elementId)) {\n      return layerName;\n    }\n  }\n  return undefined;\n}\n"],
+  "sourcesContent": ["/**\n * Element utility functions shared across commands\n */\n\nimport { Model } from \"../core/model.js\";\n\n/**\n * Find which layer contains an element by ID\n */\nexport async function findElementLayer(\n  model: Model,\n  elementId: string\n): Promise<string | undefined> {\n  for (const layerName of model.getLayerNames()) {\n    const layer = await model.getLayer(layerName);\n    if (layer && layer.getElement(elementId)) {\n      return layerName;\n    }\n  }\n  return undefined;\n}\n"],
   "mappings": "AASA,eAAsB,iBACpB,OACA,WAAiB;AAEjB,aAAW,aAAa,MAAM,cAAa,GAAI;AAC7C,UAAM,QAAQ,MAAM,MAAM,SAAS,SAAS;AAC5C,QAAI,SAAS,MAAM,WAAW,SAAS;AACrC,aAAO;EAEX;AAEF;",
   "names": []
 }

package/dist/utils/errors.js

@@ -1,13 +1,29 @@
 import ansis from "ansis";
+const MAX_SUGGESTIONS = 5;
+var ErrorCategory;
+(function(ErrorCategory2) {
+  ErrorCategory2[ErrorCategory2.USER = 1] = "USER", ErrorCategory2[ErrorCategory2.NOT_FOUND = 2] = "NOT_FOUND", ErrorCategory2[ErrorCategory2.SYSTEM = 3] = "SYSTEM", ErrorCategory2[ErrorCategory2.VALIDATION = 4] = "VALIDATION", ErrorCategory2[ErrorCategory2.BREAKING_CHANGE = 5] = "BREAKING_CHANGE";
+})(ErrorCategory || (ErrorCategory = {}));
 class CLIError extends Error {
   exitCode;
   suggestions;
-  constructor(message, exitCode = 1, suggestions) {
-    super(message), this.exitCode = exitCode, this.suggestions = suggestions, this.name = "CLIError";
+  context;
+  constructor(message, exitCode = ErrorCategory.USER, suggestions, context) {
+    super(message), this.exitCode = exitCode, this.suggestions = suggestions, this.context = context, this.name = "CLIError";
   }
   format() {
     const lines = [];
-    if (lines.push(ansis.red(`Error: ${this.message}`)), this.suggestions && this.suggestions.length > 0) {
+    if (lines.push(ansis.red(`Error: ${this.message}`)), this.context?.operation && lines.push(ansis.dim(`During: ${this.context.operation}`)), this.context?.partialProgress) {
+      const { completed, total } = this.context.partialProgress;
+      lines.push(ansis.yellow(`\u26A0 Partial progress: ${completed}/${total} completed (operation rolled back)`));
+    }
+    if (this.context?.relatedElements && this.context.relatedElements.length > 0) {
+      lines.push(ansis.dim("Related elements:"));
+      for (const elem of this.context.relatedElements.slice(0, MAX_SUGGESTIONS))
+        lines.push(ansis.dim(`  \u2022 ${elem}`));
+      this.context.relatedElements.length > MAX_SUGGESTIONS && lines.push(ansis.dim(`  ... and ${this.context.relatedElements.length - MAX_SUGGESTIONS} more`));
+    }
+    if (this.suggestions && this.suggestions.length > 0) {
       lines.push(""), lines.push(ansis.dim("Suggestions:"));
       for (const suggestion of this.suggestions)
         lines.push(ansis.dim(`  \u2022 ${suggestion}`));
@@ -18,16 +34,28 @@ class CLIError extends Error {
 }
 class ValidationError extends CLIError {
   errors;
-  constructor(message, errors = [], suggestions) {
-    super(message, 1, suggestions), this.errors = errors, this.name = "ValidationError";
+  constructor(message, errors = [], suggestions, context) {
+    super(message, ErrorCategory.VALIDATION, suggestions, context), this.errors = errors, this.name = "ValidationError";
   }
   format() {
     const lines = [];
     if (lines.push(ansis.red(`Error: ${this.message}`)), this.errors.length > 0) {
-      lines.push(""), lines.push(ansis.dim("Details:"));
+      const errorsByLayer = {};
       for (const error of this.errors) {
-        let detail = "";
-        error.layer && error.elementId ? detail = `  [${error.layer}:${error.elementId}] ${error.message}` : error.layer ? detail = `  [${error.layer}] ${error.message}` : detail = `  ${error.message}`, lines.push(ansis.dim(detail));
+        const layer = error.layer || "general";
+        errorsByLayer[layer] || (errorsByLayer[layer] = []), errorsByLayer[layer].push({ elementId: error.elementId, message: error.message });
+      }
+      lines.push(""), lines.push(ansis.dim(`Validation errors: ${this.errors.length} found`)), lines.push("");
+      const layerNames = Object.keys(errorsByLayer).sort();
+      for (const layer of layerNames) {
+        const layerErrors = errorsByLayer[layer];
+        lines.push(ansis.dim(`  [${layer}] ${layerErrors.length} error(s):`));
+        for (let i = 0; i < Math.min(layerErrors.length, MAX_SUGGESTIONS); i++) {
+          const error = layerErrors[i];
+          let detail = "";
+          error.elementId ? detail = `    ${error.elementId}: ${error.message}` : detail = `    ${error.message}`, lines.push(ansis.dim(detail));
+        }
+        layerErrors.length > MAX_SUGGESTIONS && lines.push(ansis.dim(`    ... and ${layerErrors.length - MAX_SUGGESTIONS} more in this layer`));
       }
     }
     if (this.suggestions && this.suggestions.length > 0) {
@@ -42,7 +70,7 @@ class ValidationError extends CLIError {
 class FileNotFoundError extends CLIError {
   constructor(path, context) {
     const message = context ? `${context}: ${path}` : `File not found: ${path}`;
-    super(message, 2, [
+    super(message, ErrorCategory.NOT_FOUND, [
       `Check that the path is correct: ${path}`,
       'Use "dr init" to create a new model',
       'Use "dr list <layer>" to see available elements'
@@ -51,30 +79,33 @@ class FileNotFoundError extends CLIError {
 }
 class ElementNotFoundError extends CLIError {
   constructor(elementId) {
-    super(`Element not found: ${elementId}`, 2, [
+    super(`Element not found: ${elementId}`, ErrorCategory.NOT_FOUND, [
       `Use "dr search ${elementId}" to find similar elements`,
       'Use "dr list <layer>" to list all elements in a layer',
-      "Check the element ID format: {layer}-{type}-{kebab-case-name}"
+      "Check the element ID format: {layer}.{type}.{kebab-case-name}"
     ]), this.name = "ElementNotFoundError";
   }
 }
 class ModelNotFoundError extends CLIError {
   constructor(rootPath = ".") {
-    super(`No model found at ${rootPath}`, 2, ['Run "dr init" to initialize a new model', "Check that you are in the correct directory"]), this.name = "ModelNotFoundError";
+    super(`No model found at ${rootPath}`, ErrorCategory.NOT_FOUND, [
+      'Run "dr init" to initialize a new model',
+      "Check that you are in the correct directory"
+    ]), this.name = "ModelNotFoundError";
   }
 }
 class InvalidJSONError extends CLIError {
   constructor(input, context) {
     const message = context ? `Invalid JSON in ${context}` : "Invalid JSON format";
-    super(message, 1, [
+    super(message, ErrorCategory.USER, [
       `Check your JSON syntax: ${input}`,
-      `Use single quotes to wrap JSON: --properties '{"key":"value"}'`,
+      `Use single quotes to wrap JSON: --attributes '{"key":"value"}'`,
       "Escape special characters properly"
     ]), this.name = "InvalidJSONError";
   }
 }
 function handleError(error) {
-  error instanceof CLIError ? (console.error(error.format()), process.exit(error.exitCode)) : error instanceof Error ? (console.error(ansis.red(`Error: ${error.message}`)), process.env.DEBUG && console.error(ansis.dim(error.stack)), process.exit(1)) : (console.error(ansis.red("An unexpected error occurred")), process.env.DEBUG && console.error(ansis.dim(String(error))), process.exit(1));
+  throw error instanceof CLIError ? (console.error(error.format()), error) : error instanceof Error ? (console.error(ansis.red(`Error: ${error.message}`)), process.env.DEBUG && console.error(ansis.dim(error.stack)), error) : (console.error(ansis.red("An unexpected error occurred")), process.env.DEBUG && console.error(ansis.dim(String(error))), new Error(String(error)));
 }
 function handleWarning(message, suggestions) {
   const lines = [];
@@ -91,13 +122,55 @@ function handleSuccess(message, details) {
     for (const [key, value] of Object.entries(details))
       console.log(ansis.dim(`  ${key}: ${value}`));
 }
+function formatValidOptions(options, heading = "Valid options") {
+  return options.length === 0 ? "" : options.length === 1 ? `${heading}: ${options[0]}` : `${heading}: ${options.slice(0, -1).join(", ")} or ${options[options.length - 1]}`;
+}
+function categorizeError(error) {
+  if (error instanceof CLIError)
+    return error.exitCode;
+  if (error instanceof Error && "code" in error) {
+    const code = error.code;
+    if (typeof code == "string") {
+      if (code === "ENOENT")
+        return ErrorCategory.NOT_FOUND;
+      if ((/* @__PURE__ */ new Set(["EACCES", "ENOSPC", "EIO", "EROFS", "EPERM"])).has(code))
+        return ErrorCategory.SYSTEM;
+    }
+  }
+  return ErrorCategory.USER;
+}
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function findSimilar(input, options, maxDistance = 2) {
+  return options.map((option) => ({
+    option,
+    distance: levenshteinDistance(input.toLowerCase(), option.toLowerCase())
+  })).filter(({ distance }) => distance <= maxDistance).sort((a, b) => a.distance - b.distance).slice(0, 3).map(({ option }) => option);
+}
+function levenshteinDistance(a, b) {
+  const matrix = [];
+  for (let i = 0; i <= b.length; i++)
+    matrix[i] = [i];
+  for (let j = 0; j <= a.length; j++)
+    matrix[0][j] = j;
+  for (let i = 1; i <= b.length; i++)
+    for (let j = 1; j <= a.length; j++)
+      b.charAt(i - 1) === a.charAt(j - 1) ? matrix[i][j] = matrix[i - 1][j - 1] : matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+  return matrix[b.length][a.length];
+}
 export {
   CLIError,
   ElementNotFoundError,
+  ErrorCategory,
   FileNotFoundError,
   InvalidJSONError,
   ModelNotFoundError,
   ValidationError,
+  categorizeError,
+  findSimilar,
+  formatValidOptions,
+  getErrorMessage,
   handleError,
   handleSuccess,
   handleWarning

package/dist/utils/errors.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/errors.ts"],
-  "sourcesContent": ["/**\n * Error handling utilities with formatted output\n * Matches Python CLI error message formatting\n *\n * NOTE: The add.ts command demonstrates usage of CLIError.\n * Future commands should adopt this pattern to ensure consistent error handling.\n */\n\nimport ansis from 'ansis';\n\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: number = 1,\n    public suggestions?: string[]\n  ) {\n    super(message);\n    this.name = 'CLIError';\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Suggestions:'));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n\nexport class ValidationError extends CLIError {\n  constructor(\n    message: string,\n    public errors: Array<{ layer?: string; elementId?: string; message: string }> = [],\n    suggestions?: string[]\n  ) {\n    super(message, 1, suggestions);\n    this.name = 'ValidationError';\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.errors.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Details:'));\n      for (const error of this.errors) {\n        let detail = '';\n        if (error.layer && error.elementId) {\n          detail = `  [${error.layer}:${error.elementId}] ${error.message}`;\n        } else if (error.layer) {\n          detail = `  [${error.layer}] ${error.message}`;\n        } else {\n          detail = `  ${error.message}`;\n        }\n        lines.push(ansis.dim(detail));\n      }\n    }\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Suggestions:'));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n\nexport class FileNotFoundError extends CLIError {\n  constructor(path: string, context?: string) {\n    const message = context ? `${context}: ${path}` : `File not found: ${path}`;\n    super(message, 2, [\n      `Check that the path is correct: ${path}`,\n      'Use \"dr init\" to create a new model',\n      'Use \"dr list <layer>\" to see available elements',\n    ]);\n    this.name = 'FileNotFoundError';\n  }\n}\n\nexport class ElementNotFoundError extends CLIError {\n  constructor(elementId: string) {\n    super(\n      `Element not found: ${elementId}`,\n      2,\n      [\n        `Use \"dr search ${elementId}\" to find similar elements`,\n        'Use \"dr list <layer>\" to list all elements in a layer',\n        'Check the element ID format: {layer}-{type}-{kebab-case-name}',\n      ]\n    );\n    this.name = 'ElementNotFoundError';\n  }\n}\n\nexport class ModelNotFoundError extends CLIError {\n  constructor(rootPath: string = '.') {\n    super(\n      `No model found at ${rootPath}`,\n      2,\n      [`Run \"dr init\" to initialize a new model`, 'Check that you are in the correct directory']\n    );\n    this.name = 'ModelNotFoundError';\n  }\n}\n\nexport class InvalidJSONError extends CLIError {\n  constructor(input: string, context?: string) {\n    const message = context ? `Invalid JSON in ${context}` : 'Invalid JSON format';\n    super(message, 1, [\n      `Check your JSON syntax: ${input}`,\n      'Use single quotes to wrap JSON: --properties \\'{\"key\":\"value\"}\\'',\n      'Escape special characters properly',\n    ]);\n    this.name = 'InvalidJSONError';\n  }\n}\n\nexport function handleError(error: unknown): never {\n  if (error instanceof CLIError) {\n    console.error(error.format());\n    process.exit(error.exitCode);\n  } else if (error instanceof Error) {\n    console.error(ansis.red(`Error: ${error.message}`));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(error.stack));\n    }\n    process.exit(1);\n  } else {\n    console.error(ansis.red('An unexpected error occurred'));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(String(error)));\n    }\n    process.exit(1);\n  }\n}\n\nexport function handleWarning(message: string, suggestions?: string[]): void {\n  const lines: string[] = [];\n  lines.push(ansis.yellow(`Warning: ${message}`));\n  if (suggestions && suggestions.length > 0) {\n    lines.push('');\n    lines.push(ansis.dim('Suggestions:'));\n    for (const suggestion of suggestions) {\n      lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n    }\n  }\n  console.warn(lines.join('\\n'));\n}\n\nexport function handleSuccess(message: string, details?: Record<string, string>): void {\n  console.log(ansis.green(`\u2713 ${message}`));\n  if (details) {\n    for (const [key, value] of Object.entries(details)) {\n      console.log(ansis.dim(`  ${key}: ${value}`));\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["/**\n * Error handling utilities with formatted output\n * Matches Python CLI error message formatting\n *\n * Error Categories:\n * - User Error (exit code 1): Invalid input, wrong format, element exists\n * - Not Found (exit code 2): File/element/model not found\n * - System Error (exit code 3): Permission denied, I/O failure\n * - Validation Error (exit code 4): Schema/reference/semantic validation failed\n * - Breaking Change (exit code 5): Version migration required\n */\n\nimport ansis from \"ansis\";\n\nconst MAX_SUGGESTIONS = 5;\n\nexport enum ErrorCategory {\n  USER = 1,\n  NOT_FOUND = 2,\n  SYSTEM = 3,\n  VALIDATION = 4,\n  BREAKING_CHANGE = 5,\n}\n\nexport interface ErrorContext {\n  operation?: string;\n  context?: string;\n  relatedElements?: string[];\n  partialProgress?: { completed: number; total: number };\n}\n\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: number = ErrorCategory.USER,\n    public suggestions?: string[],\n    public context?: ErrorContext\n  ) {\n    super(message);\n    this.name = \"CLIError\";\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.context?.operation) {\n      lines.push(ansis.dim(`During: ${this.context.operation}`));\n    }\n\n    if (this.context?.partialProgress) {\n      const { completed, total } = this.context.partialProgress;\n      lines.push(\n        ansis.yellow(`\u26A0 Partial progress: ${completed}/${total} completed (operation rolled back)`)\n      );\n    }\n\n    if (this.context?.relatedElements && this.context.relatedElements.length > 0) {\n      lines.push(ansis.dim(\"Related elements:\"));\n      for (const elem of this.context.relatedElements.slice(0, MAX_SUGGESTIONS)) {\n        lines.push(ansis.dim(`  \u2022 ${elem}`));\n      }\n      if (this.context.relatedElements.length > MAX_SUGGESTIONS) {\n        lines.push(\n          ansis.dim(`  ... and ${this.context.relatedElements.length - MAX_SUGGESTIONS} more`)\n        );\n      }\n    }\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push(\"\");\n      lines.push(ansis.dim(\"Suggestions:\"));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n}\n\nexport class ValidationError extends CLIError {\n  constructor(\n    message: string,\n    public errors: Array<{ layer?: string; elementId?: string; message: string }> = [],\n    suggestions?: string[],\n    context?: ErrorContext\n  ) {\n    super(message, ErrorCategory.VALIDATION, suggestions, context);\n    this.name = \"ValidationError\";\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.errors.length > 0) {\n      // Show error count and grouping\n      const errorsByLayer: Record<string, Array<{ elementId?: string; message: string }>> = {};\n      for (const error of this.errors) {\n        const layer = error.layer || \"general\";\n        if (!errorsByLayer[layer]) {\n          errorsByLayer[layer] = [];\n        }\n        errorsByLayer[layer].push({ elementId: error.elementId, message: error.message });\n      }\n\n      lines.push(\"\");\n      lines.push(ansis.dim(`Validation errors: ${this.errors.length} found`));\n      lines.push(\"\");\n\n      const layerNames = Object.keys(errorsByLayer).sort();\n\n      for (const layer of layerNames) {\n        const layerErrors = errorsByLayer[layer];\n        lines.push(ansis.dim(`  [${layer}] ${layerErrors.length} error(s):`));\n\n        for (let i = 0; i < Math.min(layerErrors.length, MAX_SUGGESTIONS); i++) {\n          const error = layerErrors[i];\n          let detail = \"\";\n          if (error.elementId) {\n            detail = `    ${error.elementId}: ${error.message}`;\n          } else {\n            detail = `    ${error.message}`;\n          }\n          lines.push(ansis.dim(detail));\n        }\n\n        if (layerErrors.length > MAX_SUGGESTIONS) {\n          lines.push(\n            ansis.dim(`    ... and ${layerErrors.length - MAX_SUGGESTIONS} more in this layer`)\n          );\n        }\n      }\n    }\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push(\"\");\n      lines.push(ansis.dim(\"Suggestions:\"));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n}\n\nexport class FileNotFoundError extends CLIError {\n  constructor(path: string, context?: string) {\n    const message = context ? `${context}: ${path}` : `File not found: ${path}`;\n    super(message, ErrorCategory.NOT_FOUND, [\n      `Check that the path is correct: ${path}`,\n      'Use \"dr init\" to create a new model',\n      'Use \"dr list <layer>\" to see available elements',\n    ]);\n    this.name = \"FileNotFoundError\";\n  }\n}\n\nexport class ElementNotFoundError extends CLIError {\n  constructor(elementId: string) {\n    super(`Element not found: ${elementId}`, ErrorCategory.NOT_FOUND, [\n      `Use \"dr search ${elementId}\" to find similar elements`,\n      'Use \"dr list <layer>\" to list all elements in a layer',\n      \"Check the element ID format: {layer}.{type}.{kebab-case-name}\",\n    ]);\n    this.name = \"ElementNotFoundError\";\n  }\n}\n\nexport class ModelNotFoundError extends CLIError {\n  constructor(rootPath: string = \".\") {\n    super(`No model found at ${rootPath}`, ErrorCategory.NOT_FOUND, [\n      `Run \"dr init\" to initialize a new model`,\n      \"Check that you are in the correct directory\",\n    ]);\n    this.name = \"ModelNotFoundError\";\n  }\n}\n\nexport class InvalidJSONError extends CLIError {\n  constructor(input: string, context?: string) {\n    const message = context ? `Invalid JSON in ${context}` : \"Invalid JSON format\";\n    super(message, ErrorCategory.USER, [\n      `Check your JSON syntax: ${input}`,\n      'Use single quotes to wrap JSON: --attributes \\'{\"key\":\"value\"}\\'',\n      \"Escape special characters properly\",\n    ]);\n    this.name = \"InvalidJSONError\";\n  }\n}\n\nexport function handleError(error: unknown): never {\n  if (error instanceof CLIError) {\n    console.error(error.format());\n    // Don't call process.exit() - rethrow so CLI wrapper can handle telemetry shutdown\n    throw error;\n  } else if (error instanceof Error) {\n    console.error(ansis.red(`Error: ${error.message}`));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(error.stack));\n    }\n    // Rethrow to allow CLI wrapper to handle shutdown\n    throw error;\n  } else {\n    console.error(ansis.red(\"An unexpected error occurred\"));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(String(error)));\n    }\n    // Create proper error to throw\n    throw new Error(String(error));\n  }\n}\n\nexport function handleWarning(message: string, suggestions?: string[]): void {\n  const lines: string[] = [];\n  lines.push(ansis.yellow(`Warning: ${message}`));\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(ansis.dim(\"Suggestions:\"));\n    for (const suggestion of suggestions) {\n      lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n    }\n  }\n  console.warn(lines.join(\"\\n\"));\n}\n\nexport function handleSuccess(message: string, details?: Record<string, string>): void {\n  console.log(ansis.green(`\u2713 ${message}`));\n  if (details) {\n    for (const [key, value] of Object.entries(details)) {\n      console.log(ansis.dim(`  ${key}: ${value}`));\n    }\n  }\n}\n\n/**\n * Utility to extract common valid options for better error suggestions\n */\nexport function formatValidOptions(options: string[], heading: string = \"Valid options\"): string {\n  if (options.length === 0) return \"\";\n  if (options.length === 1) return `${heading}: ${options[0]}`;\n  return `${heading}: ${options.slice(0, -1).join(\", \")} or ${options[options.length - 1]}`;\n}\n\n/**\n * Categorize errors based on type, using stable error.code for system errors\n * Returns the appropriate ErrorCategory for a given error\n */\nexport function categorizeError(error: unknown): ErrorCategory {\n  if (error instanceof CLIError) {\n    return error.exitCode;\n  }\n\n  // Check for system errors using stable error.code\n  if (error instanceof Error && \"code\" in error) {\n    const code = (error as NodeJS.ErrnoException).code;\n    if (typeof code === \"string\") {\n      // File not found errors should map to NOT_FOUND category\n      if (code === \"ENOENT\") {\n        return ErrorCategory.NOT_FOUND;\n      }\n      // Other system-level errors\n      const SYSTEM_ERROR_CODES = new Set([\"EACCES\", \"ENOSPC\", \"EIO\", \"EROFS\", \"EPERM\"]);\n      if (SYSTEM_ERROR_CODES.has(code)) {\n        return ErrorCategory.SYSTEM;\n      }\n    }\n  }\n\n  // Default to USER for other errors\n  return ErrorCategory.USER;\n}\n\n/**\n * Extract error message from any error type\n * Handles Error instances, strings, and unknown types consistently\n */\nexport function getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  return String(error);\n}\n\n/**\n * Simple fuzzy match to find similar strings (for typo suggestions)\n */\nexport function findSimilar(input: string, options: string[], maxDistance: number = 2): string[] {\n  return options\n    .map((option) => ({\n      option,\n      distance: levenshteinDistance(input.toLowerCase(), option.toLowerCase()),\n    }))\n    .filter(({ distance }) => distance <= maxDistance)\n    .sort((a, b) => a.distance - b.distance)\n    .slice(0, 3)\n    .map(({ option }) => option);\n}\n\n/**\n * Calculate Levenshtein distance for typo detection\n */\nfunction levenshteinDistance(a: string, b: string): number {\n  const matrix: number[][] = [];\n\n  for (let i = 0; i <= b.length; i++) {\n    matrix[i] = [i];\n  }\n\n  for (let j = 0; j <= a.length; j++) {\n    matrix[0][j] = j;\n  }\n\n  for (let i = 1; i <= b.length; i++) {\n    for (let j = 1; j <= a.length; j++) {\n      if (b.charAt(i - 1) === a.charAt(j - 1)) {\n        matrix[i][j] = matrix[i - 1][j - 1];\n      } else {\n        matrix[i][j] = Math.min(\n          matrix[i - 1][j - 1] + 1,\n          matrix[i][j - 1] + 1,\n          matrix[i - 1][j] + 1\n        );\n      }\n    }\n  }\n\n  return matrix[b.length][a.length];\n}\n"],
+  "mappings": "AAYA,OAAO,WAAW;AAElB,MAAM,kBAAkB;AAExB,IAAY;CAAZ,SAAYA,gBAAa;AACvB,EAAAA,eAAAA,eAAA,OAAA,CAAA,IAAA,QACAA,eAAAA,eAAA,YAAA,CAAA,IAAA,aACAA,eAAAA,eAAA,SAAA,CAAA,IAAA,UACAA,eAAAA,eAAA,aAAA,CAAA,IAAA,cACAA,eAAAA,eAAA,kBAAA,CAAA,IAAA;AACF,GANY,kBAAA,gBAAa,CAAA,EAAA;AAenB,MAAO,iBAAiB,MAAK;EAGxB;EACA;EACA;EAJT,YACE,SACO,WAAmB,cAAc,MACjC,aACA,SAAsB;AAE7B,UAAM,OAAO,GAJN,KAAA,WAAA,UACA,KAAA,cAAA,aACA,KAAA,UAAA,SAGP,KAAK,OAAO;EACd;EAEA,SAAM;AACJ,UAAM,QAAkB,CAAA;AAQxB,QANA,MAAM,KAAK,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC,GAE1C,KAAK,SAAS,aAChB,MAAM,KAAK,MAAM,IAAI,WAAW,KAAK,QAAQ,SAAS,EAAE,CAAC,GAGvD,KAAK,SAAS,iBAAiB;AACjC,YAAM,EAAE,WAAW,MAAK,IAAK,KAAK,QAAQ;AAC1C,YAAM,KACJ,MAAM,OAAO,4BAAuB,SAAS,IAAI,KAAK,oCAAoC,CAAC;IAE/F;AAEA,QAAI,KAAK,SAAS,mBAAmB,KAAK,QAAQ,gBAAgB,SAAS,GAAG;AAC5E,YAAM,KAAK,MAAM,IAAI,mBAAmB,CAAC;AACzC,iBAAW,QAAQ,KAAK,QAAQ,gBAAgB,MAAM,GAAG,eAAe;AACtE,cAAM,KAAK,MAAM,IAAI,YAAO,IAAI,EAAE,CAAC;AAErC,MAAI,KAAK,QAAQ,gBAAgB,SAAS,mBACxC,MAAM,KACJ,MAAM,IAAI,aAAa,KAAK,QAAQ,gBAAgB,SAAS,eAAe,OAAO,CAAC;IAG1F;AAEA,QAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,YAAM,KAAK,EAAE,GACb,MAAM,KAAK,MAAM,IAAI,cAAc,CAAC;AACpC,iBAAW,cAAc,KAAK;AAC5B,cAAM,KAAK,MAAM,IAAI,YAAO,UAAU,EAAE,CAAC;IAE7C;AAEA,WAAO,MAAM,KAAK;CAAI;EACxB;;AAGI,MAAO,wBAAwB,SAAQ;EAGlC;EAFT,YACE,SACO,SAAyE,CAAA,GAChF,aACA,SAAsB;AAEtB,UAAM,SAAS,cAAc,YAAY,aAAa,OAAO,GAJtD,KAAA,SAAA,QAKP,KAAK,OAAO;EACd;EAEA,SAAM;AACJ,UAAM,QAAkB,CAAA;AAIxB,QAFA,MAAM,KAAK,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC,GAE1C,KAAK,OAAO,SAAS,GAAG;AAE1B,YAAM,gBAAgF,CAAA;AACtF,iBAAW,SAAS,KAAK,QAAQ;AAC/B,cAAM,QAAQ,MAAM,SAAS;AAC7B,QAAK,cAAc,KAAK,MACtB,cAAc,KAAK,IAAI,CAAA,IAEzB,cAAc,KAAK,EAAE,KAAK,EAAE,WAAW,MAAM,WAAW,SAAS,MAAM,QAAO,CAAE;MAClF;AAEA,YAAM,KAAK,EAAE,GACb,MAAM,KAAK,MAAM,IAAI,sBAAsB,KAAK,OAAO,MAAM,QAAQ,CAAC,GACtE,MAAM,KAAK,EAAE;AAEb,YAAM,aAAa,OAAO,KAAK,aAAa,EAAE,KAAI;AAElD,iBAAW,SAAS,YAAY;AAC9B,cAAM,cAAc,cAAc,KAAK;AACvC,cAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,YAAY,MAAM,YAAY,CAAC;AAEpE,iBAAS,IAAI,GAAG,IAAI,KAAK,IAAI,YAAY,QAAQ,eAAe,GAAG,KAAK;AACtE,gBAAM,QAAQ,YAAY,CAAC;AAC3B,cAAI,SAAS;AACb,UAAI,MAAM,YACR,SAAS,OAAO,MAAM,SAAS,KAAK,MAAM,OAAO,KAEjD,SAAS,OAAO,MAAM,OAAO,IAE/B,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC;QAC9B;AAEA,QAAI,YAAY,SAAS,mBACvB,MAAM,KACJ,MAAM,IAAI,eAAe,YAAY,SAAS,eAAe,qBAAqB,CAAC;MAGzF;IACF;AAEA,QAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,YAAM,KAAK,EAAE,GACb,MAAM,KAAK,MAAM,IAAI,cAAc,CAAC;AACpC,iBAAW,cAAc,KAAK;AAC5B,cAAM,KAAK,MAAM,IAAI,YAAO,UAAU,EAAE,CAAC;IAE7C;AAEA,WAAO,MAAM,KAAK;CAAI;EACxB;;AAGI,MAAO,0BAA0B,SAAQ;EAC7C,YAAY,MAAc,SAAgB;AACxC,UAAM,UAAU,UAAU,GAAG,OAAO,KAAK,IAAI,KAAK,mBAAmB,IAAI;AACzE,UAAM,SAAS,cAAc,WAAW;MACtC,mCAAmC,IAAI;MACvC;MACA;KACD,GACD,KAAK,OAAO;EACd;;AAGI,MAAO,6BAA6B,SAAQ;EAChD,YAAY,WAAiB;AAC3B,UAAM,sBAAsB,SAAS,IAAI,cAAc,WAAW;MAChE,kBAAkB,SAAS;MAC3B;MACA;KACD,GACD,KAAK,OAAO;EACd;;AAGI,MAAO,2BAA2B,SAAQ;EAC9C,YAAY,WAAmB,KAAG;AAChC,UAAM,qBAAqB,QAAQ,IAAI,cAAc,WAAW;MAC9D;MACA;KACD,GACD,KAAK,OAAO;EACd;;AAGI,MAAO,yBAAyB,SAAQ;EAC5C,YAAY,OAAe,SAAgB;AACzC,UAAM,UAAU,UAAU,mBAAmB,OAAO,KAAK;AACzD,UAAM,SAAS,cAAc,MAAM;MACjC,2BAA2B,KAAK;MAChC;MACA;KACD,GACD,KAAK,OAAO;EACd;;AAGI,SAAU,YAAY,OAAc;AACxC,QAAI,iBAAiB,YACnB,QAAQ,MAAM,MAAM,OAAM,CAAE,GAEtB,SACG,iBAAiB,SAC1B,QAAQ,MAAM,MAAM,IAAI,UAAU,MAAM,OAAO,EAAE,CAAC,GAC9C,QAAQ,IAAI,SACd,QAAQ,MAAM,MAAM,IAAI,MAAM,KAAK,CAAC,GAGhC,UAEN,QAAQ,MAAM,MAAM,IAAI,8BAA8B,CAAC,GACnD,QAAQ,IAAI,SACd,QAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC,GAGlC,IAAI,MAAM,OAAO,KAAK,CAAC;AAEjC;AAEM,SAAU,cAAc,SAAiB,aAAsB;AACnE,QAAM,QAAkB,CAAA;AAExB,MADA,MAAM,KAAK,MAAM,OAAO,YAAY,OAAO,EAAE,CAAC,GAC1C,eAAe,YAAY,SAAS,GAAG;AACzC,UAAM,KAAK,EAAE,GACb,MAAM,KAAK,MAAM,IAAI,cAAc,CAAC;AACpC,eAAW,cAAc;AACvB,YAAM,KAAK,MAAM,IAAI,YAAO,UAAU,EAAE,CAAC;EAE7C;AACA,UAAQ,KAAK,MAAM,KAAK;CAAI,CAAC;AAC/B;AAEM,SAAU,cAAc,SAAiB,SAAgC;AAE7E,MADA,QAAQ,IAAI,MAAM,MAAM,UAAK,OAAO,EAAE,CAAC,GACnC;AACF,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO;AAC/C,cAAQ,IAAI,MAAM,IAAI,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC;AAGjD;AAKM,SAAU,mBAAmB,SAAmB,UAAkB,iBAAe;AACrF,SAAI,QAAQ,WAAW,IAAU,KAC7B,QAAQ,WAAW,IAAU,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,KACnD,GAAG,OAAO,KAAK,QAAQ,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,OAAO,QAAQ,QAAQ,SAAS,CAAC,CAAC;AACzF;AAMM,SAAU,gBAAgB,OAAc;AAC5C,MAAI,iBAAiB;AACnB,WAAO,MAAM;AAIf,MAAI,iBAAiB,SAAS,UAAU,OAAO;AAC7C,UAAM,OAAQ,MAAgC;AAC9C,QAAI,OAAO,QAAS,UAAU;AAE5B,UAAI,SAAS;AACX,eAAO,cAAc;AAIvB,WAD2B,oBAAI,IAAI,CAAC,UAAU,UAAU,OAAO,SAAS,OAAO,CAAC,GACzD,IAAI,IAAI;AAC7B,eAAO,cAAc;IAEzB;EACF;AAGA,SAAO,cAAc;AACvB;AAMM,SAAU,gBAAgB,OAAc;AAC5C,SAAI,iBAAiB,QACZ,MAAM,UAER,OAAO,KAAK;AACrB;AAKM,SAAU,YAAY,OAAe,SAAmB,cAAsB,GAAC;AACnF,SAAO,QACJ,IAAI,CAAC,YAAY;IAChB;IACA,UAAU,oBAAoB,MAAM,YAAW,GAAI,OAAO,YAAW,CAAE;IACvE,EACD,OAAO,CAAC,EAAE,SAAQ,MAAO,YAAY,WAAW,EAChD,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ,EACtC,MAAM,GAAG,CAAC,EACV,IAAI,CAAC,EAAE,OAAM,MAAO,MAAM;AAC/B;AAKA,SAAS,oBAAoB,GAAW,GAAS;AAC/C,QAAM,SAAqB,CAAA;AAE3B,WAAS,IAAI,GAAG,KAAK,EAAE,QAAQ;AAC7B,WAAO,CAAC,IAAI,CAAC,CAAC;AAGhB,WAAS,IAAI,GAAG,KAAK,EAAE,QAAQ;AAC7B,WAAO,CAAC,EAAE,CAAC,IAAI;AAGjB,WAAS,IAAI,GAAG,KAAK,EAAE,QAAQ;AAC7B,aAAS,IAAI,GAAG,KAAK,EAAE,QAAQ;AAC7B,MAAI,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,IACpC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,IAAI,CAAC,IAElC,OAAO,CAAC,EAAE,CAAC,IAAI,KAAK,IAClB,OAAO,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,GACvB,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,GACnB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;AAM5B,SAAO,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM;AAClC;",
+  "names": ["ErrorCategory"]
 }