living-ai-documentation 1.0.0

package/dist/src/frontend/state.js

@@ -0,0 +1,46 @@
+// ── Shared module state ──────────────────────────────────────────────────────
+// Loaded first (defer, before all other modules). All symbols are globals.
+
+let allDocs = [];
+let allFolderPaths = [];
+let annotationCounts = {};
+let fileAttachmentCounts = {};
+let currentDocId = null;
+let currentDocContent = "";
+let searchQuery = "";
+let searchResults = null;
+let navHistory = []; // stack of { id, title } visited via in-doc links
+let expandedCategories = new Set();
+let expandedFolders = new Set();
+let hideCategories = (() => {
+  try {
+    return localStorage.getItem("ld-hide-categories") === "1";
+  } catch {
+    return false;
+  }
+})();
+let hideAttachments = (() => {
+  try {
+    return localStorage.getItem("ld-hide-attachments") === "1";
+  } catch {
+    return false;
+  }
+})();
+let exclusiveFolderExpansion = false;
+let exclusiveCategoryExpansion = false;
+let codeBlockMaxHeight = 400;
+
+function filteredDocs() {
+  if (!searchQuery) return allDocs;
+  if (Array.isArray(searchResults)) return searchResults;
+  const q = searchQuery.toLowerCase();
+  return allDocs.filter(
+    (d) =>
+      d.title.toLowerCase().includes(q) ||
+      d.category.toLowerCase().includes(q),
+  );
+}
+
+function refreshSidebar() {
+  renderSidebar(filteredDocs());
+}

package/dist/src/frontend/utils.js

@@ -0,0 +1,21 @@
+// ── Pure utilities shared across index.html ──────────────────────────────────
+// Loaded as a classic script; all symbols are global.
+
+function esc(str) {
+  return String(str)
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+// Strip a leading numeric sort prefix (e.g. "1_tutorial" → "Tutorial").
+// Underscores/hyphens become spaces, result is title-cased.
+// The full original name is preserved in the tooltip.
+function folderLabel(seg) {
+  return seg
+    .replace(/^\d+_/, "")
+    .replace(/[_-]+/g, " ")
+    .replace(/\b\w/g, (c) => c.toUpperCase());
+}

package/dist/src/frontend/validate.js

@@ -0,0 +1,107 @@
+// ── Document validation ──────────────────────────────────────────────────────
+// Wires the "Validate" toolbar button: visible only when the loaded document's
+// frontmatter contains `**status:** To be validated`. Clicking flips the status
+// to `Accepted` via PUT /api/documents/:id; if the document's reliability is
+// below 100%, the confirmation modal also warns that source-file hashes will be
+// re-baselined, and POST /api/metadata/:id/refresh is called after the PUT.
+
+// Frontmatter on this project is a `---`-fenced block of `**key:** value` lines
+// (not standard YAML). The status line is the only field this module touches.
+const _STATUS_LINE_RE = /^(\*\*status:\*\*\s*).+?\s*$/m;
+
+function getDocStatus(content) {
+  if (typeof content !== "string") return null;
+  const fence = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!fence) return null;
+  const m = fence[1].match(/^\*\*status:\*\*\s*(.+?)\s*$/m);
+  return m ? m[1].trim() : null;
+}
+
+function _replaceStatus(content, newStatus) {
+  return content.replace(_STATUS_LINE_RE, `$1${newStatus}`);
+}
+
+function updateValidateButtonForCurrentDoc() {
+  const btn = document.getElementById("validate-btn");
+  if (!btn) return;
+  const status = getDocStatus(
+    typeof currentDocContent !== "undefined" ? currentDocContent : "",
+  );
+  if (status === "To be validated") {
+    btn.classList.remove("hidden");
+  } else {
+    btn.classList.add("hidden");
+  }
+}
+
+async function validateCurrentDoc() {
+  const id = typeof currentDocId !== "undefined" ? currentDocId : null;
+  if (!id) return;
+
+  // Snapshot accuracy now so the confirm modal warns when re-baselining is implied.
+  let accuracy = 1;
+  try {
+    const r = await fetch("/api/metadata/" + encodeURIComponent(id));
+    if (r.ok) {
+      const rep = await r.json();
+      if (typeof rep.accuracy === "number") accuracy = rep.accuracy;
+    }
+  } catch {
+    // Fall through with accuracy = 1; worst case we skip the warning. The
+    // refresh step is still gated on the same value, so semantics stay aligned.
+  }
+  const pct = Math.round(accuracy * 100);
+  const lowAccuracy = pct < 100;
+  const detail = lowAccuracy
+    ? window.t("doc.validate_detail_low_accuracy").replace("{accuracy}", pct + "%")
+    : "";
+
+  const ok = await window.showConfirm({
+    title: window.t("doc.validate_title"),
+    message: window.t("doc.validate_message"),
+    detail,
+    detailTone: lowAccuracy ? "warning" : undefined,
+    confirmLabel: window.t("doc.validate_confirm"),
+  });
+  if (!ok) return;
+
+  const btn = document.getElementById("validate-btn");
+  if (btn) btn.disabled = true;
+
+  try {
+    const newContent = _replaceStatus(currentDocContent, "Accepted");
+    if (newContent === currentDocContent) {
+      throw new Error("status line not found in frontmatter");
+    }
+    const putRes = await fetch("/api/documents/" + encodeURIComponent(id), {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ content: newContent }),
+    });
+    if (!putRes.ok) throw new Error(putRes.statusText || "save failed");
+
+    if (lowAccuracy) {
+      const refRes = await fetch(
+        "/api/metadata/" + encodeURIComponent(id) + "/refresh",
+        { method: "POST" },
+      );
+      if (!refRes.ok) throw new Error(refRes.statusText || "refresh failed");
+    }
+
+    if (typeof openDocument === "function") {
+      await openDocument(id, /* skipHistory */ true);
+    }
+    if (typeof loadMetadataReport === "function") {
+      await loadMetadataReport(id);
+    }
+  } catch (err) {
+    const msg = err && err.message ? err.message : String(err);
+    alert(window.t("doc.validate_failed") + msg);
+  } finally {
+    if (btn) btn.disabled = false;
+  }
+}
+
+window.validateCurrentDoc = validateCurrentDoc;
+window.updateValidateButtonForCurrentDoc = updateValidateButtonForCurrentDoc;
+window.getDocStatus = getDocStatus;