@cleocode/cleo 2026.5.86 → 2026.5.87

package/assets/viewer/index.html

@@ -10,9 +10,11 @@
   <header class="topbar">
     <h1>CLEO Docs</h1>
     <input id="filter" type="search" placeholder="Filter by slug, title, type..." autocomplete="off" />
+    <input id="search" type="search" placeholder="Search content (ranked)..." autocomplete="off" aria-label="Search docs by content" />
   </header>
   <main class="layout">
     <aside id="sidebar">
+      <div id="search-results" aria-live="polite" hidden></div>
       <div id="doc-list" aria-live="polite">Loading docs...</div>
     </aside>
     <section id="content">

package/assets/viewer/styles.css

@@ -130,3 +130,67 @@ html, body {
 
 .hint { color: var(--text-muted); }
 .error { color: #ff7f7f; }
+
+/* T9647 — search results UI */
+#search {
+  flex: 1;
+  max-width: 360px;
+  background: var(--surface-2);
+  border: 1px solid var(--border);
+  color: var(--text);
+  padding: 0.45rem 0.75rem;
+  border-radius: 6px;
+  font: inherit;
+}
+#search:focus { outline: 2px solid var(--accent); outline-offset: 0; }
+
+#search-results {
+  padding: 0.25rem 0;
+  border-bottom: 1px solid var(--border);
+}
+#search-results .result {
+  display: block;
+  padding: 0.55rem 1rem;
+  color: var(--text);
+  text-decoration: none;
+  border-left: 3px solid transparent;
+}
+#search-results .result:hover {
+  background: var(--surface-2);
+  border-left-color: var(--accent);
+}
+#search-results .result-head {
+  display: flex;
+  align-items: baseline;
+  gap: 0.5rem;
+  font-size: 0.9rem;
+}
+#search-results .result-name {
+  font-weight: 600;
+  color: var(--accent);
+  flex: 1;
+  word-break: break-word;
+}
+#search-results .result-type {
+  font-size: 0.7rem;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+#search-results .result-score {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  font-variant-numeric: tabular-nums;
+}
+#search-results .result-snippet {
+  color: var(--text-muted);
+  font-size: 0.8rem;
+  line-height: 1.4;
+  margin-top: 0.2rem;
+}
+#search-results mark {
+  background: rgba(106, 167, 255, 0.25);
+  color: inherit;
+  padding: 0 2px;
+  border-radius: 2px;
+}

package/assets/viewer/viewer.js

@@ -6,10 +6,13 @@
 const $list = document.getElementById('doc-list');
 const $render = document.getElementById('doc-render');
 const $filter = document.getElementById('filter');
+const $search = document.getElementById('search');
+const $searchResults = document.getElementById('search-results');
 
 const state = {
   docs: [],
   activeSlug: null,
+  searchSeq: 0,
 };
 
 function escapeHtml(str) {
@@ -287,6 +290,100 @@ function slugFromPath(pathname) {
 
 $filter.addEventListener('input', (e) => applyFilter(e.target.value));
 
+// ── Search (T9647) — debounced /api/search with ranked results ──────────────
+
+function debounce(fn, ms) {
+  let timer = null;
+  return function debounced(...args) {
+    if (timer !== null) clearTimeout(timer);
+    timer = setTimeout(() => {
+      timer = null;
+      fn.apply(this, args);
+    }, ms);
+  };
+}
+
+function highlightMatches(snippet, query) {
+  if (!query) return escapeHtml(snippet);
+  const terms = query
+    .toLowerCase()
+    .split(/\s+/)
+    .filter((t) => t.length >= 2);
+  if (terms.length === 0) return escapeHtml(snippet);
+  // Build a regex that matches any term, case-insensitive. Escape regex metachars.
+  const pattern = terms
+    .map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+    .join('|');
+  const re = new RegExp(`(${pattern})`, 'gi');
+  const escaped = escapeHtml(snippet);
+  return escaped.replace(re, '<mark>$1</mark>');
+}
+
+function renderSearchResults(query, payload) {
+  if (!payload || !payload.hits || payload.hits.length === 0) {
+    $searchResults.innerHTML =
+      `<p class="hint">No results for <code>${escapeHtml(query)}</code>.</p>`;
+    $searchResults.hidden = false;
+    $list.hidden = true;
+    return;
+  }
+  const html = payload.hits
+    .map((h) => {
+      const slug = escapeHtml(h.slug || h.id);
+      const name = escapeHtml(h.name || h.slug || h.id);
+      const type = h.type ? `<span class="result-type">${escapeHtml(h.type)}</span>` : '';
+      const score = typeof h.score === 'number' ? h.score.toFixed(3) : '—';
+      const snippet = highlightMatches(h.snippet || '', query);
+      return [
+        `<a href="/docs/${slug}" data-slug="${slug}" class="result">`,
+        `<div class="result-head"><span class="result-name">${name}</span>${type}<span class="result-score">${score}</span></div>`,
+        `<div class="result-snippet">${snippet}</div>`,
+        `</a>`,
+      ].join('');
+    })
+    .join('');
+  $searchResults.innerHTML = html;
+  $searchResults.hidden = false;
+  $list.hidden = true;
+  $searchResults.querySelectorAll('a.result').forEach((a) => {
+    a.addEventListener('click', (e) => {
+      e.preventDefault();
+      const slug = a.getAttribute('data-slug');
+      navigate(slug);
+    });
+  });
+}
+
+function clearSearchResults() {
+  $searchResults.hidden = true;
+  $searchResults.innerHTML = '';
+  $list.hidden = false;
+}
+
+async function runSearch(query) {
+  const q = query.trim();
+  if (q.length === 0) {
+    clearSearchResults();
+    return;
+  }
+  const seq = ++state.searchSeq;
+  try {
+    const url = `/api/search?q=${encodeURIComponent(q)}&limit=20`;
+    const data = await fetchJson(url);
+    // Drop stale responses if a newer query has fired.
+    if (seq !== state.searchSeq) return;
+    renderSearchResults(q, data);
+  } catch (err) {
+    if (seq !== state.searchSeq) return;
+    $searchResults.innerHTML = `<p class="error">${escapeHtml(String(err.message || err))}</p>`;
+    $searchResults.hidden = false;
+    $list.hidden = true;
+  }
+}
+
+const debouncedSearch = debounce(runSearch, 300);
+$search.addEventListener('input', (e) => debouncedSearch(e.target.value));
+
 (async function init() {
   try {
     const data = await fetchJson('/api/docs');

package/dist/cli/index.js

@@ -41701,7 +41701,8 @@ import { dirname as dirname8, join as join16, normalize, resolve as resolve5 } f
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import {
   createAttachmentStore as createAttachmentStore2,
-  getProjectRoot as getProjectRoot27
+  getProjectRoot as getProjectRoot27,
+  searchAllProjectDocs
 } from "@cleocode/core/internal";
 function getViewerAssetsDir() {
   const thisFile = fileURLToPath5(import.meta.url);
@@ -41810,6 +41811,39 @@ function buildViewerHandler(opts = {}) {
         send(res, 200, "application/json", lafsSuccessJson({ docs }));
         return;
       }
+      if (pathname === "/api/search") {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+        const q = (url.searchParams.get("q") ?? "").trim();
+        const limitRaw = url.searchParams.get("limit");
+        const type2 = url.searchParams.get("type") ?? void 0;
+        if (q.length === 0) {
+          send(
+            res,
+            400,
+            "application/json",
+            lafsErrorJson(
+              "E_VALIDATION",
+              "query parameter `q` is required",
+              "append ?q=<query> to /api/search, e.g. '/api/search?q=release'"
+            )
+          );
+          return;
+        }
+        const limit = limitRaw ? Math.max(1, Math.min(50, Number.parseInt(limitRaw, 10))) : 10;
+        try {
+          const result = await searchAllProjectDocs(q, {
+            projectRoot,
+            limit: Number.isFinite(limit) ? limit : 10,
+            type: type2 && type2.length > 0 ? type2 : void 0
+          });
+          send(res, 200, "application/json", lafsSuccessJson(result));
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          const code = err instanceof Error && err.code ? err.code : "E_SEARCH_FAILED";
+          send(res, 500, "application/json", lafsErrorJson(code, msg));
+        }
+        return;
+      }
       const apiDocMatch = pathname.match(/^\/api\/docs\/([^/]+)$/);
       if (apiDocMatch) {
         const slug = decodeURIComponent(apiDocMatch[1]);
@@ -41905,7 +41939,7 @@ import { spawn } from "node:child_process";
 import { open as fsOpen } from "node:fs/promises";
 import { join as join17 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
-import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot28 } from "@cleocode/core/internal";
+import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot28 } from "@cleocode/core";
 function getCleoBinPath() {
   const thisFile = fileURLToPath6(import.meta.url);
   return join17(thisFile, "..", "..", "index.js");
@@ -42402,6 +42436,7 @@ import {
   readJson,
   recordPublication,
   runDocsImport,
+  searchAllProjectDocs as searchAllProjectDocs2,
   searchDocs as searchDocs2,
   statusDocs,
   syncFromGit
@@ -42765,7 +42800,7 @@ var init_docs3 = __esm({
     searchCommand = defineCommand({
       meta: {
         name: "search",
-        description: "Search attachments by semantic similarity using llmtxt/similarity.rankBySimilarity. Pass --owner to scope the search to a specific entity (T###, ses_*, O-*)."
+        description: "Search attachments by semantic similarity using llmtxt/similarity.rankBySimilarity. Without --owner, ranks every published doc in the project by content (T9647). Pass --owner to scope to a specific entity (T###, ses_*, O-*) and rank by blob name."
       },
       args: {
         query: {
@@ -42775,7 +42810,11 @@ var init_docs3 = __esm({
         },
         owner: {
           type: "string",
-          description: "Scope search to a specific owner entity ID"
+          description: "Scope search to a specific owner entity ID (legacy name-only ranking)"
+        },
+        type: {
+          type: "string",
+          description: "Filter project-wide search by taxonomy type: spec|adr|research|handoff|note|llm-readme"
         },
         limit: {
           type: "string",
@@ -42788,10 +42827,15 @@ var init_docs3 = __esm({
       },
       async run({ args }) {
         const projectRoot = getProjectRoot29();
+        const limit = args.limit ? Number.parseInt(String(args.limit), 10) : 10;
         try {
-          const result = await searchDocs2(String(args.query), {
-            ownerId: args.owner ?? void 0,
-            limit: args.limit ? Number.parseInt(String(args.limit), 10) : 10,
+          const result = args.owner ? await searchDocs2(String(args.query), {
+            ownerId: String(args.owner),
+            limit,
+            projectRoot
+          }) : await searchAllProjectDocs2(String(args.query), {
+            limit,
+            type: args.type ? String(args.type) : void 0,
             projectRoot
           });
           cliOutput(result, { command: "docs search", operation: "docs.search" });