@tensorix/metahub 0.3.1 → 0.3.2

package/README.md

@@ -6,6 +6,10 @@ English · [简体中文](./README.zh-CN.md)
 
 metahub is a local-first knowledge base CLI built on Bun + SQLite. It gives an AI agent a durable, syncable working memory: Notion-style **typed tables** for structured data, **Markdown documents** for long-form knowledge, and a `Read / Edit / Write`-style editing interface. Everything lives on your own machine under `~/.metahub/` — offline on one machine, and consistent across many.
 
+<p align="center">
+  <img src="./docs/assets/webui.png" alt="metahub WebUI — block-level document editing" width="100%">
+</p>
+
 > Requires [Bun](https://bun.sh). Use `bunx`, a global `mh` install, or a standalone binary.
 
 ## Why metahub
@@ -15,7 +19,10 @@ metahub is a local-first knowledge base CLI built on Bun + SQLite. It gives an A
 - **Local-first and syncable** — your data sits on your own disk and works offline; multiple machines merge cleanly, and edits to different paragraphs don't clobber each other.
 - **GUI and API included** — `mh --server` starts a browser WebUI (browse, inline-edit, full-text search), a `/api/*` REST interface, and auto-generated OpenAPI docs.
 
-<!-- TODO screenshots: docs/assets/webui.png (WebUI), docs/assets/desktop.png (desktop app) -->
+<p align="center">
+  <img src="./docs/assets/webui-table.png" alt="metahub WebUI — typed tables with select, multi-select, and checkbox columns" width="100%">
+</p>
+
 > Want to see the UI? Install the [desktop app](#install) or run `mh --server` and open `http://localhost:7777/`.
 
 ## Quick start

package/dist/cli.js

@@ -3099,16 +3099,22 @@ var init_documents = __esm(() => {
 
 `)) {
       const affected = blocks.filter((b2) => b2.text.includes(opts.old));
-      const next = affected.map((b2) => opts.replaceAll ? b2.text.replaceAll(opts.old, opts.new) : b2.text.replace(opts.old, opts.new));
+      const next = affected.map((b2) => opts.replaceAll ? b2.text.replaceAll(opts.old, () => opts.new) : b2.text.replace(opts.old, () => opts.new));
       if (next.every((t2) => t2.length > 0 && !t2.includes(`
 
 `))) {
         const targets = opts.replaceAll ? affected : affected.slice(0, 1);
-        targets.forEach((b2, i2) => emit(db, "doc_blocks", b2.id, "text", next[i2]));
-        return { id, changed: true, replaced: opts.replaceAll ? count : 1, version: documentVersion(db, id) };
+        let wrote = false;
+        targets.forEach((b2, i2) => {
+          if (next[i2] !== b2.text) {
+            emit(db, "doc_blocks", b2.id, "text", next[i2]);
+            wrote = true;
+          }
+        });
+        return { id, changed: wrote, replaced: opts.replaceAll ? count : 1, version: documentVersion(db, id) };
       }
     }
-    const newBody = opts.replaceAll ? body.replaceAll(opts.old, opts.new) : body.replace(opts.old, opts.new);
+    const newBody = opts.replaceAll ? body.replaceAll(opts.old, () => opts.new) : body.replace(opts.old, () => opts.new);
     reconcileBody(db, id, newBody);
     return { id, changed: newBody !== body, replaced: opts.replaceAll ? count : 1, version: documentVersion(db, id) };
   });
@@ -3132,7 +3138,7 @@ var init_documents = __esm(() => {
       if (count > 1 && !e2.replaceAll)
         throw new MhError("ambiguous", `edit[${i2}]: ${count} matches for old; add surrounding context or set replaceAll`);
       const repl = e2.new ?? "";
-      body = e2.replaceAll ? body.replaceAll(e2.old, repl) : body.replace(e2.old, repl);
+      body = e2.replaceAll ? body.replaceAll(e2.old, () => repl) : body.replace(e2.old, () => repl);
       total += e2.replaceAll ? count : 1;
     });
     if (body !== orig)
@@ -19690,6 +19696,70 @@ var init_sites_serve = __esm(() => {
 });
 
 // src/core/md/grammar.ts
+function safeUrl(url2, opts = {}) {
+  const probe = url2.replace(/[\u0000-\u0020]+/g, "");
+  const m3 = /^([a-z][a-z0-9+.-]*):/i.exec(probe);
+  if (!m3)
+    return url2;
+  const scheme = m3[1].toLowerCase();
+  if (scheme === "http" || scheme === "https" || scheme === "mailto" || scheme === "blob")
+    return url2;
+  if (scheme === "data" && opts.allowData)
+    return url2;
+  return "#";
+}
+function extOf(url2) {
+  const clean = url2.split(/[?#]/, 1)[0] ?? url2;
+  const base = clean.slice(clean.lastIndexOf("/") + 1);
+  const dot = base.lastIndexOf(".");
+  return dot >= 0 ? base.slice(dot + 1).toLowerCase() : "";
+}
+function imageSyntaxKind(ext2) {
+  if (VIDEO_EXTS.has(ext2))
+    return "video";
+  if (AUDIO_EXTS.has(ext2))
+    return "audio";
+  return "image";
+}
+function parseMediaUrl(url2) {
+  const hash3 = url2.indexOf("#");
+  const frag = hash3 >= 0 ? url2.slice(hash3) : "";
+  const noFrag = hash3 >= 0 ? url2.slice(0, hash3) : url2;
+  const q3 = noFrag.indexOf("?");
+  if (q3 < 0)
+    return { src: url2 };
+  const base = noFrag.slice(0, q3);
+  let width;
+  const kept = [];
+  for (const p2 of noFrag.slice(q3 + 1).split("&").filter(Boolean)) {
+    const m3 = p2.match(/^w=(\d+)$/);
+    if (m3)
+      width = parseInt(m3[1], 10);
+    else
+      kept.push(p2);
+  }
+  return { src: base + (kept.length ? "?" + kept.join("&") : "") + frag, width };
+}
+function matchMediaEmbed(line) {
+  const t2 = line.trim();
+  let m3 = t2.match(/^!\[([^\]]*)\]\(([^\s)]+)\)$/);
+  if (m3) {
+    const { src: src2, width } = parseMediaUrl(m3[2]);
+    const kind = imageSyntaxKind(extOf(src2));
+    const r3 = { kind, src: src2, name: m3[1] };
+    if (kind === "image" && width)
+      r3.width = width;
+    return r3;
+  }
+  m3 = t2.match(/^\[([^\]]*)\]\(([^\s)]+)(?:\s+"([^"]*)")?\)$/);
+  if (m3 && m3[2].startsWith("/blob/")) {
+    const r3 = { kind: "file", src: m3[2], name: m3[1] };
+    if (m3[3] != null && /^\d+$/.test(m3[3]))
+      r3.size = parseInt(m3[3], 10);
+    return r3;
+  }
+  return null;
+}
 function matchQuoteLine(text) {
   const m3 = text.match(RE.quote);
   return m3 ? m3[1] : null;
@@ -19793,7 +19863,7 @@ function splitTableRow(line) {
     cells.pop();
   return cells.map((c3) => c3.trim());
 }
-var HTML_FENCE = "mh-html", RE, RE_DELIM_CELL;
+var HTML_FENCE = "mh-html", RE, VIDEO_EXTS, AUDIO_EXTS, RE_DELIM_CELL;
 var init_grammar = __esm(() => {
   RE = {
     fenceOpen: /^\s*(`{3,}|~{3,})\s*([^\s`]*)?.*$/,
@@ -19804,6 +19874,8 @@ var init_grammar = __esm(() => {
     quote: /^>[ \t](.*)$/,
     divider: /^\s*(?:-{3,}|\*{3,}|_{3,})\s*$/
   };
+  VIDEO_EXTS = new Set(["mp4", "webm", "mov", "m4v", "ogv", "mkv", "ogg"]);
+  AUDIO_EXTS = new Set(["mp3", "wav", "m4a", "aac", "flac", "opus", "oga", "weba"]);
   RE_DELIM_CELL = /^\s*:?-+:?\s*$/;
 });
 
@@ -19917,6 +19989,15 @@ function healLegacyMarkdown(src2) {
       changed = true;
     }
   }
+  for (let i2 = lines.length - 1;i2 >= 0; i2--) {
+    if (inFence[i2])
+      continue;
+    const line = lines[i2];
+    if (BARE_QUOTE.test(line) && (quoteish(i2 - 1) || quoteish(i2 + 1))) {
+      lines[i2] = line + " ";
+      changed = true;
+    }
+  }
   return changed ? lines.join(`
 `) : src2;
 }
@@ -19939,7 +20020,7 @@ function renderInline(src2, opts = {}) {
   for (const t2 of tokens) {
     out += escapeHtml(src2.slice(pos, t2.start));
     const inner = src2.slice(t2.innerFrom, t2.innerTo);
-    const url2 = rewrite(t2.url ?? "", opts).replace(/"/g, "&quot;");
+    const rawUrl = rewrite(t2.url ?? "", opts);
     switch (t2.kind) {
       case "code":
         out += `<code>${escapeHtml(inner)}</code>`;
@@ -19953,12 +20034,16 @@ function renderInline(src2, opts = {}) {
       case "del":
         out += `<del>${escapeHtml(inner)}</del>`;
         break;
-      case "link":
-        out += `<a href="${url2}" target="_blank" rel="noreferrer noopener">${escapeHtml(inner)}</a>`;
+      case "link": {
+        const href = escapeHtml(safeUrl(rawUrl));
+        out += `<a href="${href}" target="_blank" rel="noreferrer noopener">${escapeHtml(inner)}</a>`;
         break;
-      case "image":
-        out += `<img src="${url2}" alt="${escapeHtml(t2.alt ?? "")}" loading="lazy">`;
+      }
+      case "image": {
+        const imgSrc = escapeHtml(safeUrl(rawUrl, { allowData: true }));
+        out += `<img src="${imgSrc}" alt="${escapeHtml(t2.alt ?? "")}" loading="lazy">`;
         break;
+      }
     }
     pos = t2.end;
   }
@@ -19969,6 +20054,19 @@ function rewrite(url2, opts) {
     return opts.rewriteBlob(url2);
   return url2;
 }
+function renderMedia(m3, opts) {
+  const raw = rewrite(m3.src, opts);
+  if (m3.kind === "video") {
+    const src2 = escapeHtml(safeUrl(raw, { allowData: true }));
+    return `<p class="mh-media"><video src="${src2}" controls preload="metadata"></video></p>`;
+  }
+  if (m3.kind === "audio") {
+    const src2 = escapeHtml(safeUrl(raw, { allowData: true }));
+    return `<p class="mh-media"><audio src="${src2}" controls preload="metadata"></audio></p>`;
+  }
+  const href = escapeHtml(safeUrl(raw));
+  return `<p class="mh-file"><a href="${href}" download>${escapeHtml(m3.name || "file")}</a></p>`;
+}
 function renderMarkdown(md, opts = {}) {
   const healed = healLegacyMarkdown((md ?? "").replace(/\r\n?/g, `
 `));
@@ -20080,9 +20178,10 @@ function renderMarkdown(md, opts = {}) {
       out.push(ordered ? `<ol>${lis.join("")}</ol>` : `<ul>${lis.join("")}</ul>`);
       continue;
     }
-    if (/^\s*!\[[^\]]*\]\([^)\s]+\)\s*$/.test(line)) {
+    const media = matchMediaEmbed(line);
+    if (media) {
       flushPara();
-      out.push(`<p class="mh-img">${renderInline(line.trim(), opts)}</p>`);
+      out.push(media.kind === "image" ? `<p class="mh-img">${renderInline(line.trim(), opts)}</p>` : renderMedia(media, opts));
       i2++;
       continue;
     }
@@ -20517,6 +20616,8 @@ function pageShell(title, inner, opts = {}) {
   td[contenteditable]{outline:none} td.saving{opacity:.5} td.saved{background:rgba(46,160,67,.18)}
   .tag{display:inline-block;background:var(--card);border:1px solid var(--line);border-radius:999px;padding:1px 9px;font-size:12px}
   .muted{color:var(--muted)} .mh-img{text-align:center}
+  .mh-media{text-align:center} .mh-media video,.mh-media audio{max-width:100%}
+  .mh-file a{display:inline-block;background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px 14px;color:var(--accent);text-decoration:none}
   iframe.mh-embed{width:100%;border:1px solid var(--line);border-radius:8px;min-height:240px}
   textarea.mh-raw{width:100%;min-height:60vh;font:14px/1.6 ui-monospace,SFMono-Regular,Menlo,monospace;padding:14px;border:1px solid var(--line);border-radius:8px;background:var(--card);color:var(--fg)}
   ul.files{list-style:none;padding:0} ul.files li{padding:4px 0} button.file{background:none;border:0;color:var(--accent);cursor:pointer;font-size:15px;padding:0}
@@ -21955,7 +22056,7 @@ async function runMain(cmd, opts = {}) {
 // package.json
 var package_default = {
   name: "@tensorix/metahub",
-  version: "0.3.1",
+  version: "0.3.2",
   description: "Metahub core library and CLI",
   license: "AGPL-3.0-only",
   type: "module",
@@ -23678,6 +23779,7 @@ var get_default = defineCommand({
 init_properties();
 
 // src/cli/input.ts
+init_errors();
 async function resolveValue2(raw) {
   if (raw == null)
     return;
@@ -23691,7 +23793,11 @@ async function resolveJson(raw) {
   const text = await resolveValue2(raw);
   if (text == null)
     return;
-  return JSON.parse(text);
+  try {
+    return JSON.parse(text);
+  } catch (e2) {
+    throw new MhError("invalid_input", `invalid JSON: ${e2 instanceof Error ? e2.message : String(e2)}`);
+  }
 }
 
 // src/cli/commands/prop.ts
@@ -24191,7 +24297,7 @@ var edit = defineCommand({
         throw new MhError("invalid_input", "use --old/--new/--replace-all or --edits, not both");
       const edits = parseEditPairs(await resolveJson(args.edits));
       const r4 = editDocumentBatch(db, id, { edits, ifMatch: args["if-match"] });
-      print(r4, () => `edited ${r4.id} (${r4.replaced} replaced across ${edits.length} edit(s))`);
+      print(r4, () => r4.changed ? `edited ${r4.id} (${r4.replaced} replaced across ${edits.length} edit(s))` : `no change: ${r4.id}`);
       return;
     }
     if (args.old == null)
@@ -24204,7 +24310,7 @@ var edit = defineCommand({
       replaceAll: args["replace-all"],
       ifMatch: args["if-match"]
     });
-    print(r3, () => `edited ${r3.id} (${r3.replaced} replaced)`);
+    print(r3, () => r3.changed ? `edited ${r3.id} (${r3.replaced} replaced)` : `no change: ${r3.id}`);
   })
 });
 var append = defineCommand({
@@ -33005,4 +33111,4 @@ if (argv2.includes("--server")) {
   runMain(main, { showUsage: showUsage2 });
 }
 
-//# debugId=6B3DFB027376050D64756E2164756E21
+//# debugId=65C9A394BDB4F1CE64756E2164756E21