@arabold/docs-mcp-server 1.30.0 → 1.31.0

package/dist/index.js

@@ -1579,7 +1579,7 @@ function createMcpServerInstance(tools, readOnly = false) {
       "Re-scrape a previously indexed library version, updating only changed pages.",
       {
         library: z.string().trim().describe("Library name."),
-        version: z.string().trim().optional().describe("Library version (optional, refreshes unversioned if omitted).")
+        version: z.string().trim().optional().describe("Library version (optional, refreshes latest if omitted).")
       },
       {
         title: "Refresh Library Version",
@@ -1833,7 +1833,7 @@ ${formattedJob}`);
       "Remove indexed documentation for a library version. Use only if explicitly instructed.",
       {
         library: z.string().trim().describe("Library name."),
-        version: z.string().trim().optional().describe("Library version (optional, removes unversioned if omitted).")
+        version: z.string().trim().optional().describe("Library version (optional, removes latest if omitted).")
       },
       {
         title: "Remove Library Documentation",
@@ -7180,6 +7180,24 @@ let PipelineFactory$1 = class PipelineFactory {
     ];
   }
 };
+function compareVersionsDescending(a, b) {
+  const aIsUnversioned = a === "" || a === null || a === void 0;
+  const bIsUnversioned = b === "" || b === null || b === void 0;
+  if (aIsUnversioned && bIsUnversioned) return 0;
+  if (aIsUnversioned) return -1;
+  if (bIsUnversioned) return 1;
+  const aSemver = semver__default.valid(a) ?? semver__default.valid(semver__default.coerce(a));
+  const bSemver = semver__default.valid(b) ?? semver__default.valid(semver__default.coerce(b));
+  if (aSemver && bSemver) {
+    return semver__default.rcompare(aSemver, bSemver);
+  }
+  const aLower = a.toLowerCase();
+  const bLower = b.toLowerCase();
+  return bLower.localeCompare(aLower);
+}
+function sortVersionsDescending(versions) {
+  return [...versions].sort(compareVersionsDescending);
+}
 class HierarchicalAssemblyStrategy {
   /**
    * Determines if this strategy can handle the given content type.
@@ -8887,22 +8905,7 @@ class DocumentStore {
         });
       }
       for (const versions of libraryMap.values()) {
-        versions.sort((a, b) => {
-          if (a.version === "" && b.version !== "") {
-            return -1;
-          }
-          if (a.version !== "" && b.version === "") {
-            return 1;
-          }
-          if (a.version === "" && b.version === "") {
-            return 0;
-          }
-          try {
-            return semver__default.compare(a.version, b.version);
-          } catch (_error) {
-            return a.version.localeCompare(b.version);
-          }
-        });
+        versions.sort((a, b) => compareVersionsDescending(a.version, b.version));
       }
       return libraryMap;
     } catch (error) {
@@ -9680,10 +9683,12 @@ class DocumentManagementService {
   }
   /**
    * Returns a list of all available semantic versions for a library.
+   * Sorted in descending order (latest first).
    */
   async listVersions(library) {
     const versions = await this.store.queryUniqueVersions(library);
-    return versions.filter((v) => semver__default.valid(v));
+    const validVersions = versions.filter((v) => semver__default.valid(v));
+    return sortVersionsDescending(validVersions);
   }
   /**
    * Checks if documents exist for a given library and optional version.
@@ -9761,7 +9766,7 @@ class DocumentManagementService {
   async removeAllDocuments(library, version) {
     const normalizedVersion = this.normalizeVersion(version);
     logger.info(
-      `🗑️ Removing all documents from ${library}@${normalizedVersion || "[no version]"} store`
+      `🗑️ Removing all documents from ${library}@${normalizedVersion || "latest"} store`
     );
     const count = await this.store.deletePages(library, normalizedVersion);
     logger.info(`🗑️ Deleted ${count} documents`);
@@ -9792,17 +9797,15 @@ class DocumentManagementService {
    */
   async removeVersion(library, version) {
     const normalizedVersion = this.normalizeVersion(version);
-    logger.debug(`Removing version: ${library}@${normalizedVersion || "[no version]"}`);
+    logger.debug(`Removing version: ${library}@${normalizedVersion || "latest"}`);
     const result = await this.store.removeVersion(library, normalizedVersion, true);
     logger.info(`🗑️ Removed ${result.documentsDeleted} documents`);
     if (result.versionDeleted && result.libraryDeleted) {
       logger.info(`🗑️ Completely removed library ${library} (was last version)`);
     } else if (result.versionDeleted) {
-      logger.info(`🗑️ Removed version ${library}@${normalizedVersion || "[no version]"}`);
+      logger.info(`🗑️ Removed version ${library}@${normalizedVersion || "latest"}`);
     } else {
-      logger.warn(
-        `⚠️  Version ${library}@${normalizedVersion || "[no version]"} not found`
-      );
+      logger.warn(`⚠️  Version ${library}@${normalizedVersion || "latest"} not found`);
       const libraryRecord = await this.store.getLibrary(library);
       if (libraryRecord) {
         const versions = await this.store.queryUniqueVersions(library);
@@ -10538,6 +10541,29 @@ function registerEventsRoute(server, eventBus) {
     });
   });
 }
+const PrimaryButton = ({
+  children,
+  type = "button",
+  class: className = "",
+  disabled = false,
+  ...rest
+}) => {
+  const baseClasses = "w-full flex justify-center py-1.5 px-3 border border-transparent rounded-md shadow-sm text-sm font-medium text-white bg-primary-600 hover:bg-primary-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary-500 transition-colors duration-150";
+  const disabledClasses = disabled ? "opacity-50 cursor-not-allowed" : "";
+  const combinedClasses = `${baseClasses} ${disabledClasses} ${className}`.trim();
+  return /* @__PURE__ */ jsx("button", { type, class: combinedClasses, disabled, ...rest, children });
+};
+const AddJobButton = () => {
+  return /* @__PURE__ */ jsx(
+    PrimaryButton,
+    {
+      "hx-get": "/web/jobs/new",
+      "hx-target": "#addJobForm",
+      "hx-swap": "innerHTML",
+      children: "Add New Documentation"
+    }
+  );
+};
 const Toast = () => {
   return /* @__PURE__ */ jsx(
     "div",
@@ -10666,7 +10692,7 @@ const Layout = ({
   children,
   eventClientConfig
 }) => {
-  const versionString = version || "1.30.0";
+  const versionString = version || "1.31.0";
   const versionInitializer = `versionUpdate({ currentVersion: ${`'${versionString}'`} })`;
   return /* @__PURE__ */ jsxs("html", { lang: "en", children: [
     /* @__PURE__ */ jsxs("head", { children: [
@@ -11014,17 +11040,7 @@ function registerIndexRoute(server, config) {
               }
             )
           ] }),
-          /* @__PURE__ */ jsx("section", { class: "mb-8", children: /* @__PURE__ */ jsx("div", { id: "addJobForm", children: /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              "hx-get": "/web/jobs/new",
-              "hx-target": "#addJobForm",
-              "hx-swap": "innerHTML",
-              class: "w-full flex justify-center py-1.5 px-3 border border-transparent rounded-md shadow-sm text-sm font-medium text-white bg-primary-600 hover:bg-primary-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary-500 transition-colors duration-150",
-              children: "Add New Documentation"
-            }
-          ) }) }),
+          /* @__PURE__ */ jsx("section", { class: "mb-8", children: /* @__PURE__ */ jsx("div", { id: "addJobForm", children: /* @__PURE__ */ jsx(AddJobButton, {}) }) }),
           /* @__PURE__ */ jsxs("div", { children: [
             /* @__PURE__ */ jsx("h2", { class: "text-xl font-semibold mb-2 text-gray-900 dark:text-white", children: "Indexed Documentation" }),
             /* @__PURE__ */ jsx(
@@ -11155,10 +11171,12 @@ const ProgressBar = ({ progress, showText = true }) => {
     ) })
   ] });
 };
-const LoadingSpinner = () => /* @__PURE__ */ jsxs(
+const LoadingSpinner = ({
+  class: className = "text-white"
+}) => /* @__PURE__ */ jsxs(
   "svg",
   {
-    class: "animate-spin h-4 w-4 text-white",
+    class: `animate-spin h-4 w-4 ${className}`,
     xmlns: "http://www.w3.org/2000/svg",
     fill: "none",
     viewBox: "0 0 24 24",
@@ -11293,6 +11311,17 @@ function registerJobListRoutes(server, listJobsTool) {
     return /* @__PURE__ */ jsx(JobList, { jobs: result.jobs });
   });
 }
+const AddVersionButton = ({ libraryName }) => {
+  return /* @__PURE__ */ jsx(
+    PrimaryButton,
+    {
+      "hx-get": `/web/libraries/${encodeURIComponent(libraryName)}/add-version-form`,
+      "hx-target": "#add-version-form-container",
+      "hx-swap": "innerHTML",
+      children: "Add New Version"
+    }
+  );
+};
 const Alert = ({ type, title, message }) => {
   let iconSvg;
   let colorClasses;
@@ -11437,17 +11466,39 @@ const Tooltip = ({ text, position = "top" }) => {
   );
 };
 const ScrapeFormContent = ({
-  defaultExcludePatterns
+  defaultExcludePatterns,
+  initialValues,
+  mode = "new"
 }) => {
-  const defaultExcludePatternsText = defaultExcludePatterns?.join("\n") || "";
+  const isAddVersionMode = mode === "add-version";
+  const urlValue = initialValues?.url || "";
+  const libraryValue = initialValues?.library || "";
+  const maxPagesValue = initialValues?.maxPages?.toString() || "";
+  const maxDepthValue = initialValues?.maxDepth?.toString() || "";
+  const scopeValue = initialValues?.scope || "subpages";
+  const includePatternsValue = initialValues?.includePatterns || "";
+  const scrapeModeValue = initialValues?.scrapeMode || ScrapeMode.Auto;
+  const followRedirectsValue = initialValues?.followRedirects ?? true;
+  const ignoreErrorsValue = initialValues?.ignoreErrors ?? true;
+  const excludePatternsText = initialValues?.excludePatterns !== void 0 ? initialValues.excludePatterns : defaultExcludePatterns?.join("\n") || "";
+  const headersJson = JSON.stringify(initialValues?.headers || []);
+  const closeButtonAttrs = isAddVersionMode ? {
+    "hx-get": `/web/libraries/${encodeURIComponent(libraryValue)}/add-version-button`,
+    "hx-target": "#add-version-form-container",
+    "hx-swap": "innerHTML"
+  } : {
+    "hx-get": "/web/jobs/new-button",
+    "hx-target": "#addJobForm",
+    "hx-swap": "innerHTML"
+  };
+  const formTarget = isAddVersionMode ? "#add-version-form-container" : "#addJobForm";
+  const title = isAddVersionMode ? "Add New Version" : "Add New Documentation";
   return /* @__PURE__ */ jsxs("div", { class: "mt-4 p-4 bg-white dark:bg-gray-800 rounded-lg shadow border border-gray-300 dark:border-gray-600 relative animate-[fadeSlideIn_0.2s_ease-out]", children: [
     /* @__PURE__ */ jsx(
       "button",
       {
         type: "button",
-        "hx-get": "/web/jobs/new-button",
-        "hx-target": "#addJobForm",
-        "hx-swap": "innerHTML",
+        ...closeButtonAttrs,
         class: "absolute top-3 right-3 p-1 text-gray-400 hover:text-gray-600 dark:hover:text-gray-300 rounded-full hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors duration-150",
         title: "Close",
         children: /* @__PURE__ */ jsx(
@@ -11471,16 +11522,20 @@ const ScrapeFormContent = ({
         )
       }
     ),
-    /* @__PURE__ */ jsx("h3", { class: "text-xl font-semibold text-gray-900 dark:text-white mb-2 pr-8", children: "Add New Documentation" }),
+    /* @__PURE__ */ jsx("h3", { class: "text-xl font-semibold text-gray-900 dark:text-white mb-2 pr-8", children: title }),
     /* @__PURE__ */ jsxs(
       "form",
       {
         "hx-post": "/web/jobs/scrape",
-        "hx-target": "#addJobForm",
+        "hx-target": formTarget,
         "hx-swap": "innerHTML",
         class: "space-y-2",
-        "x-data": "{\n        url: '',\n        hasPath: false,\n        headers: [],\n        checkUrlPath() {\n          try {\n            const url = new URL(this.url);\n            this.hasPath = url.pathname !== '/' && url.pathname !== '';\n          } catch (e) {\n            this.hasPath = false;\n          }\n        }\n      }",
+        "data-initial-url": urlValue,
+        "data-initial-headers": headersJson,
+        "x-data": "{\n          url: '',\n          hasPath: false,\n          headers: [],\n          checkUrlPath() {\n            try {\n              const url = new URL(this.url);\n              this.hasPath = url.pathname !== '/' && url.pathname !== '';\n            } catch (e) {\n              this.hasPath = false;\n            }\n          }\n        }",
+        "x-init": "\n          url = $el.dataset.initialUrl || '';\n          headers = JSON.parse($el.dataset.initialHeaders || '[]');\n          checkUrlPath();\n        ",
         children: [
+          /* @__PURE__ */ jsx("input", { type: "hidden", name: "formMode", value: mode }),
           /* @__PURE__ */ jsxs("div", { children: [
             /* @__PURE__ */ jsxs("div", { class: "flex items-center", children: [
               /* @__PURE__ */ jsx(
@@ -11521,6 +11576,7 @@ const ScrapeFormContent = ({
                 "x-model": "url",
                 "x-on:input": "checkUrlPath",
                 "x-on:paste": "$nextTick(() => checkUrlPath())",
+                placeholder: "https://docs.example.com/library/",
                 class: "mt-0.5 block w-full px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
               }
             ),
@@ -11555,13 +11611,18 @@ const ScrapeFormContent = ({
               ),
               /* @__PURE__ */ jsx(Tooltip, { text: "The name of the library you're documenting. This will be used when searching." })
             ] }),
-            /* @__PURE__ */ jsx(
+            isAddVersionMode ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("input", { type: "hidden", name: "library", value: libraryValue }),
+              /* @__PURE__ */ jsx("div", { class: "mt-0.5 px-2 py-1 text-sm text-gray-700 dark:text-gray-300 bg-gray-100 dark:bg-gray-700 rounded-md border border-gray-300 dark:border-gray-600", children: /* @__PURE__ */ jsx("span", { safe: true, children: libraryValue }) })
+            ] }) : /* @__PURE__ */ jsx(
               "input",
               {
                 type: "text",
                 name: "library",
                 id: "library",
                 required: true,
+                value: libraryValue,
+                placeholder: "e.g. react, vue, express",
                 class: "mt-0.5 block w-full px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
               }
             )
@@ -11576,7 +11637,7 @@ const ScrapeFormContent = ({
                   children: "Version (optional)"
                 }
               ),
-              /* @__PURE__ */ jsx(Tooltip, { text: "Specify the version of the library documentation you're indexing. This allows for version-specific searches." })
+              /* @__PURE__ */ jsx(Tooltip, { text: "Specify the version of the library documentation you're indexing (e.g. 2.0.0). Leave empty or enter 'latest' to index without a specific version. This allows for version-specific searches." })
             ] }),
             /* @__PURE__ */ jsx(
               "input",
@@ -11584,6 +11645,7 @@ const ScrapeFormContent = ({
                 type: "text",
                 name: "version",
                 id: "version",
+                placeholder: "e.g. 2.0.0 or leave empty for latest",
                 class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
               }
             )
@@ -11592,7 +11654,9 @@ const ScrapeFormContent = ({
             "div",
             {
               class: "bg-gray-50 dark:bg-gray-900 p-2 rounded-md",
-              "x-data": "{ open: false, headers: [] }",
+              "data-should-open": isAddVersionMode && (maxPagesValue || maxDepthValue || scopeValue !== "subpages" || includePatternsValue || excludePatternsText || scrapeModeValue !== ScrapeMode.Auto) ? "true" : "false",
+              "x-data": "{ open: false }",
+              "x-init": "open = $el.dataset.shouldOpen === 'true'",
               children: [
                 /* @__PURE__ */ jsxs(
                   "button",
@@ -11645,6 +11709,7 @@ const ScrapeFormContent = ({
                         id: "maxPages",
                         min: "1",
                         placeholder: "1000",
+                        value: maxPagesValue,
                         class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
                       }
                     )
@@ -11669,6 +11734,7 @@ const ScrapeFormContent = ({
                         id: "maxDepth",
                         min: "0",
                         placeholder: "3",
+                        value: maxDepthValue,
                         class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
                       }
                     )
@@ -11704,9 +11770,9 @@ const ScrapeFormContent = ({
                         id: "scope",
                         class: "mt-0.5 block w-full max-w-sm pl-2 pr-10 py-1 text-base border border-gray-300 dark:border-gray-600 focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm rounded-md bg-white dark:bg-gray-700 text-gray-900 dark:text-white",
                         children: [
-                          /* @__PURE__ */ jsx("option", { value: "subpages", selected: true, children: "Subpages (Default)" }),
-                          /* @__PURE__ */ jsx("option", { value: "hostname", children: "Hostname" }),
-                          /* @__PURE__ */ jsx("option", { value: "domain", children: "Domain" })
+                          /* @__PURE__ */ jsx("option", { value: "subpages", selected: scopeValue === "subpages", children: "Subpages (Default)" }),
+                          /* @__PURE__ */ jsx("option", { value: "hostname", selected: scopeValue === "hostname", children: "Hostname" }),
+                          /* @__PURE__ */ jsx("option", { value: "domain", selected: scopeValue === "domain", children: "Domain" })
                         ]
                       }
                     )
@@ -11730,7 +11796,9 @@ const ScrapeFormContent = ({
                         id: "includePatterns",
                         rows: "2",
                         placeholder: "e.g. docs/* or /api\\/v1.*/",
-                        class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
+                        class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white",
+                        safe: true,
+                        children: includePatternsValue
                       }
                     )
                   ] }),
@@ -11754,10 +11822,10 @@ const ScrapeFormContent = ({
                         rows: "5",
                         safe: true,
                         class: "mt-0.5 block w-full max-w-sm px-2 py-1 border border-gray-300 dark:border-gray-600 rounded-md shadow-sm focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm bg-white dark:bg-gray-700 text-gray-900 dark:text-white font-mono text-xs",
-                        children: defaultExcludePatternsText
+                        children: excludePatternsText
                       }
                     ),
-                    /* @__PURE__ */ jsx("p", { class: "mt-1 text-xs text-gray-500 dark:text-gray-400", children: "Default patterns are pre-filled. Edit to customize or clear to exclude nothing." })
+                    /* @__PURE__ */ jsx("p", { class: "mt-1 text-xs text-gray-500 dark:text-gray-400", children: isAddVersionMode ? "Patterns from previous version. Edit as needed." : "Default patterns are pre-filled. Edit to customize or clear to exclude nothing." })
                   ] }),
                   /* @__PURE__ */ jsxs("div", { children: [
                     /* @__PURE__ */ jsxs("div", { class: "flex items-center", children: [
@@ -11787,9 +11855,30 @@ const ScrapeFormContent = ({
                         id: "scrapeMode",
                         class: "mt-0.5 block w-full max-w-sm pl-2 pr-10 py-1 text-base border border-gray-300 dark:border-gray-600 focus:outline-none focus:ring-primary-500 focus:border-primary-500 sm:text-sm rounded-md bg-white dark:bg-gray-700 text-gray-900 dark:text-white",
                         children: [
-                          /* @__PURE__ */ jsx("option", { value: ScrapeMode.Auto, selected: true, children: "Auto (Default)" }),
-                          /* @__PURE__ */ jsx("option", { value: ScrapeMode.Fetch, children: "Fetch" }),
-                          /* @__PURE__ */ jsx("option", { value: ScrapeMode.Playwright, children: "Playwright" })
+                          /* @__PURE__ */ jsx(
+                            "option",
+                            {
+                              value: ScrapeMode.Auto,
+                              selected: scrapeModeValue === ScrapeMode.Auto,
+                              children: "Auto (Default)"
+                            }
+                          ),
+                          /* @__PURE__ */ jsx(
+                            "option",
+                            {
+                              value: ScrapeMode.Fetch,
+                              selected: scrapeModeValue === ScrapeMode.Fetch,
+                              children: "Fetch"
+                            }
+                          ),
+                          /* @__PURE__ */ jsx(
+                            "option",
+                            {
+                              value: ScrapeMode.Playwright,
+                              selected: scrapeModeValue === ScrapeMode.Playwright,
+                              children: "Playwright"
+                            }
+                          )
                         ]
                       }
                     )
@@ -11858,7 +11947,7 @@ const ScrapeFormContent = ({
                         id: "followRedirects",
                         name: "followRedirects",
                         type: "checkbox",
-                        checked: true,
+                        checked: followRedirectsValue,
                         class: "h-4 w-4 text-primary-600 focus:ring-primary-500 border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700"
                       }
                     ),
@@ -11878,7 +11967,7 @@ const ScrapeFormContent = ({
                         id: "ignoreErrors",
                         name: "ignoreErrors",
                         type: "checkbox",
-                        checked: true,
+                        checked: ignoreErrorsValue,
                         class: "h-4 w-4 text-primary-600 focus:ring-primary-500 border-gray-300 dark:border-gray-600 rounded bg-white dark:bg-gray-700"
                       }
                     ),
@@ -12009,23 +12098,12 @@ function getEffectiveExclusionPatterns(userPatterns) {
   }
   return DEFAULT_EXCLUSION_PATTERNS;
 }
-const ScrapeFormButton = () => /* @__PURE__ */ jsx(
-  "button",
-  {
-    type: "button",
-    "hx-get": "/web/jobs/new",
-    "hx-target": "#addJobForm",
-    "hx-swap": "innerHTML",
-    class: "w-full flex justify-center py-1.5 px-3 border border-transparent rounded-md shadow-sm text-sm font-medium text-white bg-primary-600 hover:bg-primary-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary-500 transition-colors duration-150",
-    children: "Add New Documentation"
-  }
-);
 function registerNewJobRoutes(server, scrapeTool) {
   server.get("/web/jobs/new", async () => {
     return /* @__PURE__ */ jsx(ScrapeForm, { defaultExcludePatterns: DEFAULT_EXCLUSION_PATTERNS });
   });
   server.get("/web/jobs/new-button", async () => {
-    return /* @__PURE__ */ jsx(ScrapeFormButton, {});
+    return /* @__PURE__ */ jsx(AddJobButton, {});
   });
   server.post(
     "/web/jobs/scrape",
@@ -12061,11 +12139,11 @@ function registerNewJobRoutes(server, scrapeTool) {
             }
           );
         }
+        const normalizedVersion = !body.version || body.version.trim() === "" || body.version.trim().toLowerCase() === "latest" ? null : body.version.trim();
         const scrapeOptions = {
           url: body.url,
           library: body.library,
-          version: body.version || null,
-          // Handle empty string as null
+          version: normalizedVersion,
           waitForCompletion: false,
           // Don't wait in UI
           options: {
@@ -12084,16 +12162,20 @@ function registerNewJobRoutes(server, scrapeTool) {
         };
         const result = await scrapeTool.execute(scrapeOptions);
         if ("jobId" in result) {
+          const versionDisplay = normalizedVersion || "latest";
           reply.header(
             "HX-Trigger",
             JSON.stringify({
               toast: {
-                message: "Job queued successfully!",
+                message: `Indexing started for ${body.library}@${versionDisplay}`,
                 type: "success"
               }
             })
           );
-          return /* @__PURE__ */ jsx(ScrapeFormButton, {});
+          if (body.formMode === "add-version") {
+            return /* @__PURE__ */ jsx(AddVersionButton, { libraryName: body.library });
+          }
+          return /* @__PURE__ */ jsx(AddJobButton, {});
         }
         return /* @__PURE__ */ jsx(Alert, { type: "warning", message: "Job finished unexpectedly quickly." });
       } catch (error) {
@@ -12119,15 +12201,16 @@ function registerNewJobRoutes(server, scrapeTool) {
 const VersionDetailsRow = ({
   version,
   libraryName,
-  showDelete = true
-  // Default to true
+  showDelete = true,
+  showRefresh = false
 }) => {
   const indexedDate = version.indexedAt ? new Date(version.indexedAt).toLocaleDateString() : "N/A";
-  const versionLabel = version.ref.version || "Unversioned";
+  const versionLabel = version.ref.version || "Latest";
   const versionParam = version.ref.version || "";
   const sanitizedLibraryName = libraryName.replace(/[^a-zA-Z0-9-_]/g, "-");
   const sanitizedVersionParam = versionParam.replace(/[^a-zA-Z0-9-_]/g, "-");
   const rowId = `row-${sanitizedLibraryName}-${sanitizedVersionParam}`;
+  const initialIsRefreshing = isActiveStatus(version.status);
   const defaultStateClasses = "text-red-700 border border-red-700 hover:bg-red-700 hover:text-white focus:ring-4 focus:outline-none focus:ring-red-300 dark:border-red-500 dark:text-red-500 dark:hover:text-white dark:focus:ring-red-800 dark:hover:bg-red-500";
   const confirmingStateClasses = "bg-red-600 text-white border-red-600 focus:ring-4 focus:outline-none focus:ring-red-300 dark:bg-red-700 dark:border-red-700 dark:focus:ring-red-800";
   return (
@@ -12139,14 +12222,16 @@ const VersionDetailsRow = ({
         class: "flex justify-between items-center py-1 border-b border-gray-200 dark:border-gray-600 last:border-b-0",
         "data-library-name": libraryName,
         "data-version-param": versionParam,
-        "x-data": "{ library: $el.dataset.libraryName, version: $el.dataset.versionParam, confirming: $el.dataset.confirming === 'true', isDeleting: false }",
+        "data-is-refreshing": initialIsRefreshing ? "true" : "false",
+        "x-data": "{ \n        library: $el.dataset.libraryName, \n        version: $el.dataset.versionParam, \n        confirming: $el.dataset.confirming === 'true', \n        isDeleting: false,\n        isRefreshing: $el.dataset.isRefreshing === 'true',\n        setRefreshing(val) {\n          this.isRefreshing = !!val;\n          this.$el.dataset.isRefreshing = val ? 'true' : 'false';\n        },\n        init() {\n          const rowId = this.$el.id;\n          const myLibrary = this.library;\n          const myVersion = this.version;\n          \n          document.body.addEventListener('job-status-change', (e) => {\n            const job = e.detail;\n            const jobVersion = job.version || '';\n            if (job.library === myLibrary && jobVersion === myVersion) {\n              const newValue = ['queued', 'running'].includes(job.status);\n              const el = document.getElementById(rowId);\n              if (el) {\n                el.dispatchEvent(new CustomEvent('set-refreshing', { detail: newValue, bubbles: true }));\n              }\n            }\n          });\n        }\n      }",
+        "x-on:set-refreshing": "setRefreshing($event.detail)",
         children: [
           /* @__PURE__ */ jsx(
             "span",
             {
               class: "text-sm text-gray-900 dark:text-white w-1/4 truncate",
               title: versionLabel,
-              children: version.ref.version ? /* @__PURE__ */ jsx(VersionBadge, { version: version.ref.version }) : /* @__PURE__ */ jsx("span", { children: "Unversioned" })
+              children: version.ref.version ? /* @__PURE__ */ jsx(VersionBadge, { version: version.ref.version }) : /* @__PURE__ */ jsx("span", { class: "text-gray-600 dark:text-gray-400", children: "Latest" })
             }
           ),
           /* @__PURE__ */ jsxs("div", { class: "flex space-x-2 text-sm text-gray-600 dark:text-gray-400 w-3/4 justify-end items-center", children: [
@@ -12166,66 +12251,117 @@ const VersionDetailsRow = ({
               /* @__PURE__ */ jsx("span", { class: "font-semibold", safe: true, children: indexedDate })
             ] })
           ] }),
-          showDelete && /* @__PURE__ */ jsxs(
-            "button",
-            {
-              type: "button",
-              class: "ml-2 font-medium rounded-lg text-sm p-1 text-center inline-flex items-center transition-colors duration-150 ease-in-out",
-              title: "Remove this version",
-              "x-bind:class": `confirming ? '${confirmingStateClasses}' : '${defaultStateClasses}'`,
-              "x-bind:disabled": "isDeleting",
-              "x-on:click": "\n            if (confirming) {\n              isDeleting = true;\n              window.confirmationManager.clear($root.id);\n              $el.dispatchEvent(new CustomEvent('confirmed-delete', { bubbles: true }));\n            } else {\n              confirming = true;\n              isDeleting = false;\n              window.confirmationManager.start($root.id);\n            }\n          ",
-              "hx-delete": `/web/libraries/${encodeURIComponent(libraryName)}/versions/${encodeURIComponent(versionParam)}`,
-              "hx-target": `#${rowId}`,
-              "hx-swap": "outerHTML",
-              "hx-trigger": "confirmed-delete",
-              children: [
-                /* @__PURE__ */ jsxs("span", { "x-show": "!confirming && !isDeleting", children: [
-                  /* @__PURE__ */ jsx(
-                    "svg",
-                    {
-                      class: "w-4 h-4",
-                      "aria-hidden": "true",
-                      xmlns: "http://www.w3.org/2000/svg",
-                      fill: "none",
-                      viewBox: "0 0 18 20",
-                      children: /* @__PURE__ */ jsx(
-                        "path",
-                        {
-                          stroke: "currentColor",
-                          "stroke-linecap": "round",
-                          "stroke-linejoin": "round",
-                          "stroke-width": "2",
-                          d: "M1 5h16M7 8v8m4-8v8M7 1h4a1 1 0 0 1 1 1v3H6V2a1 1 0 0 1-1-1ZM3 5h12v13a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V5Z"
-                        }
-                      )
-                    }
-                  ),
-                  /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Remove version" })
-                ] }),
-                /* @__PURE__ */ jsxs("span", { "x-show": "confirming && !isDeleting", class: "mx-1", children: [
-                  "Confirm?",
-                  /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Confirm delete" })
-                ] }),
-                /* @__PURE__ */ jsxs("span", { "x-show": "isDeleting", children: [
-                  /* @__PURE__ */ jsx(LoadingSpinner, {}),
-                  /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Loading..." })
-                ] })
-              ]
-            }
-          )
+          /* @__PURE__ */ jsxs("div", { class: "flex items-center ml-2 space-x-1", children: [
+            showRefresh && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("template", { "x-if": "!isRefreshing", children: /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  class: "font-medium rounded-lg text-sm p-1 w-6 h-6 text-center inline-flex items-center justify-center transition-colors duration-150 ease-in-out text-gray-500 border border-gray-300 hover:bg-gray-100 hover:text-gray-700 focus:ring-4 focus:outline-none focus:ring-gray-200 dark:border-gray-600 dark:text-gray-400 dark:hover:text-white dark:focus:ring-gray-700 dark:hover:bg-gray-600",
+                  title: "Refresh this version (re-scrape changed pages)",
+                  "x-on:click": "\n                  isRefreshing = true;\n                  $root.dataset.isRefreshing = 'true';\n                  $el.dispatchEvent(new CustomEvent('trigger-refresh', { bubbles: true }));\n                ",
+                  "hx-post": `/web/libraries/${encodeURIComponent(libraryName)}/versions/${encodeURIComponent(versionParam)}/refresh`,
+                  "hx-swap": "none",
+                  "hx-trigger": "trigger-refresh",
+                  children: [
+                    /* @__PURE__ */ jsx(
+                      "svg",
+                      {
+                        class: "w-4 h-4",
+                        "aria-hidden": "true",
+                        xmlns: "http://www.w3.org/2000/svg",
+                        fill: "none",
+                        viewBox: "0 0 24 24",
+                        children: /* @__PURE__ */ jsx(
+                          "path",
+                          {
+                            stroke: "currentColor",
+                            "stroke-linecap": "round",
+                            "stroke-linejoin": "round",
+                            "stroke-width": "2",
+                            d: "M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"
+                          }
+                        )
+                      }
+                    ),
+                    /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Refresh version" })
+                  ]
+                }
+              ) }),
+              /* @__PURE__ */ jsx("template", { "x-if": "isRefreshing", children: /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  class: "font-medium rounded-lg text-sm p-1 w-6 h-6 text-center inline-flex items-center justify-center transition-colors duration-150 ease-in-out text-gray-500 border border-gray-300 dark:border-gray-600 dark:text-gray-400",
+                  title: "Refresh in progress...",
+                  disabled: true,
+                  children: [
+                    /* @__PURE__ */ jsx(LoadingSpinner, { class: "text-gray-500 dark:text-gray-400" }),
+                    /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Refreshing..." })
+                  ]
+                }
+              ) })
+            ] }),
+            showDelete && /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                class: "font-medium rounded-lg text-sm p-1 min-w-6 h-6 text-center inline-flex items-center justify-center transition-colors duration-150 ease-in-out",
+                title: "Remove this version",
+                "x-bind:class": `confirming ? '${confirmingStateClasses}' : '${defaultStateClasses}'`,
+                "x-bind:disabled": "isDeleting",
+                "x-on:click": "\n              if (confirming) {\n                isDeleting = true;\n                window.confirmationManager.clear($root.id);\n                $el.dispatchEvent(new CustomEvent('confirmed-delete', { bubbles: true }));\n              } else {\n                confirming = true;\n                isDeleting = false;\n                window.confirmationManager.start($root.id);\n              }\n            ",
+                "hx-delete": `/web/libraries/${encodeURIComponent(libraryName)}/versions/${encodeURIComponent(versionParam)}`,
+                "hx-target": `#${rowId}`,
+                "hx-swap": "outerHTML",
+                "hx-trigger": "confirmed-delete",
+                children: [
+                  /* @__PURE__ */ jsxs("span", { "x-show": "!confirming && !isDeleting", children: [
+                    /* @__PURE__ */ jsx(
+                      "svg",
+                      {
+                        class: "w-4 h-4",
+                        "aria-hidden": "true",
+                        xmlns: "http://www.w3.org/2000/svg",
+                        fill: "none",
+                        viewBox: "0 0 18 20",
+                        children: /* @__PURE__ */ jsx(
+                          "path",
+                          {
+                            stroke: "currentColor",
+                            "stroke-linecap": "round",
+                            "stroke-linejoin": "round",
+                            "stroke-width": "2",
+                            d: "M1 5h16M7 8v8m4-8v8M7 1h4a1 1 0 0 1 1 1v3H6V2a1 1 0 0 1-1-1ZM3 5h12v13a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V5Z"
+                          }
+                        )
+                      }
+                    ),
+                    /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Remove version" })
+                  ] }),
+                  /* @__PURE__ */ jsxs("span", { "x-show": "confirming && !isDeleting", class: "mx-1", children: [
+                    "Confirm?",
+                    /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Confirm delete" })
+                  ] }),
+                  /* @__PURE__ */ jsxs("span", { "x-show": "isDeleting", children: [
+                    /* @__PURE__ */ jsx(LoadingSpinner, {}),
+                    /* @__PURE__ */ jsx("span", { class: "sr-only", children: "Loading..." })
+                  ] })
+                ]
+              }
+            )
+          ] })
         ]
       }
     )
   );
 };
 const LibraryDetailCard = ({ library }) => {
-  const versions = library.versions?.reverse() || [];
+  const versions = library.versions || [];
   const latestVersion = versions[0];
-  return (
-    // Use Flowbite Card structure with updated padding and border, and white background
-    /* @__PURE__ */ jsxs("div", { class: "block p-4 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-300 dark:border-gray-600 mb-4", children: [
-      /* @__PURE__ */ jsx("h3", { class: "text-lg font-medium text-gray-900 dark:text-white mb-1", children: /* @__PURE__ */ jsx("span", { safe: true, children: library.name }) }),
+  return /* @__PURE__ */ jsxs("div", { class: "block p-4 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-300 dark:border-gray-600 mb-4", children: [
+    /* @__PURE__ */ jsx("div", { class: "flex justify-between items-start mb-1", children: /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx("h3", { class: "text-lg font-medium text-gray-900 dark:text-white", children: /* @__PURE__ */ jsx("span", { safe: true, children: library.name }) }),
       latestVersion?.sourceUrl ? /* @__PURE__ */ jsx("div", { class: "text-sm text-gray-500 dark:text-gray-400", children: /* @__PURE__ */ jsx(
         "a",
         {
@@ -12235,31 +12371,43 @@ const LibraryDetailCard = ({ library }) => {
           safe: true,
           children: latestVersion.sourceUrl
         }
-      ) }) : null,
-      /* @__PURE__ */ jsx("div", { class: "mt-2", children: versions.length > 0 ? versions.map((v) => {
-        const adapted = {
-          id: -1,
-          ref: { library: library.name, version: v.version },
-          status: v.status,
-          progress: v.progress,
-          counts: {
-            documents: v.documentCount,
-            uniqueUrls: v.uniqueUrlCount
-          },
-          indexedAt: v.indexedAt,
-          sourceUrl: v.sourceUrl ?? void 0
-        };
-        return /* @__PURE__ */ jsx(
-          VersionDetailsRow,
-          {
-            libraryName: library.name,
-            version: adapted,
-            showDelete: false
-          }
-        );
-      }) : /* @__PURE__ */ jsx("p", { class: "text-sm text-gray-500 dark:text-gray-400 italic", children: "No versions indexed." }) })
-    ] })
-  );
+      ) }) : null
+    ] }) }),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        class: "mt-2",
+        id: "version-list",
+        "hx-get": `/web/libraries/${encodeURIComponent(library.name)}/versions-list`,
+        "hx-trigger": "library-change from:body",
+        "hx-swap": "morph:innerHTML",
+        children: versions.length > 0 ? versions.map((v) => {
+          const adapted = {
+            id: -1,
+            ref: { library: library.name, version: v.version },
+            status: v.status,
+            progress: v.progress,
+            counts: {
+              documents: v.documentCount,
+              uniqueUrls: v.uniqueUrlCount
+            },
+            indexedAt: v.indexedAt,
+            sourceUrl: v.sourceUrl ?? void 0
+          };
+          return /* @__PURE__ */ jsx(
+            VersionDetailsRow,
+            {
+              libraryName: library.name,
+              version: adapted,
+              showDelete: true,
+              showRefresh: true
+            }
+          );
+        }) : /* @__PURE__ */ jsx("p", { class: "text-sm text-gray-500 dark:text-gray-400 italic", children: "No versions indexed." })
+      }
+    ),
+    /* @__PURE__ */ jsx("div", { id: "add-version-form-container", class: "mt-4", children: /* @__PURE__ */ jsx(AddVersionButton, { libraryName: library.name }) })
+  ] });
 };
 const LibrarySearchCard = ({ library }) => {
   return /* @__PURE__ */ jsxs("div", { class: "block p-4 bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-300 dark:border-gray-600 mb-4", children: [
@@ -12285,7 +12433,7 @@ const LibrarySearchCard = ({ library }) => {
               children: [
                 /* @__PURE__ */ jsx("option", { value: "", children: "Latest" }),
                 " ",
-                library.versions.map((version) => /* @__PURE__ */ jsx("option", { value: version.version || "unversioned", safe: true, children: version.version || "Unversioned" }))
+                library.versions.map((version) => /* @__PURE__ */ jsx("option", { value: version.version || "latest", safe: true, children: version.version || "Latest" }))
               ]
             }
           ),
@@ -12359,7 +12507,7 @@ const SearchResultSkeletonItem = () => /* @__PURE__ */ jsxs("div", { class: "blo
   /* @__PURE__ */ jsx("div", { class: "h-[0.8em] bg-gray-200 dark:bg-gray-700 rounded w-full mb-2" }),
   /* @__PURE__ */ jsx("div", { class: "h-[0.8em] bg-gray-200 dark:bg-gray-700 rounded w-5/6" })
 ] });
-function registerLibraryDetailRoutes(server, listLibrariesTool, searchTool) {
+function registerLibraryDetailRoutes(server, listLibrariesTool, searchTool, scrapeTool, docService) {
   server.get(
     "/libraries/:libraryName",
     async (request, reply) => {
@@ -12367,7 +12515,7 @@ function registerLibraryDetailRoutes(server, listLibrariesTool, searchTool) {
       try {
         const result = await listLibrariesTool.execute();
         const libraryInfo = result.libraries.find(
-          (lib) => lib.name === libraryName
+          (lib) => lib.name.toLowerCase() === libraryName.toLowerCase()
         );
         if (!libraryInfo) {
           reply.status(404).send("Library not found");
@@ -12404,7 +12552,7 @@ function registerLibraryDetailRoutes(server, listLibrariesTool, searchTool) {
         reply.status(400).send("Search query is required.");
         return;
       }
-      const versionParam = version === "unversioned" ? void 0 : version;
+      const versionParam = version === "latest" ? void 0 : version;
       try {
         const searchResult = await searchTool.execute({
           library: libraryName,
@@ -12423,9 +12571,128 @@ function registerLibraryDetailRoutes(server, listLibrariesTool, searchTool) {
       }
     }
   );
+  server.get(
+    "/web/libraries/:libraryName/versions-list",
+    async (request, reply) => {
+      const { libraryName } = request.params;
+      try {
+        const result = await listLibrariesTool.execute();
+        const libraryInfo = result.libraries.find(
+          (lib) => lib.name.toLowerCase() === libraryName.toLowerCase()
+        );
+        if (!libraryInfo) {
+          reply.status(404).send("Library not found");
+          return;
+        }
+        const versions = libraryInfo.versions || [];
+        reply.type("text/html; charset=utf-8");
+        if (versions.length === 0) {
+          return /* @__PURE__ */ jsx("p", { class: "text-sm text-gray-500 dark:text-gray-400 italic", children: "No versions indexed." });
+        }
+        return /* @__PURE__ */ jsx(Fragment, { children: versions.map((v) => {
+          const adapted = {
+            id: -1,
+            ref: { library: libraryInfo.name, version: v.version },
+            status: v.status,
+            progress: v.progress,
+            counts: {
+              documents: v.documentCount,
+              uniqueUrls: v.uniqueUrlCount
+            },
+            indexedAt: v.indexedAt,
+            sourceUrl: v.sourceUrl ?? void 0
+          };
+          return /* @__PURE__ */ jsx(
+            VersionDetailsRow,
+            {
+              libraryName: libraryInfo.name,
+              version: adapted,
+              showDelete: true,
+              showRefresh: true
+            }
+          );
+        }) });
+      } catch (error) {
+        logger.error(`Failed to fetch versions for ${libraryName}: ${error}`);
+        reply.status(500).send("Internal Server Error");
+      }
+    }
+  );
+  server.get(
+    "/web/libraries/:libraryName/add-version-button",
+    async (request, reply) => {
+      const { libraryName } = request.params;
+      reply.type("text/html; charset=utf-8");
+      return /* @__PURE__ */ jsx(AddVersionButton, { libraryName });
+    }
+  );
+  server.get(
+    "/web/libraries/:libraryName/add-version-form",
+    async (request, reply) => {
+      const { libraryName } = request.params;
+      try {
+        const result = await listLibrariesTool.execute();
+        const libraryInfo = result.libraries.find(
+          (lib) => lib.name.toLowerCase() === libraryName.toLowerCase()
+        );
+        if (!libraryInfo) {
+          reply.status(404).send("Library not found");
+          return;
+        }
+        const versions = libraryInfo.versions || [];
+        const latestVersion = versions[0];
+        let initialValues = {
+          library: libraryName
+        };
+        if (latestVersion) {
+          const summaries = await docService.listLibraries();
+          const libSummary = summaries.find(
+            (s) => s.library.toLowerCase() === libraryName.toLowerCase()
+          );
+          if (libSummary) {
+            const versionSummary = libSummary.versions.find(
+              (v) => v.ref.version === (latestVersion.version || "") || !latestVersion.version && v.ref.version === ""
+            );
+            if (versionSummary) {
+              const scraperConfig = await docService.getScraperOptions(
+                versionSummary.id
+              );
+              if (scraperConfig) {
+                const opts = scraperConfig.options;
+                initialValues = {
+                  library: libraryName,
+                  url: scraperConfig.sourceUrl,
+                  maxPages: opts.maxPages,
+                  maxDepth: opts.maxDepth,
+                  scope: opts.scope,
+                  includePatterns: opts.includePatterns?.join("\n"),
+                  excludePatterns: opts.excludePatterns?.join("\n"),
+                  scrapeMode: opts.scrapeMode,
+                  headers: opts.headers ? Object.entries(opts.headers).map(([name, value]) => ({
+                    name,
+                    value
+                  })) : void 0,
+                  followRedirects: opts.followRedirects,
+                  ignoreErrors: opts.ignoreErrors
+                };
+              }
+            }
+          }
+        }
+        reply.type("text/html; charset=utf-8");
+        return /* @__PURE__ */ jsx(ScrapeFormContent, { initialValues, mode: "add-version" });
+      } catch (error) {
+        logger.error(
+          `Failed to load add-version form for ${libraryName}: ${error}`
+        );
+        reply.type("text/html; charset=utf-8");
+        return /* @__PURE__ */ jsx(Alert, { type: "error", message: "Failed to load the add version form." });
+      }
+    }
+  );
 }
 const LibraryItem = ({ library }) => {
-  const versions = library.versions?.reverse() || [];
+  const versions = library.versions || [];
   const latestVersion = versions[0];
   return (
     // Use Flowbite Card structure with updated padding and border, and white background
@@ -12514,7 +12781,7 @@ const LibraryList = ({ libraries }) => {
     }
   );
 };
-function registerLibrariesRoutes(server, listLibrariesTool, removeTool) {
+function registerLibrariesRoutes(server, listLibrariesTool, removeTool, refreshVersionTool) {
   server.get("/web/libraries", async (_request, reply) => {
     try {
       const result = await listLibrariesTool.execute();
@@ -12529,9 +12796,16 @@ function registerLibrariesRoutes(server, listLibrariesTool, removeTool) {
     "/web/libraries/:libraryName/versions/:versionParam",
     async (request, reply) => {
       const { libraryName, versionParam } = request.params;
-      const version = versionParam === "unversioned" ? void 0 : versionParam;
+      const version = versionParam === "latest" ? void 0 : versionParam;
       try {
         await removeTool.execute({ library: libraryName, version });
+        const result = await listLibrariesTool.execute();
+        const libraryStillExists = result.libraries.some(
+          (lib) => lib.name.toLowerCase() === libraryName.toLowerCase()
+        );
+        if (!libraryStillExists) {
+          reply.header("HX-Redirect", "/");
+        }
         reply.status(204).send();
       } catch (error) {
         logger.error(
@@ -12541,6 +12815,46 @@ function registerLibrariesRoutes(server, listLibrariesTool, removeTool) {
       }
     }
   );
+  server.post(
+    "/web/libraries/:libraryName/versions/:versionParam/refresh",
+    async (request, reply) => {
+      const { libraryName, versionParam } = request.params;
+      const version = versionParam === "latest" || versionParam === "" ? void 0 : versionParam;
+      try {
+        await refreshVersionTool.execute({
+          library: libraryName,
+          version,
+          waitForCompletion: false
+        });
+        const versionDisplay = version || "latest";
+        reply.header(
+          "HX-Trigger",
+          JSON.stringify({
+            toast: {
+              message: `Refresh started for ${libraryName}@${versionDisplay}`,
+              type: "success"
+            }
+          })
+        );
+        reply.status(204).send();
+      } catch (error) {
+        logger.error(
+          `Failed to refresh ${libraryName}@${versionParam}: ${error}`
+        );
+        const errorMessage = error instanceof Error ? error.message : "Failed to refresh version.";
+        reply.header(
+          "HX-Trigger",
+          JSON.stringify({
+            toast: {
+              message: errorMessage,
+              type: "error"
+            }
+          })
+        );
+        reply.status(500).send();
+      }
+    }
+  );
 }
 function formatNumber(num) {
   if (num >= 1e9) {
@@ -12616,12 +12930,19 @@ async function registerWebService(server, docService, pipeline, eventBus, config
   const listJobsTool = new ListJobsTool(pipeline);
   const scrapeTool = new ScrapeTool(pipeline);
   const removeTool = new RemoveTool(docService, pipeline);
+  const refreshVersionTool = new RefreshVersionTool(pipeline);
   const searchTool = new SearchTool(docService);
   const cancelJobTool = new CancelJobTool(pipeline);
   const clearCompletedJobsTool = new ClearCompletedJobsTool(pipeline);
   registerIndexRoute(server, config);
-  registerLibrariesRoutes(server, listLibrariesTool, removeTool);
-  registerLibraryDetailRoutes(server, listLibrariesTool, searchTool);
+  registerLibrariesRoutes(server, listLibrariesTool, removeTool, refreshVersionTool);
+  registerLibraryDetailRoutes(
+    server,
+    listLibrariesTool,
+    searchTool,
+    scrapeTool,
+    docService
+  );
   registerJobListRoutes(server, listJobsTool);
   registerNewJobRoutes(server, scrapeTool);
   registerCancelJobRoute(server, cancelJobTool);
@@ -12683,7 +13004,7 @@ class AppServer {
       try {
         if (telemetry.isEnabled()) {
           telemetry.setGlobalContext({
-            appVersion: "1.30.0",
+            appVersion: "1.31.0",
             appPlatform: process.platform,
             appNodeVersion: process.version,
             appServicesEnabled: this.getActiveServicesList(),
@@ -14347,11 +14668,11 @@ class PipelineWorker {
       if (!scraperOptions.isRefresh) {
         await this.store.removeAllDocuments(library, version);
         logger.info(
-          `💾 Cleared store for ${library}@${version || "[no version]"} before scraping.`
+          `💾 Cleared store for ${library}@${version || "latest"} before scraping.`
         );
       } else {
         logger.info(
-          `🔄 Refresh operation - preserving existing data for ${library}@${version || "[no version]"}.`
+          `🔄 Refresh operation - preserving existing data for ${library}@${version || "latest"}.`
         );
       }
       await this.scraperService.scrape(
@@ -14503,7 +14824,7 @@ class PipelineManager {
       for (const version of runningVersions) {
         await this.store.updateVersionStatus(version.id, VersionStatus.QUEUED);
         logger.info(
-          `🔄 Reset interrupted job to QUEUED: ${version.library_name}@${version.name || "unversioned"}`
+          `🔄 Reset interrupted job to QUEUED: ${version.library_name}@${version.name || "latest"}`
         );
       }
       const queuedVersions = await this.store.getVersionsByStatus([VersionStatus.QUEUED]);
@@ -14524,7 +14845,7 @@ class PipelineManager {
             parsedScraperOptions = JSON.parse(version.scraper_options);
           } catch (error) {
             logger.warn(
-              `⚠️  Failed to parse scraper options for ${version.library_name}@${version.name || "unversioned"}: ${error}`
+              `⚠️  Failed to parse scraper options for ${version.library_name}@${version.name || "latest"}: ${error}`
             );
           }
         }
@@ -14631,7 +14952,7 @@ class PipelineManager {
     this.jobMap.set(jobId, job);
     this.jobQueue.push(jobId);
     logger.info(
-      `📝 Job enqueued: ${jobId} for ${library}${normalizedVersion ? `@${normalizedVersion}` : " (unversioned)"}`
+      `📝 Job enqueued: ${jobId} for ${library}${normalizedVersion ? `@${normalizedVersion}` : " (latest)"}`
     );
     await this.updateJobStatus(job, PipelineJobStatus.QUEUED);
     if (this.isRunning) {
@@ -14665,7 +14986,7 @@ class PipelineManager {
       }
       if (versionInfo && versionInfo.status !== VersionStatus.COMPLETED) {
         logger.info(
-          `⚠️  Version ${library}@${normalizedVersion || "unversioned"} has status "${versionInfo.status}". Performing full re-scrape instead of refresh.`
+          `⚠️  Version ${library}@${normalizedVersion || "latest"} has status "${versionInfo.status}". Performing full re-scrape instead of refresh.`
         );
         return this.enqueueJobWithStoredOptions(library, normalizedVersion);
       }
@@ -14677,11 +14998,11 @@ class PipelineManager {
       }
       if (pages.length === 0) {
         throw new Error(
-          `No pages found for ${library}@${normalizedVersion || "unversioned"}. Use scrape_docs to index it first.`
+          `No pages found for ${library}@${normalizedVersion || "latest"}. Use scrape_docs to index it first.`
         );
       }
       logger.info(
-        `🔄 Preparing refresh job for ${library}@${normalizedVersion || "unversioned"} with ${pages.length} page(s)`
+        `🔄 Preparing refresh job for ${library}@${normalizedVersion || "latest"} with ${pages.length} page(s)`
       );
       const initialQueue = pages.map((page) => ({
         url: page.url,
@@ -14705,7 +15026,7 @@ class PipelineManager {
         // Mark this as a refresh operation
       };
       logger.info(
-        `📝 Enqueueing refresh job for ${library}@${normalizedVersion || "unversioned"}`
+        `📝 Enqueueing refresh job for ${library}@${normalizedVersion || "latest"}`
       );
       return this.enqueueScrapeJob(library, normalizedVersion, scraperOptions);
     } catch (error) {
@@ -14727,7 +15048,7 @@ class PipelineManager {
       const stored = await this.store.getScraperOptions(versionId);
       if (!stored) {
         throw new Error(
-          `No stored scraper options found for ${library}@${normalizedVersion || "unversioned"}`
+          `No stored scraper options found for ${library}@${normalizedVersion || "latest"}`
         );
       }
       const storedOptions = stored.options;
@@ -14738,7 +15059,7 @@ class PipelineManager {
         ...storedOptions
       };
       logger.info(
-        `🔄 Re-indexing ${library}@${normalizedVersion || "unversioned"} with stored options from ${stored.sourceUrl}`
+        `🔄 Re-indexing ${library}@${normalizedVersion || "latest"} with stored options from ${stored.sourceUrl}`
       );
       return this.enqueueScrapeJob(library, normalizedVersion, completeOptions);
     } catch (error) {
@@ -15774,7 +16095,7 @@ async function removeAction(library, options, command) {
 function createRemoveCommand(program) {
   return program.command("remove <library>").description("Remove documents for a specific library and version").option(
     "-v, --version <string>",
-    "Version to remove (optional, removes unversioned if omitted)"
+    "Version to remove (optional, removes latest if omitted)"
   ).option(
     "--server-url <url>",
     "URL of external pipeline worker RPC (e.g., http://localhost:8080/api)"
@@ -16170,7 +16491,7 @@ function createCliProgram() {
   const commandStartTimes = /* @__PURE__ */ new Map();
   let globalEventBus = null;
   let globalTelemetryService = null;
-  program.name("docs-mcp-server").description("Unified CLI, MCP Server, and Web Interface for Docs MCP Server.").version("1.30.0").addOption(
+  program.name("docs-mcp-server").description("Unified CLI, MCP Server, and Web Interface for Docs MCP Server.").version("1.31.0").addOption(
     new Option("--verbose", "Enable verbose (debug) logging").conflicts("silent")
   ).addOption(new Option("--silent", "Disable all logging except errors")).addOption(
     new Option("--telemetry", "Enable telemetry collection").env("DOCS_MCP_TELEMETRY").argParser((value) => {
@@ -16204,7 +16525,7 @@ function createCliProgram() {
     if (shouldEnableTelemetry()) {
       if (telemetry.isEnabled()) {
         telemetry.setGlobalContext({
-          appVersion: "1.30.0",
+          appVersion: "1.31.0",
           appPlatform: process.platform,
           appNodeVersion: process.version,
           appInterface: "cli",