@mikedown/core 0.3.0 → 0.4.0

package/dist/{chunk-7A5HEPLK.js → chunk-DWXGWVA3.js}

@@ -1,22 +1,24 @@
 import {
   aiHostTier
-} from "./chunk-LXZG7IKN.js";
+} from "./chunk-N4N54LK2.js";
 import {
   AI_CLOUD_PRIVACY,
-  AI_ENGINE_KINDS,
   AI_ENGINE_PRESETS,
-  AI_FALLBACK_MODES,
   AI_HOST_PRESET_FAMILY,
   AI_HOST_PRIVACY,
   AI_LOCAL_DETECT_TIMEOUT_MS,
   AI_PRESET_FAMILIES,
   AI_TASKS,
-  DEFAULT_CONTEXT_TOKENS,
+  DOCS_NO_HOME_TEXT,
   aiConsentHost,
   aiConsentStepNote,
   aiErrorCopy,
   aiProviderPolicy,
+  checkDocRoot,
+  clampDocsHops,
+  clampDocsSourceShare,
   detectCapabilities,
+  docRootKey,
   formatModelSize,
   generateAiId,
   getAiTask,
@@ -28,6 +30,8 @@ import {
   missingCapabilities,
   modelMoeFastHint,
   modelSizeHint,
+  normalizeDocHomeFile,
+  parseAiSettings,
   presetForEngine,
   recommendSetupPath,
   resolveRoute,
@@ -38,14 +42,22 @@ import {
   vscodeLmAvailability,
   whatIsSent,
   withThinkingLevel
-} from "./chunk-JZWKEBCI.js";
+} from "./chunk-IWCXWUWW.js";
 import {
+  AI_DOCS_MAX_HOPS_MAX,
+  AI_DOCS_MAX_HOPS_MIN,
+  AI_DOCS_NAVIGATE_BY,
+  AI_DOCS_SOURCE_SHARE_MAX,
+  AI_DOCS_SOURCE_SHARE_MIN,
+  AI_ENGINE_KINDS,
+  AI_FALLBACK_MODES,
+  DEFAULT_CONTEXT_TOKENS,
   DEFAULT_LOCAL_NETWORKS,
   detectLocality,
   engineLocality,
   hostOfUrl,
   localityMismatch
-} from "./chunk-QDVY7WW6.js";
+} from "./chunk-APPBNQEY.js";
 
 // src/ai-settings-model.ts
 var AI_ENGINE_KIND_LABELS = {
@@ -1149,7 +1161,8 @@ var ICONS = {
   refresh: svg('<path d="M13 8a5 5 0 1 1-1.5-3.55M13 2.5v3h-3"/>', 12),
   search: svg('<circle cx="7" cy="7" r="4.25"/><path d="M10.2 10.2l3.3 3.3"/>', 12),
   back: svg('<path d="M10 3.5L5.5 8l4.5 4.5"/>', 14),
-  routing: svg('<path d="M3 4h4.5a2 2 0 0 1 2 2v4a2 2 0 0 0 2 2H13M3 12h3M11 2.5L13 4l-2 1.5M11 10.5l2 1.5-2 1.5"/>', 16)
+  routing: svg('<path d="M3 4h4.5a2 2 0 0 1 2 2v4a2 2 0 0 0 2 2H13M3 12h3M11 2.5L13 4l-2 1.5M11 10.5l2 1.5-2 1.5"/>', 16),
+  book: svg('<path d="M3 13V4a1.5 1.5 0 0 1 1.5-1.5H13v8.5H4.5A1.5 1.5 0 0 0 3 12.5 1.5 1.5 0 0 0 4.5 14H13M6 5.5h4"/>', 16)
 };
 var KIND_MONOGRAMS = {
   lmstudio: "LM",
@@ -3087,6 +3100,771 @@ function createRoutingSection(ctx, deps) {
   return { element: body, render };
 }
 
+// src/ai-docs-page.ts
+var DOCS_CLOUD_LABEL = "May be sent to cloud engines";
+var DOCS_CLOUD_LINE = "Pages from this base may go to the cloud engines you allow.";
+var DOCS_NOT_CHECKED_TEXT = "Not checked yet";
+var DOCS_ROOT_MISSING_TEXT = "Root not found";
+var NAVIGATE_LABELS = { section: "Section", page: "Page" };
+var plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+function docsRootChips(root) {
+  if (!root.found) {
+    return [{ text: DOCS_ROOT_MISSING_TEXT, tone: "warn" }];
+  }
+  const chips = [];
+  const hasHome = !!root.home && root.home !== "map" && !!root.homePath;
+  chips.push({ text: hasHome ? `Home: ${root.homePath}` : DOCS_NO_HOME_TEXT, tone: "quiet" });
+  chips.push({ text: plural(root.fileCount, "file"), tone: "quiet" });
+  if (root.oversizeSkipped > 0) {
+    chips.push({ text: `${root.oversizeSkipped} too large, skipped`, tone: "quiet" });
+  }
+  if (root.capReached) {
+    chips.push({ text: "File limit reached", tone: "warn" });
+  }
+  if (root.notTextSkipped) {
+    chips.push({ text: `${root.notTextSkipped} not UTF-8 text, skipped`, tone: "quiet" });
+  }
+  if (root.dirCapReached) {
+    chips.push({ text: "Folder limit reached", tone: "warn" });
+  }
+  return chips;
+}
+function docsBaseChips(status) {
+  const chips = [];
+  if (status.brokenLinks) {
+    chips.push({ text: plural(status.brokenLinks, "broken link"), tone: "warn" });
+  }
+  if (status.timedOut) {
+    chips.push({ text: "Stopped early: this folder took too long to read", tone: "warn" });
+  }
+  return chips;
+}
+function withDocsOptions(settings, patch) {
+  const next = { ...settings.docs, ...patch };
+  return {
+    ...settings,
+    docs: {
+      ...next,
+      maxHops: clampDocsHops(next.maxHops),
+      sourceShare: clampDocsSourceShare(next.sourceShare),
+      navigateBy: AI_DOCS_NAVIGATE_BY.includes(next.navigateBy) ? next.navigateBy : "section"
+    }
+  };
+}
+function checkBaseRoot(raw, inThisBase, others) {
+  const checked = checkDocRoot(raw);
+  if (!checked.ok) {
+    return { ok: false, message: `This path ${checked.reason}.` };
+  }
+  const key = docRootKey(checked.path);
+  if (inThisBase.some((r) => docRootKey(r) === key)) {
+    return { ok: false, message: "This base already has that folder." };
+  }
+  const holder = others.find((b) => b.roots.some((r) => docRootKey(r) === key));
+  if (holder) {
+    return { ok: false, message: `That folder is already in \u201C${holder.name}\u201D.` };
+  }
+  return { ok: true, path: checked.path };
+}
+function checkDocBaseForm(values, others, existing) {
+  const errors = {};
+  if (values.roots.length === 0) {
+    errors.roots = "Add at least one folder.";
+  }
+  for (const [i, root] of values.roots.entries()) {
+    const checked = checkBaseRoot(root, values.roots.slice(0, i), others);
+    if (!checked.ok) {
+      errors.roots = `${root}: ${checked.message}`;
+      break;
+    }
+  }
+  const homeText = values.homeFile.trim();
+  const home = homeText ? normalizeDocHomeFile(homeText) : null;
+  if (homeText && !home) {
+    errors.homeFile = "The home file must be a markdown file name or a path inside the folder, such as HOME.md.";
+  }
+  if (errors.roots || errors.homeFile) {
+    return { ok: false, errors };
+  }
+  const base = {
+    ...existing ?? { enabled: true },
+    id: existing?.id ?? "",
+    name: values.name.trim(),
+    roots: values.roots,
+    allowCloud: values.allowCloud
+  };
+  if (home) {
+    base.homeFile = home;
+  } else {
+    delete base.homeFile;
+  }
+  return { ok: true, base };
+}
+function revalidateDocBases(bases) {
+  const warnings = [];
+  const taken = bases.map((b) => b.id).filter(Boolean);
+  const parsed = parseAiSettings({ docBases: bases }, {
+    onWarning: (w) => warnings.push(w),
+    generateId: (name) => {
+      const id = uniqueEngineId(name, taken);
+      taken.push(id);
+      return id;
+    }
+  }).docBases;
+  if (warnings.length > 0) {
+    return { ok: false, reason: `Not saved: ${warnings[0].replace(/^docBases\[\d+\](\.\w+(\[\d+\])?)?\s*/, "")}` };
+  }
+  return { ok: true, bases: parsed };
+}
+function lastPathSegment(path) {
+  const parts = path.split(/[\\/]+/).filter(Boolean);
+  return parts[parts.length - 1] ?? "";
+}
+function sameRootsAndHome(a, b) {
+  return JSON.stringify(a.roots) === JSON.stringify(b.roots) && (a.homeFile ?? "") === (b.homeFile ?? "");
+}
+function createDocsBasesSection(ctx, deps) {
+  const { docs } = deps;
+  const element = el("div", "ai-docs");
+  const listView = el("div", "ai-docs-list-view");
+  const formView = el("div", "ai-docs-form-view");
+  formView.hidden = true;
+  let entries = [];
+  let loaded = false;
+  let checking = false;
+  let openedOnce = false;
+  let disposed = false;
+  let problem = null;
+  let confirmRemoveId = null;
+  let form = null;
+  let queue = Promise.resolve();
+  function enqueue(job) {
+    const run = queue.then(job);
+    queue = run.catch(() => {
+    });
+    return run;
+  }
+  function focusFk(key) {
+    Array.from(element.querySelectorAll("[data-fk]")).find((n) => n.dataset.fk === key)?.focus({ preventScroll: true });
+  }
+  function load() {
+    if (checking || disposed) {
+      return;
+    }
+    checking = true;
+    problem = null;
+    renderList();
+    deps.announce("Checking bases\u2026");
+    void enqueue(async () => {
+      if (disposed) {
+        return;
+      }
+      try {
+        const list = await docs.listBases({ refresh: true });
+        if (disposed) {
+          return;
+        }
+        entries = list.map((status) => ({ base: status.base, health: status }));
+        loaded = true;
+        deps.announce(`Checked ${plural(entries.length, "base")}.`);
+      } catch (err) {
+        if (disposed) {
+          return;
+        }
+        problem = `Could not read your bases: ${toAiError(err).message}`;
+        deps.announce(problem);
+      }
+      checking = false;
+      if (confirmRemoveId && !entries.some((e) => e.base.id === confirmRemoveId)) {
+        confirmRemoveId = null;
+      }
+      renderList();
+      deps.onCountChanged();
+    });
+  }
+  function mutate(change) {
+    return enqueue(async () => {
+      if (disposed) {
+        return null;
+      }
+      if (!loaded) {
+        return "Your bases could not be read, so nothing was saved. Choose Refresh and try again.";
+      }
+      const checked = revalidateDocBases(change(entries.map((e) => e.base)));
+      if (!checked.ok) {
+        return checked.reason;
+      }
+      try {
+        await docs.saveBases(checked.bases);
+      } catch (err) {
+        return `Not saved: ${toAiError(err).message}`;
+      }
+      if (disposed) {
+        return null;
+      }
+      const before = new Map(entries.map((e) => [e.base.id, e]));
+      entries = checked.bases.map((base) => {
+        const prev = before.get(base.id);
+        if (!prev?.health || !sameRootsAndHome(prev.base, base)) {
+          return { base, health: null };
+        }
+        return { base, health: { ...prev.health, base, active: base.enabled && prev.health.rootsMissing < base.roots.length } };
+      });
+      problem = null;
+      deps.onCountChanged();
+      return null;
+    });
+  }
+  function chipNode(chip) {
+    const node = el("span", `ai-docs-chip${chip.tone === "warn" ? " ai-docs-chip--warn" : ""}`);
+    if (chip.tone === "warn") {
+      node.innerHTML = ICONS.warn;
+    }
+    node.append(el("span", "", chip.text));
+    return node;
+  }
+  function chipLine(chips) {
+    const line = el("span", "ai-docs-chips");
+    line.append(...chips.map(chipNode));
+    return line;
+  }
+  function renderList() {
+    keepFocus(listView, () => {
+      listView.replaceChildren();
+      listView.append(buildBar());
+      if (problem) {
+        listView.append(note("error", problem, "ai-result"));
+      }
+      if (loaded && entries.length === 0) {
+        const empty = el("div", "ai-summary-empty");
+        empty.append(
+          el("div", "ai-empty-title", "No bases yet"),
+          el("div", "ai-empty-text", "A base is a folder of markdown the AI can read to answer your questions."),
+          el("div", "ai-empty-text", "Add your docs folder, and chat can cite its pages.")
+        );
+        listView.append(empty);
+      } else if (entries.length > 0) {
+        const group = ctx.makeGroup(...entries.map(buildRow));
+        group.setAttribute("role", "list");
+        group.setAttribute("aria-label", "Documentation bases");
+        listView.append(group);
+      }
+    });
+  }
+  function buildBar() {
+    const bar = el("div", "ai-docs-bar");
+    bar.append(el("span", "ai-docs-status", checking ? "Checking bases\u2026" : ""));
+    if (entries.length > 0 || !loaded) {
+      const refresh = button("settings-btn", "Refresh", { html: ICONS.refresh, fk: "docs:refresh", title: "Check the folders again" });
+      if (checking) {
+        refresh.setAttribute("aria-disabled", "true");
+      }
+      refresh.addEventListener("click", () => load());
+      bar.append(refresh);
+    }
+    const add = button("settings-btn settings-btn--secondary", "Add base", { html: ICONS.plus, fk: "docs:add" });
+    if (!loaded) {
+      add.setAttribute("aria-disabled", "true");
+    }
+    add.addEventListener("click", () => {
+      if (loaded) {
+        openForm();
+      }
+    });
+    bar.append(add);
+    return bar;
+  }
+  function buildRow({ base, health }) {
+    const row = el("div", "settings-row ai-docs-base");
+    row.setAttribute("role", "listitem");
+    row.dataset.baseId = base.id;
+    row.classList.toggle("is-disabled", !base.enabled);
+    const head = el("div", "ai-docs-base-head");
+    const title = el("div", "ai-docs-base-title");
+    title.append(el("span", "ai-docs-base-name", base.name));
+    if (base.allowCloud) {
+      title.append(chipNode({ text: "May go to cloud", tone: "quiet" }));
+    }
+    if (!health) {
+      title.append(chipNode({ text: DOCS_NOT_CHECKED_TEXT, tone: "quiet" }));
+    }
+    const actions = el("div", "ai-docs-base-actions");
+    const edit = button("ai-link-btn", "Edit", { ariaLabel: `Edit ${base.name}`, fk: `base:${base.id}:edit` });
+    edit.addEventListener("click", () => openForm(base));
+    const remove = button("ai-icon-btn ai-delete-btn", "", { html: ICONS.trash, ariaLabel: `Remove ${base.name}`, title: "Remove from this list", fk: `base:${base.id}:remove` });
+    remove.addEventListener("click", () => {
+      confirmRemoveId = base.id;
+      renderList();
+      focusFk(`base:${base.id}:confirm-cancel`);
+    });
+    const enabled = switchInput(base.enabled, `Use ${base.name}`, `base:${base.id}:enabled`);
+    enabled.addEventListener("change", () => setEnabled(base, enabled.checked));
+    actions.append(edit, remove, enabled);
+    head.append(title, actions);
+    const roots = el("ul", "ai-docs-roots");
+    for (const path of base.roots) {
+      const item = el("li", "ai-docs-root");
+      const pathNode = el("span", "ai-docs-path ai-mono", path);
+      pathNode.title = path;
+      item.append(pathNode);
+      const status = health?.roots.find((r) => docRootKey(r.root) === docRootKey(path));
+      if (status) {
+        item.append(chipLine(docsRootChips(status)));
+      }
+      roots.append(item);
+    }
+    row.append(head, roots);
+    const baseChips = health ? docsBaseChips(health) : [];
+    if (baseChips.length > 0) {
+      row.append(chipLine(baseChips));
+    }
+    if (confirmRemoveId === base.id) {
+      row.append(buildRemoveConfirm(base));
+    }
+    return row;
+  }
+  function setEnabled(base, on) {
+    void mutate((bases) => bases.map((b) => b.id === base.id ? { ...b, enabled: on } : b)).then((error) => {
+      if (disposed) {
+        return;
+      }
+      problem = error;
+      renderList();
+      deps.announce(error ?? `${base.name} turned ${on ? "on" : "off"}.`);
+    });
+  }
+  function buildRemoveConfirm(base) {
+    const box = el("div", "ai-confirm");
+    box.setAttribute("role", "group");
+    box.setAttribute("aria-label", `Remove ${base.name}?`);
+    const yes = button("settings-btn ai-btn--danger", "Remove", { fk: `base:${base.id}:confirm-remove` });
+    const no = button("settings-btn", "Cancel", { fk: `base:${base.id}:confirm-cancel` });
+    yes.addEventListener("click", () => removeBase(base));
+    no.addEventListener("click", () => closeConfirm());
+    box.append(el("span", "ai-confirm-text", `Remove ${base.name} from this list? The folders and files on disk are not touched.`), yes, no);
+    return box;
+  }
+  function closeConfirm() {
+    const id = confirmRemoveId;
+    confirmRemoveId = null;
+    renderList();
+    if (id) {
+      focusFk(`base:${id}:remove`);
+    }
+  }
+  function removeBase(base) {
+    const index = entries.findIndex((e) => e.base.id === base.id);
+    void mutate((bases) => bases.filter((b) => b.id !== base.id)).then((error) => {
+      if (disposed) {
+        return;
+      }
+      problem = error;
+      confirmRemoveId = null;
+      renderList();
+      if (error) {
+        deps.announce(error);
+        focusFk(`base:${base.id}:remove`);
+        return;
+      }
+      deps.announce(`Removed ${base.name} from this list. No files were touched.`);
+      const next = entries[Math.min(index, entries.length - 1)];
+      focusFk(next ? `base:${next.base.id}:edit` : "docs:add");
+    });
+  }
+  const advancedPanelId = nextId("ai-docs-advanced");
+  const advancedToggle = button("ai-disclosure ai-docs-advanced-toggle", "Advanced", { html: ICONS.chevron, fk: "docs:advanced" });
+  advancedToggle.setAttribute("aria-expanded", "false");
+  advancedToggle.setAttribute("aria-controls", advancedPanelId);
+  const advancedPanel = el("div", "ai-advanced ai-docs-advanced");
+  advancedPanel.id = advancedPanelId;
+  advancedPanel.hidden = true;
+  advancedToggle.addEventListener("click", () => {
+    advancedPanel.hidden = !advancedPanel.hidden;
+    advancedToggle.setAttribute("aria-expanded", String(!advancedPanel.hidden));
+  });
+  function numberRow(label, description, read, write, min, max, fk) {
+    const row = ctx.makeRow(label, description, "inline");
+    const input = el("input", "settings-input settings-input--small ai-docs-number");
+    input.type = "number";
+    input.min = String(min);
+    input.max = String(max);
+    input.step = "1";
+    input.value = String(read());
+    input.dataset.fk = fk;
+    input.setAttribute("aria-label", label);
+    input.addEventListener("change", () => {
+      const value = input.value.trim() === "" ? NaN : Number(input.value);
+      if (Number.isFinite(value)) {
+        write(value);
+      }
+      input.value = String(read());
+    });
+    row.append(input);
+    return row;
+  }
+  function buildAdvanced() {
+    const draft = () => deps.getDraft();
+    const hops = numberRow(
+      "Max hops",
+      `Rounds of picking pages before the answer, ${AI_DOCS_MAX_HOPS_MIN} to ${AI_DOCS_MAX_HOPS_MAX}.`,
+      () => draft().docs.maxHops,
+      (n) => deps.setDraft(withDocsOptions(draft(), { maxHops: n })),
+      AI_DOCS_MAX_HOPS_MIN,
+      AI_DOCS_MAX_HOPS_MAX,
+      "docs:hops"
+    );
+    const share = numberRow(
+      "Source share",
+      `How much of the model\u2019s context the pages may take, ${AI_DOCS_SOURCE_SHARE_MIN} to ${AI_DOCS_SOURCE_SHARE_MAX}%.`,
+      () => draft().docs.sourceShare,
+      (n) => deps.setDraft(withDocsOptions(draft(), { sourceShare: n })),
+      AI_DOCS_SOURCE_SHARE_MIN,
+      AI_DOCS_SOURCE_SHARE_MAX,
+      "docs:share"
+    );
+    const by = ctx.makeSelectRow(
+      "Navigate by",
+      "What the AI asks to read: one section, or a whole page.",
+      draft().docs.navigateBy,
+      AI_DOCS_NAVIGATE_BY.map((value) => ({ value, label: NAVIGATE_LABELS[value] }))
+    );
+    by.select.classList.add("settings-input--small", "ai-docs-select");
+    by.select.dataset.fk = "docs:navigate-by";
+    by.select.setAttribute("aria-label", "Navigate by");
+    by.select.addEventListener("change", () => deps.setDraft(withDocsOptions(draft(), { navigateBy: by.select.value })));
+    advancedPanel.append(ctx.makeGroup(hops, share, by.row), el("div", "settings-desc", "These save when you choose Done."));
+  }
+  const otherBases = (existing) => entries.map((e) => e.base).filter((b) => b.id !== existing?.id);
+  function openForm(existing) {
+    confirmRemoveId = null;
+    const values = {
+      name: existing?.name ?? "",
+      roots: [...existing?.roots ?? []],
+      homeFile: existing?.homeFile ?? "",
+      allowCloud: existing?.allowCloud ?? false
+    };
+    const state = {
+      existing,
+      initial: { ...values, roots: [...values.roots] },
+      values,
+      saving: false,
+      showError: () => {
+      },
+      focusFirst: () => {
+      }
+    };
+    form = state;
+    formView.replaceChildren(buildForm(state));
+    showView();
+    state.focusFirst();
+  }
+  function closeForm(focusKey) {
+    form = null;
+    formView.replaceChildren();
+    showView();
+    renderList();
+    if (focusKey) {
+      focusFk(focusKey);
+    }
+  }
+  function showView() {
+    const editing = !!form;
+    formView.hidden = !editing;
+    listView.hidden = editing;
+    advancedToggle.hidden = editing;
+    if (editing) {
+      advancedPanel.hidden = true;
+      advancedToggle.setAttribute("aria-expanded", "false");
+    }
+  }
+  function labelRow(label, description, layout, control) {
+    const row = ctx.makeRow(label, description, layout);
+    if (control) {
+      control.id || (control.id = nextId("ai-docs-field"));
+      const labelNode = row.querySelector("label");
+      if (labelNode) {
+        labelNode.htmlFor = control.id;
+      }
+    }
+    return row;
+  }
+  function buildForm(state) {
+    const { existing, values } = state;
+    const box = el("div", "ai-docs-form");
+    box.setAttribute("role", "group");
+    const heading = el("div", "ai-subhead", existing ? `Edit ${existing.name}` : "Add a base");
+    heading.id = nextId("ai-docs-form-title");
+    box.setAttribute("aria-labelledby", heading.id);
+    const nameInput = el("input", "settings-input");
+    nameInput.type = "text";
+    nameInput.value = values.name;
+    nameInput.dataset.fk = "form:name";
+    nameInput.spellcheck = false;
+    nameInput.placeholder = "Team docs";
+    nameInput.addEventListener("input", () => {
+      values.name = nameInput.value;
+    });
+    const nameRow = labelRow("Name", "Shown in the chat and when asking before a cloud request.", "inline", nameInput);
+    nameRow.append(nameInput);
+    const rootsError = el("div", "ai-field-error");
+    rootsError.id = nextId("ai-docs-roots-error");
+    rootsError.setAttribute("aria-live", "polite");
+    const rootsList = el("ul", "ai-docs-form-roots");
+    rootsList.setAttribute("aria-label", "Folders in this base");
+    function setRootsError(text) {
+      rootsError.textContent = text;
+    }
+    function renderRoots() {
+      keepFocus(rootsList, () => {
+        rootsList.replaceChildren();
+        for (const root of values.roots) {
+          const item = el("li", "ai-docs-form-root");
+          const pathNode = el("span", "ai-docs-path ai-mono", root);
+          pathNode.title = root;
+          const remove = button("ai-icon-btn", "", { html: ICONS.close, ariaLabel: `Take ${root} out of this base`, title: "Take out of this base", fk: `form:root-remove:${root}` });
+          remove.addEventListener("click", () => {
+            const at = values.roots.indexOf(root);
+            values.roots = values.roots.filter((r) => r !== root);
+            renderRoots();
+            const next = values.roots[Math.min(at, values.roots.length - 1)];
+            focusFk(next ? `form:root-remove:${next}` : firstAddKey);
+          });
+          item.append(pathNode, remove);
+          rootsList.append(item);
+        }
+      });
+    }
+    function addRoot(raw) {
+      const checked = checkBaseRoot(raw, values.roots, otherBases(existing));
+      if (!checked.ok) {
+        setRootsError(checked.message);
+        return false;
+      }
+      setRootsError("");
+      values.roots = [...values.roots, checked.path];
+      if (!values.name.trim()) {
+        values.name = lastPathSegment(checked.path);
+        nameInput.value = values.name;
+      }
+      renderRoots();
+      deps.announce(`Added ${checked.path}.`);
+      return true;
+    }
+    function pickerButton(label, fk, pick) {
+      const b = button("settings-btn settings-btn--secondary", label, { fk });
+      b.addEventListener("click", () => {
+        void pick().then(
+          (path) => {
+            if (form === state && path) {
+              addRoot(path);
+            }
+          },
+          (err) => {
+            if (form === state) {
+              setRootsError(toAiError(err).message);
+            }
+          }
+        );
+      });
+      return b;
+    }
+    const adders = el("div", "ai-docs-form-adders");
+    if (docs.addWorkspaceFolder) {
+      adders.append(pickerButton("Add this workspace folder", "form:workspace", () => docs.addWorkspaceFolder()));
+    }
+    if (docs.pickFolder) {
+      adders.append(pickerButton("Choose folder\u2026", "form:pick", () => docs.pickFolder()));
+    }
+    let pathLine = null;
+    if (!docs.pickFolder) {
+      pathLine = el("div", "ai-docs-form-path");
+      const pathInput = el("input", "settings-input ai-mono");
+      pathInput.type = "text";
+      pathInput.dataset.fk = "form:path";
+      pathInput.spellcheck = false;
+      pathInput.placeholder = "/full/path/to/docs";
+      pathInput.setAttribute("aria-label", "Folder path");
+      pathInput.setAttribute("aria-describedby", rootsError.id);
+      const addPath = button("settings-btn settings-btn--secondary", "Add", { ariaLabel: "Add this path", fk: "form:add-path" });
+      const submitPath = () => {
+        if (addRoot(pathInput.value)) {
+          pathInput.value = "";
+          pathInput.removeAttribute("aria-invalid");
+        } else {
+          pathInput.setAttribute("aria-invalid", "true");
+        }
+      };
+      addPath.addEventListener("click", submitPath);
+      pathInput.addEventListener("input", () => {
+        pathInput.removeAttribute("aria-invalid");
+        setRootsError("");
+      });
+      pathInput.addEventListener("keydown", (e) => {
+        if (e.key !== "Enter") {
+          return;
+        }
+        e.preventDefault();
+        submitPath();
+      });
+      pathLine.append(pathInput, addPath);
+    }
+    const firstAddKey = docs.addWorkspaceFolder ? "form:workspace" : docs.pickFolder ? "form:pick" : "form:path";
+    const rootsRow = ctx.makeRow("Folders", "Every markdown file under these folders can be read. Symlinks are skipped.");
+    rootsRow.append(rootsList);
+    if (adders.childElementCount > 0) {
+      rootsRow.append(adders);
+    }
+    if (pathLine) {
+      rootsRow.append(pathLine);
+    }
+    rootsRow.append(rootsError);
+    renderRoots();
+    const homeInput = el("input", "settings-input ai-mono");
+    homeInput.type = "text";
+    homeInput.value = values.homeFile;
+    homeInput.dataset.fk = "form:home";
+    homeInput.spellcheck = false;
+    homeInput.placeholder = "HOME.md";
+    const homeError = el("div", "ai-field-error");
+    homeError.id = nextId("ai-docs-home-error");
+    homeError.setAttribute("aria-live", "polite");
+    homeInput.setAttribute("aria-describedby", homeError.id);
+    homeInput.addEventListener("input", () => {
+      values.homeFile = homeInput.value;
+      homeError.textContent = "";
+      homeInput.removeAttribute("aria-invalid");
+    });
+    const homeRow = labelRow("Home file", "Optional. The page to start from in each folder. Otherwise INDEX.md, then README.md.", "inline", homeInput);
+    homeRow.append(homeInput, homeError);
+    const cloud = switchInput(values.allowCloud, DOCS_CLOUD_LABEL, "form:cloud");
+    cloud.addEventListener("change", () => {
+      values.allowCloud = cloud.checked;
+    });
+    const cloudRow = labelRow(DOCS_CLOUD_LABEL, DOCS_CLOUD_LINE, "inline", cloud);
+    cloudRow.append(cloud);
+    const formError = el("div", "ai-docs-form-error");
+    formError.setAttribute("aria-live", "polite");
+    state.showError = (text) => formError.replaceChildren(note("error", text, "ai-result"));
+    const save = button("settings-btn settings-btn--primary", existing ? "Save" : "Add base", { fk: "form:save" });
+    const cancel = button("settings-btn", "Cancel", { fk: "form:cancel" });
+    save.addEventListener("click", () => submit());
+    cancel.addEventListener("click", () => back());
+    const actions = el("div", "ai-docs-form-actions");
+    actions.append(save, cancel);
+    function submit() {
+      if (state.saving) {
+        return;
+      }
+      formError.replaceChildren();
+      const checked = checkDocBaseForm(values, otherBases(existing), existing);
+      setRootsError("");
+      homeError.textContent = "";
+      homeInput.removeAttribute("aria-invalid");
+      if (!checked.ok) {
+        setRootsError(checked.errors.roots ?? "");
+        homeError.textContent = checked.errors.homeFile ?? "";
+        if (checked.errors.homeFile) {
+          homeInput.setAttribute("aria-invalid", "true");
+        }
+        deps.announce(checked.errors.roots ?? checked.errors.homeFile ?? "");
+        focusFk(checked.errors.roots ? firstAddKey : "form:home");
+        return;
+      }
+      state.saving = true;
+      save.setAttribute("aria-disabled", "true");
+      const base = checked.base;
+      void mutate((bases) => existing ? bases.map((b) => b.id === existing.id ? base : b) : [...bases, base]).then((error) => {
+        if (disposed) {
+          return;
+        }
+        if (form !== state) {
+          problem = error;
+          renderList();
+          deps.announce(error ?? `Saved ${base.name || lastPathSegment(base.roots[0])}.`);
+          return;
+        }
+        state.saving = false;
+        save.removeAttribute("aria-disabled");
+        if (error) {
+          state.showError(error);
+          deps.announce(error);
+          save.focus();
+          return;
+        }
+        const name = base.name || lastPathSegment(base.roots[0]);
+        deps.announce(existing ? `Saved ${name}.` : `Added ${name}. Choose Refresh to check it.`);
+        const saved = existing?.id ?? entries[entries.length - 1]?.base.id;
+        closeForm(saved ? `base:${saved}:edit` : "docs:add");
+      });
+    }
+    for (const input of [nameInput, homeInput]) {
+      input.addEventListener("keydown", (e) => {
+        if (e.key !== "Enter") {
+          return;
+        }
+        e.preventDefault();
+        submit();
+      });
+    }
+    state.focusFirst = () => {
+      if (existing || values.roots.length > 0) {
+        nameInput.focus({ preventScroll: true });
+      } else {
+        focusFk(firstAddKey);
+      }
+    };
+    box.append(heading, ctx.makeGroup(nameRow, rootsRow, homeRow, cloudRow), formError, actions);
+    return box;
+  }
+  function formDirty() {
+    return !!form && JSON.stringify(form.values) !== JSON.stringify(form.initial);
+  }
+  function back() {
+    if (form) {
+      const id = form.existing?.id;
+      closeForm(id ? `base:${id}:edit` : "docs:add");
+      return true;
+    }
+    if (confirmRemoveId) {
+      closeConfirm();
+      return true;
+    }
+    return false;
+  }
+  buildAdvanced();
+  element.append(listView, formView, advancedToggle, advancedPanel);
+  renderList();
+  return {
+    element,
+    opened() {
+      if (openedOnce) {
+        return;
+      }
+      openedOnce = true;
+      load();
+    },
+    back,
+    hasUnsavedForm: formDirty,
+    flagUnsavedForm() {
+      form?.showError("Save this base or cancel it before you choose Done.");
+      deps.announce("Save this base or cancel it before you choose Done.");
+      focusFk("form:save");
+    },
+    focus() {
+      if (form) {
+        form.focusFirst();
+      } else {
+        focusFk("docs:add");
+      }
+    },
+    count: () => loaded ? entries.length : null,
+    dispose() {
+      disposed = true;
+      form = null;
+    }
+  };
+}
+
 // src/ai-setup-wizard.ts
 var AI_WIZARD_STEPS = 3;
 function wizardStepNumber(step) {
@@ -3787,7 +4565,7 @@ function mountAiEnginesPage(container, ctx, opts) {
   let hardware = knownHardware(ai);
   let selection = initialSelection();
   let narrow = false;
-  let view = opts.initial?.engineId || opts.initial?.section === "routing" ? "detail" : "list";
+  let view = opts.initial?.engineId || opts.initial?.section === "routing" || opts.initial?.section === "bases" && opts.docs ? "detail" : "list";
   let confirmDeleteId = null;
   let confirmDiscard = false;
   let finished = false;
@@ -3797,6 +4575,9 @@ function mountAiEnginesPage(container, ctx, opts) {
     if (opts.initial?.section === "routing") {
       return { kind: "routing" };
     }
+    if (opts.initial?.section === "bases" && opts.docs) {
+      return { kind: "bases" };
+    }
     const wanted = opts.initial?.engineId && engines.find((e) => e.id === opts.initial?.engineId);
     if (wanted) {
       return { kind: "engine", id: wanted.id };
@@ -3880,6 +4661,15 @@ function mountAiEnginesPage(container, ctx, opts) {
     },
     statusList: () => session.statusList()
   });
+  const docsSection = opts.docs ? createDocsBasesSection(ctx, {
+    docs: opts.docs,
+    getDraft: () => session.draft,
+    setDraft: (next) => {
+      session.draft = next;
+    },
+    announce,
+    onCountChanged: () => refreshBasesEntry()
+  }) : null;
   async function setKey(id, value) {
     const engine = getEngine(id);
     const error = await session.setKey(id, value);
@@ -3972,7 +4762,7 @@ function mountAiEnginesPage(container, ctx, opts) {
         }
         navEngines.append(navList);
       }
-      routingEntry.replaceChildren(buildRoutingEntry(), buildAddEntry());
+      routingEntry.replaceChildren(buildRoutingEntry(), ...docsSection ? [buildBasesEntry()] : [], buildAddEntry());
     });
   }
   function buildNavItem(engine) {
@@ -4046,6 +4836,27 @@ function mountAiEnginesPage(container, ctx, opts) {
       sub.textContent = routingSubline();
     }
   }
+  function basesSubline() {
+    const count = docsSection?.count() ?? session.draft.docBases.length;
+    return count === 0 ? "None yet" : `${count} ${count === 1 ? "base" : "bases"}`;
+  }
+  function buildBasesEntry() {
+    const btn = navButton("nav:bases", selection.kind === "bases");
+    btn.classList.add("ai-nav-btn--bases");
+    const icon = el("span", "ai-nav-icon");
+    icon.innerHTML = ICONS.book;
+    const text = el("span", "ai-nav-text");
+    text.append(el("span", "ai-nav-name", "Documentation bases"), el("span", "ai-nav-sub", basesSubline()));
+    btn.append(icon, text);
+    btn.addEventListener("click", () => select({ kind: "bases" }));
+    return btn;
+  }
+  function refreshBasesEntry() {
+    const sub = routingEntry.querySelector(".ai-nav-btn--bases .ai-nav-sub");
+    if (sub) {
+      sub.textContent = basesSubline();
+    }
+  }
   function buildAddEntry() {
     const btn = navButton("nav:add", selection.kind === "add");
     btn.classList.add("ai-nav-btn--add");
@@ -4119,6 +4930,11 @@ function mountAiEnginesPage(container, ctx, opts) {
     } else if (selection.kind === "routing") {
       routing.render();
       detailBody.append(routing.element);
+    } else if (selection.kind === "bases") {
+      if (docsSection) {
+        detailBody.append(docsSection.element);
+        docsSection.opened();
+      }
     } else {
       detailBody.append(buildPresetCards());
       if (canDetect && !detectedOnce) {
@@ -4150,6 +4966,14 @@ function mountAiEnginesPage(container, ctx, opts) {
         detailHead.append(icon, main);
         return;
       }
+      if (selection.kind === "bases") {
+        const icon = el("span", "ai-detail-icon");
+        icon.innerHTML = ICONS.book;
+        const main = el("div", "ai-detail-main");
+        main.append(detailTitle("Documentation bases"), el("div", "ai-detail-sub", "Folders of markdown the AI can answer from. A change to a base saves right away; nothing on disk is ever changed."));
+        detailHead.append(icon, main);
+        return;
+      }
       if (selection.kind === "add") {
         const icon = el("span", "ai-detail-icon");
         icon.innerHTML = ICONS.plus;
@@ -4578,6 +5402,9 @@ function mountAiEnginesPage(container, ctx, opts) {
       wizard.back();
       return;
     }
+    if (selection.kind === "bases" && docsSection?.back()) {
+      return;
+    }
     if (narrow && view === "detail") {
       view = "list";
       applyLayout();
@@ -4614,6 +5441,13 @@ function mountAiEnginesPage(container, ctx, opts) {
       requirePick(unpicked.id);
       return;
     }
+    if (docsSection?.hasUnsavedForm()) {
+      if (selection.kind !== "bases") {
+        select({ kind: "bases" });
+      }
+      docsSection.flagUnsavedForm();
+      return;
+    }
     finished = true;
     const patch = session.collect();
     const saved = session.commit();
@@ -4655,7 +5489,7 @@ function mountAiEnginesPage(container, ctx, opts) {
     box.setAttribute("aria-describedby", textId);
     const head = el("div", "ai-page-confirm-title", "Discard changes?");
     head.id = headId;
-    const text = el("div", "ai-page-confirm-text", "Your changes to engines and tasks have not been saved. Engines added here and their keys are removed.");
+    const text = el("div", "ai-page-confirm-text", docsSection ? "Your changes to engines, tasks and base options have not been saved. Engines added here and their keys are removed. Bases you saved stay saved." : "Your changes to engines and tasks have not been saved. Engines added here and their keys are removed.");
     text.id = textId;
     const keep = button("settings-btn", "Keep editing", { fk: "page:keep" });
     keep.addEventListener("click", () => hideDiscard());
@@ -4705,7 +5539,7 @@ function mountAiEnginesPage(container, ctx, opts) {
     applyLayout();
   }
   function focusSelectedEntry() {
-    const fk = selection.kind === "engine" ? `nav:eng:${selection.id}` : selection.kind === "routing" ? "nav:routing" : "nav:add";
+    const fk = selection.kind === "engine" ? `nav:eng:${selection.id}` : selection.kind === "routing" ? "nav:routing" : selection.kind === "bases" ? "nav:bases" : "nav:add";
     focusKey(fk);
   }
   let resizeObserver = null;
@@ -4855,6 +5689,7 @@ function mountAiEnginesPage(container, ctx, opts) {
       unsubscribe?.();
       resizeObserver?.disconnect();
       form.dispose();
+      docsSection?.dispose();
       container.replaceChildren();
     },
     focus() {
@@ -4866,6 +5701,8 @@ function mountAiEnginesPage(container, ctx, opts) {
         focusDetailTitle();
       } else if (!narrow && selection.kind === "routing") {
         focusKey("route:default");
+      } else if (!narrow && selection.kind === "bases") {
+        docsSection?.focus();
       } else if (!narrow && selection.kind === "add" && session.draft.engines.length === 0) {
         detailBody.querySelector(".ai-card")?.focus({ preventScroll: true });
       } else {
@@ -4905,6 +5742,7 @@ export {
   bestLocalServer,
   setUpLocalEngine,
   scanForSetup,
+  createDocsBasesSection,
   mountAiEnginesPage
 };
-//# sourceMappingURL=chunk-7A5HEPLK.js.map
+//# sourceMappingURL=chunk-DWXGWVA3.js.map