passive-docs-index 0.2.0 → 0.3.0

package/dist/cli.js

@@ -8627,6 +8627,70 @@ var require_prompts3 = __commonJS((exports, module) => {
   module.exports = isNodeLT("8.6.0") ? require_dist() : require_lib();
 });
 
+// src/lib/errors.ts
+var PDIError, ConfigError, Context7Error, NotInitializedError;
+var init_errors = __esm(() => {
+  PDIError = class PDIError extends Error {
+    code;
+    hint;
+    cause;
+    constructor(message, options) {
+      super(message);
+      this.name = "PDIError";
+      this.code = options?.code ?? "PDI_ERROR";
+      this.hint = options?.hint;
+      this.cause = options?.cause;
+    }
+  };
+  ConfigError = class ConfigError extends PDIError {
+    configPath;
+    validationIssues;
+    constructor(message, options) {
+      super(message, {
+        code: "CONFIG_INVALID",
+        hint: options?.hint,
+        cause: options?.cause
+      });
+      this.name = "ConfigError";
+      this.configPath = options?.configPath;
+      this.validationIssues = options?.validationIssues;
+    }
+    formatValidationIssues() {
+      if (!this.validationIssues || this.validationIssues.length === 0) {
+        return "";
+      }
+      return this.validationIssues.map((issue2) => {
+        const expected = issue2.expected ? `, expected ${issue2.expected}` : "";
+        return `  - ${issue2.path}: ${issue2.message}${expected}`;
+      }).join(`
+`);
+    }
+  };
+  Context7Error = class Context7Error extends PDIError {
+    category;
+    source;
+    constructor(message, options) {
+      super(message, {
+        code: "CONTEXT7_ERROR",
+        hint: options?.hint,
+        cause: options?.cause
+      });
+      this.name = "Context7Error";
+      this.category = options?.category ?? "unknown";
+      this.source = options?.source ?? "none";
+    }
+  };
+  NotInitializedError = class NotInitializedError extends PDIError {
+    constructor() {
+      super("PDI not initialized in this project.", {
+        code: "NOT_INITIALIZED",
+        hint: "Run `pdi init` to initialize."
+      });
+      this.name = "NotInitializedError";
+    }
+  };
+});
+
 // src/lib/mcp-client.ts
 import { execSync, spawn } from "node:child_process";
 import { existsSync as existsSync2, readdirSync } from "node:fs";
@@ -8907,7 +8971,7 @@ var init_mcp_client2 = __esm(() => {
 // node_modules/@upstash/context7-sdk/dist/client.js
 var exports_client = {};
 __export(exports_client, {
-  Context7Error: () => Context7Error,
+  Context7Error: () => Context7Error2,
   Context7: () => Context7
 });
 function formatCodeSnippet(snippet) {
@@ -8979,7 +9043,7 @@ function formatLibrariesAsText(libraries) {
 ----------
 `);
 }
-var Context7Error, HttpClient = class {
+var Context7Error2, HttpClient = class {
   baseUrl;
   headers;
   options;
@@ -9046,7 +9110,7 @@ var Context7Error, HttpClient = class {
     }
     if (!res.ok) {
       const errorBody = await res.json();
-      throw new Context7Error(errorBody.error || errorBody.message || res.statusText);
+      throw new Context7Error2(errorBody.error || errorBody.message || res.statusText);
     }
     const contentType = res.headers.get("content-type");
     if (contentType?.includes("application/json")) {
@@ -9101,7 +9165,7 @@ var Context7Error, HttpClient = class {
   constructor(config2 = {}) {
     const apiKey = config2.apiKey || process.env.CONTEXT7_API_KEY;
     if (!apiKey) {
-      throw new Context7Error("API key is required. Pass it in the config or set CONTEXT7_API_KEY environment variable.");
+      throw new Context7Error2("API key is required. Pass it in the config or set CONTEXT7_API_KEY environment variable.");
     }
     if (!apiKey.startsWith(API_KEY_PREFIX)) {
       console.warn(`API key should start with '${API_KEY_PREFIX}'`);
@@ -9128,7 +9192,7 @@ var Context7Error, HttpClient = class {
   }
 };
 var init_client = __esm(() => {
-  Context7Error = class extends Error {
+  Context7Error2 = class extends Error {
     constructor(message) {
       super(message);
       this.name = "Context7Error";
@@ -9153,7 +9217,7 @@ var init_client = __esm(() => {
         body: this.request.body
       });
       if (result === undefined) {
-        throw new Context7Error("Request did not return a result");
+        throw new Context7Error2("Request did not return a result");
       }
       if (this.responseType === "txt" && typeof result === "string") {
         return result;
@@ -9168,7 +9232,7 @@ var init_client = __esm(() => {
     responseType;
     constructor(query, libraryName, options) {
       if (!query || !libraryName) {
-        throw new Context7Error("query and libraryName are required");
+        throw new Context7Error2("query and libraryName are required");
       }
       const queryParams = {};
       queryParams.query = query;
@@ -9183,7 +9247,7 @@ var init_client = __esm(() => {
         query: this.request.query
       });
       if (result === undefined) {
-        throw new Context7Error("Request did not return a result");
+        throw new Context7Error2("Request did not return a result");
       }
       const libraries = result.results.map(formatLibrary);
       if (this.responseType === "txt") {
@@ -9205,8 +9269,59 @@ __export(exports_context7_client, {
   resetClients: () => resetClients,
   queryContext7: () => queryContext72,
   isHttpClientAvailable: () => isHttpClientAvailable,
+  classifyContext7Error: () => classifyContext7Error,
   checkAvailability: () => checkAvailability
 });
+function classifyContext7Error(error48, source) {
+  const message = error48 instanceof Error ? error48.message : String(error48);
+  const cause = error48 instanceof Error ? error48 : undefined;
+  const lowerMessage = message.toLowerCase();
+  if (lowerMessage.includes("401") || lowerMessage.includes("403") || lowerMessage.includes("unauthorized") || lowerMessage.includes("invalid") && lowerMessage.includes("key") || lowerMessage.includes("forbidden")) {
+    return new Context7Error("Context7 API key is invalid or expired.", {
+      category: "auth",
+      source,
+      hint: "Run `pdi auth` to reconfigure your API key, or set CONTEXT7_API_KEY in your environment.",
+      cause
+    });
+  }
+  if (lowerMessage.includes("429") || lowerMessage.includes("rate limit") || lowerMessage.includes("too many requests")) {
+    return new Context7Error("Context7 rate limit reached.", {
+      category: "rate_limit",
+      source,
+      hint: "Wait a moment and try again. Consider using `pdi update` with fewer frameworks at once.",
+      cause
+    });
+  }
+  if (lowerMessage.includes("timeout") || lowerMessage.includes("econnrefused") || lowerMessage.includes("enotfound") || lowerMessage.includes("fetch failed") || lowerMessage.includes("failed to fetch") || lowerMessage.includes("network") || lowerMessage.includes("aborted") || lowerMessage.includes("econnreset")) {
+    return new Context7Error("Cannot reach Context7 servers.", {
+      category: "network",
+      source,
+      hint: "Check your internet connection. If the issue persists, try again later.",
+      cause
+    });
+  }
+  if (lowerMessage.includes("library_redirected") || lowerMessage.includes("redirected")) {
+    return new Context7Error("Library ID has changed in Context7.", {
+      category: "redirect",
+      source,
+      hint: "Run `pdi add <framework> --force` to update with the new library ID.",
+      cause
+    });
+  }
+  if (lowerMessage.includes("no documentation found") || lowerMessage.includes("not found") || lowerMessage.includes("404")) {
+    return new Context7Error("No documentation found for this query.", {
+      category: "not_found",
+      source,
+      hint: "The library may not be indexed by Context7, or the query returned no results.",
+      cause
+    });
+  }
+  return new Context7Error(message, {
+    category: "unknown",
+    source,
+    cause
+  });
+}
 function setHttpClientFactory(factory) {
   httpClientFactory = factory;
 }
@@ -9338,9 +9453,10 @@ async function queryViaHttp(libraryId, query, apiKeyOverride) {
         source: "http"
       };
     }
+    const classified = classifyContext7Error(error48, "http");
     return {
       success: false,
-      error: errorMessage,
+      error: classified.hint ? `${classified.message} ${classified.hint}` : classified.message,
       source: "http"
     };
   }
@@ -9384,9 +9500,10 @@ async function queryViaMcp(libraryId, query, mcpClient) {
       source: "mcp"
     };
   } catch (error48) {
+    const classified = classifyContext7Error(error48, "mcp");
     return {
       success: false,
-      error: error48 instanceof Error ? error48.message : "MCP query failed",
+      error: classified.hint ? `${classified.message} ${classified.hint}` : classified.message,
       source: "mcp"
     };
   }
@@ -9415,7 +9532,7 @@ async function queryContext72(libraryId, query, config2) {
   }
   return {
     success: false,
-    error: httpAvailable ? `HTTP failed, MCP failed: ${mcpResult.error}` : `No API key set, MCP failed: ${mcpResult.error}`,
+    error: httpAvailable ? "Documentation fetch failed. Check connection and API key with `pdi doctor`." : "No documentation source available. Run `pdi auth` to configure Context7 API.",
     source: "none"
   };
 }
@@ -9477,6 +9594,7 @@ var defaultHttpClientFactory = async (apiKey) => {
   return new Context72({ apiKey });
 }, httpClientFactory, httpClient = null, httpClientApiKey = null, libraryIdCache, defaultMcpClient;
 var init_context7_client = __esm(() => {
+  init_errors();
   init_mcp_client2();
   init_mcp_client();
   httpClientFactory = defaultHttpClientFactory;
@@ -9484,206 +9602,1989 @@ var init_context7_client = __esm(() => {
   defaultMcpClient = new McpCliClient;
 });
 
-// node_modules/chalk/source/vendor/ansi-styles/index.js
-var ANSI_BACKGROUND_OFFSET = 10;
-var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
-var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
-var wrapAnsi16m = (offset = 0) => (red, green, blue) => `\x1B[${38 + offset};2;${red};${green};${blue}m`;
-var styles = {
-  modifier: {
-    reset: [0, 0],
-    bold: [1, 22],
-    dim: [2, 22],
-    italic: [3, 23],
-    underline: [4, 24],
-    overline: [53, 55],
-    inverse: [7, 27],
-    hidden: [8, 28],
-    strikethrough: [9, 29]
-  },
-  color: {
-    black: [30, 39],
-    red: [31, 39],
-    green: [32, 39],
-    yellow: [33, 39],
-    blue: [34, 39],
-    magenta: [35, 39],
-    cyan: [36, 39],
-    white: [37, 39],
-    blackBright: [90, 39],
-    gray: [90, 39],
-    grey: [90, 39],
-    redBright: [91, 39],
-    greenBright: [92, 39],
-    yellowBright: [93, 39],
-    blueBright: [94, 39],
-    magentaBright: [95, 39],
-    cyanBright: [96, 39],
-    whiteBright: [97, 39]
-  },
-  bgColor: {
-    bgBlack: [40, 49],
-    bgRed: [41, 49],
-    bgGreen: [42, 49],
-    bgYellow: [43, 49],
-    bgBlue: [44, 49],
-    bgMagenta: [45, 49],
-    bgCyan: [46, 49],
-    bgWhite: [47, 49],
-    bgBlackBright: [100, 49],
-    bgGray: [100, 49],
-    bgGrey: [100, 49],
-    bgRedBright: [101, 49],
-    bgGreenBright: [102, 49],
-    bgYellowBright: [103, 49],
-    bgBlueBright: [104, 49],
-    bgMagentaBright: [105, 49],
-    bgCyanBright: [106, 49],
-    bgWhiteBright: [107, 49]
-  }
-};
-var modifierNames = Object.keys(styles.modifier);
-var foregroundColorNames = Object.keys(styles.color);
-var backgroundColorNames = Object.keys(styles.bgColor);
-var colorNames = [...foregroundColorNames, ...backgroundColorNames];
-function assembleStyles() {
-  const codes = new Map;
-  for (const [groupName, group] of Object.entries(styles)) {
-    for (const [styleName, style] of Object.entries(group)) {
-      styles[styleName] = {
-        open: `\x1B[${style[0]}m`,
-        close: `\x1B[${style[1]}m`
-      };
-      group[styleName] = styles[styleName];
-      codes.set(style[0], style[1]);
-    }
-    Object.defineProperty(styles, groupName, {
-      value: group,
-      enumerable: false
-    });
-  }
-  Object.defineProperty(styles, "codes", {
-    value: codes,
-    enumerable: false
-  });
-  styles.color.close = "\x1B[39m";
-  styles.bgColor.close = "\x1B[49m";
-  styles.color.ansi = wrapAnsi16();
-  styles.color.ansi256 = wrapAnsi256();
-  styles.color.ansi16m = wrapAnsi16m();
-  styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
-  styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
-  styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
-  Object.defineProperties(styles, {
-    rgbToAnsi256: {
-      value(red, green, blue) {
-        if (red === green && green === blue) {
-          if (red < 8) {
-            return 16;
-          }
-          if (red > 248) {
-            return 231;
-          }
-          return Math.round((red - 8) / 247 * 24) + 232;
-        }
-        return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green / 255 * 5) + Math.round(blue / 255 * 5);
-      },
-      enumerable: false
-    },
-    hexToRgb: {
-      value(hex) {
-        const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
-        if (!matches) {
-          return [0, 0, 0];
-        }
-        let [colorString] = matches;
-        if (colorString.length === 3) {
-          colorString = [...colorString].map((character) => character + character).join("");
-        }
-        const integer = Number.parseInt(colorString, 16);
-        return [
-          integer >> 16 & 255,
-          integer >> 8 & 255,
-          integer & 255
-        ];
-      },
-      enumerable: false
-    },
-    hexToAnsi256: {
-      value: (hex) => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
-      enumerable: false
-    },
-    ansi256ToAnsi: {
-      value(code) {
-        if (code < 8) {
-          return 30 + code;
-        }
-        if (code < 16) {
-          return 90 + (code - 8);
-        }
-        let red;
-        let green;
-        let blue;
-        if (code >= 232) {
-          red = ((code - 232) * 10 + 8) / 255;
-          green = red;
-          blue = red;
+// node_modules/semver/internal/constants.js
+var require_constants = __commonJS((exports, module) => {
+  var SEMVER_SPEC_VERSION = "2.0.0";
+  var MAX_LENGTH = 256;
+  var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
+  var MAX_SAFE_COMPONENT_LENGTH = 16;
+  var MAX_SAFE_BUILD_LENGTH = MAX_LENGTH - 6;
+  var RELEASE_TYPES = [
+    "major",
+    "premajor",
+    "minor",
+    "preminor",
+    "patch",
+    "prepatch",
+    "prerelease"
+  ];
+  module.exports = {
+    MAX_LENGTH,
+    MAX_SAFE_COMPONENT_LENGTH,
+    MAX_SAFE_BUILD_LENGTH,
+    MAX_SAFE_INTEGER,
+    RELEASE_TYPES,
+    SEMVER_SPEC_VERSION,
+    FLAG_INCLUDE_PRERELEASE: 1,
+    FLAG_LOOSE: 2
+  };
+});
+
+// node_modules/semver/internal/debug.js
+var require_debug = __commonJS((exports, module) => {
+  var debug = typeof process === "object" && process.env && process.env.NODE_DEBUG && /\bsemver\b/i.test(process.env.NODE_DEBUG) ? (...args) => console.error("SEMVER", ...args) : () => {};
+  module.exports = debug;
+});
+
+// node_modules/semver/internal/re.js
+var require_re = __commonJS((exports, module) => {
+  var {
+    MAX_SAFE_COMPONENT_LENGTH,
+    MAX_SAFE_BUILD_LENGTH,
+    MAX_LENGTH
+  } = require_constants();
+  var debug = require_debug();
+  exports = module.exports = {};
+  var re = exports.re = [];
+  var safeRe = exports.safeRe = [];
+  var src = exports.src = [];
+  var safeSrc = exports.safeSrc = [];
+  var t = exports.t = {};
+  var R = 0;
+  var LETTERDASHNUMBER = "[a-zA-Z0-9-]";
+  var safeRegexReplacements = [
+    ["\\s", 1],
+    ["\\d", MAX_LENGTH],
+    [LETTERDASHNUMBER, MAX_SAFE_BUILD_LENGTH]
+  ];
+  var makeSafeRegex = (value) => {
+    for (const [token, max] of safeRegexReplacements) {
+      value = value.split(`${token}*`).join(`${token}{0,${max}}`).split(`${token}+`).join(`${token}{1,${max}}`);
+    }
+    return value;
+  };
+  var createToken = (name, value, isGlobal) => {
+    const safe = makeSafeRegex(value);
+    const index = R++;
+    debug(name, index, value);
+    t[name] = index;
+    src[index] = value;
+    safeSrc[index] = safe;
+    re[index] = new RegExp(value, isGlobal ? "g" : undefined);
+    safeRe[index] = new RegExp(safe, isGlobal ? "g" : undefined);
+  };
+  createToken("NUMERICIDENTIFIER", "0|[1-9]\\d*");
+  createToken("NUMERICIDENTIFIERLOOSE", "\\d+");
+  createToken("NONNUMERICIDENTIFIER", `\\d*[a-zA-Z-]${LETTERDASHNUMBER}*`);
+  createToken("MAINVERSION", `(${src[t.NUMERICIDENTIFIER]})\\.` + `(${src[t.NUMERICIDENTIFIER]})\\.` + `(${src[t.NUMERICIDENTIFIER]})`);
+  createToken("MAINVERSIONLOOSE", `(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` + `(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` + `(${src[t.NUMERICIDENTIFIERLOOSE]})`);
+  createToken("PRERELEASEIDENTIFIER", `(?:${src[t.NONNUMERICIDENTIFIER]}|${src[t.NUMERICIDENTIFIER]})`);
+  createToken("PRERELEASEIDENTIFIERLOOSE", `(?:${src[t.NONNUMERICIDENTIFIER]}|${src[t.NUMERICIDENTIFIERLOOSE]})`);
+  createToken("PRERELEASE", `(?:-(${src[t.PRERELEASEIDENTIFIER]}(?:\\.${src[t.PRERELEASEIDENTIFIER]})*))`);
+  createToken("PRERELEASELOOSE", `(?:-?(${src[t.PRERELEASEIDENTIFIERLOOSE]}(?:\\.${src[t.PRERELEASEIDENTIFIERLOOSE]})*))`);
+  createToken("BUILDIDENTIFIER", `${LETTERDASHNUMBER}+`);
+  createToken("BUILD", `(?:\\+(${src[t.BUILDIDENTIFIER]}(?:\\.${src[t.BUILDIDENTIFIER]})*))`);
+  createToken("FULLPLAIN", `v?${src[t.MAINVERSION]}${src[t.PRERELEASE]}?${src[t.BUILD]}?`);
+  createToken("FULL", `^${src[t.FULLPLAIN]}$`);
+  createToken("LOOSEPLAIN", `[v=\\s]*${src[t.MAINVERSIONLOOSE]}${src[t.PRERELEASELOOSE]}?${src[t.BUILD]}?`);
+  createToken("LOOSE", `^${src[t.LOOSEPLAIN]}$`);
+  createToken("GTLT", "((?:<|>)?=?)");
+  createToken("XRANGEIDENTIFIERLOOSE", `${src[t.NUMERICIDENTIFIERLOOSE]}|x|X|\\*`);
+  createToken("XRANGEIDENTIFIER", `${src[t.NUMERICIDENTIFIER]}|x|X|\\*`);
+  createToken("XRANGEPLAIN", `[v=\\s]*(${src[t.XRANGEIDENTIFIER]})` + `(?:\\.(${src[t.XRANGEIDENTIFIER]})` + `(?:\\.(${src[t.XRANGEIDENTIFIER]})` + `(?:${src[t.PRERELEASE]})?${src[t.BUILD]}?` + `)?)?`);
+  createToken("XRANGEPLAINLOOSE", `[v=\\s]*(${src[t.XRANGEIDENTIFIERLOOSE]})` + `(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` + `(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` + `(?:${src[t.PRERELEASELOOSE]})?${src[t.BUILD]}?` + `)?)?`);
+  createToken("XRANGE", `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAIN]}$`);
+  createToken("XRANGELOOSE", `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAINLOOSE]}$`);
+  createToken("COERCEPLAIN", `${"(^|[^\\d])" + "(\\d{1,"}${MAX_SAFE_COMPONENT_LENGTH}})` + `(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?` + `(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?`);
+  createToken("COERCE", `${src[t.COERCEPLAIN]}(?:$|[^\\d])`);
+  createToken("COERCEFULL", src[t.COERCEPLAIN] + `(?:${src[t.PRERELEASE]})?` + `(?:${src[t.BUILD]})?` + `(?:$|[^\\d])`);
+  createToken("COERCERTL", src[t.COERCE], true);
+  createToken("COERCERTLFULL", src[t.COERCEFULL], true);
+  createToken("LONETILDE", "(?:~>?)");
+  createToken("TILDETRIM", `(\\s*)${src[t.LONETILDE]}\\s+`, true);
+  exports.tildeTrimReplace = "$1~";
+  createToken("TILDE", `^${src[t.LONETILDE]}${src[t.XRANGEPLAIN]}$`);
+  createToken("TILDELOOSE", `^${src[t.LONETILDE]}${src[t.XRANGEPLAINLOOSE]}$`);
+  createToken("LONECARET", "(?:\\^)");
+  createToken("CARETTRIM", `(\\s*)${src[t.LONECARET]}\\s+`, true);
+  exports.caretTrimReplace = "$1^";
+  createToken("CARET", `^${src[t.LONECARET]}${src[t.XRANGEPLAIN]}$`);
+  createToken("CARETLOOSE", `^${src[t.LONECARET]}${src[t.XRANGEPLAINLOOSE]}$`);
+  createToken("COMPARATORLOOSE", `^${src[t.GTLT]}\\s*(${src[t.LOOSEPLAIN]})$|^$`);
+  createToken("COMPARATOR", `^${src[t.GTLT]}\\s*(${src[t.FULLPLAIN]})$|^$`);
+  createToken("COMPARATORTRIM", `(\\s*)${src[t.GTLT]}\\s*(${src[t.LOOSEPLAIN]}|${src[t.XRANGEPLAIN]})`, true);
+  exports.comparatorTrimReplace = "$1$2$3";
+  createToken("HYPHENRANGE", `^\\s*(${src[t.XRANGEPLAIN]})` + `\\s+-\\s+` + `(${src[t.XRANGEPLAIN]})` + `\\s*$`);
+  createToken("HYPHENRANGELOOSE", `^\\s*(${src[t.XRANGEPLAINLOOSE]})` + `\\s+-\\s+` + `(${src[t.XRANGEPLAINLOOSE]})` + `\\s*$`);
+  createToken("STAR", "(<|>)?=?\\s*\\*");
+  createToken("GTE0", "^\\s*>=\\s*0\\.0\\.0\\s*$");
+  createToken("GTE0PRE", "^\\s*>=\\s*0\\.0\\.0-0\\s*$");
+});
+
+// node_modules/semver/internal/parse-options.js
+var require_parse_options = __commonJS((exports, module) => {
+  var looseOption = Object.freeze({ loose: true });
+  var emptyOpts = Object.freeze({});
+  var parseOptions = (options) => {
+    if (!options) {
+      return emptyOpts;
+    }
+    if (typeof options !== "object") {
+      return looseOption;
+    }
+    return options;
+  };
+  module.exports = parseOptions;
+});
+
+// node_modules/semver/internal/identifiers.js
+var require_identifiers = __commonJS((exports, module) => {
+  var numeric = /^[0-9]+$/;
+  var compareIdentifiers = (a, b) => {
+    if (typeof a === "number" && typeof b === "number") {
+      return a === b ? 0 : a < b ? -1 : 1;
+    }
+    const anum = numeric.test(a);
+    const bnum = numeric.test(b);
+    if (anum && bnum) {
+      a = +a;
+      b = +b;
+    }
+    return a === b ? 0 : anum && !bnum ? -1 : bnum && !anum ? 1 : a < b ? -1 : 1;
+  };
+  var rcompareIdentifiers = (a, b) => compareIdentifiers(b, a);
+  module.exports = {
+    compareIdentifiers,
+    rcompareIdentifiers
+  };
+});
+
+// node_modules/semver/classes/semver.js
+var require_semver = __commonJS((exports, module) => {
+  var debug = require_debug();
+  var { MAX_LENGTH, MAX_SAFE_INTEGER } = require_constants();
+  var { safeRe: re, t } = require_re();
+  var parseOptions = require_parse_options();
+  var { compareIdentifiers } = require_identifiers();
+
+  class SemVer {
+    constructor(version2, options) {
+      options = parseOptions(options);
+      if (version2 instanceof SemVer) {
+        if (version2.loose === !!options.loose && version2.includePrerelease === !!options.includePrerelease) {
+          return version2;
         } else {
-          code -= 16;
-          const remainder = code % 36;
-          red = Math.floor(code / 36) / 5;
-          green = Math.floor(remainder / 6) / 5;
-          blue = remainder % 6 / 5;
-        }
-        const value = Math.max(red, green, blue) * 2;
-        if (value === 0) {
-          return 30;
-        }
-        let result = 30 + (Math.round(blue) << 2 | Math.round(green) << 1 | Math.round(red));
-        if (value === 2) {
-          result += 60;
+          version2 = version2.version;
         }
-        return result;
-      },
-      enumerable: false
-    },
-    rgbToAnsi: {
-      value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
-      enumerable: false
-    },
-    hexToAnsi: {
-      value: (hex) => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
-      enumerable: false
+      } else if (typeof version2 !== "string") {
+        throw new TypeError(`Invalid version. Must be a string. Got type "${typeof version2}".`);
+      }
+      if (version2.length > MAX_LENGTH) {
+        throw new TypeError(`version is longer than ${MAX_LENGTH} characters`);
+      }
+      debug("SemVer", version2, options);
+      this.options = options;
+      this.loose = !!options.loose;
+      this.includePrerelease = !!options.includePrerelease;
+      const m = version2.trim().match(options.loose ? re[t.LOOSE] : re[t.FULL]);
+      if (!m) {
+        throw new TypeError(`Invalid Version: ${version2}`);
+      }
+      this.raw = version2;
+      this.major = +m[1];
+      this.minor = +m[2];
+      this.patch = +m[3];
+      if (this.major > MAX_SAFE_INTEGER || this.major < 0) {
+        throw new TypeError("Invalid major version");
+      }
+      if (this.minor > MAX_SAFE_INTEGER || this.minor < 0) {
+        throw new TypeError("Invalid minor version");
+      }
+      if (this.patch > MAX_SAFE_INTEGER || this.patch < 0) {
+        throw new TypeError("Invalid patch version");
+      }
+      if (!m[4]) {
+        this.prerelease = [];
+      } else {
+        this.prerelease = m[4].split(".").map((id) => {
+          if (/^[0-9]+$/.test(id)) {
+            const num = +id;
+            if (num >= 0 && num < MAX_SAFE_INTEGER) {
+              return num;
+            }
+          }
+          return id;
+        });
+      }
+      this.build = m[5] ? m[5].split(".") : [];
+      this.format();
     }
-  });
-  return styles;
-}
-var ansiStyles = assembleStyles();
-var ansi_styles_default = ansiStyles;
-
-// node_modules/chalk/source/vendor/supports-color/index.js
-import process2 from "node:process";
-import os from "node:os";
-import tty from "node:tty";
-function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process2.argv) {
-  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-  const position = argv.indexOf(prefix + flag);
-  const terminatorPosition = argv.indexOf("--");
-  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-}
-var { env } = process2;
-var flagForceColor;
-if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
-  flagForceColor = 0;
-} else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
-  flagForceColor = 1;
-}
-function envForceColor() {
-  if ("FORCE_COLOR" in env) {
-    if (env.FORCE_COLOR === "true") {
-      return 1;
+    format() {
+      this.version = `${this.major}.${this.minor}.${this.patch}`;
+      if (this.prerelease.length) {
+        this.version += `-${this.prerelease.join(".")}`;
+      }
+      return this.version;
     }
-    if (env.FORCE_COLOR === "false") {
+    toString() {
+      return this.version;
+    }
+    compare(other) {
+      debug("SemVer.compare", this.version, this.options, other);
+      if (!(other instanceof SemVer)) {
+        if (typeof other === "string" && other === this.version) {
+          return 0;
+        }
+        other = new SemVer(other, this.options);
+      }
+      if (other.version === this.version) {
+        return 0;
+      }
+      return this.compareMain(other) || this.comparePre(other);
+    }
+    compareMain(other) {
+      if (!(other instanceof SemVer)) {
+        other = new SemVer(other, this.options);
+      }
+      if (this.major < other.major) {
+        return -1;
+      }
+      if (this.major > other.major) {
+        return 1;
+      }
+      if (this.minor < other.minor) {
+        return -1;
+      }
+      if (this.minor > other.minor) {
+        return 1;
+      }
+      if (this.patch < other.patch) {
+        return -1;
+      }
+      if (this.patch > other.patch) {
+        return 1;
+      }
+      return 0;
+    }
+    comparePre(other) {
+      if (!(other instanceof SemVer)) {
+        other = new SemVer(other, this.options);
+      }
+      if (this.prerelease.length && !other.prerelease.length) {
+        return -1;
+      } else if (!this.prerelease.length && other.prerelease.length) {
+        return 1;
+      } else if (!this.prerelease.length && !other.prerelease.length) {
+        return 0;
+      }
+      let i = 0;
+      do {
+        const a = this.prerelease[i];
+        const b = other.prerelease[i];
+        debug("prerelease compare", i, a, b);
+        if (a === undefined && b === undefined) {
+          return 0;
+        } else if (b === undefined) {
+          return 1;
+        } else if (a === undefined) {
+          return -1;
+        } else if (a === b) {
+          continue;
+        } else {
+          return compareIdentifiers(a, b);
+        }
+      } while (++i);
+    }
+    compareBuild(other) {
+      if (!(other instanceof SemVer)) {
+        other = new SemVer(other, this.options);
+      }
+      let i = 0;
+      do {
+        const a = this.build[i];
+        const b = other.build[i];
+        debug("build compare", i, a, b);
+        if (a === undefined && b === undefined) {
+          return 0;
+        } else if (b === undefined) {
+          return 1;
+        } else if (a === undefined) {
+          return -1;
+        } else if (a === b) {
+          continue;
+        } else {
+          return compareIdentifiers(a, b);
+        }
+      } while (++i);
+    }
+    inc(release, identifier, identifierBase) {
+      if (release.startsWith("pre")) {
+        if (!identifier && identifierBase === false) {
+          throw new Error("invalid increment argument: identifier is empty");
+        }
+        if (identifier) {
+          const match = `-${identifier}`.match(this.options.loose ? re[t.PRERELEASELOOSE] : re[t.PRERELEASE]);
+          if (!match || match[1] !== identifier) {
+            throw new Error(`invalid identifier: ${identifier}`);
+          }
+        }
+      }
+      switch (release) {
+        case "premajor":
+          this.prerelease.length = 0;
+          this.patch = 0;
+          this.minor = 0;
+          this.major++;
+          this.inc("pre", identifier, identifierBase);
+          break;
+        case "preminor":
+          this.prerelease.length = 0;
+          this.patch = 0;
+          this.minor++;
+          this.inc("pre", identifier, identifierBase);
+          break;
+        case "prepatch":
+          this.prerelease.length = 0;
+          this.inc("patch", identifier, identifierBase);
+          this.inc("pre", identifier, identifierBase);
+          break;
+        case "prerelease":
+          if (this.prerelease.length === 0) {
+            this.inc("patch", identifier, identifierBase);
+          }
+          this.inc("pre", identifier, identifierBase);
+          break;
+        case "release":
+          if (this.prerelease.length === 0) {
+            throw new Error(`version ${this.raw} is not a prerelease`);
+          }
+          this.prerelease.length = 0;
+          break;
+        case "major":
+          if (this.minor !== 0 || this.patch !== 0 || this.prerelease.length === 0) {
+            this.major++;
+          }
+          this.minor = 0;
+          this.patch = 0;
+          this.prerelease = [];
+          break;
+        case "minor":
+          if (this.patch !== 0 || this.prerelease.length === 0) {
+            this.minor++;
+          }
+          this.patch = 0;
+          this.prerelease = [];
+          break;
+        case "patch":
+          if (this.prerelease.length === 0) {
+            this.patch++;
+          }
+          this.prerelease = [];
+          break;
+        case "pre": {
+          const base = Number(identifierBase) ? 1 : 0;
+          if (this.prerelease.length === 0) {
+            this.prerelease = [base];
+          } else {
+            let i = this.prerelease.length;
+            while (--i >= 0) {
+              if (typeof this.prerelease[i] === "number") {
+                this.prerelease[i]++;
+                i = -2;
+              }
+            }
+            if (i === -1) {
+              if (identifier === this.prerelease.join(".") && identifierBase === false) {
+                throw new Error("invalid increment argument: identifier already exists");
+              }
+              this.prerelease.push(base);
+            }
+          }
+          if (identifier) {
+            let prerelease = [identifier, base];
+            if (identifierBase === false) {
+              prerelease = [identifier];
+            }
+            if (compareIdentifiers(this.prerelease[0], identifier) === 0) {
+              if (isNaN(this.prerelease[1])) {
+                this.prerelease = prerelease;
+              }
+            } else {
+              this.prerelease = prerelease;
+            }
+          }
+          break;
+        }
+        default:
+          throw new Error(`invalid increment argument: ${release}`);
+      }
+      this.raw = this.format();
+      if (this.build.length) {
+        this.raw += `+${this.build.join(".")}`;
+      }
+      return this;
+    }
+  }
+  module.exports = SemVer;
+});
+
+// node_modules/semver/functions/parse.js
+var require_parse = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var parse5 = (version2, options, throwErrors = false) => {
+    if (version2 instanceof SemVer) {
+      return version2;
+    }
+    try {
+      return new SemVer(version2, options);
+    } catch (er) {
+      if (!throwErrors) {
+        return null;
+      }
+      throw er;
+    }
+  };
+  module.exports = parse5;
+});
+
+// node_modules/semver/functions/valid.js
+var require_valid = __commonJS((exports, module) => {
+  var parse5 = require_parse();
+  var valid = (version2, options) => {
+    const v = parse5(version2, options);
+    return v ? v.version : null;
+  };
+  module.exports = valid;
+});
+
+// node_modules/semver/functions/clean.js
+var require_clean = __commonJS((exports, module) => {
+  var parse5 = require_parse();
+  var clean = (version2, options) => {
+    const s = parse5(version2.trim().replace(/^[=v]+/, ""), options);
+    return s ? s.version : null;
+  };
+  module.exports = clean;
+});
+
+// node_modules/semver/functions/inc.js
+var require_inc = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var inc = (version2, release, options, identifier, identifierBase) => {
+    if (typeof options === "string") {
+      identifierBase = identifier;
+      identifier = options;
+      options = undefined;
+    }
+    try {
+      return new SemVer(version2 instanceof SemVer ? version2.version : version2, options).inc(release, identifier, identifierBase).version;
+    } catch (er) {
+      return null;
+    }
+  };
+  module.exports = inc;
+});
+
+// node_modules/semver/functions/diff.js
+var require_diff = __commonJS((exports, module) => {
+  var parse5 = require_parse();
+  var diff = (version1, version2) => {
+    const v1 = parse5(version1, null, true);
+    const v2 = parse5(version2, null, true);
+    const comparison = v1.compare(v2);
+    if (comparison === 0) {
+      return null;
+    }
+    const v1Higher = comparison > 0;
+    const highVersion = v1Higher ? v1 : v2;
+    const lowVersion = v1Higher ? v2 : v1;
+    const highHasPre = !!highVersion.prerelease.length;
+    const lowHasPre = !!lowVersion.prerelease.length;
+    if (lowHasPre && !highHasPre) {
+      if (!lowVersion.patch && !lowVersion.minor) {
+        return "major";
+      }
+      if (lowVersion.compareMain(highVersion) === 0) {
+        if (lowVersion.minor && !lowVersion.patch) {
+          return "minor";
+        }
+        return "patch";
+      }
+    }
+    const prefix = highHasPre ? "pre" : "";
+    if (v1.major !== v2.major) {
+      return prefix + "major";
+    }
+    if (v1.minor !== v2.minor) {
+      return prefix + "minor";
+    }
+    if (v1.patch !== v2.patch) {
+      return prefix + "patch";
+    }
+    return "prerelease";
+  };
+  module.exports = diff;
+});
+
+// node_modules/semver/functions/major.js
+var require_major = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var major = (a, loose) => new SemVer(a, loose).major;
+  module.exports = major;
+});
+
+// node_modules/semver/functions/minor.js
+var require_minor = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var minor = (a, loose) => new SemVer(a, loose).minor;
+  module.exports = minor;
+});
+
+// node_modules/semver/functions/patch.js
+var require_patch = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var patch = (a, loose) => new SemVer(a, loose).patch;
+  module.exports = patch;
+});
+
+// node_modules/semver/functions/prerelease.js
+var require_prerelease = __commonJS((exports, module) => {
+  var parse5 = require_parse();
+  var prerelease = (version2, options) => {
+    const parsed = parse5(version2, options);
+    return parsed && parsed.prerelease.length ? parsed.prerelease : null;
+  };
+  module.exports = prerelease;
+});
+
+// node_modules/semver/functions/compare.js
+var require_compare = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var compare = (a, b, loose) => new SemVer(a, loose).compare(new SemVer(b, loose));
+  module.exports = compare;
+});
+
+// node_modules/semver/functions/rcompare.js
+var require_rcompare = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var rcompare = (a, b, loose) => compare(b, a, loose);
+  module.exports = rcompare;
+});
+
+// node_modules/semver/functions/compare-loose.js
+var require_compare_loose = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var compareLoose = (a, b) => compare(a, b, true);
+  module.exports = compareLoose;
+});
+
+// node_modules/semver/functions/compare-build.js
+var require_compare_build = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var compareBuild = (a, b, loose) => {
+    const versionA = new SemVer(a, loose);
+    const versionB = new SemVer(b, loose);
+    return versionA.compare(versionB) || versionA.compareBuild(versionB);
+  };
+  module.exports = compareBuild;
+});
+
+// node_modules/semver/functions/sort.js
+var require_sort = __commonJS((exports, module) => {
+  var compareBuild = require_compare_build();
+  var sort = (list, loose) => list.sort((a, b) => compareBuild(a, b, loose));
+  module.exports = sort;
+});
+
+// node_modules/semver/functions/rsort.js
+var require_rsort = __commonJS((exports, module) => {
+  var compareBuild = require_compare_build();
+  var rsort = (list, loose) => list.sort((a, b) => compareBuild(b, a, loose));
+  module.exports = rsort;
+});
+
+// node_modules/semver/functions/gt.js
+var require_gt = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var gt = (a, b, loose) => compare(a, b, loose) > 0;
+  module.exports = gt;
+});
+
+// node_modules/semver/functions/lt.js
+var require_lt = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var lt = (a, b, loose) => compare(a, b, loose) < 0;
+  module.exports = lt;
+});
+
+// node_modules/semver/functions/eq.js
+var require_eq = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var eq = (a, b, loose) => compare(a, b, loose) === 0;
+  module.exports = eq;
+});
+
+// node_modules/semver/functions/neq.js
+var require_neq = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var neq = (a, b, loose) => compare(a, b, loose) !== 0;
+  module.exports = neq;
+});
+
+// node_modules/semver/functions/gte.js
+var require_gte = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var gte = (a, b, loose) => compare(a, b, loose) >= 0;
+  module.exports = gte;
+});
+
+// node_modules/semver/functions/lte.js
+var require_lte = __commonJS((exports, module) => {
+  var compare = require_compare();
+  var lte = (a, b, loose) => compare(a, b, loose) <= 0;
+  module.exports = lte;
+});
+
+// node_modules/semver/functions/cmp.js
+var require_cmp = __commonJS((exports, module) => {
+  var eq = require_eq();
+  var neq = require_neq();
+  var gt = require_gt();
+  var gte = require_gte();
+  var lt = require_lt();
+  var lte = require_lte();
+  var cmp = (a, op, b, loose) => {
+    switch (op) {
+      case "===":
+        if (typeof a === "object") {
+          a = a.version;
+        }
+        if (typeof b === "object") {
+          b = b.version;
+        }
+        return a === b;
+      case "!==":
+        if (typeof a === "object") {
+          a = a.version;
+        }
+        if (typeof b === "object") {
+          b = b.version;
+        }
+        return a !== b;
+      case "":
+      case "=":
+      case "==":
+        return eq(a, b, loose);
+      case "!=":
+        return neq(a, b, loose);
+      case ">":
+        return gt(a, b, loose);
+      case ">=":
+        return gte(a, b, loose);
+      case "<":
+        return lt(a, b, loose);
+      case "<=":
+        return lte(a, b, loose);
+      default:
+        throw new TypeError(`Invalid operator: ${op}`);
+    }
+  };
+  module.exports = cmp;
+});
+
+// node_modules/semver/functions/coerce.js
+var require_coerce = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var parse5 = require_parse();
+  var { safeRe: re, t } = require_re();
+  var coerce = (version2, options) => {
+    if (version2 instanceof SemVer) {
+      return version2;
+    }
+    if (typeof version2 === "number") {
+      version2 = String(version2);
+    }
+    if (typeof version2 !== "string") {
+      return null;
+    }
+    options = options || {};
+    let match = null;
+    if (!options.rtl) {
+      match = version2.match(options.includePrerelease ? re[t.COERCEFULL] : re[t.COERCE]);
+    } else {
+      const coerceRtlRegex = options.includePrerelease ? re[t.COERCERTLFULL] : re[t.COERCERTL];
+      let next;
+      while ((next = coerceRtlRegex.exec(version2)) && (!match || match.index + match[0].length !== version2.length)) {
+        if (!match || next.index + next[0].length !== match.index + match[0].length) {
+          match = next;
+        }
+        coerceRtlRegex.lastIndex = next.index + next[1].length + next[2].length;
+      }
+      coerceRtlRegex.lastIndex = -1;
+    }
+    if (match === null) {
+      return null;
+    }
+    const major = match[2];
+    const minor = match[3] || "0";
+    const patch = match[4] || "0";
+    const prerelease = options.includePrerelease && match[5] ? `-${match[5]}` : "";
+    const build = options.includePrerelease && match[6] ? `+${match[6]}` : "";
+    return parse5(`${major}.${minor}.${patch}${prerelease}${build}`, options);
+  };
+  module.exports = coerce;
+});
+
+// node_modules/semver/internal/lrucache.js
+var require_lrucache = __commonJS((exports, module) => {
+  class LRUCache {
+    constructor() {
+      this.max = 1000;
+      this.map = new Map;
+    }
+    get(key) {
+      const value = this.map.get(key);
+      if (value === undefined) {
+        return;
+      } else {
+        this.map.delete(key);
+        this.map.set(key, value);
+        return value;
+      }
+    }
+    delete(key) {
+      return this.map.delete(key);
+    }
+    set(key, value) {
+      const deleted = this.delete(key);
+      if (!deleted && value !== undefined) {
+        if (this.map.size >= this.max) {
+          const firstKey = this.map.keys().next().value;
+          this.delete(firstKey);
+        }
+        this.map.set(key, value);
+      }
+      return this;
+    }
+  }
+  module.exports = LRUCache;
+});
+
+// node_modules/semver/classes/range.js
+var require_range = __commonJS((exports, module) => {
+  var SPACE_CHARACTERS = /\s+/g;
+
+  class Range {
+    constructor(range, options) {
+      options = parseOptions(options);
+      if (range instanceof Range) {
+        if (range.loose === !!options.loose && range.includePrerelease === !!options.includePrerelease) {
+          return range;
+        } else {
+          return new Range(range.raw, options);
+        }
+      }
+      if (range instanceof Comparator) {
+        this.raw = range.value;
+        this.set = [[range]];
+        this.formatted = undefined;
+        return this;
+      }
+      this.options = options;
+      this.loose = !!options.loose;
+      this.includePrerelease = !!options.includePrerelease;
+      this.raw = range.trim().replace(SPACE_CHARACTERS, " ");
+      this.set = this.raw.split("||").map((r) => this.parseRange(r.trim())).filter((c) => c.length);
+      if (!this.set.length) {
+        throw new TypeError(`Invalid SemVer Range: ${this.raw}`);
+      }
+      if (this.set.length > 1) {
+        const first = this.set[0];
+        this.set = this.set.filter((c) => !isNullSet(c[0]));
+        if (this.set.length === 0) {
+          this.set = [first];
+        } else if (this.set.length > 1) {
+          for (const c of this.set) {
+            if (c.length === 1 && isAny(c[0])) {
+              this.set = [c];
+              break;
+            }
+          }
+        }
+      }
+      this.formatted = undefined;
+    }
+    get range() {
+      if (this.formatted === undefined) {
+        this.formatted = "";
+        for (let i = 0;i < this.set.length; i++) {
+          if (i > 0) {
+            this.formatted += "||";
+          }
+          const comps = this.set[i];
+          for (let k = 0;k < comps.length; k++) {
+            if (k > 0) {
+              this.formatted += " ";
+            }
+            this.formatted += comps[k].toString().trim();
+          }
+        }
+      }
+      return this.formatted;
+    }
+    format() {
+      return this.range;
+    }
+    toString() {
+      return this.range;
+    }
+    parseRange(range) {
+      const memoOpts = (this.options.includePrerelease && FLAG_INCLUDE_PRERELEASE) | (this.options.loose && FLAG_LOOSE);
+      const memoKey = memoOpts + ":" + range;
+      const cached2 = cache.get(memoKey);
+      if (cached2) {
+        return cached2;
+      }
+      const loose = this.options.loose;
+      const hr = loose ? re[t.HYPHENRANGELOOSE] : re[t.HYPHENRANGE];
+      range = range.replace(hr, hyphenReplace(this.options.includePrerelease));
+      debug("hyphen replace", range);
+      range = range.replace(re[t.COMPARATORTRIM], comparatorTrimReplace);
+      debug("comparator trim", range);
+      range = range.replace(re[t.TILDETRIM], tildeTrimReplace);
+      debug("tilde trim", range);
+      range = range.replace(re[t.CARETTRIM], caretTrimReplace);
+      debug("caret trim", range);
+      let rangeList = range.split(" ").map((comp) => parseComparator(comp, this.options)).join(" ").split(/\s+/).map((comp) => replaceGTE0(comp, this.options));
+      if (loose) {
+        rangeList = rangeList.filter((comp) => {
+          debug("loose invalid filter", comp, this.options);
+          return !!comp.match(re[t.COMPARATORLOOSE]);
+        });
+      }
+      debug("range list", rangeList);
+      const rangeMap = new Map;
+      const comparators = rangeList.map((comp) => new Comparator(comp, this.options));
+      for (const comp of comparators) {
+        if (isNullSet(comp)) {
+          return [comp];
+        }
+        rangeMap.set(comp.value, comp);
+      }
+      if (rangeMap.size > 1 && rangeMap.has("")) {
+        rangeMap.delete("");
+      }
+      const result = [...rangeMap.values()];
+      cache.set(memoKey, result);
+      return result;
+    }
+    intersects(range, options) {
+      if (!(range instanceof Range)) {
+        throw new TypeError("a Range is required");
+      }
+      return this.set.some((thisComparators) => {
+        return isSatisfiable(thisComparators, options) && range.set.some((rangeComparators) => {
+          return isSatisfiable(rangeComparators, options) && thisComparators.every((thisComparator) => {
+            return rangeComparators.every((rangeComparator) => {
+              return thisComparator.intersects(rangeComparator, options);
+            });
+          });
+        });
+      });
+    }
+    test(version2) {
+      if (!version2) {
+        return false;
+      }
+      if (typeof version2 === "string") {
+        try {
+          version2 = new SemVer(version2, this.options);
+        } catch (er) {
+          return false;
+        }
+      }
+      for (let i = 0;i < this.set.length; i++) {
+        if (testSet(this.set[i], version2, this.options)) {
+          return true;
+        }
+      }
+      return false;
+    }
+  }
+  module.exports = Range;
+  var LRU = require_lrucache();
+  var cache = new LRU;
+  var parseOptions = require_parse_options();
+  var Comparator = require_comparator();
+  var debug = require_debug();
+  var SemVer = require_semver();
+  var {
+    safeRe: re,
+    t,
+    comparatorTrimReplace,
+    tildeTrimReplace,
+    caretTrimReplace
+  } = require_re();
+  var { FLAG_INCLUDE_PRERELEASE, FLAG_LOOSE } = require_constants();
+  var isNullSet = (c) => c.value === "<0.0.0-0";
+  var isAny = (c) => c.value === "";
+  var isSatisfiable = (comparators, options) => {
+    let result = true;
+    const remainingComparators = comparators.slice();
+    let testComparator = remainingComparators.pop();
+    while (result && remainingComparators.length) {
+      result = remainingComparators.every((otherComparator) => {
+        return testComparator.intersects(otherComparator, options);
+      });
+      testComparator = remainingComparators.pop();
+    }
+    return result;
+  };
+  var parseComparator = (comp, options) => {
+    comp = comp.replace(re[t.BUILD], "");
+    debug("comp", comp, options);
+    comp = replaceCarets(comp, options);
+    debug("caret", comp);
+    comp = replaceTildes(comp, options);
+    debug("tildes", comp);
+    comp = replaceXRanges(comp, options);
+    debug("xrange", comp);
+    comp = replaceStars(comp, options);
+    debug("stars", comp);
+    return comp;
+  };
+  var isX = (id) => !id || id.toLowerCase() === "x" || id === "*";
+  var replaceTildes = (comp, options) => {
+    return comp.trim().split(/\s+/).map((c) => replaceTilde(c, options)).join(" ");
+  };
+  var replaceTilde = (comp, options) => {
+    const r = options.loose ? re[t.TILDELOOSE] : re[t.TILDE];
+    return comp.replace(r, (_, M, m, p, pr) => {
+      debug("tilde", comp, _, M, m, p, pr);
+      let ret;
+      if (isX(M)) {
+        ret = "";
+      } else if (isX(m)) {
+        ret = `>=${M}.0.0 <${+M + 1}.0.0-0`;
+      } else if (isX(p)) {
+        ret = `>=${M}.${m}.0 <${M}.${+m + 1}.0-0`;
+      } else if (pr) {
+        debug("replaceTilde pr", pr);
+        ret = `>=${M}.${m}.${p}-${pr} <${M}.${+m + 1}.0-0`;
+      } else {
+        ret = `>=${M}.${m}.${p} <${M}.${+m + 1}.0-0`;
+      }
+      debug("tilde return", ret);
+      return ret;
+    });
+  };
+  var replaceCarets = (comp, options) => {
+    return comp.trim().split(/\s+/).map((c) => replaceCaret(c, options)).join(" ");
+  };
+  var replaceCaret = (comp, options) => {
+    debug("caret", comp, options);
+    const r = options.loose ? re[t.CARETLOOSE] : re[t.CARET];
+    const z2 = options.includePrerelease ? "-0" : "";
+    return comp.replace(r, (_, M, m, p, pr) => {
+      debug("caret", comp, _, M, m, p, pr);
+      let ret;
+      if (isX(M)) {
+        ret = "";
+      } else if (isX(m)) {
+        ret = `>=${M}.0.0${z2} <${+M + 1}.0.0-0`;
+      } else if (isX(p)) {
+        if (M === "0") {
+          ret = `>=${M}.${m}.0${z2} <${M}.${+m + 1}.0-0`;
+        } else {
+          ret = `>=${M}.${m}.0${z2} <${+M + 1}.0.0-0`;
+        }
+      } else if (pr) {
+        debug("replaceCaret pr", pr);
+        if (M === "0") {
+          if (m === "0") {
+            ret = `>=${M}.${m}.${p}-${pr} <${M}.${m}.${+p + 1}-0`;
+          } else {
+            ret = `>=${M}.${m}.${p}-${pr} <${M}.${+m + 1}.0-0`;
+          }
+        } else {
+          ret = `>=${M}.${m}.${p}-${pr} <${+M + 1}.0.0-0`;
+        }
+      } else {
+        debug("no pr");
+        if (M === "0") {
+          if (m === "0") {
+            ret = `>=${M}.${m}.${p}${z2} <${M}.${m}.${+p + 1}-0`;
+          } else {
+            ret = `>=${M}.${m}.${p}${z2} <${M}.${+m + 1}.0-0`;
+          }
+        } else {
+          ret = `>=${M}.${m}.${p} <${+M + 1}.0.0-0`;
+        }
+      }
+      debug("caret return", ret);
+      return ret;
+    });
+  };
+  var replaceXRanges = (comp, options) => {
+    debug("replaceXRanges", comp, options);
+    return comp.split(/\s+/).map((c) => replaceXRange(c, options)).join(" ");
+  };
+  var replaceXRange = (comp, options) => {
+    comp = comp.trim();
+    const r = options.loose ? re[t.XRANGELOOSE] : re[t.XRANGE];
+    return comp.replace(r, (ret, gtlt, M, m, p, pr) => {
+      debug("xRange", comp, ret, gtlt, M, m, p, pr);
+      const xM = isX(M);
+      const xm = xM || isX(m);
+      const xp = xm || isX(p);
+      const anyX = xp;
+      if (gtlt === "=" && anyX) {
+        gtlt = "";
+      }
+      pr = options.includePrerelease ? "-0" : "";
+      if (xM) {
+        if (gtlt === ">" || gtlt === "<") {
+          ret = "<0.0.0-0";
+        } else {
+          ret = "*";
+        }
+      } else if (gtlt && anyX) {
+        if (xm) {
+          m = 0;
+        }
+        p = 0;
+        if (gtlt === ">") {
+          gtlt = ">=";
+          if (xm) {
+            M = +M + 1;
+            m = 0;
+            p = 0;
+          } else {
+            m = +m + 1;
+            p = 0;
+          }
+        } else if (gtlt === "<=") {
+          gtlt = "<";
+          if (xm) {
+            M = +M + 1;
+          } else {
+            m = +m + 1;
+          }
+        }
+        if (gtlt === "<") {
+          pr = "-0";
+        }
+        ret = `${gtlt + M}.${m}.${p}${pr}`;
+      } else if (xm) {
+        ret = `>=${M}.0.0${pr} <${+M + 1}.0.0-0`;
+      } else if (xp) {
+        ret = `>=${M}.${m}.0${pr} <${M}.${+m + 1}.0-0`;
+      }
+      debug("xRange return", ret);
+      return ret;
+    });
+  };
+  var replaceStars = (comp, options) => {
+    debug("replaceStars", comp, options);
+    return comp.trim().replace(re[t.STAR], "");
+  };
+  var replaceGTE0 = (comp, options) => {
+    debug("replaceGTE0", comp, options);
+    return comp.trim().replace(re[options.includePrerelease ? t.GTE0PRE : t.GTE0], "");
+  };
+  var hyphenReplace = (incPr) => ($0, from, fM, fm, fp, fpr, fb, to, tM, tm, tp, tpr) => {
+    if (isX(fM)) {
+      from = "";
+    } else if (isX(fm)) {
+      from = `>=${fM}.0.0${incPr ? "-0" : ""}`;
+    } else if (isX(fp)) {
+      from = `>=${fM}.${fm}.0${incPr ? "-0" : ""}`;
+    } else if (fpr) {
+      from = `>=${from}`;
+    } else {
+      from = `>=${from}${incPr ? "-0" : ""}`;
+    }
+    if (isX(tM)) {
+      to = "";
+    } else if (isX(tm)) {
+      to = `<${+tM + 1}.0.0-0`;
+    } else if (isX(tp)) {
+      to = `<${tM}.${+tm + 1}.0-0`;
+    } else if (tpr) {
+      to = `<=${tM}.${tm}.${tp}-${tpr}`;
+    } else if (incPr) {
+      to = `<${tM}.${tm}.${+tp + 1}-0`;
+    } else {
+      to = `<=${to}`;
+    }
+    return `${from} ${to}`.trim();
+  };
+  var testSet = (set2, version2, options) => {
+    for (let i = 0;i < set2.length; i++) {
+      if (!set2[i].test(version2)) {
+        return false;
+      }
+    }
+    if (version2.prerelease.length && !options.includePrerelease) {
+      for (let i = 0;i < set2.length; i++) {
+        debug(set2[i].semver);
+        if (set2[i].semver === Comparator.ANY) {
+          continue;
+        }
+        if (set2[i].semver.prerelease.length > 0) {
+          const allowed = set2[i].semver;
+          if (allowed.major === version2.major && allowed.minor === version2.minor && allowed.patch === version2.patch) {
+            return true;
+          }
+        }
+      }
+      return false;
+    }
+    return true;
+  };
+});
+
+// node_modules/semver/classes/comparator.js
+var require_comparator = __commonJS((exports, module) => {
+  var ANY = Symbol("SemVer ANY");
+
+  class Comparator {
+    static get ANY() {
+      return ANY;
+    }
+    constructor(comp, options) {
+      options = parseOptions(options);
+      if (comp instanceof Comparator) {
+        if (comp.loose === !!options.loose) {
+          return comp;
+        } else {
+          comp = comp.value;
+        }
+      }
+      comp = comp.trim().split(/\s+/).join(" ");
+      debug("comparator", comp, options);
+      this.options = options;
+      this.loose = !!options.loose;
+      this.parse(comp);
+      if (this.semver === ANY) {
+        this.value = "";
+      } else {
+        this.value = this.operator + this.semver.version;
+      }
+      debug("comp", this);
+    }
+    parse(comp) {
+      const r = this.options.loose ? re[t.COMPARATORLOOSE] : re[t.COMPARATOR];
+      const m = comp.match(r);
+      if (!m) {
+        throw new TypeError(`Invalid comparator: ${comp}`);
+      }
+      this.operator = m[1] !== undefined ? m[1] : "";
+      if (this.operator === "=") {
+        this.operator = "";
+      }
+      if (!m[2]) {
+        this.semver = ANY;
+      } else {
+        this.semver = new SemVer(m[2], this.options.loose);
+      }
+    }
+    toString() {
+      return this.value;
+    }
+    test(version2) {
+      debug("Comparator.test", version2, this.options.loose);
+      if (this.semver === ANY || version2 === ANY) {
+        return true;
+      }
+      if (typeof version2 === "string") {
+        try {
+          version2 = new SemVer(version2, this.options);
+        } catch (er) {
+          return false;
+        }
+      }
+      return cmp(version2, this.operator, this.semver, this.options);
+    }
+    intersects(comp, options) {
+      if (!(comp instanceof Comparator)) {
+        throw new TypeError("a Comparator is required");
+      }
+      if (this.operator === "") {
+        if (this.value === "") {
+          return true;
+        }
+        return new Range(comp.value, options).test(this.value);
+      } else if (comp.operator === "") {
+        if (comp.value === "") {
+          return true;
+        }
+        return new Range(this.value, options).test(comp.semver);
+      }
+      options = parseOptions(options);
+      if (options.includePrerelease && (this.value === "<0.0.0-0" || comp.value === "<0.0.0-0")) {
+        return false;
+      }
+      if (!options.includePrerelease && (this.value.startsWith("<0.0.0") || comp.value.startsWith("<0.0.0"))) {
+        return false;
+      }
+      if (this.operator.startsWith(">") && comp.operator.startsWith(">")) {
+        return true;
+      }
+      if (this.operator.startsWith("<") && comp.operator.startsWith("<")) {
+        return true;
+      }
+      if (this.semver.version === comp.semver.version && this.operator.includes("=") && comp.operator.includes("=")) {
+        return true;
+      }
+      if (cmp(this.semver, "<", comp.semver, options) && this.operator.startsWith(">") && comp.operator.startsWith("<")) {
+        return true;
+      }
+      if (cmp(this.semver, ">", comp.semver, options) && this.operator.startsWith("<") && comp.operator.startsWith(">")) {
+        return true;
+      }
+      return false;
+    }
+  }
+  module.exports = Comparator;
+  var parseOptions = require_parse_options();
+  var { safeRe: re, t } = require_re();
+  var cmp = require_cmp();
+  var debug = require_debug();
+  var SemVer = require_semver();
+  var Range = require_range();
+});
+
+// node_modules/semver/functions/satisfies.js
+var require_satisfies = __commonJS((exports, module) => {
+  var Range = require_range();
+  var satisfies = (version2, range, options) => {
+    try {
+      range = new Range(range, options);
+    } catch (er) {
+      return false;
+    }
+    return range.test(version2);
+  };
+  module.exports = satisfies;
+});
+
+// node_modules/semver/ranges/to-comparators.js
+var require_to_comparators = __commonJS((exports, module) => {
+  var Range = require_range();
+  var toComparators = (range, options) => new Range(range, options).set.map((comp) => comp.map((c) => c.value).join(" ").trim().split(" "));
+  module.exports = toComparators;
+});
+
+// node_modules/semver/ranges/max-satisfying.js
+var require_max_satisfying = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var Range = require_range();
+  var maxSatisfying = (versions2, range, options) => {
+    let max = null;
+    let maxSV = null;
+    let rangeObj = null;
+    try {
+      rangeObj = new Range(range, options);
+    } catch (er) {
+      return null;
+    }
+    versions2.forEach((v) => {
+      if (rangeObj.test(v)) {
+        if (!max || maxSV.compare(v) === -1) {
+          max = v;
+          maxSV = new SemVer(max, options);
+        }
+      }
+    });
+    return max;
+  };
+  module.exports = maxSatisfying;
+});
+
+// node_modules/semver/ranges/min-satisfying.js
+var require_min_satisfying = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var Range = require_range();
+  var minSatisfying = (versions2, range, options) => {
+    let min = null;
+    let minSV = null;
+    let rangeObj = null;
+    try {
+      rangeObj = new Range(range, options);
+    } catch (er) {
+      return null;
+    }
+    versions2.forEach((v) => {
+      if (rangeObj.test(v)) {
+        if (!min || minSV.compare(v) === 1) {
+          min = v;
+          minSV = new SemVer(min, options);
+        }
+      }
+    });
+    return min;
+  };
+  module.exports = minSatisfying;
+});
+
+// node_modules/semver/ranges/min-version.js
+var require_min_version = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var Range = require_range();
+  var gt = require_gt();
+  var minVersion = (range, loose) => {
+    range = new Range(range, loose);
+    let minver = new SemVer("0.0.0");
+    if (range.test(minver)) {
+      return minver;
+    }
+    minver = new SemVer("0.0.0-0");
+    if (range.test(minver)) {
+      return minver;
+    }
+    minver = null;
+    for (let i = 0;i < range.set.length; ++i) {
+      const comparators = range.set[i];
+      let setMin = null;
+      comparators.forEach((comparator) => {
+        const compver = new SemVer(comparator.semver.version);
+        switch (comparator.operator) {
+          case ">":
+            if (compver.prerelease.length === 0) {
+              compver.patch++;
+            } else {
+              compver.prerelease.push(0);
+            }
+            compver.raw = compver.format();
+          case "":
+          case ">=":
+            if (!setMin || gt(compver, setMin)) {
+              setMin = compver;
+            }
+            break;
+          case "<":
+          case "<=":
+            break;
+          default:
+            throw new Error(`Unexpected operation: ${comparator.operator}`);
+        }
+      });
+      if (setMin && (!minver || gt(minver, setMin))) {
+        minver = setMin;
+      }
+    }
+    if (minver && range.test(minver)) {
+      return minver;
+    }
+    return null;
+  };
+  module.exports = minVersion;
+});
+
+// node_modules/semver/ranges/valid.js
+var require_valid2 = __commonJS((exports, module) => {
+  var Range = require_range();
+  var validRange = (range, options) => {
+    try {
+      return new Range(range, options).range || "*";
+    } catch (er) {
+      return null;
+    }
+  };
+  module.exports = validRange;
+});
+
+// node_modules/semver/ranges/outside.js
+var require_outside = __commonJS((exports, module) => {
+  var SemVer = require_semver();
+  var Comparator = require_comparator();
+  var { ANY } = Comparator;
+  var Range = require_range();
+  var satisfies = require_satisfies();
+  var gt = require_gt();
+  var lt = require_lt();
+  var lte = require_lte();
+  var gte = require_gte();
+  var outside = (version2, range, hilo, options) => {
+    version2 = new SemVer(version2, options);
+    range = new Range(range, options);
+    let gtfn, ltefn, ltfn, comp, ecomp;
+    switch (hilo) {
+      case ">":
+        gtfn = gt;
+        ltefn = lte;
+        ltfn = lt;
+        comp = ">";
+        ecomp = ">=";
+        break;
+      case "<":
+        gtfn = lt;
+        ltefn = gte;
+        ltfn = gt;
+        comp = "<";
+        ecomp = "<=";
+        break;
+      default:
+        throw new TypeError('Must provide a hilo val of "<" or ">"');
+    }
+    if (satisfies(version2, range, options)) {
+      return false;
+    }
+    for (let i = 0;i < range.set.length; ++i) {
+      const comparators = range.set[i];
+      let high = null;
+      let low = null;
+      comparators.forEach((comparator) => {
+        if (comparator.semver === ANY) {
+          comparator = new Comparator(">=0.0.0");
+        }
+        high = high || comparator;
+        low = low || comparator;
+        if (gtfn(comparator.semver, high.semver, options)) {
+          high = comparator;
+        } else if (ltfn(comparator.semver, low.semver, options)) {
+          low = comparator;
+        }
+      });
+      if (high.operator === comp || high.operator === ecomp) {
+        return false;
+      }
+      if ((!low.operator || low.operator === comp) && ltefn(version2, low.semver)) {
+        return false;
+      } else if (low.operator === ecomp && ltfn(version2, low.semver)) {
+        return false;
+      }
+    }
+    return true;
+  };
+  module.exports = outside;
+});
+
+// node_modules/semver/ranges/gtr.js
+var require_gtr = __commonJS((exports, module) => {
+  var outside = require_outside();
+  var gtr = (version2, range, options) => outside(version2, range, ">", options);
+  module.exports = gtr;
+});
+
+// node_modules/semver/ranges/ltr.js
+var require_ltr = __commonJS((exports, module) => {
+  var outside = require_outside();
+  var ltr = (version2, range, options) => outside(version2, range, "<", options);
+  module.exports = ltr;
+});
+
+// node_modules/semver/ranges/intersects.js
+var require_intersects = __commonJS((exports, module) => {
+  var Range = require_range();
+  var intersects = (r1, r2, options) => {
+    r1 = new Range(r1, options);
+    r2 = new Range(r2, options);
+    return r1.intersects(r2, options);
+  };
+  module.exports = intersects;
+});
+
+// node_modules/semver/ranges/simplify.js
+var require_simplify = __commonJS((exports, module) => {
+  var satisfies = require_satisfies();
+  var compare = require_compare();
+  module.exports = (versions2, range, options) => {
+    const set2 = [];
+    let first = null;
+    let prev = null;
+    const v = versions2.sort((a, b) => compare(a, b, options));
+    for (const version2 of v) {
+      const included = satisfies(version2, range, options);
+      if (included) {
+        prev = version2;
+        if (!first) {
+          first = version2;
+        }
+      } else {
+        if (prev) {
+          set2.push([first, prev]);
+        }
+        prev = null;
+        first = null;
+      }
+    }
+    if (first) {
+      set2.push([first, null]);
+    }
+    const ranges = [];
+    for (const [min, max] of set2) {
+      if (min === max) {
+        ranges.push(min);
+      } else if (!max && min === v[0]) {
+        ranges.push("*");
+      } else if (!max) {
+        ranges.push(`>=${min}`);
+      } else if (min === v[0]) {
+        ranges.push(`<=${max}`);
+      } else {
+        ranges.push(`${min} - ${max}`);
+      }
+    }
+    const simplified = ranges.join(" || ");
+    const original = typeof range.raw === "string" ? range.raw : String(range);
+    return simplified.length < original.length ? simplified : range;
+  };
+});
+
+// node_modules/semver/ranges/subset.js
+var require_subset = __commonJS((exports, module) => {
+  var Range = require_range();
+  var Comparator = require_comparator();
+  var { ANY } = Comparator;
+  var satisfies = require_satisfies();
+  var compare = require_compare();
+  var subset = (sub, dom, options = {}) => {
+    if (sub === dom) {
+      return true;
+    }
+    sub = new Range(sub, options);
+    dom = new Range(dom, options);
+    let sawNonNull = false;
+    OUTER:
+      for (const simpleSub of sub.set) {
+        for (const simpleDom of dom.set) {
+          const isSub = simpleSubset(simpleSub, simpleDom, options);
+          sawNonNull = sawNonNull || isSub !== null;
+          if (isSub) {
+            continue OUTER;
+          }
+        }
+        if (sawNonNull) {
+          return false;
+        }
+      }
+    return true;
+  };
+  var minimumVersionWithPreRelease = [new Comparator(">=0.0.0-0")];
+  var minimumVersion = [new Comparator(">=0.0.0")];
+  var simpleSubset = (sub, dom, options) => {
+    if (sub === dom) {
+      return true;
+    }
+    if (sub.length === 1 && sub[0].semver === ANY) {
+      if (dom.length === 1 && dom[0].semver === ANY) {
+        return true;
+      } else if (options.includePrerelease) {
+        sub = minimumVersionWithPreRelease;
+      } else {
+        sub = minimumVersion;
+      }
+    }
+    if (dom.length === 1 && dom[0].semver === ANY) {
+      if (options.includePrerelease) {
+        return true;
+      } else {
+        dom = minimumVersion;
+      }
+    }
+    const eqSet = new Set;
+    let gt, lt;
+    for (const c of sub) {
+      if (c.operator === ">" || c.operator === ">=") {
+        gt = higherGT(gt, c, options);
+      } else if (c.operator === "<" || c.operator === "<=") {
+        lt = lowerLT(lt, c, options);
+      } else {
+        eqSet.add(c.semver);
+      }
+    }
+    if (eqSet.size > 1) {
+      return null;
+    }
+    let gtltComp;
+    if (gt && lt) {
+      gtltComp = compare(gt.semver, lt.semver, options);
+      if (gtltComp > 0) {
+        return null;
+      } else if (gtltComp === 0 && (gt.operator !== ">=" || lt.operator !== "<=")) {
+        return null;
+      }
+    }
+    for (const eq of eqSet) {
+      if (gt && !satisfies(eq, String(gt), options)) {
+        return null;
+      }
+      if (lt && !satisfies(eq, String(lt), options)) {
+        return null;
+      }
+      for (const c of dom) {
+        if (!satisfies(eq, String(c), options)) {
+          return false;
+        }
+      }
+      return true;
+    }
+    let higher, lower;
+    let hasDomLT, hasDomGT;
+    let needDomLTPre = lt && !options.includePrerelease && lt.semver.prerelease.length ? lt.semver : false;
+    let needDomGTPre = gt && !options.includePrerelease && gt.semver.prerelease.length ? gt.semver : false;
+    if (needDomLTPre && needDomLTPre.prerelease.length === 1 && lt.operator === "<" && needDomLTPre.prerelease[0] === 0) {
+      needDomLTPre = false;
+    }
+    for (const c of dom) {
+      hasDomGT = hasDomGT || c.operator === ">" || c.operator === ">=";
+      hasDomLT = hasDomLT || c.operator === "<" || c.operator === "<=";
+      if (gt) {
+        if (needDomGTPre) {
+          if (c.semver.prerelease && c.semver.prerelease.length && c.semver.major === needDomGTPre.major && c.semver.minor === needDomGTPre.minor && c.semver.patch === needDomGTPre.patch) {
+            needDomGTPre = false;
+          }
+        }
+        if (c.operator === ">" || c.operator === ">=") {
+          higher = higherGT(gt, c, options);
+          if (higher === c && higher !== gt) {
+            return false;
+          }
+        } else if (gt.operator === ">=" && !satisfies(gt.semver, String(c), options)) {
+          return false;
+        }
+      }
+      if (lt) {
+        if (needDomLTPre) {
+          if (c.semver.prerelease && c.semver.prerelease.length && c.semver.major === needDomLTPre.major && c.semver.minor === needDomLTPre.minor && c.semver.patch === needDomLTPre.patch) {
+            needDomLTPre = false;
+          }
+        }
+        if (c.operator === "<" || c.operator === "<=") {
+          lower = lowerLT(lt, c, options);
+          if (lower === c && lower !== lt) {
+            return false;
+          }
+        } else if (lt.operator === "<=" && !satisfies(lt.semver, String(c), options)) {
+          return false;
+        }
+      }
+      if (!c.operator && (lt || gt) && gtltComp !== 0) {
+        return false;
+      }
+    }
+    if (gt && hasDomLT && !lt && gtltComp !== 0) {
+      return false;
+    }
+    if (lt && hasDomGT && !gt && gtltComp !== 0) {
+      return false;
+    }
+    if (needDomGTPre || needDomLTPre) {
+      return false;
+    }
+    return true;
+  };
+  var higherGT = (a, b, options) => {
+    if (!a) {
+      return b;
+    }
+    const comp = compare(a.semver, b.semver, options);
+    return comp > 0 ? a : comp < 0 ? b : b.operator === ">" && a.operator === ">=" ? b : a;
+  };
+  var lowerLT = (a, b, options) => {
+    if (!a) {
+      return b;
+    }
+    const comp = compare(a.semver, b.semver, options);
+    return comp < 0 ? a : comp > 0 ? b : b.operator === "<" && a.operator === "<=" ? b : a;
+  };
+  module.exports = subset;
+});
+
+// node_modules/semver/index.js
+var require_semver2 = __commonJS((exports, module) => {
+  var internalRe = require_re();
+  var constants = require_constants();
+  var SemVer = require_semver();
+  var identifiers = require_identifiers();
+  var parse5 = require_parse();
+  var valid = require_valid();
+  var clean = require_clean();
+  var inc = require_inc();
+  var diff = require_diff();
+  var major = require_major();
+  var minor = require_minor();
+  var patch = require_patch();
+  var prerelease = require_prerelease();
+  var compare = require_compare();
+  var rcompare = require_rcompare();
+  var compareLoose = require_compare_loose();
+  var compareBuild = require_compare_build();
+  var sort = require_sort();
+  var rsort = require_rsort();
+  var gt = require_gt();
+  var lt = require_lt();
+  var eq = require_eq();
+  var neq = require_neq();
+  var gte = require_gte();
+  var lte = require_lte();
+  var cmp = require_cmp();
+  var coerce = require_coerce();
+  var Comparator = require_comparator();
+  var Range = require_range();
+  var satisfies = require_satisfies();
+  var toComparators = require_to_comparators();
+  var maxSatisfying = require_max_satisfying();
+  var minSatisfying = require_min_satisfying();
+  var minVersion = require_min_version();
+  var validRange = require_valid2();
+  var outside = require_outside();
+  var gtr = require_gtr();
+  var ltr = require_ltr();
+  var intersects = require_intersects();
+  var simplifyRange = require_simplify();
+  var subset = require_subset();
+  module.exports = {
+    parse: parse5,
+    valid,
+    clean,
+    inc,
+    diff,
+    major,
+    minor,
+    patch,
+    prerelease,
+    compare,
+    rcompare,
+    compareLoose,
+    compareBuild,
+    sort,
+    rsort,
+    gt,
+    lt,
+    eq,
+    neq,
+    gte,
+    lte,
+    cmp,
+    coerce,
+    Comparator,
+    Range,
+    satisfies,
+    toComparators,
+    maxSatisfying,
+    minSatisfying,
+    minVersion,
+    validRange,
+    outside,
+    gtr,
+    ltr,
+    intersects,
+    simplifyRange,
+    subset,
+    SemVer,
+    re: internalRe.re,
+    src: internalRe.src,
+    tokens: internalRe.t,
+    SEMVER_SPEC_VERSION: constants.SEMVER_SPEC_VERSION,
+    RELEASE_TYPES: constants.RELEASE_TYPES,
+    compareIdentifiers: identifiers.compareIdentifiers,
+    rcompareIdentifiers: identifiers.rcompareIdentifiers
+  };
+});
+
+// node_modules/chalk/source/vendor/ansi-styles/index.js
+var ANSI_BACKGROUND_OFFSET = 10;
+var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
+var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
+var wrapAnsi16m = (offset = 0) => (red, green, blue) => `\x1B[${38 + offset};2;${red};${green};${blue}m`;
+var styles = {
+  modifier: {
+    reset: [0, 0],
+    bold: [1, 22],
+    dim: [2, 22],
+    italic: [3, 23],
+    underline: [4, 24],
+    overline: [53, 55],
+    inverse: [7, 27],
+    hidden: [8, 28],
+    strikethrough: [9, 29]
+  },
+  color: {
+    black: [30, 39],
+    red: [31, 39],
+    green: [32, 39],
+    yellow: [33, 39],
+    blue: [34, 39],
+    magenta: [35, 39],
+    cyan: [36, 39],
+    white: [37, 39],
+    blackBright: [90, 39],
+    gray: [90, 39],
+    grey: [90, 39],
+    redBright: [91, 39],
+    greenBright: [92, 39],
+    yellowBright: [93, 39],
+    blueBright: [94, 39],
+    magentaBright: [95, 39],
+    cyanBright: [96, 39],
+    whiteBright: [97, 39]
+  },
+  bgColor: {
+    bgBlack: [40, 49],
+    bgRed: [41, 49],
+    bgGreen: [42, 49],
+    bgYellow: [43, 49],
+    bgBlue: [44, 49],
+    bgMagenta: [45, 49],
+    bgCyan: [46, 49],
+    bgWhite: [47, 49],
+    bgBlackBright: [100, 49],
+    bgGray: [100, 49],
+    bgGrey: [100, 49],
+    bgRedBright: [101, 49],
+    bgGreenBright: [102, 49],
+    bgYellowBright: [103, 49],
+    bgBlueBright: [104, 49],
+    bgMagentaBright: [105, 49],
+    bgCyanBright: [106, 49],
+    bgWhiteBright: [107, 49]
+  }
+};
+var modifierNames = Object.keys(styles.modifier);
+var foregroundColorNames = Object.keys(styles.color);
+var backgroundColorNames = Object.keys(styles.bgColor);
+var colorNames = [...foregroundColorNames, ...backgroundColorNames];
+function assembleStyles() {
+  const codes = new Map;
+  for (const [groupName, group] of Object.entries(styles)) {
+    for (const [styleName, style] of Object.entries(group)) {
+      styles[styleName] = {
+        open: `\x1B[${style[0]}m`,
+        close: `\x1B[${style[1]}m`
+      };
+      group[styleName] = styles[styleName];
+      codes.set(style[0], style[1]);
+    }
+    Object.defineProperty(styles, groupName, {
+      value: group,
+      enumerable: false
+    });
+  }
+  Object.defineProperty(styles, "codes", {
+    value: codes,
+    enumerable: false
+  });
+  styles.color.close = "\x1B[39m";
+  styles.bgColor.close = "\x1B[49m";
+  styles.color.ansi = wrapAnsi16();
+  styles.color.ansi256 = wrapAnsi256();
+  styles.color.ansi16m = wrapAnsi16m();
+  styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
+  styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
+  styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
+  Object.defineProperties(styles, {
+    rgbToAnsi256: {
+      value(red, green, blue) {
+        if (red === green && green === blue) {
+          if (red < 8) {
+            return 16;
+          }
+          if (red > 248) {
+            return 231;
+          }
+          return Math.round((red - 8) / 247 * 24) + 232;
+        }
+        return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green / 255 * 5) + Math.round(blue / 255 * 5);
+      },
+      enumerable: false
+    },
+    hexToRgb: {
+      value(hex) {
+        const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
+        if (!matches) {
+          return [0, 0, 0];
+        }
+        let [colorString] = matches;
+        if (colorString.length === 3) {
+          colorString = [...colorString].map((character) => character + character).join("");
+        }
+        const integer = Number.parseInt(colorString, 16);
+        return [
+          integer >> 16 & 255,
+          integer >> 8 & 255,
+          integer & 255
+        ];
+      },
+      enumerable: false
+    },
+    hexToAnsi256: {
+      value: (hex) => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
+      enumerable: false
+    },
+    ansi256ToAnsi: {
+      value(code) {
+        if (code < 8) {
+          return 30 + code;
+        }
+        if (code < 16) {
+          return 90 + (code - 8);
+        }
+        let red;
+        let green;
+        let blue;
+        if (code >= 232) {
+          red = ((code - 232) * 10 + 8) / 255;
+          green = red;
+          blue = red;
+        } else {
+          code -= 16;
+          const remainder = code % 36;
+          red = Math.floor(code / 36) / 5;
+          green = Math.floor(remainder / 6) / 5;
+          blue = remainder % 6 / 5;
+        }
+        const value = Math.max(red, green, blue) * 2;
+        if (value === 0) {
+          return 30;
+        }
+        let result = 30 + (Math.round(blue) << 2 | Math.round(green) << 1 | Math.round(red));
+        if (value === 2) {
+          result += 60;
+        }
+        return result;
+      },
+      enumerable: false
+    },
+    rgbToAnsi: {
+      value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
+      enumerable: false
+    },
+    hexToAnsi: {
+      value: (hex) => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
+      enumerable: false
+    }
+  });
+  return styles;
+}
+var ansiStyles = assembleStyles();
+var ansi_styles_default = ansiStyles;
+
+// node_modules/chalk/source/vendor/supports-color/index.js
+import process2 from "node:process";
+import os from "node:os";
+import tty from "node:tty";
+function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process2.argv) {
+  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
+  const position = argv.indexOf(prefix + flag);
+  const terminatorPosition = argv.indexOf("--");
+  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
+}
+var { env } = process2;
+var flagForceColor;
+if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
+  flagForceColor = 0;
+} else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
+  flagForceColor = 1;
+}
+function envForceColor() {
+  if ("FORCE_COLOR" in env) {
+    if (env.FORCE_COLOR === "true") {
+      return 1;
+    }
+    if (env.FORCE_COLOR === "false") {
       return 0;
     }
     return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
@@ -24582,6 +26483,9 @@ var PROJECT_TYPE_INDICATORS = {
   cli: ["commander", "yargs", "meow", "cac"]
 };
 
+// src/lib/config.ts
+init_errors();
+
 // src/lib/templates.ts
 var HONO_TEMPLATE = {
   name: "hono",
@@ -25312,18 +27216,39 @@ async function readConfig(projectRoot) {
   }
   try {
     const content = await readFile(configPath, "utf-8");
-    const parsed = JSON.parse(content);
+    let parsed;
+    try {
+      parsed = JSON.parse(content);
+    } catch (parseError) {
+      throw new ConfigError("Config file contains invalid JSON", {
+        configPath,
+        hint: `Check ${configPath} for syntax errors (missing commas, brackets, quotes), or run \`pdi init --force\` to regenerate.`,
+        cause: parseError instanceof Error ? parseError : undefined
+      });
+    }
     const result = PDIConfigSchema.safeParse(parsed);
     if (!result.success) {
-      const issues = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
-      throw new Error(`Invalid config: ${issues}`);
+      const issues = result.error.issues.map((i) => ({
+        path: i.path.join("."),
+        message: i.message,
+        expected: "expected" in i ? String(i.expected) : undefined
+      }));
+      throw new ConfigError("Config validation failed", {
+        configPath,
+        validationIssues: issues,
+        hint: `Fix the fields above in ${configPath}, or run \`pdi init --force\` to regenerate.`
+      });
     }
     return result.data;
   } catch (error48) {
-    if (error48 instanceof Error && error48.message.startsWith("Invalid config")) {
+    if (error48 instanceof ConfigError) {
       throw error48;
     }
-    throw new Error(`Failed to read config: ${error48 instanceof Error ? error48.message : "Unknown error"}`);
+    throw new ConfigError("Failed to read config file", {
+      configPath,
+      hint: `Check file permissions for ${configPath}.`,
+      cause: error48 instanceof Error ? error48 : undefined
+    });
   }
 }
 async function writeConfig(projectRoot, config2) {
@@ -25500,6 +27425,7 @@ ${content}`;
 
 // src/commands/add.ts
 init_context7_client();
+init_errors();
 
 // src/lib/fs-utils.ts
 import { existsSync as existsSync3 } from "node:fs";
@@ -25862,11 +27788,13 @@ async function addCommand(frameworks, options) {
   const projectRoot = options.projectRoot || process.cwd();
   const spinner = ora();
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   let config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   let selectedFrameworks = frameworks;
   if (selectedFrameworks.length === 0) {
@@ -25982,9 +27910,9 @@ async function addCommand(frameworks, options) {
       categories: Object.keys(template.structure)
     };
     config2 = updateFrameworkInConfig(config2, frameworkName, frameworkConfig);
-    if (template.libraryId) {
+    if (template.libraryId && config2.mcp) {
       config2.mcp.libraryMappings = {
-        ...config2.mcp.libraryMappings,
+        ...config2.mcp.libraryMappings ?? {},
         [frameworkName]: template.libraryId
       };
     }
@@ -26290,15 +28218,18 @@ async function loadApiKeyFromConfig() {
 // src/commands/clean.ts
 import { join as join6 } from "node:path";
 var import_prompts3 = __toESM(require_prompts3(), 1);
+init_errors();
 async function cleanCommand(options = {}) {
   const projectRoot = options.projectRoot || process.cwd();
   const spinner = ora();
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   let config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   const packageJson = await readPackageJson(projectRoot);
   const installed = packageJson ? detectDependencies(packageJson) : [];
@@ -26620,6 +28551,7 @@ Summary
 import { readdir as readdir2, readFile as readFile5, stat as stat2 } from "node:fs/promises";
 import { extname, join as join8, relative as relative2 } from "node:path";
 var import_prompts4 = __toESM(require_prompts3(), 1);
+init_errors();
 var PATTERN_DETECTORS = [
   {
     name: "Two-Schema Database Pattern",
@@ -27137,11 +29069,13 @@ async function generateCommand(type, options) {
     throw new Error(`Unknown type: ${type}. Available: internal`);
   }
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   let config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   console.log(source_default.bold(`Analyzing codebase...
 `));
@@ -27238,70 +29172,465 @@ async function initCommand(options) {
     console.log(source_default.dim("Use --force to reinitialize."));
     return;
   }
-  spinner.start("Reading package.json...");
-  const packageJson = await readPackageJson(projectRoot);
-  if (!packageJson) {
-    spinner.fail("No package.json found");
-    console.log(source_default.dim("Please run this command in a Node.js project directory."));
-    return;
+  spinner.start("Reading package.json...");
+  const packageJson = await readPackageJson(projectRoot);
+  if (!packageJson) {
+    spinner.fail("No package.json found");
+    console.log(source_default.dim("Please run this command in a Node.js project directory."));
+    return;
+  }
+  spinner.succeed("Found package.json");
+  const projectType = detectProjectType(packageJson);
+  const projectName = packageJson.name || "unnamed-project";
+  console.log(source_default.dim(`Project: ${projectName} (${projectType})`));
+  spinner.start("Creating .claude-docs/ structure...");
+  const docsPath = join9(projectRoot, CLAUDE_DOCS_DIR);
+  const frameworksPath = join9(docsPath, FRAMEWORKS_DIR);
+  const internalPath = join9(docsPath, INTERNAL_DIR);
+  await ensureDir(docsPath);
+  await ensureDir(frameworksPath);
+  if (options.internal) {
+    await ensureDir(internalPath);
+  }
+  spinner.succeed("Created .claude-docs/");
+  spinner.start("Creating config.json...");
+  const config2 = createDefaultConfig(projectName, projectType);
+  await writeConfig(projectRoot, config2);
+  spinner.succeed("Created config.json");
+  const gitignoreUpdated = await updateGitignore(projectRoot);
+  if (gitignoreUpdated) {
+    console.log(source_default.dim("Updated .gitignore"));
+  }
+  if (!options.noDetect) {
+    console.log("");
+    console.log(source_default.bold("Detected dependencies:"));
+    const detected = detectDependencies(packageJson);
+    if (detected.length === 0) {
+      console.log(source_default.dim("  No supported frameworks detected."));
+    } else {
+      for (const dep of detected) {
+        const templateStatus = hasTemplate(dep.framework?.name || "") ? source_default.green("docs available") : source_default.yellow("no template");
+        const frameworkName = dep.framework?.displayName || dep.name;
+        const version2 = dep.framework?.name ? getMajorVersion(dep.version) : dep.version;
+        console.log(`  ${source_default.dim("├──")} ${frameworkName}@${dep.version} → ${frameworkName.toLowerCase()}@${version2} ${templateStatus}`);
+      }
+      console.log("");
+      const frameworkNames = detected.filter((d) => d.framework && hasTemplate(d.framework.name)).map((d) => d.framework.name);
+      if (frameworkNames.length > 0) {
+        console.log(source_default.bold("Next steps:"));
+        console.log(`  ${source_default.cyan(`pdi add ${frameworkNames.join(" ")}`)}`);
+        console.log(source_default.dim("  Or run: pdi sync  (auto-add all detected)"));
+      }
+    }
+  }
+  console.log("");
+  console.log(source_default.green("✓ PDI initialized successfully"));
+}
+
+// src/commands/status.ts
+init_errors();
+
+// src/lib/freshness.ts
+var import_semver = __toESM(require_semver2(), 1);
+
+// node_modules/yocto-queue/index.js
+class Node {
+  value;
+  next;
+  constructor(value) {
+    this.value = value;
+  }
+}
+
+class Queue {
+  #head;
+  #tail;
+  #size;
+  constructor() {
+    this.clear();
+  }
+  enqueue(value) {
+    const node = new Node(value);
+    if (this.#head) {
+      this.#tail.next = node;
+      this.#tail = node;
+    } else {
+      this.#head = node;
+      this.#tail = node;
+    }
+    this.#size++;
+  }
+  dequeue() {
+    const current = this.#head;
+    if (!current) {
+      return;
+    }
+    this.#head = this.#head.next;
+    this.#size--;
+    if (!this.#head) {
+      this.#tail = undefined;
+    }
+    return current.value;
+  }
+  peek() {
+    if (!this.#head) {
+      return;
+    }
+    return this.#head.value;
+  }
+  clear() {
+    this.#head = undefined;
+    this.#tail = undefined;
+    this.#size = 0;
+  }
+  get size() {
+    return this.#size;
+  }
+  *[Symbol.iterator]() {
+    let current = this.#head;
+    while (current) {
+      yield current.value;
+      current = current.next;
+    }
+  }
+  *drain() {
+    while (this.#head) {
+      yield this.dequeue();
+    }
+  }
+}
+
+// node_modules/p-limit/index.js
+function pLimit(concurrency) {
+  validateConcurrency(concurrency);
+  const queue = new Queue;
+  let activeCount = 0;
+  const resumeNext = () => {
+    if (activeCount < concurrency && queue.size > 0) {
+      queue.dequeue()();
+      activeCount++;
+    }
+  };
+  const next = () => {
+    activeCount--;
+    resumeNext();
+  };
+  const run = async (function_, resolve, arguments_) => {
+    const result = (async () => function_(...arguments_))();
+    resolve(result);
+    try {
+      await result;
+    } catch {}
+    next();
+  };
+  const enqueue = (function_, resolve, arguments_) => {
+    new Promise((internalResolve) => {
+      queue.enqueue(internalResolve);
+    }).then(run.bind(undefined, function_, resolve, arguments_));
+    (async () => {
+      await Promise.resolve();
+      if (activeCount < concurrency) {
+        resumeNext();
+      }
+    })();
+  };
+  const generator = (function_, ...arguments_) => new Promise((resolve) => {
+    enqueue(function_, resolve, arguments_);
+  });
+  Object.defineProperties(generator, {
+    activeCount: {
+      get: () => activeCount
+    },
+    pendingCount: {
+      get: () => queue.size
+    },
+    clearQueue: {
+      value() {
+        queue.clear();
+      }
+    },
+    concurrency: {
+      get: () => concurrency,
+      set(newConcurrency) {
+        validateConcurrency(newConcurrency);
+        concurrency = newConcurrency;
+        queueMicrotask(() => {
+          while (activeCount < concurrency && queue.size > 0) {
+            resumeNext();
+          }
+        });
+      }
+    }
+  });
+  return generator;
+}
+function validateConcurrency(concurrency) {
+  if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {
+    throw new TypeError("Expected `concurrency` to be a number from 1 and up");
+  }
+}
+
+// src/lib/registry-client.ts
+var NPM_REGISTRY_URL = "https://registry.npmjs.org";
+var ABBREVIATED_METADATA_ACCEPT = "application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*";
+var REQUEST_TIMEOUT_MS = 5000;
+var MAX_CONCURRENCY = 5;
+async function fetchLatestVersion(packageName) {
+  const encodedName = encodePackageName(packageName);
+  const url2 = `${NPM_REGISTRY_URL}/${encodedName}`;
+  const response = await fetch(url2, {
+    headers: {
+      Accept: ABBREVIATED_METADATA_ACCEPT
+    },
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+  });
+  if (response.status === 404) {
+    return null;
+  }
+  if (!response.ok) {
+    throw new Error(`npm registry error for "${packageName}": HTTP ${response.status}`);
+  }
+  const data = await response.json();
+  return data["dist-tags"]?.latest ?? null;
+}
+async function fetchLatestVersions(packageNames) {
+  const results = new Map;
+  if (packageNames.length === 0) {
+    return results;
+  }
+  const limit = pLimit(MAX_CONCURRENCY);
+  const tasks = packageNames.map((name) => limit(async () => {
+    try {
+      const version2 = await fetchLatestVersion(name);
+      results.set(name, version2);
+    } catch (error48) {
+      console.error(`Failed to fetch version for "${name}":`, error48 instanceof Error ? error48.message : error48);
+      results.set(name, null);
+    }
+  }));
+  await Promise.all(tasks);
+  return results;
+}
+function encodePackageName(name) {
+  return encodeURIComponent(name);
+}
+
+// src/lib/freshness.ts
+var EXIT_CODES = {
+  SUCCESS: 0,
+  STALE: 1,
+  MISSING: 2,
+  ORPHANED: 3,
+  MIXED: 4,
+  NETWORK_ERROR: 5
+};
+var DEFAULT_STALE_DAYS = 30;
+function checkVersionFreshness(indexedVersion, latestVersion) {
+  const coercedIndexed = import_semver.default.coerce(indexedVersion);
+  const coercedLatest = import_semver.default.coerce(latestVersion);
+  if (!(coercedIndexed && coercedLatest)) {
+    return { isStale: false, diffType: "uncoercible" };
+  }
+  const diff = import_semver.default.diff(coercedIndexed, coercedLatest);
+  if (!diff) {
+    return { isStale: false, diffType: null };
+  }
+  const staleTypes = new Set(["major", "minor", "premajor", "preminor"]);
+  return {
+    isStale: staleTypes.has(diff),
+    diffType: diff
+  };
+}
+async function checkFreshness(config2, packageJson, options) {
+  const staleDays = options?.staleDays ?? DEFAULT_STALE_DAYS;
+  const fetchVersions = options?.fetchVersionsFn ?? fetchLatestVersions;
+  const results = [];
+  const allDeps = {
+    ...packageJson?.dependencies ?? {},
+    ...packageJson?.devDependencies ?? {}
+  };
+  const frameworkToNpm = buildFrameworkToNpmMap();
+  const npmToFramework = buildNpmToFrameworkMap();
+  const npmPackagesToFetch = [];
+  for (const frameworkName of Object.keys(config2.frameworks)) {
+    const npmPkg = frameworkToNpm.get(frameworkName);
+    if (npmPkg) {
+      npmPackagesToFetch.push(npmPkg);
+    }
+  }
+  let latestVersions;
+  try {
+    latestVersions = await fetchVersions(npmPackagesToFetch);
+  } catch (error48) {
+    console.error("Failed to fetch versions from registry:", error48);
+    return {
+      results: [],
+      exitCode: EXIT_CODES.NETWORK_ERROR,
+      summary: {
+        total: 0,
+        stale: 0,
+        missing: 0,
+        orphaned: 0,
+        upToDate: 0,
+        unknown: 0
+      }
+    };
   }
-  spinner.succeed("Found package.json");
-  const projectType = detectProjectType(packageJson);
-  const projectName = packageJson.name || "unnamed-project";
-  console.log(source_default.dim(`Project: ${projectName} (${projectType})`));
-  spinner.start("Creating .claude-docs/ structure...");
-  const docsPath = join9(projectRoot, CLAUDE_DOCS_DIR);
-  const frameworksPath = join9(docsPath, FRAMEWORKS_DIR);
-  const internalPath = join9(docsPath, INTERNAL_DIR);
-  await ensureDir(docsPath);
-  await ensureDir(frameworksPath);
-  if (options.internal) {
-    await ensureDir(internalPath);
+  const processedFrameworks = new Set;
+  for (const [frameworkName, frameworkConfig] of Object.entries(config2.frameworks)) {
+    processedFrameworks.add(frameworkName);
+    const npmPkg = frameworkToNpm.get(frameworkName);
+    const knownFw = findKnownFramework(frameworkName);
+    const displayName = knownFw?.displayName ?? frameworkName;
+    const isInDeps = npmPkg ? npmPkg in allDeps : (frameworkName in allDeps);
+    if (!isInDeps) {
+      results.push({
+        framework: frameworkName,
+        displayName,
+        indexedVersion: frameworkConfig.version,
+        latestVersion: npmPkg ? latestVersions.get(npmPkg) ?? null : null,
+        status: "orphaned",
+        diffType: null
+      });
+      continue;
+    }
+    if (npmPkg) {
+      const latest = latestVersions.get(npmPkg) ?? null;
+      if (latest) {
+        const { isStale, diffType } = checkVersionFreshness(frameworkConfig.version, latest);
+        results.push({
+          framework: frameworkName,
+          displayName,
+          indexedVersion: frameworkConfig.version,
+          latestVersion: latest,
+          status: isStale ? "stale" : "up-to-date",
+          diffType
+        });
+      } else {
+        results.push({
+          framework: frameworkName,
+          displayName,
+          indexedVersion: frameworkConfig.version,
+          latestVersion: null,
+          status: "unknown",
+          diffType: "fetch-failed"
+        });
+      }
+    } else {
+      const lastUpdateDate = new Date(frameworkConfig.lastUpdate);
+      const isValidDate = !Number.isNaN(lastUpdateDate.getTime());
+      if (!isValidDate) {
+        results.push({
+          framework: frameworkName,
+          displayName,
+          indexedVersion: frameworkConfig.version,
+          latestVersion: null,
+          status: "stale",
+          diffType: "invalid-timestamp"
+        });
+        continue;
+      }
+      const daysSinceUpdate = Math.floor((Date.now() - lastUpdateDate.getTime()) / (1000 * 60 * 60 * 24));
+      const isStale = daysSinceUpdate > staleDays;
+      results.push({
+        framework: frameworkName,
+        displayName,
+        indexedVersion: frameworkConfig.version,
+        latestVersion: null,
+        status: isStale ? "stale" : "up-to-date",
+        diffType: isStale ? "timestamp" : null
+      });
+    }
   }
-  spinner.succeed("Created .claude-docs/");
-  spinner.start("Creating config.json...");
-  const config2 = createDefaultConfig(projectName, projectType);
-  await writeConfig(projectRoot, config2);
-  spinner.succeed("Created config.json");
-  const gitignoreUpdated = await updateGitignore(projectRoot);
-  if (gitignoreUpdated) {
-    console.log(source_default.dim("Updated .gitignore"));
+  for (const depName of Object.keys(allDeps)) {
+    const matched = npmToFramework.get(depName);
+    if (matched && !processedFrameworks.has(matched.name)) {
+      processedFrameworks.add(matched.name);
+      results.push({
+        framework: matched.name,
+        displayName: matched.displayName,
+        indexedVersion: "",
+        latestVersion: null,
+        status: "missing",
+        diffType: null
+      });
+    }
   }
-  if (!options.noDetect) {
-    console.log("");
-    console.log(source_default.bold("Detected dependencies:"));
-    const detected = detectDependencies(packageJson);
-    if (detected.length === 0) {
-      console.log(source_default.dim("  No supported frameworks detected."));
-    } else {
-      for (const dep of detected) {
-        const templateStatus = hasTemplate(dep.framework?.name || "") ? source_default.green("docs available") : source_default.yellow("no template");
-        const frameworkName = dep.framework?.displayName || dep.name;
-        const version2 = dep.framework?.name ? getMajorVersion(dep.version) : dep.version;
-        console.log(`  ${source_default.dim("├──")} ${frameworkName}@${dep.version} → ${frameworkName.toLowerCase()}@${version2} ${templateStatus}`);
+  const summary = {
+    total: results.length,
+    stale: results.filter((r) => r.status === "stale").length,
+    missing: results.filter((r) => r.status === "missing").length,
+    orphaned: results.filter((r) => r.status === "orphaned").length,
+    upToDate: results.filter((r) => r.status === "up-to-date").length,
+    unknown: results.filter((r) => r.status === "unknown").length
+  };
+  const exitCode = computeExitCode(summary);
+  return { results, exitCode, summary };
+}
+function buildFrameworkToNpmMap() {
+  const map2 = new Map;
+  for (const fw of KNOWN_FRAMEWORKS) {
+    const source = fw.pattern.source;
+    if (source.startsWith("^") && source.endsWith("$")) {
+      const npmPkg = source.slice(1, -1).replace(/\\\//g, "/");
+      if (!map2.has(fw.name)) {
+        map2.set(fw.name, npmPkg);
       }
-      console.log("");
-      const frameworkNames = detected.filter((d) => d.framework && hasTemplate(d.framework.name)).map((d) => d.framework.name);
-      if (frameworkNames.length > 0) {
-        console.log(source_default.bold("Next steps:"));
-        console.log(`  ${source_default.cyan(`pdi add ${frameworkNames.join(" ")}`)}`);
-        console.log(source_default.dim("  Or run: pdi sync  (auto-add all detected)"));
+    }
+  }
+  return map2;
+}
+function buildNpmToFrameworkMap() {
+  const map2 = new Map;
+  for (const fw of KNOWN_FRAMEWORKS) {
+    const source = fw.pattern.source;
+    if (source.startsWith("^") && source.endsWith("$")) {
+      const npmPkg = source.slice(1, -1).replace(/\\\//g, "/");
+      if (!map2.has(npmPkg)) {
+        map2.set(npmPkg, { name: fw.name, displayName: fw.displayName });
       }
     }
   }
-  console.log("");
-  console.log(source_default.green("✓ PDI initialized successfully"));
+  return map2;
+}
+function findKnownFramework(frameworkName) {
+  return KNOWN_FRAMEWORKS.find((fw) => fw.name === frameworkName);
+}
+function computeExitCode(summary) {
+  const problemTypes = [
+    summary.stale > 0,
+    summary.missing > 0,
+    summary.orphaned > 0
+  ].filter(Boolean).length;
+  if (problemTypes === 0) {
+    return EXIT_CODES.SUCCESS;
+  }
+  if (problemTypes > 1) {
+    return EXIT_CODES.MIXED;
+  }
+  if (summary.stale > 0) {
+    return EXIT_CODES.STALE;
+  }
+  if (summary.missing > 0) {
+    return EXIT_CODES.MISSING;
+  }
+  if (summary.orphaned > 0) {
+    return EXIT_CODES.ORPHANED;
+  }
+  return EXIT_CODES.SUCCESS;
 }
 
 // src/commands/status.ts
 async function statusCommand(options = {}) {
   const projectRoot = options.projectRoot || process.cwd();
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   const config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   const packageJson = await readPackageJson(projectRoot);
   const installedDeps = packageJson ? detectDependencies(packageJson) : [];
@@ -27312,6 +29641,61 @@ async function statusCommand(options = {}) {
   const internalIndex = buildInternalIndex(internalDocs);
   const sections = buildIndexSections(`.claude-docs/${FRAMEWORKS_DIR}`, ".claude-docs/internal", frameworksIndex, internalIndex);
   const indexSizeKb = calculateIndexSize(sections);
+  let freshnessOutput;
+  try {
+    freshnessOutput = await checkFreshness(config2, packageJson);
+  } catch (error48) {
+    if (options.format === "json") {
+      console.log(JSON.stringify({
+        project: config2.project.name,
+        timestamp: new Date().toISOString(),
+        status: "issues_found",
+        exitCode: EXIT_CODES.NETWORK_ERROR,
+        issues: [
+          {
+            type: "network_error",
+            message: error48 instanceof Error ? error48.message : String(error48)
+          }
+        ],
+        summary: {
+          total: 0,
+          upToDate: 0,
+          stale: 0,
+          missing: 0,
+          orphaned: 0,
+          unknown: 0
+        }
+      }, null, 2));
+    } else {
+      console.error("");
+      console.error(source_default.red("Freshness check failed:"), error48 instanceof Error ? error48.message : String(error48));
+    }
+    if (options.check) {
+      process.exit(EXIT_CODES.NETWORK_ERROR);
+    }
+    return;
+  }
+  if (options.format === "json") {
+    const issues = freshnessOutput.results.filter((r) => r.status !== "up-to-date").map((r) => ({
+      framework: r.framework,
+      displayName: r.displayName,
+      type: r.status,
+      indexedVersion: r.indexedVersion || undefined,
+      latestVersion: r.latestVersion || undefined
+    }));
+    console.log(JSON.stringify({
+      project: config2.project.name,
+      timestamp: new Date().toISOString(),
+      status: freshnessOutput.exitCode === 0 ? "ok" : "issues_found",
+      exitCode: freshnessOutput.exitCode,
+      issues,
+      summary: freshnessOutput.summary
+    }, null, 2));
+    if (options.check && freshnessOutput.exitCode !== 0) {
+      process.exit(freshnessOutput.exitCode);
+    }
+    return;
+  }
   console.log("");
   console.log(source_default.bold(`PDI Status for ${config2.project.name}`));
   console.log(source_default.dim("═".repeat(40)));
@@ -27375,24 +29759,53 @@ async function statusCommand(options = {}) {
 Run: pdi add ${missingFrameworks.map((d) => d.framework?.name).join(" ")}`));
   }
   console.log("");
+  console.log(source_default.bold("Freshness Check"));
+  console.log(source_default.dim("─".repeat(40)));
+  if (freshnessOutput.results.length > 0) {
+    console.log(`  ${"Framework".padEnd(20)} ${"Indexed".padEnd(10)} ${"Latest".padEnd(10)} Status`);
+    console.log(source_default.dim(`  ${"─".repeat(20)} ${"─".repeat(10)} ${"─".repeat(10)} ${"─".repeat(12)}`));
+    for (const r of freshnessOutput.results) {
+      const statusColor = r.status === "up-to-date" ? source_default.green : r.status === "unknown" ? source_default.dim : r.status === "stale" ? source_default.yellow : source_default.red;
+      console.log(`  ${r.displayName.padEnd(20)} ${(r.indexedVersion || "—").padEnd(10)} ${(r.latestVersion || "—").padEnd(10)} ${statusColor(r.status)}`);
+    }
+    const { summary } = freshnessOutput;
+    console.log("");
+    let summaryText = `  ${summary.upToDate} up-to-date, ${summary.stale} stale, ${summary.missing} missing, ${summary.orphaned} orphaned`;
+    if (summary.unknown > 0) {
+      summaryText += `, ${summary.unknown} unknown`;
+    }
+    console.log(source_default.dim(summaryText));
+  } else {
+    console.log(source_default.dim("  No frameworks to check"));
+  }
+  if (options.check && freshnessOutput.exitCode !== 0) {
+    process.exit(freshnessOutput.exitCode);
+  }
+  console.log("");
 }
 
 // src/commands/sync.ts
 import { join as join10 } from "node:path";
 var import_prompts5 = __toESM(require_prompts3(), 1);
+init_errors();
 async function syncCommand(options) {
   const projectRoot = options.projectRoot || process.cwd();
   const spinner = ora();
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   let config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   const packageJson = await readPackageJson(projectRoot);
   if (!packageJson) {
-    throw new Error("No package.json found");
+    throw new PDIError("No package.json found", {
+      code: "NO_PACKAGE_JSON",
+      hint: "Run this command in a Node.js project directory with a package.json file."
+    });
   }
   console.log(source_default.bold("Checking package.json..."));
   console.log("");
@@ -27521,7 +29934,7 @@ async function syncCommand(options) {
       const frameworkPath = join10(projectRoot, CLAUDE_DOCS_DIR, FRAMEWORKS_DIR, action.framework);
       await removeDir(frameworkPath);
       config2 = removeFrameworkFromConfig(config2, action.framework);
-      if (config2.mcp.libraryMappings) {
+      if (config2.mcp?.libraryMappings) {
         delete config2.mcp.libraryMappings[action.framework];
       }
       spinner.succeed(`Removed ${action.framework}`);
@@ -27537,155 +29950,21 @@ async function syncCommand(options) {
   console.log(source_default.green("✓ Sync completed"));
 }
 
-// node_modules/yocto-queue/index.js
-class Node {
-  value;
-  next;
-  constructor(value) {
-    this.value = value;
-  }
-}
-
-class Queue {
-  #head;
-  #tail;
-  #size;
-  constructor() {
-    this.clear();
-  }
-  enqueue(value) {
-    const node = new Node(value);
-    if (this.#head) {
-      this.#tail.next = node;
-      this.#tail = node;
-    } else {
-      this.#head = node;
-      this.#tail = node;
-    }
-    this.#size++;
-  }
-  dequeue() {
-    const current = this.#head;
-    if (!current) {
-      return;
-    }
-    this.#head = this.#head.next;
-    this.#size--;
-    if (!this.#head) {
-      this.#tail = undefined;
-    }
-    return current.value;
-  }
-  peek() {
-    if (!this.#head) {
-      return;
-    }
-    return this.#head.value;
-  }
-  clear() {
-    this.#head = undefined;
-    this.#tail = undefined;
-    this.#size = 0;
-  }
-  get size() {
-    return this.#size;
-  }
-  *[Symbol.iterator]() {
-    let current = this.#head;
-    while (current) {
-      yield current.value;
-      current = current.next;
-    }
-  }
-  *drain() {
-    while (this.#head) {
-      yield this.dequeue();
-    }
-  }
-}
-
-// node_modules/p-limit/index.js
-function pLimit(concurrency) {
-  validateConcurrency(concurrency);
-  const queue = new Queue;
-  let activeCount = 0;
-  const resumeNext = () => {
-    if (activeCount < concurrency && queue.size > 0) {
-      queue.dequeue()();
-      activeCount++;
-    }
-  };
-  const next = () => {
-    activeCount--;
-    resumeNext();
-  };
-  const run = async (function_, resolve, arguments_) => {
-    const result = (async () => function_(...arguments_))();
-    resolve(result);
-    try {
-      await result;
-    } catch {}
-    next();
-  };
-  const enqueue = (function_, resolve, arguments_) => {
-    new Promise((internalResolve) => {
-      queue.enqueue(internalResolve);
-    }).then(run.bind(undefined, function_, resolve, arguments_));
-    (async () => {
-      await Promise.resolve();
-      if (activeCount < concurrency) {
-        resumeNext();
-      }
-    })();
-  };
-  const generator = (function_, ...arguments_) => new Promise((resolve) => {
-    enqueue(function_, resolve, arguments_);
-  });
-  Object.defineProperties(generator, {
-    activeCount: {
-      get: () => activeCount
-    },
-    pendingCount: {
-      get: () => queue.size
-    },
-    clearQueue: {
-      value() {
-        queue.clear();
-      }
-    },
-    concurrency: {
-      get: () => concurrency,
-      set(newConcurrency) {
-        validateConcurrency(newConcurrency);
-        concurrency = newConcurrency;
-        queueMicrotask(() => {
-          while (activeCount < concurrency && queue.size > 0) {
-            resumeNext();
-          }
-        });
-      }
-    }
-  });
-  return generator;
-}
-function validateConcurrency(concurrency) {
-  if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) {
-    throw new TypeError("Expected `concurrency` to be a number from 1 and up");
-  }
-}
-
 // src/commands/update.ts
 var import_prompts6 = __toESM(require_prompts3(), 1);
 init_context7_client();
+init_errors();
 async function updateCommand(frameworks, options) {
   const projectRoot = options.projectRoot || process.cwd();
   const spinner = ora();
   if (!configExists(projectRoot)) {
-    throw new Error("PDI not initialized. Run: pdi init");
+    throw new NotInitializedError;
   }
   let config2 = await readConfig(projectRoot);
   if (!config2) {
-    throw new Error("Failed to read config");
+    throw new ConfigError("Config file exists but returned null", {
+      hint: "Run `pdi init --force` to regenerate config."
+    });
   }
   let frameworksToUpdate;
   if (frameworks.length === 0) {
@@ -27846,6 +30125,40 @@ Skipping ${template.displayName}@${version2} (updated ${Math.round(hoursSinceUpd
   }
 }
 
+// src/lib/error-handler.ts
+init_errors();
+function handleCommandError(error48) {
+  if (error48 instanceof ConfigError) {
+    console.error(source_default.red("Config Error:"), error48.message);
+    if (error48.validationIssues && error48.validationIssues.length > 0) {
+      console.error(source_default.dim(error48.formatValidationIssues()));
+    }
+  } else if (error48 instanceof NotInitializedError) {
+    console.error(source_default.red("Error:"), error48.message);
+  } else if (error48 instanceof Context7Error) {
+    console.error(source_default.red("Context7 Error:"), error48.message);
+  } else if (error48 instanceof PDIError) {
+    console.error(source_default.red("Error:"), error48.message);
+  } else if (error48 instanceof Error) {
+    console.error(source_default.red("Error:"), error48.message);
+    if (error48.cause instanceof Error) {
+      console.error(source_default.dim(`  Caused by: ${error48.cause.message}`));
+    }
+  } else {
+    console.error(source_default.red("Error:"), String(error48));
+  }
+  if (error48 instanceof PDIError && error48.hint) {
+    console.error(source_default.dim(`
+Fix: ${error48.hint}`));
+  }
+  if (process.env.PDI_DEBUG && error48 instanceof Error && error48.stack) {
+    console.error(source_default.dim(`
+Stack trace:`));
+    console.error(source_default.dim(error48.stack));
+  }
+  process.exit(1);
+}
+
 // src/cli.ts
 try {
   await loadApiKeyFromConfig();
@@ -27860,47 +30173,42 @@ program2.command("init").description("Initialize PDI in the current project").op
   try {
     await initCommand(options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("add").description("Add documentation for frameworks (interactive if no args)").argument("[frameworks...]", "Framework names to add (e.g., hono drizzle zod)").option("-v, --version <version>", "Specify version (e.g., 4.x)").option("--minimal", "Download only essential docs").option("-f, --force", "Overwrite existing docs").option("--no-index", "Do not update CLAUDE.md index").option("--offline", "Generate placeholders only (skip MCP)").action(async (frameworks, options) => {
   try {
     await addCommand(frameworks || [], options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("sync").description("Synchronize docs with package.json dependencies").option("-y, --yes", "Accept all changes without prompting").option("--check", "Only check for changes, do not apply").option("--prune", "Remove docs for uninstalled packages").action(async (options) => {
   try {
     await syncCommand(options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
-program2.command("status").description("Show current PDI status").action(async () => {
+program2.command("status").description("Show current PDI status and doc freshness").option("--check", "Exit with non-zero code if issues found (for CI)").option("--format <format>", "Output format: table or json", "table").action(async (options) => {
   try {
-    await statusCommand();
+    await statusCommand(options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("clean").description("Remove orphan docs and optimize index").option("-y, --yes", "Remove without prompting").option("--dry-run", "Show what would be removed without doing it").action(async (options) => {
   try {
     await cleanCommand(options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("list").description("List available framework templates").option("--category <category>", "Filter by category").action((options) => {
   const templates = listTemplates();
   console.log(source_default.bold(`
 Available Framework Templates`));
-  console.log(source_default.dim("═".repeat(40)));
+  console.log(source_default.dim("=".repeat(40)));
   console.log("");
   const categories = new Map;
   for (const template of templates) {
@@ -27926,32 +30234,28 @@ program2.command("update").description("Update docs to latest versions (HTTP fir
   try {
     await updateCommand(frameworks, options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("generate").description("Generate internal pattern documentation").argument("<type>", "Type of docs to generate (internal)").option("--category <category>", "Specific category to generate").option("--dry-run", "Show what would be generated").option("--ai", "Use AI to enhance descriptions (requires API key)").action(async (type, options) => {
   try {
     await generateCommand(type, options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("auth").description("Configure Context7 API key").option("-s, --status", "Show authentication status").option("--logout", "Remove saved API key").action(async (options) => {
   try {
     await authCommand(options);
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.command("doctor").description("Diagnose configuration and provide recommendations").action(async () => {
   try {
     await doctorCommand();
   } catch (error48) {
-    console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : error48);
-    process.exit(1);
+    handleCommandError(error48);
   }
 });
 program2.parse();